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

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

**必要條件**

您要從中讀取的 SendGrid 物件。您將需要物件名稱，例如 `lists`、`singlesends` 或 `segments`。

**來源的支援實體**：


| 實體 | 可以篩選 | 支援限制 | 支援排序依據 | 支援選取 \* | 支援分區 | 
| --- | --- | --- | --- | --- | --- | 
| 清單 | 否 | 是 | 否 | 是 | 否 | 
| 單次傳送 | 是 | 是 | 否 | 是 | 否 | 
| 行銷活動統計資料 - 自動化 | 是 | 是 | 否 | 是 | 否 | 
| 行銷活動統計資料 - 單次傳送 | 是 | 是 | 否 | 是 | 否 | 
| 客群 | 是 | 否 | 否 | 是 | 否 | 
| 聯絡人 | 是 | 否 | 否 | 是 | 否 | 
| Category | 否 | 否 | 否 | 是 | 否 | 
| 統計資料 | 是 | 否 | 否 | 是 | 否 | 
| 取消訂閱群組 | 是 | 否 | 否 | 是 | 否 | 

**範例**：

```
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
  - **欄位:** email / **資料類型:** 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
  - **欄位:** whatsapp / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** line / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** facebook / **資料類型:** 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

- **Category**
  - **欄位:** 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。

## 分區查詢
<a name="sendgrid-reading-partitioning-queries"></a>

SendGrid 不支援篩選條件型分區或記錄型分區。