

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menulis ke entitas Cloud Pemasaran Salesforce
<a name="salesforce-marketing-cloud-writing-to-entities"></a>

**Prasyarat**
+ Objek Pemasaran Salesforce yang ingin Anda tulis. Anda perlu menentukan nama objek seperti `List` atau `Campaigns` atau entitas lain yang diuraikan dalam tabel di bawah ini.
+ Konektor Salesforce Marketing Cloud mendukung tiga operasi penulisan:
  + INSERT
  + MENEGAKKAN
  + UPDATE

  Saat menggunakan operasi `UPDATE` dan `UPSERT` tulis, Anda harus memberikan `ID_FIELD_NAMES` opsi untuk menentukan bidang ID eksternal untuk catatan. 

**Entitas yang didukung untuk tujuan**:


| Entitas | Prioritas | Antarmuka (REST, SOAP, dll) | Dapat Dimasukkan | Dapat Diperbarui | Dapat Ditambah | 
| --- | --- | --- | --- | --- | --- | 
| Kampanye | P0 | REST | Y- Tunggal | Y- Tunggal | T | 
| Aset Konten | P0 | REST | Y- Tunggal, Massal | Y- Tunggal | T | 
| Kontak | P1 | REST | Y- Tunggal | Y- Tunggal | T | 
| Verifikasi Domain | P1 | REST | Y- Tunggal | Y- Tunggal, Massal | T | 
| Callback Pemberitahuan Acara | P1 | REST | Y- Tunggal | Y- Tunggal | T | 
| Langganan Pemberitahuan Acara | P1 | REST | Y- Tunggal | Y- Tunggal | T | 
| Perpesanan | P1 | REST | Y- Tunggal | T | T | 
| Tag Bersarang Objek | P2 | REST | Y- Tunggal | Y- Tunggal | T | 
| Daftar Benih | P1 | REST | Y- Tunggal | Y- Tunggal | T | 
| Pengaturan | P1 | REST | Y- Tunggal | Y- Tunggal | T | 
| Ekstensi Data | P0 | SOAP | Y- Tunggal | Y- Tunggal | Y- Tunggal | 
| Email | P0 | SOAP | Y- Tunggal | Y- Tunggal | T | 
| Daftar | P0 | SOAP | Y- Tunggal | Y- Tunggal | T | 
| Kirim | P0 | SOAP | Y- Tunggal | T | T | 
| Pelanggan | P0 | SOAP | Y- Tunggal | Y- Tunggal | T | 

**Contoh untuk operasi INSERT untuk REST**:

```
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"
    }
)
```

**Contoh untuk operasi INSERT untuk SOAP**:

```
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"
    }
)
```

**Contoh untuk operasi UPDATE untuk REST**:

```
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"
    }
)
```

**Contoh untuk operasi UPDATE untuk SOAP**:

```
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"
    }
)
```

**Contoh untuk operasi UPSERT untuk SOAP**:

```
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"
    }
)
```