Salesforce Marketing Cloud

Ejemplo: listar todos los recursos

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Assets en la lista Entity.
3. Selecciona la operación List y, a continuación, haz clic en Hecho.
4. Entrada de tarea de la tarea Conectores, puede definir el filterClause según los requisitos del cliente.

Debes usar comillas simples (") para incluir el valor de una cláusula de filtro y debe transmitirse directamente, como CategoryName='Content Builder'. En este caso, CategoryName es el nombre de la columna y Content Builder es el valor.

Puede usar la cláusula de filtro para filtrar registros en función de las columnas. Por ejemplo, para filtrar registros, usa la siguiente cláusula de filtro: Location='US' y region='us-east1'.

En algunos casos, si se proporciona un ID de entidad, se puede producir un error. En estos casos, puede usar la cláusula de filtro, como id=172.

Ejemplo: obtener un registro de recursos

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Assets en la lista Entity.
3. Selecciona la operación Get y, a continuación, haz clic en Hecho.
4. Asigna el ID de entidad a 49851.0, que es la clave que se va a transferir. Para definir el ID de entidad, en la sección Entrada de tarea de la tarea Conectores, haz clic en EntityId y, a continuación, introduce 49851.0 en el campo Valor predeterminado.

   El valor de Entity ID debe transferirse directamente, como Id= 49851.0. En este caso, 49851.0 es el valor de clave principal único que se debe transferir.

Ejemplo: eliminar un registro de recursos

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Assets en la lista Entity.
3. Selecciona la operación Delete y, a continuación, haz clic en Hecho.
4. Asigna el ID de entidad a 49851.0, que es la clave que se va a transferir. Para definir el ID de entidad, en la sección Entrada de tarea de la tarea Conectores, haz clic en EntityId y, a continuación, introduce 49851.0 en el campo Valor predeterminado.

   El valor del ID de entidad debe enviarse directamente, como ID= 49851.0. En este caso, 49851.0 es el valor de clave principal único que se debe transferir.

Ejemplo: crear un registro DataExtensionObject_Custom

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona DataExtensionObject_Custom en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "StudentName":"Cruz",
   "StudentID":"1",
   "Rank":"1"}
   

   Si la integración se realiza correctamente, el parámetro connectorOutputPayload de la respuesta de la tarea del conector tendrá un valor similar al siguiente:

   {
     "StudentID": 1
   } 

Ejemplo: crear un registro de recursos

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Assets en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "Name": "Googlecloud_Created_HTMLEmail_Testing_V1",
     "TypeName": "htmlemail",
     "TypeId": 208.0
   }

   Si la integración se realiza correctamente, el parámetro connectorOutputPayload de la respuesta de la tarea del conector tendrá un valor similar al siguiente:

   {
     "Id": 60188.0
   }

Ejemplo: Crear un registro de campañas

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Campaigns en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "Name": "Campaigns - Tested via Googlecloud",
     "CampaignCode": "annual2023",
     "Color": "0000ff",
     "Favorite": false
   }

   Si la integración se realiza correctamente, el parámetro connectorOutputPayload de la respuesta de la tarea del conector tendrá un valor similar al siguiente:

   {
     "Id": 247.0
   } 

Ejemplo: crear un registro de recorridos

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Journeys en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "Version": 1.0,
     "Name": "API_Journey_Googlecloud_Retest_1",
     "CreatedDate": "2023-04-26 04:20:29.87",
     "ModifiedDate": "2023-05-10 07:45:06.04",
     "LastPublishedDate": "2023-04-26 04:37:18.0",
     "Description": "API_Journey_Googlecloud_Retest_1",
     "WorkFlowApiVersion": 1.0,
     "Tags": null,
     "Goals": "",
     "Triggers": "[{\"id\": \"c79154a3-a0d2-435e-a6ad-bed46474620a\", \"key\": \"TRIGGER\", \"name\": \"API_Journey_Googlecloud\", \"description\": \"\", \"type\": \"APIEvent\", \"outcomes\": [], \"arguments\": {\"startActivityKey\": \"{Context.StartActivityKey}\", \"dequeueReason\": \"{Context.DequeueReason}\", \"lastExecutedActivityKey\": \"{Context.LastExecutedActivityKey}\", \"filterResult\": \"true\"}, \"configurationArguments\": {\"schemaVersionId\": 0, \"criteria\": \"\", \"filterDefinitionId\": \"00000000-0000-0000-0000-000000000000\"}, \"metaData\": {\"sourceInteractionId\": \"00000000-0000-0000-0000-000000000000\", \"eventDefinitionId\": \"8153cf00-ebf6-4c18-b52f-573eb724df87\", \"eventDefinitionKey\": \"APIEvent-4d84e619-a629-6b17-945f-9a6e78a1982c\", \"chainType\": \"None\", \"configurationRequired\": false, \"iconUrl\": \"/images/icon_journeyBuilder-event-api-blue.svg\", \"title\": \"\", \"entrySourceGroupConfigUrl\": \"jb:///data/entry/api-event/entrysourcegroupconfig.json\"}}",
     "Defaults": "[{\"email\": [\"{Event.APIEvent-4d84e619-a629-6b17-945f-9a6e78a1982c.\"Email"}\"], \"properties\": {\"analyticsTracking\": {\"enabled\": false, \"analyticsType\": \"google\", \"urlDomainsToTrack\": []}}}]"
   }

   Si la integración se realiza correctamente, el parámetro connectorOutputPayload de la respuesta de la tarea del conector tendrá un valor similar al siguiente:

   {
     "Id": "aa03afe4-6a28-481f-bec4-564712127414"
   }

