# 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 필드를 지정하려면 `ID_FIELD_NAMES` 옵션을 제공해야 합니다.

**대상에 지원되는 엔터티**:


| 개체 | 우선순위 | 인터페이스(REST, SOAP 등) | 삽입 가능 | 업데이트 가능 | 업서트 가능 | 
| --- | --- | --- | --- | --- | --- | 
| Campaigns | P0 | REST | Y- 단일 | Y- 단일 | N | 
| 콘텐츠 자산 | P0 | REST | Y- 단일, 대량 | Y- 단일 | N | 
| Contact | P1 | REST | Y- 단일 | Y- 단일 | N | 
| 도메인 확인 | P1 | REST | Y- 단일 | Y- 단일, 대량 | N | 
| 이벤트 알림 콜백 | P1 | REST | Y- 단일 | Y- 단일 | N | 
| 이벤트 알림 구독 | P1 | REST | Y- 단일 | Y- 단일 | N | 
| 메시지 전송 | P1 | REST | Y- 단일 | N | N | 
| 객체 중첩된 태그 | P2 | REST | Y- 단일 | Y- 단일 | N | 
| 시드-목록 | P1 | REST | Y- 단일 | Y- 단일 | N | 
| 설정 | P1 | REST | Y- 단일 | Y- 단일 | N | 
| 데이터 확장 | P0 | SOAP | Y- 단일 | Y- 단일 | Y- 단일 | 
| 이메일 | P0 | SOAP | Y- 단일 | Y- 단일 | N | 
| 나열 | P0 | SOAP | Y- 단일 | Y- 단일 | N | 
| Send | 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"
    }
)
```