Marketing Cloud de Salesforce

Ejemplo: Enumera 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 haz clic en Listo.
4. En la sección Entrada de tarea de la tarea Connectors, puedes establecer la filterClause según los requisitos del cliente.

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

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

En algunos casos, pasar un ID de entidad puede generar un error. En esos casos, puedes usar la cláusula de filtro, como id=172.

Ejemplo: Obtén un registro de Assets

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 haz clic en Listo.
4. Establece el ID de la entidad en 49851.0, que es la clave que se pasará. Para establecer el ID de la entidad, en la sección Task Input de la tarea Connectors, haz clic en EntityId y, luego, ingresa 49851.0 en el campo Valor predeterminado.

   El valor del ID de entidad debe pasarse directamente, como Id= 49851.0. Aquí, 49851.0 es el valor único de la clave primaria que se debe pasar.

Ejemplo: Borra un registro de Assets

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 haz clic en Listo.
4. Establece el ID de la entidad en 49851.0, que es la clave que se pasará. Para establecer el ID de la entidad, en la sección Task Input de la tarea Connectors, haz clic en EntityId y, luego, ingresa 49851.0 en el campo Valor predeterminado.

   El valor del ID de entidad debe pasarse directamente, por ejemplo, ID= 49851.0. Aquí, 49851.0 es el valor único de la clave primaria que se debe pasar.

Ejemplo: Crea un registro de 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 haz clic en Listo.
4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa 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 de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   {
     "StudentID": 1
   } 

Ejemplo: Crea un registro de Assets

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 haz clic en Listo.
4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa 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 de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   {
     "Id": 60188.0
   }

Ejemplo: Crea un registro de Campaigns

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 haz clic en Listo.
4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa 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 de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   {
     "Id": 247.0
   } 

Ejemplo: Crea 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 Create y haz clic en Listo.
4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa 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 de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

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

Ejemplo: Crea 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 haz clic en Listo.
4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa 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 de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   {
     "Id": 4052023.0
   }

Ejemplo: Crea 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 haz clic en Listo.
4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa 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 de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   {
     "Success": true
   }

Ejemplo: Actualiza un registro de 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 haz clic en Listo.
4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

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

5. Establece el ID de la entidad en, p. ej., 103032, que es la clave principal que se pasará. Para establecer el ID de la entidad, en la sección Task Input de la tarea Connectors, haz clic en entityId y, luego, ingresa 10 en el campo Valor predeterminado.

   Si la entidad tiene claves principales o de negocio compuestas, en lugar de especificar entityId, también puedes establecer filterClause en 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: Actualiza un registro de Assets

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 haz clic en Listo.
4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

   {
     "Description": "June2023-Updated"
   }
   

5. Establece el ID de la entidad en la entidad de los recursos . Para establecer el ID de la entidad, haz clic en entityId y, luego, ingresa 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: Actualiza 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 haz clic en Listo.
4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

   {
     "Name": "SFMC_CRETAE_JOURNEY_FROM_Googlecloud_Updated_V1"
   }
   

5. Configura el ID de la entidad en la entidad de Journeys . Para establecer el ID de la entidad, haz clic en entityId y, luego, ingresa 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: Actualiza 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 haz clic en Listo.
4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

   {
     "Description": "UpdatedDescription"
   }
   

5. Configura el ID de la entidad en la entidad de la lista . Para establecer el ID de la entidad, haz clic en entityId y, luego, ingresa 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
   }