# Escritura en entidades de Salesforce Marketing Cloud
<a name="salesforce-marketing-cloud-writing-to-entities"></a>

**Requisitos previos**
+ Un objeto de Salesforce Marketing en el que desea escribir. Deberá especificar el nombre del objeto, por ejemplo, `List` o `Campaigns` o cualquiera de las demás entidades que se indican en la siguiente tabla.
+ El conector de Salesforce Marketing Cloud admite tres operaciones de escritura:
  + INSERT
  + UPSERT
  + UPDATE

  Al utilizar las operaciones de escritura `UPDATE` y `UPSERT`, debe proporcionar la opción `ID_FIELD_NAMES` para especificar el campo de ID externo de los registros. 

**Entidades compatibles para el destino**:


| Entidad | Priority (Prioridad) | Interfaz (REST, SOAP, etc.) | Se puede insertar | Se puede actualizar | Se puede actualizar o insertar | 
| --- | --- | --- | --- | --- | --- | 
| Campañas | P0 | REST | Sí | Sí: individual | N | 
| Activos de contenido | P0 | REST | Sí: individual, masivo | Sí: individual | N | 
| Contacto | P1 | REST | Sí | Sí: individual | N | 
| Verificación de dominio | P1 | REST | Sí: individual | Sí: individual, masivo | N | 
| Devolución de llamadas para notificaciones de eventos | P1 | REST | Sí | Sí: individual | N | 
| Suscripción a notificaciones de eventos | P1 | REST | Sí | Sí: individual | N | 
| Mensajería | P1 | REST | Sí | N | N | 
| Etiqueta anidada de objeto | P2 | REST | Sí | Sí: individual | N | 
| Lista de semillas | P1 | REST | Sí | Sí: individual | N | 
| Configuración | P1 | REST | Sí | Sí: individual | N | 
| Extensión de datos | P0 | SOAP | Sí: individual | Sí: individual | Sí: individual | 
| Correo electrónico | P0 | SOAP | Sí: individual | Sí: individual | N | 
| Enumeración | P0 | SOAP | Sí: individual | Sí: individual | N | 
| Send | P0 | SOAP | Sí: individual | N | N | 
| Suscriptor | P0 | SOAP | Sí: individual | Sí: individual | N | 

**Ejemplo de operación 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"
    }
)
```

**Ejemplo de operación 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"
    }
)
```

**Ejemplo de operación 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"
    }
)
```

**Ejemplo de operación 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"
    }
)
```

**Ejemplo de operación 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"
    }
)
```