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

# 寫入到 HubSpot 實體
<a name="hubspot-writing-to-entities"></a>

## 先決條件
<a name="hubspot-writing-prerequisites"></a>
+ 您要寫入到的 HubSpot 物件。將需要物件名稱，例如聯絡人或票證。
+ HubSpot 連接器支援下列寫入操作：
  + INSERT
  + UPDATE
+ 使用 `UPDATE` 寫入操作時，必須提供 `ID_FIELD_NAMES` 選項來指定記錄的 ID 欄位。

## 同步目的地的支援實體
<a name="hubspot-supported-entities"></a>


| 實體 | API 版本 | 將支援為目的地連接器 | 可以插入 | 可以更新 | 
| --- | --- | --- | --- | --- | 
| 公司 | v3 | 是 | 是 (單一、大量) | 是 (單一、大量) | 
| 聯絡人 | v3 | 是 | 是 (單一、大量) | 是 (單一、大量) | 
| 交易 | v3 | 是 | 是 (單一、大量) | 是 (單一、大量) | 
| 產品 | v3 | 是 | 是 (單一、大量) | 是 (單一、大量) | 
| 呼叫 | v3 | 是 | 是 (單一、大量) | 是 (單一、大量) | 
| 會議 | v3 | 是 | 是 (單一、大量) | 是 (單一、大量) | 
| 備註 | v3 | 是 | 是 (單一、大量) | 是 (單一、大量) | 
| 電子郵件 | v3 | 是 | 是 (單一、大量) | 是 (單一、大量) | 
| 任務​ | v3 | 是 | 是 (單一、大量) | 是 (單一、大量) | 
| 郵政郵件 | v3 | 是 | 是 (單一、大量) | 是 (單一、大量) | 
| 自訂物件 | v3 | 是 | 是 (單一、大量) | 是 (單一、大量) | 
| 票證 | v3 | 是 | 是 (單一、大量) | 是 (單一、大量) | 
| 關聯 | v4 | 是 | 是 (單一、大量) | 否 | 
| 關聯標籤 | v4 | 是 | 是 (單一、大量) | 是 (單一、大量) | 

**範例**：

**INSERT 操作**

```
hubspot_write = glueContext.write_dynamic_frame.from_options(
    frame=frameToWrite,
    connection_type="hubspot",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "contact",
        "API_VERSION": "v3",
        "WRITE_OPERATION": "INSERT"
    }
)
```

**UPDATE 操作**

```
hubspot_write = glueContext.write_dynamic_frame.from_options(
    frame=frameToWrite,
    connection_type="hubspot",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "deal",
        "API_VERSION": "v3",
        "WRITE_OPERATION": "UPDATE",
        "ID_FIELD_NAMES": "hs_object_id"
    }
)
```