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

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

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


| エンティティ | API\$1Version | フィルタリング可能 | 制限をサポートする | Order By をサポートする | Select \$1 をサポートする | パーティション分割をサポートする | 
| --- | --- | --- | --- | --- | --- | --- | 
| 管理者 | 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\$1mode\$1enabled | ブール値 | NA | 
| 管理者 | away\$1mode\$1reassign | ブール値 | NA | 
| 管理者 | has\$1inbox\$1seat | ブール値 | NA | 
| 管理者 | teams\$1ids | リスト | NA | 
| 管理者 | job\$1title | 文字列 | NA | 
| Companies | type | 文字列 | NA | 
| Companies | id | 文字列 | NA | 
| Companies | app\$1id | 文字列 | NA | 
| Companies | created\$1at | DateTime | NA | 
| Companies | remote\$1created\$1at | DateTime | NA | 
| Companies | updated\$1at | DateTime | NA | 
| Companies | last\$1request\$1at | DateTime | NA | 
| Companies | 計画 | Struct | NA | 
| Companies | company\$1id | 文字列 | NA | 
| Companies | 名前 | 文字列 | NA | 
| Companies | custom\$1attributes | Struct | NA | 
| Companies | session\$1count | 整数 | NA | 
| Companies | monthly\$1spend | 整数 | NA | 
| Companies | user\$1count | 整数 | NA | 
| Companies | industry | 文字列 | NA | 
| Companies | size | 整数 | NA | 
| Companies | website | 文字列 | NA | 
| Companies | tags | Struct | NA | 
| Companies | segments | Struct | NA | 
| 問い合わせ | id | 文字列 | EQUAL\$1TO.NOT\$1EQUAL\$1TO | 
| 問い合わせ | type | 文字列 | NA | 
| 問い合わせ | workspace\$1id | 文字列 | NA | 
| 問い合わせ | external\$1id | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| 問い合わせ | ロール | 文字列 | EQUAL\$1TO.NOT\$1EQUAL\$1TO | 
| 問い合わせ | email | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| 問い合わせ | phone | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| 問い合わせ | 名前 | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| 問い合わせ | avatar | 文字列 | NA | 
| 問い合わせ | owner\$1id | 整数 | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| 問い合わせ | social\$1profiles | Struct | NA | 
| 問い合わせ | has\$1hard\$1bounced | ブール値 | EQUAL\$1TO | 
| 問い合わせ | marked\$1email\$1as\$1spam | ブール値 | EQUAL\$1TO | 
| 問い合わせ | unsubscribed\$1from\$1emails | ブール値 | EQUAL\$1TO | 
| 問い合わせ | created\$1at | DateTime | EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| 問い合わせ | updated\$1at | DateTime | EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| 問い合わせ | signed\$1up\$1at | DateTime | EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| 問い合わせ | last\$1seen\$1at | DateTime | EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| 問い合わせ | last\$1replied\$1at | DateTime | EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| 問い合わせ | last\$1contacted\$1at | DateTime | EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| 問い合わせ | last\$1email\$1opened\$1at | DateTime | EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| 問い合わせ | last\$1email\$1clicked\$1at | DateTime | EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| 問い合わせ | language\$1override | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| 問い合わせ | ブラウザ | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| 問い合わせ | browser\$1version | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| 問い合わせ | browser\$1language | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| 問い合わせ | os | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| 問い合わせ | location | Struct | NA | 
| 問い合わせ | location\$1country | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| 問い合わせ | location\$1region | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| 問い合わせ | location\$1city | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| 問い合わせ | Android\$1app\$1name | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| 問い合わせ | Android\$1app\$1version | 文字列 | NA | 
| 問い合わせ | android\$1device | 文字列 | NA | 
| 問い合わせ | android\$1os\$1version | 文字列 | NA | 
| 問い合わせ | android\$1sdk\$1version | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| 問い合わせ | android\$1last\$1seen\$1at | 日付 | NA | 
| 問い合わせ | ios\$1app\$1name | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| 問い合わせ | ios\$1app\$1version | 文字列 | NA | 
| 問い合わせ | ios\$1device | 文字列 | NA | 
| 問い合わせ | ios\$1os\$1version | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| 問い合わせ | ios\$1sdk\$1version | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| 問い合わせ | ios\$1last\$1seen\$1at | DateTime | NA | 
| 問い合わせ | custom\$1attributes | Struct | NA | 
| 問い合わせ | tags | Struct | NA | 
| 問い合わせ | 注意事項 | Struct | NA | 
| 問い合わせ | companies | Struct | NA | 
| 問い合わせ | unsubscribed\$1from\$1sms | ブール値 | NA | 
| 問い合わせ | sms\$1consent | ブール値 | NA | 
| 問い合わせ | opted\$1out\$1subscription\$1types | Struct | NA | 
| 問い合わせ | referrer | 文字列 | NA | 
| 問い合わせ | utm\$1campaign | 文字列 | NA | 
| 問い合わせ | utm\$1content | 文字列 | NA | 
| 問い合わせ | utm\$1medium | 文字列 | NA | 
| 問い合わせ | utm\$1source | 文字列 | NA | 
| 問い合わせ | utm\$1term | 文字列 | NA | 
| Conversations | type | 文字列 | NA | 
| Conversations | id | 整数 | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | created\$1at | DateTime | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | updated\$1at | DateTime | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | ソース | Struct | NA | 
| Conversations | source\$1id | 文字列 | EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| Conversations | source\$1type | 文字列 | EQUAL\$1TO、NOT\$1EQUAL\$1TO、 | 
| Conversations | source\$1delivered\$1as | 文字列 | EQUAL\$1TO、NOT\$1EQUAL\$1TO、 | 
| Conversations | source\$1subject | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| Conversations | source\$1body | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| Conversations | source\$1author\$1id | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| Conversations | source\$1author\$1type | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| Conversations | source\$1author\$1name | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| Conversations | source\$1author\$1email | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| Conversations | source\$1url | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| Conversations | contacts | Struct | NA | 
| Conversations | teammates | Struct | NA | 
| Conversations | title | 文字列 | NA | 
| Conversations | admin\$1assignee\$1id | 整数 | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | team\$1assignee\$1id | 整数 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| Conversations | custom\$1attributes | Struct | NA | 
| Conversations | open | ブール値 | EQUAL\$1TO | 
| Conversations | state | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| Conversations | read | ブール値 | EQUAL\$1TO | 
| Conversations | waiting\$1since | DateTime | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | snoozed\$1until | DateTime | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | tags | Struct | NA | 
| Conversations | first\$1contact\$1reply | Struct | NA | 
| Conversations | priority | 文字列 | EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| Conversations | トピック | Struct | NA | 
| Conversations | sla\$1applied | Struct | NA | 
| Conversations | conversation\$1rating | Struct | NA | 
| Conversations | conversation\$1rating\$1requested\$1at | DateTime | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | conversation\$1rating\$1replied\$1at | DateTime | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | conversation\$1rating\$1score | 整数 | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | conversation\$1rating\$1remark | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| Conversations | conversation\$1rating\$1contact\$1id | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| Conversations | conversation\$1rating\$1admin\$1id | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| Conversations | 統計 | Struct | NA | 
| Conversations | statistics\$1time\$1to\$1assignment | 整数 | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | statistics\$1time\$1to\$1admin\$1reply | 整数 | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | statistics\$1time\$1to\$1first\$1close | 整数 | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | statistics\$1time\$1to\$1last\$1close | 整数 | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | statistics\$1median\$1time\$1to\$1reply | 整数 | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | statistics\$1first\$1contact\$1reply\$1at | DateTime | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | statistics\$1first\$1assignment\$1at | DateTime | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | statistics\$1first\$1admin\$1reply\$1at | DateTime | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | statistics\$1first\$1close\$1at | DateTime | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | statistics\$1last\$1assignment\$1at | DateTime | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | statistics\$1last\$1assignment\$1admin\$1reply\$1at | DateTime | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | statistics\$1last\$1contact\$1reply\$1at | DateTime | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | statistics\$1last\$1admin\$1reply\$1at | DateTime | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | statistics\$1last\$1close\$1at | DateTime | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | statistics\$1last\$1closed\$1by\$1id | 文字列 | CONTAINS、EQUAL\$1TO、NOT\$1EQUAL\$1TO | 
| Conversations | statistics\$1count\$1reopens | 整数 | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | statistics\$1count\$1assignments | 整数 | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | statistics\$1count\$1conversation\$1parts | 整数 | EQUAL\$1TO、NOT\$1EQUAL\$1TO、GREATER\$1THAN、LESS\$1THAN | 
| Conversations | conversation\$1parts | リスト | NA | 
| Data Attributes | id | 整数 | NA | 
| Data Attributes | type | 文字列 | NA | 
| Data Attributes | モデル | 文字列 | NA | 
| Data Attributes | 名前 | 文字列 | NA | 
| Data Attributes | full\$1name | 文字列 | NA | 
| Data Attributes | ラベル | 文字列 | NA | 
| Data Attributes | description | 文字列 | NA | 
| Data Attributes | data\$1type | 文字列 | NA | 
| Data Attributes | options | リスト | NA | 
| Data Attributes | api\$1writable | ブール値 | NA | 
| Data Attributes | ui\$1writable | ブール値 | NA | 
| Data Attributes | カスタム | ブール値 | NA | 
| Data Attributes | archived | ブール値 | NA | 
| Data Attributes | created\$1at | ブール値 | NA | 
| Data Attributes | updated\$1at | DateTime | NA | 
| Data Attributes | admin\$1id | 文字列 | NA | 
| セグメント | type | 文字列 | NA | 
| セグメント | id | 文字列 | NA | 
| セグメント | 名前 | 文字列 | NA | 
| セグメント | created\$1at | DateTime | NA | 
| セグメント | updated\$1at | DateTime | NA | 
| セグメント | person\$1type | 文字列 | NA | 
| セグメント | count | 整数 | NA | 
| [タグ] | type | 文字列 | NA | 
| [タグ] | id | 文字列 | NA | 
| [タグ] | 名前 | 文字列 | NA | 
| チーム | type | 文字列 | NA | 
| チーム | id | 文字列 | NA | 
| チーム | 名前 | 文字列 | NA | 
| チーム | admin\$1ids | リスト | 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\$1at、update\$1at、last\$1seen\$1at | DateTime | 
| Conversations | id | 整数 | 
| Conversations | created\$1at、update\$1at | 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"
    }
)
```