Salesforce Marketing Cloud

Exemplo: listar todos os recursos

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Assets na lista Entity.
3. Selecione a operação List e clique em Concluído.
4. Na seção Entrada de tarefa da tarefa Conectores, é possível definir a filterClause de acordo com o requisito do cliente.

Use aspas simples (") para incluir o valor de uma cláusula de filtro, que precisa ser transmitido diretamente, como CategoryName='Content Builder'. Aqui, "Nome da categoria" é o nome da coluna e "Criador de conteúdo" é o valor.

É possível usar a cláusula de filtro para filtrar registros com base nas colunas. Por exemplo, para filtrar registros, use a cláusula de filtro a seguir: Location='US' e region='us-east1'

Em alguns casos, a transmissão de um ID de entidade pode gerar um erro. Nesses casos, use a cláusula de filtro, como id=172.

Exemplo: receber um registro de recursos

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Assets na lista Entity.
3. Selecione a operação Get e clique em Concluído.
4. Defina o ID da entidade como 49851.0, que é a chave a ser transmitida. Para definir o ID da entidade, na seção Entrada da tarefa da tarefa Connectors, clique em EntityId e insira 49851.0 no campo Valor padrão.

   O valor do ID da entidade precisa ser transmitido diretamente, como Id= 49851.0. Aqui, 49851.0 é o valor exclusivo da chave primária, que precisa ser transmitido.

Exemplo: excluir um registro de recursos

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Assets na lista Entity.
3. Selecione a operação Delete e clique em Concluído.
4. Defina o ID da entidade como 49851.0, que é a chave a ser transmitida. Para definir o ID da entidade, na seção Entrada da tarefa da tarefa Connectors, clique em EntityId e insira 49851.0 no campo Valor padrão.

   O valor do ID da entidade precisa ser transmitido diretamente, como ID= 49851.0. Aqui, 49851.0 é o valor exclusivo da chave primária, que precisa ser transmitido.

Exemplo: criar um registro DataExtensionObject_Custom

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione DataExtensionObject_Custom na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

   {
     "StudentID": 1
   } 

Exemplo: criar um registro de recursos

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Assets na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

   {
     "Id": 60188.0
   }

Exemplo: criar um registro de campanhas

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Campaigns na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

   {
     "Id": 247.0
   } 

Exemplo: criar um registro de jornadas

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Journeys na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no 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\": []}}}]"
   }

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

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

Exemplo: criar um registro de lista

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione List na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no 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"
   }

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

   {
     "Id": 4052023.0
   }

Exemplo: criar um registro de assinante

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Subscriber na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

   {
     "Success": true
   }

Exemplo: atualizar um registro DataExtensionObject_Custom

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione DataExtensionObject_Custom na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

5. Defina o ID da entidade como, por exemplo, 103032, que é a chave primária a ser transmitida. Para definir o ID da entidade, na seção Entrada da tarefa da tarefa Connectors, clique em entityId e insira 10 no campo Valor padrão.

   Se a entidade tiver chaves primárias ou de negócios compostas, em vez de especificar o entityId, você também pode definir a filterClause como Rank='1' and StudentID='10'.

Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

{
    "StudentID": 1
}

Exemplo: atualizar um registro de recursos

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione "Recursos" na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

   {
     "Description": "June2023-Updated"
   }
   

5. Defina o ID da entidade como a entidade dos recursos . Para definir o ID da entidade, clique em entityId e insira 52080 no campo Valor padrão.

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

   {
     "Id": 52080.0
   }
   

Exemplo: atualizar um registro do Journeys

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Journeys na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

   {
     "Name": "SFMC_CRETAE_JOURNEY_FROM_Googlecloud_Updated_V1"
   }
   

5. Defina o ID da entidade como a entidade das jornadas . Para definir o ID da entidade, clique em entityId e insira 0868BF36-3107-460E-9EF1-09633A0592E8 no campo Valor padrão.

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

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

Exemplo: atualizar um registro de lista

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione List na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

   {
     "Description": "UpdatedDescription"
   }
   

5. Defina o ID da entidade como a entidade da lista . Para definir o ID da entidade, clique em entityId e insira 1234 no campo Valor padrão.

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

   {
     "ID": 1234.0
   }