# Intercom エンティティからの読み取り
<a name="intercom-reading-from-entities"></a>

 **前提条件** 
+  読み取り元の Intercom オブジェクト。使用可能なエンティティを確認するには、以下のサポートされているエンティティの表を参照してください。

 **サポートされているエンティティ** 


| エンティティ | API\_Version | フィルタリング可能 | 制限をサポートする | Order By をサポートする | Select \* をサポートする | パーティション分割をサポートする | 
| --- | --- | --- | --- | --- | --- | --- | 
| 管理者 | v2.5 | なし | なし | なし | あり | なし | 
| Companies | v2.5 | なし | あり | なし | あり | なし | 
| Conversations | v2.5 | はい | あり | あり | あり | あり | 
| Data Attributes | v2.5 | なし | なし | なし | あり | なし | 
| 問い合わせ | v2.5 | はい | あり | あり | あり | あり | 
| セグメント | v2.5 | なし | なし | なし | あり | なし | 
| [タグ] | 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 | 文字列 | NA | 
| 管理者 | id | 文字列 | NA | 
| 管理者 | avatar | Struct | NA | 
| 管理者 | 名前 | 文字列 | NA | 
| 管理者 | email | 文字列 | NA | 
| 管理者 | away\_mode\_enabled | ブール値 | NA | 
| 管理者 | away\_mode\_reassign | ブール値 | NA | 
| 管理者 | has\_inbox\_seat | ブール値 | NA | 
| 管理者 | teams\_ids | リスト | NA | 
| 管理者 | job\_title | 文字列 | NA | 
| Companies | type | 文字列 | NA | 
| Companies | id | 文字列 | NA | 
| Companies | app\_id | 文字列 | NA | 
| Companies | created\_at | DateTime | NA | 
| Companies | remote\_created\_at | DateTime | NA | 
| Companies | updated\_at | DateTime | NA | 
| Companies | last\_request\_at | DateTime | NA | 
| Companies | 計画 | Struct | NA | 
| Companies | company\_id | 文字列 | NA | 
| Companies | 名前 | 文字列 | NA | 
| Companies | custom\_attributes | Struct | NA | 
| Companies | session\_count | 整数 | NA | 
| Companies | monthly\_spend | 整数 | NA | 
| Companies | user\_count | 整数 | NA | 
| Companies | industry | 文字列 | NA | 
| Companies | size | 整数 | NA | 
| Companies | website | 文字列 | NA | 
| Companies | tags | Struct | NA | 
| Companies | segments | Struct | NA | 
| 問い合わせ | id | 文字列 | EQUAL\_TO.NOT\_EQUAL\_TO | 
| 問い合わせ | type | 文字列 | NA | 
| 問い合わせ | workspace\_id | 文字列 | NA | 
| 問い合わせ | external\_id | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| 問い合わせ | ロール | 文字列 | EQUAL\_TO.NOT\_EQUAL\_TO | 
| 問い合わせ | email | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| 問い合わせ | phone | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| 問い合わせ | 名前 | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| 問い合わせ | avatar | 文字列 | NA | 
| 問い合わせ | owner\_id | 整数 | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| 問い合わせ | social\_profiles | Struct | NA | 
| 問い合わせ | has\_hard\_bounced | ブール値 | EQUAL\_TO | 
| 問い合わせ | marked\_email\_as\_spam | ブール値 | EQUAL\_TO | 
| 問い合わせ | unsubscribed\_from\_emails | ブール値 | 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 | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| 問い合わせ | ブラウザ | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| 問い合わせ | browser\_version | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| 問い合わせ | browser\_language | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| 問い合わせ | os | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| 問い合わせ | location | Struct | NA | 
| 問い合わせ | location\_country | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| 問い合わせ | location\_region | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| 問い合わせ | location\_city | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| 問い合わせ | Android\_app\_name | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| 問い合わせ | Android\_app\_version | 文字列 | NA | 
| 問い合わせ | android\_device | 文字列 | NA | 
| 問い合わせ | android\_os\_version | 文字列 | NA | 
| 問い合わせ | android\_sdk\_version | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| 問い合わせ | android\_last\_seen\_at | 日付 | NA | 
| 問い合わせ | ios\_app\_name | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| 問い合わせ | ios\_app\_version | 文字列 | NA | 
| 問い合わせ | ios\_device | 文字列 | NA | 
| 問い合わせ | ios\_os\_version | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| 問い合わせ | ios\_sdk\_version | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| 問い合わせ | ios\_last\_seen\_at | DateTime | NA | 
| 問い合わせ | custom\_attributes | Struct | NA | 
| 問い合わせ | tags | Struct | NA | 
| 問い合わせ | 注意事項 | Struct | NA | 
| 問い合わせ | companies | Struct | NA | 
| 問い合わせ | unsubscribed\_from\_sms | ブール値 | NA | 
| 問い合わせ | sms\_consent | ブール値 | NA | 
| 問い合わせ | opted\_out\_subscription\_types | Struct | NA | 
| 問い合わせ | referrer | 文字列 | NA | 
| 問い合わせ | utm\_campaign | 文字列 | NA | 
| 問い合わせ | utm\_content | 文字列 | NA | 
| 問い合わせ | utm\_medium | 文字列 | NA | 
| 問い合わせ | utm\_source | 文字列 | NA | 
| 問い合わせ | utm\_term | 文字列 | NA | 
| Conversations | type | 文字列 | NA | 
| Conversations | id | 整数 | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | created\_at | DateTime | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | updated\_at | DateTime | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | ソース | Struct | NA | 
| Conversations | source\_id | 文字列 | EQUAL\_TO、NOT\_EQUAL\_TO | 
| Conversations | source\_type | 文字列 | EQUAL\_TO、NOT\_EQUAL\_TO、 | 
| Conversations | source\_delivered\_as | 文字列 | EQUAL\_TO、NOT\_EQUAL\_TO、 | 
| Conversations | source\_subject | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| Conversations | source\_body | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| Conversations | source\_author\_id | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| Conversations | source\_author\_type | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| Conversations | source\_author\_name | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| Conversations | source\_author\_email | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| Conversations | source\_url | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| Conversations | contacts | Struct | NA | 
| Conversations | teammates | Struct | NA | 
| Conversations | title | 文字列 | NA | 
| Conversations | admin\_assignee\_id | 整数 | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | team\_assignee\_id | 整数 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| Conversations | custom\_attributes | Struct | NA | 
| Conversations | open | ブール値 | EQUAL\_TO | 
| Conversations | state | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| Conversations | read | ブール値 | EQUAL\_TO | 
| Conversations | waiting\_since | DateTime | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | snoozed\_until | DateTime | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | tags | Struct | NA | 
| Conversations | first\_contact\_reply | Struct | NA | 
| Conversations | priority | 文字列 | EQUAL\_TO、NOT\_EQUAL\_TO | 
| Conversations | トピック | Struct | NA | 
| Conversations | sla\_applied | Struct | NA | 
| Conversations | conversation\_rating | Struct | NA | 
| Conversations | conversation\_rating\_requested\_at | DateTime | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | conversation\_rating\_replied\_at | DateTime | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | conversation\_rating\_score | 整数 | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | conversation\_rating\_remark | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| Conversations | conversation\_rating\_contact\_id | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| Conversations | conversation\_rating\_admin\_id | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| Conversations | 統計 | Struct | NA | 
| Conversations | statistics\_time\_to\_assignment | 整数 | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | statistics\_time\_to\_admin\_reply | 整数 | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | statistics\_time\_to\_first\_close | 整数 | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | statistics\_time\_to\_last\_close | 整数 | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | statistics\_median\_time\_to\_reply | 整数 | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | statistics\_first\_contact\_reply\_at | DateTime | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | statistics\_first\_assignment\_at | DateTime | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | statistics\_first\_admin\_reply\_at | DateTime | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | statistics\_first\_close\_at | DateTime | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | statistics\_last\_assignment\_at | DateTime | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | statistics\_last\_assignment\_admin\_reply\_at | DateTime | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | statistics\_last\_contact\_reply\_at | DateTime | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | statistics\_last\_admin\_reply\_at | DateTime | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | statistics\_last\_close\_at | DateTime | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | statistics\_last\_closed\_by\_id | 文字列 | CONTAINS、EQUAL\_TO、NOT\_EQUAL\_TO | 
| Conversations | statistics\_count\_reopens | 整数 | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | statistics\_count\_assignments | 整数 | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | statistics\_count\_conversation\_parts | 整数 | EQUAL\_TO、NOT\_EQUAL\_TO、GREATER\_THAN、LESS\_THAN | 
| Conversations | conversation\_parts | リスト | NA | 
| Data Attributes | id | 整数 | NA | 
| Data Attributes | type | 文字列 | NA | 
| Data Attributes | モデル | 文字列 | NA | 
| Data Attributes | 名前 | 文字列 | NA | 
| Data Attributes | full\_name | 文字列 | NA | 
| Data Attributes | ラベル | 文字列 | NA | 
| Data Attributes | description | 文字列 | NA | 
| Data Attributes | data\_type | 文字列 | NA | 
| Data Attributes | options | リスト | NA | 
| Data Attributes | api\_writable | ブール値 | NA | 
| Data Attributes | ui\_writable | ブール値 | NA | 
| Data Attributes | カスタム | ブール値 | NA | 
| Data Attributes | archived | ブール値 | NA | 
| Data Attributes | created\_at | ブール値 | NA | 
| Data Attributes | updated\_at | DateTime | NA | 
| Data Attributes | admin\_id | 文字列 | NA | 
| セグメント | type | 文字列 | NA | 
| セグメント | id | 文字列 | NA | 
| セグメント | 名前 | 文字列 | NA | 
| セグメント | created\_at | DateTime | NA | 
| セグメント | updated\_at | DateTime | NA | 
| セグメント | person\_type | 文字列 | NA | 
| セグメント | count | 整数 | NA | 
| [タグ] | type | 文字列 | NA | 
| [タグ] | id | 文字列 | NA | 
| [タグ] | 名前 | 文字列 | NA | 
| チーム | type | 文字列 | NA | 
| チーム | id | 文字列 | NA | 
| チーム | 名前 | 文字列 | 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`: パーティション数。

 エンティティごとのパーティション分割フィールドのサポートの詳細は、次の表にまとめられています。


| エンティティ名 | Partitioning Field | データタイプ | 
| --- | --- | --- | 
| 問い合わせ | created\_at、update\_at、last\_seen\_at | DateTime | 
| Conversations | id | 整数 | 
| Conversations | created\_at、update\_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"
    }
)
```