# 写入 HubSpot 实体
<a name="hubspot-writing-to-entities"></a>

## 先决条件
<a name="hubspot-writing-prerequisites"></a>
+ 您要写入的 HubSpot 对象。您将需要联系人或工单等对象名称。
+ HubSpot 连接器支持以下写入操作：
  + INSERT
  + UPDATE
+ 使用 `UPDATE` 写入操作时，必须提供 `ID_FIELD_NAMES` 选项以指定记录的 ID 字段。

## Sync 目标支持的实体
<a name="hubspot-supported-entities"></a>


| 实体 | API 版本 | 是否支持作为目的地连接器 | 是否可以插入 | 是否可以更新 | 
| --- | --- | --- | --- | --- | 
| 公司 | v3 | 是 | 是（单条、批量） | 是（单条、批量） | 
| 联系人 | v3 | 是 | 是（单条、批量） | 是（单条、批量） | 
| 交易 | v3 | 是 | 是（单条、批量） | 是（单条、批量） | 
| 产品 | v3 | 是 | 是（单条、批量） | 是（单条、批量） | 
| Calls | 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"
    }
)
```