從 SendGrid 實體中讀取
必要條件
您要從中讀取的 SendGrid 物件。您將需要物件名稱,例如 lists、singlesends 或 segments。
來源的支援實體:
| 實體 | 可以篩選 | 支援限制 | 支援排序依據 | 支援選取 * | 支援分區 |
|---|---|---|---|---|---|
| 清單 | 否 | 是 | 否 | 是 | 否 |
| 單次傳送 | 是 | 是 | 否 | 是 | 否 |
| 行銷活動統計資料 - 自動化 | 是 | 是 | 否 | 是 | 否 |
| 行銷活動統計資料 - 單次傳送 | 是 | 是 | 否 | 是 | 否 |
| 客群 | 是 | 否 | 否 | 是 | 否 |
| 聯絡人 | 是 | 否 | 否 | 是 | 否 |
| 類別 | 否 | 否 | 否 | 是 | 否 |
| 統計資料 | 是 | 否 | 否 | 是 | 否 |
| 取消訂閱群組 | 是 | 否 | 否 | 是 | 否 |
範例:
sendgrid_read = glueContext.create_dynamic_frame.from_options( connection_type="sendgrid", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "lists", "API_VERSION": "v3", "INSTANCE_URL": "instanceUrl" }
SendGrid 實體和欄位詳細資訊:
具有靜態中繼資料的實體:
| 實體 | 欄位 | 資料類型 | 支援的運算子 |
|---|---|---|---|
| 清單 | id | String | N/A |
| name | String | N/A | |
| contact_count | Integer | N/A | |
| _metadata | Struct | N/A | |
| 單次傳送 | id | String | N/A |
| name | String | EQUAL_TO | |
| abtest | Struct | N/A | |
| status | String | EQUAL_TO | |
| categories | 清單 | EQUAL_TO | |
| send_at | String | N/A | |
| is_abtest | Boolean | N/A | |
| updated_at | String | N/A | |
| created_at | String | N/A | |
| 頻道 | 清單 | N/A | |
| 行銷活動統計資料 - 自動化 | id | String | N/A |
| aggregation | String | N/A | |
| step_id | String | N/A | |
| 統計資料 | Struct | N/A | |
| automation_ids | 清單 | EQUAL_TO | |
| 行銷活動統計資料 - 單次傳送 | id | String | N/A |
| ab_variation | String | N/A | |
| ab_phase | String | N/A | |
| aggregation | String | N/A | |
| 統計資料 | Struct | N/A | |
| singlesend_ids | 清單 | EQUAL_TO | |
| 客群 | id | String | N/A |
| name | String | N/A | |
| query_version | String | N/A | |
| contact_count | Integer | N/A | |
| sample_updated_at | String | N/A | |
| next_sample_update | String | N/A | |
| created_at | String | N/A | |
| updated_at | String | N/A | |
| parent_list_id | String | N/A | |
| status | Struct | N/A | |
| parent_list_ids | String | EQUAL_TO | |
| no_parent_list_id | Boolean | EQUAL_TO | |
| 聯絡人 | id | String | N/A |
| first_name | String | N/A | |
| last_name | String | N/A | |
| unique_name | String | N/A | |
| String | N/A | ||
| alternate_emails | 清單 | N/A | |
| address_line_1 | String | N/A | |
| address_line_2 | String | N/A | |
| 城市 | String | N/A | |
| state_province_region | String | N/A | |
| 國家/地區 | String | N/A | |
| postal_code | String | N/A | |
| phone_number | String | N/A | |
| String | N/A | ||
| line | String | N/A | |
| String | N/A | ||
| list_ids | 清單 | N/A | |
| custom_fields | Struct | N/A | |
| created_at | String | N/A | |
| updated_at | String | N/A | |
| _metadata | Struct | N/A | |
| event_timestamp | DateTime | BETWEEN | |
| 類別 | categories | 清單 | N/A |
| 統計資料 | date | String | N/A |
| 統計資料 | 清單 | N/A | |
| start_date | DateTime | EQUAL_TO, BETWEEN | |
| aggregated_by | String | EQUAL_TO | |
| 取消訂閱群組 | id | Integer | EQUAL_TO |
| name | String | N/A | |
| 描述 | String | N/A | |
| last_email_sent_at | Integer | N/A | |
| is_default | Boolean | N/A | |
| unsubscribes | Integer | N/A |
注意
在連接器的回應中,Struct 和 List 資料類型會轉換為 String 資料類型,DateTime 資料類型會轉換為 Timestamp。
分區查詢
SendGrid 不支援篩選條件型分區或記錄型分區。