Ejemplo: crear un registro de lista

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona List en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "ID": "04052023.0",
     "ObjectID": "82349658-b482-404f-8c67-e555aadee0f4",
     "PartnerKey": "null",
     "CreatedDate": "2023-03-16 10:52:48.097",
     "ModifiedDate": "2023-03-17 10:30:34.497",
     "Client_ID": "5.14012689E8",
     "Client_PartnerClientKey": null,
     "ListName": "Googlecloud_Created_Subscriber_List",
     "Description": "null",
     "Category": "15449.0",
     "Type": "Public",
     "CustomerKey": "Googlecloud_BCONE",
     "ListClassification": "ExactTargetList",
     "AutomatedEmail_ID": "null"
   }

   Si la integración se realiza correctamente, el parámetro connectorOutputPayload de la respuesta de la tarea del conector tendrá un valor similar al siguiente:

   {
     "Id": 4052023.0
   }

Ejemplo: crear un registro de suscriptor

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Subscriber en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "EmailAddress": "baklavainthebalkans@gmail.com",
     "SubscriberKey": "KB1"
   }

   Si la integración se realiza correctamente, el parámetro connectorOutputPayload de la respuesta de la tarea del conector tendrá un valor similar al siguiente:

   {
     "Success": true
   }

Ejemplo: actualizar un registro DataExtensionObject_Custom

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona DataExtensionObject_Custom en la lista Entity.
3. Selecciona la operación Update y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "StudentName":"Charlie",
   "Rank":"1"
   }
   

5. Define el ID de entidad. Por ejemplo, 103032, que es la clave principal que se va a transferir. Para definir el ID de entidad, en la sección Entrada de tarea de la tarea Conectores, haga clic en entityId y, a continuación, introduzca 10 en el campo Valor predeterminado.

   Si la entidad tiene claves empresariales o primarias compuestas, en lugar de especificar entityId, también puede definir filterClause como Rank='1' and StudentID='10'.

Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

{
    "StudentID": 1
}

Ejemplo: actualizar un registro de recursos

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Recursos en la lista Entity.
3. Selecciona la operación Update y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "Description": "June2023-Updated"
   }
   

5. Asigna el ID de entidad a la entidad de los recursos . Para definir el ID de entidad, haz clic en entityId y, a continuación, introduce 52080 en el campo Valor predeterminado.

   Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   {
     "Id": 52080.0
   }
   

Ejemplo: actualizar un registro de Journeys

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Journeys en la lista Entity.
3. Selecciona la operación Update y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "Name": "SFMC_CRETAE_JOURNEY_FROM_Googlecloud_Updated_V1"
   }
   

5. Asigna el ID de entidad a la entidad de Journeys . Para definir el ID de entidad, haz clic en entityId y, a continuación, introduce 0868BF36-3107-460E-9EF1-09633A0592E8 en el campo Valor predeterminado.

   Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   {
     "Id": "0868bf36-3107-460e-9ef1-09633a0592e8"
   }
   

Ejemplo: actualizar un registro de lista

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona List en la lista Entity.
3. Selecciona la operación Update y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "Description": "UpdatedDescription"
   }
   

5. Asigna el ID de entidad a la entidad de la lista . Para definir el ID de entidad, haz clic en entityId y, a continuación, introduce 1234 en el campo Valor predeterminado.

   Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   {
     "ID": 1234.0
   }