# Salesforce Marketing Cloud エンティティへの書き込み
<a name="salesforce-marketing-cloud-writing-to-entities"></a>

**前提条件**
+ 書き込み先の Salesforce Marketing オブジェクト。`List` または `Campaigns` などのオブジェクト名、または以下の表に概説されている他のエンティティのいずれかを指定する必要があります。
+ Salesforce Marketing Cloud コネクタは、次の 3 つの書き込みオペレーションをサポートしています。
  + INSERT
  + UPSERT
  + UPDATE

  `UPDATE` および `UPSERT` 書き込みオペレーションを使用する場合は、`ID_FIELD_NAMES` オプションを指定してレコードの外部 ID フィールドを指定する必要があります。

**送信先でサポートされているエンティティ**:


| エンティティ | 優先度 | インターフェイス (REST、SOAP など) | 挿入可能 | 更新可能 | アップサート可能 | 
| --- | --- | --- | --- | --- | --- | 
| キャンペーン | P0 | REST | Y- シングル | Y- シングル | N | 
| Content Assets | P0 | REST | Y- シングル、バルク | Y- シングル | N | 
| 連絡先 | P1 | REST | Y- シングル | Y- シングル | N | 
| ドメインの検証 | P1 | REST | Y- シングル | Y- シングル、バルク | N | 
| Event Notification Callback | P1 | REST | Y- シングル | Y- シングル | N | 
| Event Notification Subscription | P1 | REST | Y- シングル | Y- シングル | N | 
| メッセージング | P1 | REST | Y- シングル | N | N | 
| Object Nested Tag | P2 | REST | Y- シングル | Y- シングル | N | 
| Seed-List | P1 | REST | Y- シングル | Y- シングル | N | 
| セットアップ | P1 | REST | Y- シングル | Y- シングル | N | 
| Data Extension | P0 | SOAP | Y- シングル | Y- シングル | Y- シングル | 
| E メール | P0 | SOAP | Y- シングル | Y- シングル | N | 
| リスト | P0 | SOAP | Y- シングル | Y- シングル | N | 
| 送信 | P0 | SOAP | Y- シングル | N | N | 
| サブスクライバー | P0 | SOAP | Y- シングル | Y- シングル | N | 

**REST の INSERT オペレーションの例**:

```
salesforcemarketingcloud_write = glueContext.write_dynamic_frame.from_options(
    connection_type="salesforcemarketingcloud",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "Campaigns",
        "API_VERSION": "v1",
        "writeOperation" : "INSERT",
        "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com"
    }
)
```

**SOAP の INSERT オペレーションの例**:

```
salesforcemarketingcloud_write = glueContext.write_dynamic_frame.from_options(
    connection_type="salesforcemarketingcloud",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "List",
        "API_VERSION": "v1",
        "writeOperation" : "INSERT",
        "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com"
    }
)
```

**REST の UPDATE オペレーションの例**:

```
salesforcemarketingcloud_write = glueContext.write_dynamic_frame.from_options(
    connection_type="salesforcemarketingcloud",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "Campaigns",
        "API_VERSION": "v1",
        "writeOperation" : "UPDATE",
         "ID_FIELD_NAMES": "id",
        "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com"
    }
)
```

**SOAP の UPDATE オペレーションの例**:

```
salesforcemarketingcloud_write = glueContext.write_dynamic_frame.from_options(
    connection_type="salesforcemarketingcloud",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "List",
        "API_VERSION": "v1",
        "writeOperation" : "UPDATE",
         "ID_FIELD_NAMES": "id",
        "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com"
    }
)
```

**SOAP の UPSERT オペレーションの例**:

```
salesforcemarketingcloud_write = glueContext.write_dynamic_frame.from_options(
    connection_type="salesforcemarketingcloud",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "DataExtension/Insert-***E/6*******3",
        "API_VERSION": "v1",
        "writeOperation" : "UPSERT",
        "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com"
    }
)
```