本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 從 Intercom 實體中讀取
<a name="intercom-reading-from-entities"></a>

 **先決條件** 
+  您想要從中進行讀取的 Intercom 物件。請參閱以下支援的實體表格，以檢查可用實體。

 **支援的實體** 


| 實體 | API\_Version | 可以篩選 | 支援限制 | 支援排序依據 | 支援選取 \* | 支援分區 | 
| --- | --- | --- | --- | --- | --- | --- | 
| 管理員 | v2.5 | 否 | 否 | 否 | 是 | 否 | 
| 公司 | v2.5 | 否 | 是 | 否 | 是 | 否 | 
| 對話 | v2.5 | 是 | 是 | 是 | 是 | 是 | 
| 資料屬性 | v2.5 | 否 | 否 | 否 | 是 | 否 | 
| 聯絡人 | v2.5 | 是 | 是 | 是 | 是 | 是 | 
| 客群 | v2.5 | 否 | 否 | 否 | 是 | 否 | 
| Tags (標籤) | v2.5 | 否 | 否 | 否 | 是 | 否 | 
| 團隊 | v2.5 | 否 | 否 | 否 | 是 | 否 | 

 **範例** 

```
Intercom_read = glueContext.create_dynamic_frame.from_options(
    connection_type="Intercom",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "company",
        "API_VERSION": "V2.5"
    }
)
```

 **Intercom 實體和欄位詳細資訊** 


