# Gravação em entidades do Salesforce Marketing Cloud
<a name="salesforce-marketing-cloud-writing-to-entities"></a>

**Pré-requisitos**
+ Um objeto do Salesforce Marketing no qual você deseja gravar. Você precisará especificar o nome do objeto, como `List` ou `Campaigns`, ou qualquer outra entidade descrita na tabela abaixo.
+ O conector do Salesforce Marketing Cloud é compatível com três operações de gravação:
  + INSERT
  + UPSERT
  + UPDATE

  Ao usar as operações de gravação `UPDATE` e `UPSERT`, você deverá fornecer opção `ID_FIELD_NAMES` para especificar o campo de ID externo para os registros. 

**Entidades compatíveis para destino**:


| Entidade | Prioridade | Interface (REST, SOAP etc.) | Pode ser inserido | Pode ser atualizado | Pode ser upserted | 
| --- | --- | --- | --- | --- | --- | 
| Campanhas | P0 | REST | S- Único | S- Único | N | 
| Ativos de conteúdo | P0 | REST | S- Único, em massa | S- Único | N | 
| Contato | P1 | REST | S- Único | S- Único | N | 
| Verificação de domínio | P1 | REST | S- Único | S- Único, em massa | N | 
| Retorno de chamada de notificação de eventos | P1 | REST | S- Único | S- Único | N | 
| Assinatura de notificação de eventos | P1 | REST | S- Único | S- Único | N | 
| Sistema de mensagens | P1 | REST | S- Único | N | N | 
| Tags de objetos aninhados | P2 | REST | S- Único | S- Único | N | 
| Seed-List | P1 | REST | S- Único | S- Único | N | 
| Configuração | P1 | REST | S- Único | S- Único | N | 
| Extensão de dados | P0 | SOAP | S- Único | S- Único | S- Único | 
| E-mail | P0 | SOAP | S- Único | S- Único | N | 
| Lista | P0 | SOAP | S- Único | S- Único | N | 
| Enviar | P0 | SOAP | S- Único | N | N | 
| Assinante | P0 | SOAP | S- Único | S- Único | N | 

**Exemplo de operação INSERT para 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"
    }
)
```

**Exemplo de operação INSERT para 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"
    }
)
```

**Exemplo de operação UPDATE para 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"
    }
)
```

**Exemplo de operação UPDATE para 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"
    }
)
```

**Exemplo de operação UPSERT para 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"
    }
)
```