# Adobe Marketo Engage エンティティへの書き込み
<a name="adobe-marketo-engage-writing-to-entities"></a>

**前提条件**
+ 書き込み先の Adobe Marketo オブジェクト。`leads` または `customobjects` などのオブジェクト名が必要です。
+ Adobe Marketo コネクタは、次の 3 つの書き込みオペレーションをサポートしています。
  + INSERT
  + UPSERT
  + UPDATE
+ `UPSERT` および `UPDATE` 書き込みオペレーションでは、レコードの ID フィールドを指定する `ID_FIELD_NAMES` オプションを指定する必要があります。`leads` エンティティを使用する場合は、`email` を `ID_FIELD_NAMES` として `UPSERT` オペレーションに、`id` を `UPDATE` オペレーションに使用します。`customobjects` エンティティの場合は、`UPDATE` オペレーションと `UPSERT` オペレーションの両方に `marketoGUID` を `ID_FIELD_NAMES` として使用します。

**Destination (Synchronous) でサポートされているエンティティ**


| エンティティ名 | Destination Connector としてサポートされます | 挿入可能 | 更新可能 | アップサート可能 | 
| --- | --- | --- | --- | --- | 
| leads | はい | はい (バルク) | はい (バルク) | はい (バルク) | 
| customobjects | はい | はい (バルク) | はい (バルク) | はい (バルク) | 

**例**:

**INSERT オペレーション:**

```
marketo_write = glueContext.write_dynamic_frame.from_options(
    frame=frameToWrite,
    connection_type="marketo",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "leads",
        "API_VERSION": "v1",
        "WRITE_OPERATION": "INSERT"
    }
```

**Update オペレーション:**

```
marketo_write = glueContext.write_dynamic_frame.from_options(
    frame=frameToWrite,
    connection_type="marketo",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "leads",
        "API_VERSION": "v1",
        "WRITE_OPERATION": "UPDATE",
        "ID_FIELD_NAMES": "id"
    }
```

**注記**  
`leads` および `customobjects` エンティティの場合、Adobe Marketo はメタデータを動的に取得するエンドポイントを提供するため、書き込み可能なフィールドは Marketo API レスポンスから識別されます。