| 實體 | 欄位 | 資料類型 | 支援的運算子 | 
| --- | --- | --- | --- | 
| 管理員 | type | String | NA | 
| 管理員 | id | String | NA | 
| 管理員 | avatar | Struct | NA | 
| 管理員 | name | String | NA | 
| 管理員 | email | String | NA | 
| 管理員 | away\_mode\_enabled | Boolean | NA | 
| 管理員 | away\_mode\_reassign | Boolean | NA | 
| 管理員 | has\_inbox\_seat | Boolean | NA | 
| 管理員 | team\_ids | 清單 | NA | 
| 管理員 | job\_title | String | NA | 
| 公司 | type | String | NA | 
| 公司 | id | String | NA | 
| 公司 | app\_id | String | NA | 
| 公司 | created\_at | DateTime | NA | 
| 公司 | remote\_created\_at | DateTime | NA | 
| 公司 | updated\_at | DateTime | NA | 
| 公司 | last\_request\_at | DateTime | NA | 
| 公司 | plan | Struct | NA | 
| 公司 | company\_id | String | NA | 
| 公司 | name | String | NA | 
| 公司 | custom\_attributes | Struct | NA | 
| 公司 | session\_count | Integer | NA | 
| 公司 | monthly\_spend | Integer | NA | 
| 公司 | user\_count | Integer | NA | 
| 公司 | industry | String | NA | 
| 公司 | size | Integer | NA | 
| 公司 | website | String | NA | 
| 公司 | 標籤 | Struct | NA | 
| 公司 | segments | Struct | NA | 
| 聯絡人 | id | String | EQUAL\_TO.NOT\_EQUAL\_TO | 
| 聯絡人 | type | String | NA | 
| 聯絡人 | workspace\_id | String | NA | 
| 聯絡人 | external\_id | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 聯絡人 | role | String | EQUAL\_TO.NOT\_EQUAL\_TO | 
| 聯絡人 | email | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 聯絡人 | phone | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 聯絡人 | name | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 聯絡人 | avatar | String | NA | 
| 聯絡人 | owner\_id | Integer | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 聯絡人 | social\_profiles | Struct | NA | 
| 聯絡人 | has\_hard\_bounced | Boolean | EQUAL\_TO | 
| 聯絡人 | marked\_email\_as\_spam | Boolean | EQUAL\_TO | 
| 聯絡人 | unsubscribed\_from\_emails | Boolean | EQUAL\_TO | 
| 聯絡人 | created\_at | DateTime | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 聯絡人 | updated\_at | DateTime | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 聯絡人 | signed\_up\_at | DateTime | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 聯絡人 | last\_seen\_at | DateTime | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 聯絡人 | last\_replied\_at | DateTime | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 聯絡人 | last\_contacted\_at | DateTime | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 聯絡人 | last\_email\_opened\_at | DateTime | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 聯絡人 | last\_email\_clicked\_at | DateTime | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 聯絡人 | language\_override | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 聯絡人 | browser | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 聯絡人 | browser\_version | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 聯絡人 | 瀏覽器\_語言 | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 聯絡人 | os | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 聯絡人 | location | Struct | NA | 
| 聯絡人 | location\_country | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 聯絡人 | location\_region | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 聯絡人 | location\_city | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 聯絡人 | android\_app\_name | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 聯絡人 | android\_app\_version | String | NA | 
| 聯絡人 | android\_device | String | NA | 
| 聯絡人 | android\_os\_version | String | NA | 
| 聯絡人 | android\_sdk\_version | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 聯絡人 | android\_last\_seen\_at | Date | NA | 
| 聯絡人 | ios\_app\_name | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 聯絡人 | ios\_app\_version | String | NA | 
| 聯絡人 | ios\_device | String | NA | 
| 聯絡人 | ios\_os\_version | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 聯絡人 | ios\_sdk\_version | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 聯絡人 | ios\_last\_seen\_at | DateTime | NA | 
| 聯絡人 | custom\_attributes | Struct | NA | 
| 聯絡人 | 標籤 | Struct | NA | 
| 聯絡人 | notes | Struct | NA | 
| 聯絡人 | 公司 | Struct | NA | 
| 聯絡人 | unsubscribed\_from\_sms | Boolean | NA | 
| 聯絡人 | sms\_consent | Boolean | NA | 
| 聯絡人 | opted\_out\_subscription\_types | Struct | NA | 
| 聯絡人 | referrer | String | NA | 
| 聯絡人 | utm\_campaign | String | NA | 
| 聯絡人 | utm\_content | String | NA | 
| 聯絡人 | utm\_medium | String | NA | 
| 聯絡人 | utm\_source | String | NA | 
| 聯絡人 | utm\_term | String | NA | 
| 對話 | type | String | NA | 
| 對話 | id | Integer | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | created\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | updated\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | source | Struct | NA | 
| 對話 | source\_id | String | EQUAL\_TO, NOT\_EQUAL\_TO | 
| 對話 | source\_type | String | EQUAL\_TO, NOT\_EQUAL\_TO, | 
| 對話 | source\_delivered\_as | String | EQUAL\_TO, NOT\_EQUAL\_TO, | 
| 對話 | source\_subject | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 對話 | source\_body | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 對話 | source\_author\_id | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 對話 | source\_author\_type | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 對話 | source\_author\_name | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 對話 | source\_author\_email | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 對話 | source\_url | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 對話 | 聯絡人 | Struct | NA | 
| 對話 | 隊友 | Struct | NA | 
| 對話 | 標題 | String | NA | 
| 對話 | admin\_assignee\_id | Integer | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | team\_assignee\_id | Integer | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 對話 | custom\_attributes | Struct | NA | 
| 對話 | 開啟 | Boolean | EQUAL\_TO | 
| 對話 | state | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 對話 | 讀取 | Boolean | EQUAL\_TO | 
| 對話 | waiting\_since | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | snoozed\_until | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | 標籤 | Struct | NA | 
| 對話 | first\_contact\_reply | Struct | NA | 
| 對話 | priority | String | EQUAL\_TO, NOT\_EQUAL\_TO | 
| 對話 | topics | Struct | NA | 
| 對話 | sla\_applied | Struct | NA | 
| 對話 | conversation\_rating | Struct | NA | 
| 對話 | conversation\_rating\_requested\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | conversation\_rating\_replied\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | conversation\_rating\_score | Integer | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | conversation\_rating\_remark | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 對話 | conversation\_rating\_contact\_id | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 對話 | conversation\_rating\_admin\_id | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 對話 | 統計資訊 | Struct | NA | 
| 對話 | statistics\_time\_to\_assignment | Integer | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | statistics\_time\_to\_admin\_reply | Integer | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | statistics\_time\_to\_first\_close | Integer | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | statistics\_time\_to\_last\_close | Integer | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | statistics\_median\_time\_to\_reply | Integer | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | statistics\_first\_contact\_reply\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | statistics\_first\_assignment\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | statistics\_first\_admin\_reply\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | statistics\_first\_close\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | statistics\_last\_assignment\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | statistics\_last\_assignment\_admin\_reply\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | statistics\_last\_contact\_reply\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | statistics\_last\_admin\_reply\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | statistics\_last\_close\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | statistics\_last\_closed\_by\_id | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 對話 | statistics\_count\_reopens | Integer | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | statistics\_count\_assignments | Integer | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | statistics\_count\_conversation\_parts | Integer | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 對話 | conversation\_parts | 清單 | NA | 
| 資料屬性 | id | Integer | NA | 
| 資料屬性 | type | String | NA | 
| 資料屬性 | 模型 | String | NA | 
| 資料屬性 | name | String | NA | 
| 資料屬性 | full\_name | String | NA | 
| 資料屬性 | label | String | NA | 
| 資料屬性 | 描述 | String | NA | 
| 資料屬性 | data\_type | String | NA | 
| 資料屬性 | options | 清單 | NA | 
| 資料屬性 | api\_writable | Boolean | NA | 
| 資料屬性 | ui\_writable | Boolean | NA | 
| 資料屬性 | 自訂 | Boolean | NA | 
| 資料屬性 | archived | Boolean | NA | 
| 資料屬性 | created\_at | Boolean | NA | 
| 資料屬性 | updated\_at | DateTime | NA | 
| 資料屬性 | admin\_id | String | NA | 
| 客群 | type | String | NA | 
| 客群 | id | String | NA | 
| 客群 | name | String | NA | 
| 客群 | created\_at | DateTime | NA | 
| 客群 | updated\_at | DateTime | NA | 
| 客群 | person\_type | String | NA | 
| 客群 | count | Integer | NA | 
| Tags (標籤) | type | String | NA | 
| Tags (標籤) | id | String | NA | 
| Tags (標籤) | name | String | NA | 
| 團隊 | type | String | NA | 
| 團隊 | id | String | NA | 
| 團隊 | name | String | NA | 
| 團隊 | admin\_ids | 清單 | NA | 

 **分區查詢** 

 如果想要在 Spark 中使用並行，可以提供其他 Spark 選項 `PARTITION_FIELD`、`LOWER_BOUND`、`UPPER_BOUND`、`NUM_PARTITIONS`。使用這些參數，原始查詢會分區為可由 Spark 任務並行執行的子查詢的 `NUM_PARTITIONS` 數目。
+  `PARTITION_FIELD`：用來分區查詢的欄位名稱。
+  `LOWER_BOUND`：所選分區欄位的包含下限值。

   對於日期，我們接受 Spark SQL 查詢中使用的 Spark 日期格式。有效值的範例：`"2024-02-06"`。
+  `UPPER_BOUND`：所選分區欄位的唯一上限值。
+  `NUM_PARTITIONS`：分區數目。

 實體分區欄位支援詳細資訊如下表所示。


| 實體名稱 | 分區欄位 | 資料類型 | 
| --- | --- | --- | 
| 聯絡人 | created\_at, updated\_at,last\_seen\_at | DateTime | 
| 對話 | id | Integer | 
| 對話 | created\_at, updated\_at | DateTime | 

 **範例** 

```
Intercom_read = glueContext.create_dynamic_frame.from_options(
    connection_type="Intercom",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "conversation",
        "API_VERSION": "V2.5",
        "PARTITION_FIELD": "created_at"
        "LOWER_BOUND": "2022-07-13T07:55:27.065Z"
        "UPPER_BOUND": "2022-08-12T07:55:27.065Z"
        "NUM_PARTITIONS": "2"
    }
)
```