Salesforce Marketing Cloud

O conetor do Salesforce Marketing Cloud permite-lhe realizar operações de inserção, eliminação, atualização e leitura num conjunto de dados do Salesforce Marketing Cloud.

Antes de começar

Antes de usar o conetor do Salesforce Marketing Cloud, faça as seguintes tarefas:

  • No seu projeto do Google Cloud:
    • Certifique-se de que a conetividade de rede está configurada. Para obter informações sobre padrões de rede, consulte o artigo Conetividade de rede.
    • Conceda a função IAM roles/connectors.admin ao utilizador que está a configurar o conetor.
    • Conceda as seguintes funções de IAM à conta de serviço que quer usar para o conector:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Uma conta de serviço é um tipo especial de Conta Google destinada a representar um utilizador não humano que precisa de autenticação e autorização para aceder a dados nas APIs Google. Se não tiver uma conta de serviço, tem de criar uma. O conector e a conta de serviço têm de pertencer ao mesmo projeto. Para mais informações, consulte Criar uma conta de serviço.

    • Ative os seguintes serviços:
      • secretmanager.googleapis.com (Secret Manager API)
      • connectors.googleapis.com (API Connectors)

      Para saber como ativar serviços, consulte o artigo Ativar serviços.

    Se estes serviços ou autorizações não tiverem sido ativados anteriormente para o seu projeto, é-lhe pedido que os ative quando configurar o conector.

Configure o conetor

Uma associação é específica de uma origem de dados. Isto significa que, se tiver muitas origens de dados, tem de criar uma associação separada para cada origem de dados. Para criar uma associação, faça o seguinte:

  1. Na Cloud Console, aceda à página Integration Connectors > Ligações e, de seguida, selecione ou crie um projeto do Google Cloud.

    Aceda à página Ligações

  2. Clique em + CRIAR NOVO para abrir a página Criar associação.
  3. Na secção Localização, escolha a localização para a ligação.
    1. Região: selecione uma localização na lista pendente.

      Para ver a lista de todas as regiões suportadas, consulte o artigo Localizações.

    2. Clique em SEGUINTE.
  4. Na secção Detalhes da associação, conclua o seguinte:
    1. Conetor: selecione Salesforce Marketing Cloud na lista pendente de conetores disponíveis.
    2. Versão do conetor: selecione a versão do conetor na lista pendente de versões disponíveis.
    3. No campo Nome da ligação, introduza um nome para a instância de ligação.

      Os nomes das associações têm de cumprir os seguintes critérios:

      • Os nomes das associações podem usar letras, números ou hífenes.
      • As letras têm de ser minúsculas.
      • Os nomes das associações têm de começar com uma letra e terminar com uma letra ou um número.
      • Os nomes das associações não podem exceder 49 carateres.
    4. Opcionalmente, introduza uma Descrição para a instância de associação.
    5. Opcionalmente, ative o Registo na nuvem e, em seguida, selecione um nível de registo. Por predefinição, o nível do registo está definido como Error.
    6. Conta de serviço: selecione uma conta de serviço que tenha as funções necessárias.
    7. Opcionalmente, configure as definições do nó de associação:

      • Número mínimo de nós: introduza o número mínimo de nós de ligação.
      • Número máximo de nós: introduza o número máximo de nós de ligação.

      Um nó é uma unidade (ou uma réplica) de uma ligação que processa transações. São necessários mais nós para processar mais transações para uma ligação e, inversamente, são necessários menos nós para processar menos transações. Para compreender como os nós afetam os preços dos conectores, consulte o artigo Preços dos nós de ligação. Se não introduzir valores, por predefinição, os nós mínimos são definidos como 2 (para uma melhor disponibilidade) e os nós máximos são definidos como 50.

    8. Tipo de integração da API: o tipo de concessão para o fluxo OAuth. As entradas aceites são de servidor a servidor e Web-app.
    9. ID da conta: o identificador da conta ou o MID da unidade empresarial de destino.
    10. Apresentar extensões de dados de contas secundárias: apresenta as extensões de dados de contas secundárias, se estiverem definidas.
    11. Instância: a instância da API Salesforce Marketing Cloud usada.
    12. List Data Extensions: um valor booleano que determina se as extensões de dados devem ser apresentadas como tabelas ou não.
    13. Consultar todas as contas: consulta todas as contas, incluindo a conta principal e todas as contas secundárias, relativamente a um evento.
    14. Esquema: especifique a versão do servidor do Salesforce Marketing Cloud com a qual estabelecer ligação.
    15. Subdomínio: o subdomínio da API Salesforce Marketing Cloud.
    16. Usar autenticação antiga: um valor booleano que determina se a ligação deve ser feita à API REST do Salesforce Marketing Cloud através da autenticação antiga ou não.
    17. (Opcional) Na secção Definições avançadas, selecione a caixa de verificação Usar proxy para configurar um servidor proxy para a ligação e configurar os seguintes valores:
      • Esquema de autenticação de proxy: selecione o tipo de autenticação para autenticar com o servidor proxy. Os seguintes tipos de autenticação são suportados:
        • Básica: autenticação HTTP básica.
        • Resumo: autenticação HTTP de resumo.
      • Utilizador do proxy: um nome de utilizador a ser usado para autenticação com o servidor proxy.
      • Palavra-passe do proxy: o segredo do Secret Manager da palavra-passe do utilizador.
      • Tipo de SSL do proxy: o tipo de SSL a usar quando se liga ao servidor proxy. Os seguintes tipos de autenticação são suportados:
        • Automático: predefinição. Se o URL for um URL HTTPS, é usada a opção Túnel. Se o URL for um URL HTTP, é usada a opção NUNCA.
        • Sempre: a ligação está sempre ativada com SSL.
        • Nunca: a ligação não tem o SSL ativado.
        • Túnel: a ligação é feita através de um proxy de túnel. O servidor proxy abre uma ligação ao anfitrião remoto e o tráfego flui em ambas as direções através do proxy.
      • Na secção Servidor proxy, introduza os detalhes do servidor proxy.
        1. Clique em + Adicionar destino.
        2. Selecione um Tipo de destino.
          • Endereço do anfitrião: especifique o nome do anfitrião ou o endereço IP do destino.

            Se quiser estabelecer uma ligação privada ao seu sistema de back-end, faça o seguinte:

    18. Opcionalmente, clique em + ADICIONAR ETIQUETA para adicionar uma etiqueta à associação sob a forma de um par chave/valor.
    19. Clique em SEGUINTE.
  5. Na secção Autenticação, introduza os detalhes de autenticação.
    1. Selecione um Tipo de autenticação e introduza os detalhes relevantes.

      A ligação do Salesforce Marketing Cloud suporta os seguintes tipos de autenticação:

      • Nome de utilizador e palavra-passe
      • OAuth 2.0 – Credenciais de cliente
      • OAuth 2.0 – Código de autorização

        • Para saber como configurar estes tipos de autenticação, consulte o artigo Configurar autenticação.

    2. Clique em SEGUINTE.
  6. Rever: reveja os detalhes da ligação e da autenticação.
  7. Clique em Criar.

Configure a autenticação

Introduza os detalhes com base na autenticação que quer usar.

  • Nome de utilizador e palavra-passe
    • Nome de utilizador: nome de utilizador do conetor
    • Palavra-passe: Secret do Secret Manager que contém a palavra-passe associada ao conector.
  • OAuth 2.0 – Credenciais de cliente
    • ID de cliente: o ID de cliente da app que criou.
    • Segredo do cliente: segredo do Secret Manager que contém o segredo do cliente da app associada que criou.
    • Versão do Secret: a versão do segredo do cliente.
  • OAuth 2.0 – Código de autorização
    • ID de cliente: o ID de cliente usado para pedir tokens de acesso.
    • Âmbitos: uma lista separada por vírgulas dos âmbitos pretendidos.
    • Segredo do cliente: o segredo do cliente usado para pedir tokens de acesso.
    • Versão do Secret: a versão do segredo do cliente.
    • URL de autorização: o URL de autorização gerado quando cria o cliente.

Configure o Salesforce Marketing Cloud

Para configurar o Salesforce Marketing Cloud, inicie sessão na sua conta existente ou crie uma nova conta através do início de sessão do Salesforce Marketing Cloud. Para informações sobre o apoio técnico da comunidade e informações adicionais, consulte a comunidade Trailblazer. Para obter informações sobre as APIs REST do Salesforce Marketing Cloud, consulte o artigo API REST do Salesforce Marketing Cloud. Para obter informações sobre a API SOAP do Salesforce Marketing Cloud, consulte o artigo APIs SOAP.

Crie um cliente da API

  1. Na página do perfil do Salesforce Marketing Cloud, clique em Configuração.
  2. No painel do lado esquerdo, selecione Pacotes instalados e, de seguida, clique em Novo.
  3. Introduza um nome e uma descrição para a integração.
  4. Escolha Servidor a servidor como tipo de integração.
  5. Clique em Guardar.

    6. Pode ver o ID de cliente, o segredo do cliente, o URL base SOAP, o URL base REST e outros detalhes.

Autenticação básica – Tipo de ligação

A tabela seguinte apresenta os valores de configuração de exemplo para o tipo de ligação de autenticação básica.

Nome do campo Detalhes
Localização us-east1
Conetor Salesforce Marketing Cloud
Versão do conetor 1
Nome da ligação sfmcconn1
Descrição SOAP – Palavra-passe do utilizador
Ative o Cloud Logging Sim
Conta de serviço service-account@my-project.iam.gserviceaccount.com
Tipo de integração da API Servidor a servidor
Esquema SOAP
ID da conta ACCOUNT_ID
Apresente extensões de dados secundários Sim
Instância s11
Apresentar extensões de dados Sim
Nível de verbosidade 5
Subdomínio SUBDOMAIN
Nome de utilizador NOME DE UTILIZADOR
Palavra-passe PASSWORD
Versão do Secret 1

OAuth 2.0 – Tipo de ligação

A tabela seguinte apresenta os valores de configuração de exemplo para o tipo de ligação de credenciais de cliente OAuth 2.0.

Nome do campo Detalhes
Localização us-east1
Conetor Salesforce Marketing Cloud
Versão do conetor 1
Nome da ligação sfmc-rest-conn
Ative o Cloud Logging Não
Conta de serviço service-account@my-project.iam.gserviceaccount.com
Tipo de integração da API Servidor a servidor
Esquema REST
ID da conta ACCOUNT_ID
Apresente extensões de dados secundários Sim
Instância s11
Apresentar extensões de dados Sim
Consultar todas as contas Sim
Nível de verbosidade 4
Subdomínio SUBDOMAIN
ID do cliente CLIENT_ID
Segredo do cliente CLIENT_SECRET
Versão do Secret 1

Entidades, operações e ações

Todos os conetores de integração oferecem uma camada de abstração para os objetos da aplicação ligada. Só pode aceder aos objetos de uma aplicação através desta abstração. A abstração é exposta como entidades, operações e ações.

  • Entidade: pode considerar uma entidade como um objeto ou uma coleção de propriedades na aplicação ou no serviço associado. A definição de uma entidade difere de um conetor para um conetor. Por exemplo, num conetor de base de dados, as tabelas são as entidades. Num conetor de servidor de ficheiros, as pastas são as entidades. Num conetor de sistema de mensagens, as filas são as entidades.

    No entanto, é possível que um conector não suporte ou não tenha entidades, caso em que a lista Entities estará vazia.

  • Operação: uma operação é a atividade que pode realizar numa entidade. Pode realizar qualquer uma das seguintes operações numa entidade:

    Selecionar uma entidade na lista disponível gera uma lista de operações disponíveis para a entidade. Para uma descrição detalhada das operações, consulte as operações de entidades da tarefa de conectores. No entanto, se um conector não suportar nenhuma das operações de entidades, essas operações não suportadas não são apresentadas na lista Operations.

  • Ação: uma ação é uma função de primeira classe que é disponibilizada à integração através da interface do conetor. Uma ação permite-lhe fazer alterações a uma ou mais entidades e varia de conetor para conetor. Normalmente, uma ação tem alguns parâmetros de entrada e um parâmetro de saída. No entanto, é possível que um conector não suporte nenhuma ação, caso em que a lista Actions está vazia.

Limitações do sistema

O conetor do Salesforce Marketing Cloud pode processar um máximo de 7 transações por segundo, por nó e limita todas as transações que excedam este limite. Por predefinição, os Integration Connectors atribuem 2 nós (para uma melhor disponibilidade) a uma ligação.

Para informações sobre os limites aplicáveis aos Integration Connectors, consulte Limites.

Ações

Esta secção apresenta todas as ações suportadas pela associação do Salesforce Marketing Cloud.

Ação GetJourneyPublicationStatus

Esta ação obtém o estado de uma publicação de percurso.

Parâmetros de entrada da ação GetJourneyPublicationStatus

Nome do parâmetro Tipo de dados Obrigatória Descrição
StatusId de string True O ID de estado de uma publicação de viagens.

Parâmetros de saída da ação GetJourneyPublicationStatus

Esta ação devolve o estado 200 (OK) com um corpo de resposta que indica todos os resultados.

Por exemplo, para saber como configurar a ação GetJourneyPublicationStatus, consulte os exemplos.

Ação FireEntryEvent

Acione o evento de entrada que inicia o percurso.

Parâmetros de entrada da ação FireEntryEvent

Nome do parâmetro Tipo de dados Obrigatória Descrição
ContactKey String True O ID que identifica exclusivamente um subscritor ou um contacto
EventDefinitionKey String True Encontre a EventDefinitionKey na administração de eventos depois de o evento ser criado e guardado. Isto aplica-se a eventos padrão e personalizados. Não inclua um ponto na chave de definição de eventos.
Dados String Falso Propriedades do evento. Só é necessário se for definido num evento personalizado ou pelo evento.

Parâmetros de saída da ação FireEntryEvent

Esta ação devolve o estado 200 (OK) com um corpo de resposta que indica todos os resultados

Por exemplo, para saber como configurar a ação FireEntryEvent, consulte os exemplos.

Ação StopJourney

Para uma viagem em curso

Introduza os parâmetros da ação StopJourney

Nome do parâmetro Tipo de dados Obrigatória Descrição
JourneyId String True O ID do percurso a parar, expresso sob a forma de um GUID (UUID)
JourneyVersion Número inteiro True O número da versão do percurso a parar

Parâmetros de saída da ação StopJourney

Esta ação devolve o estado 200 (OK) com um corpo de resposta que indica todos os resultados

Por exemplo, para saber como configurar a ação StopJourney, consulte os exemplos.

Ação PublishJourney

A ação PublishJourney publica uma versão do percurso de forma assíncrona

Introduza os parâmetros da ação PublishJourney

Nome do parâmetro Tipo de dados Obrigatória Descrição
JourneyId String True O ID do trajeto a parar, expresso sob a forma de um GUID (UUID).
JourneyVersion Número inteiro True O número da versão do percurso a parar.

Parâmetros de saída da ação PublishJourney

Esta ação devolve o estado 200 (OK) com um corpo de resposta que indica todos os resultados

Por exemplo, para saber como configurar a ação PublishJourney, consulte os exemplos.

CreateTriggeredSend action

A ação CreateTriggeredSend cria um objeto de envio acionado que representa uma instância específica de um envio de email acionado

Parâmetros de entrada da ação CreateTriggeredSend

Nome do parâmetro Tipo de dados Obrigatória Descrição
Chave String Falso Define a definição de envio acionado associada para o envio acionado. Esta propriedade corresponde à chave externa atribuída a um objeto no Marketing Cloud.
SendId String Falso ID da definição de envio do evento de entrada que provém da resposta quando cria uma TriggeredSendDefinition. Esta opção ou a chave externa é obrigatória.
FromAddress String Falso Endereço de email que é apresentado como remetente.
FromName String Falso Nome do remetente
ToAddress String True Endereço de email do destinatário da mensagem.
SubscriberKey String True Identificador exclusivo definido para o destinatário da mensagem.
SubscriberAttributes String Falso Pares de valor e nome para atributos de subscritores definidos para a mensagem.
RequestType String Falso Os valores válidos são ASYNC e SYNC. O valor predefinido quando não está definido é ASYNC. Determina se o pedido é processado de forma assíncrona.

Parâmetros de saída da ação CreateTriggeredSend

Esta ação devolve o estado 200 (OK) com um corpo de resposta que indica todos os resultados

Por exemplo, para saber como configurar a ação CreateTriggeredSend, consulte os exemplos.

SendTransactionalMessageToRecipient action

A ação SendTransactionalMessageToRecipient envia uma mensagem a um único destinatário através de uma definição de envio

Introduza os parâmetros da ação SendTransactionalMessageToRecipient

Nome do parâmetro Tipo de dados Obrigatória Descrição
MessageKey String True Identificador da mensagem definido pelo utilizador.
DefinitionKey String True Identificador exclusivo da definição.
RecipientContactKey String True Identificador exclusivo de um subscritor no Marketing Cloud. Cada pedido tem de incluir uma contactKey. Pode usar uma chave de subscritor existente ou criar uma no momento do envio através do endereço de email do destinatário
RecipientTo String Falso Endereço do canal do destinatário. Para email, é o endereço de email do destinatário
Atributos String Falso Informações usadas para personalizar a mensagem para o destinatário. Escrito como pares de chaves. Os atributos correspondem aos atributos do perfil, aos atributos de conteúdo ou aos atributos da extensão de dados de envio acionado

Parâmetros de saída da ação SendTransactionalMessageToRecipient

Esta ação devolve o estado 200 (OK) com um corpo de resposta que indica todos os resultados

Por exemplo, para saber como configurar a ação SendTransactionalMessageToRecipient, consulte os exemplos.

Exemplos de ações

Esta secção descreve como realizar algumas das ações neste conector.

Exemplo: obtenha o estado de uma publicação de percurso

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação GetJourneyPublicationStatus e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value: 
    {
  "StatusId": "3acf1f54-5c9e-4719-b7f7-bfc2e5caf10a"
}

    4. Se a ação for bem-sucedida, o campo connectorOutputPayload da tarefa do conector terá um valor semelhante ao seguinte:

     [{
  "Status": "PublishCompleted",
  "Message": null
}]

Exemplo: acione um evento de entrada para iniciar um percurso

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação FireEntryEvent e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value: 
    {
  "ContactKey": "Email",
  "EventDefinitionKey": "APIEvent-4d84e619-a629-6b17-945f-9a6e78a1982c",
  "Data": "{\"Email\": \"usr1@test.com\"}"
}

    4. Se a ação for bem-sucedida, o campo connectorOutputPayload da tarefa do conetor tem um valor semelhante ao seguinte:

     [{
  "EventInstanceId": "0d6f6dd1-1aaa-4eec-9727-f99550ab68f9"
}]

Exemplo: pare um percurso em execução

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação StopJourney e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value: 
    {
  "JourneyId": "37D2789E-2B1D-433E-8E18-8F47E4D8E865",
  "JourneyVersion": 1.0
}

    4. Se a ação for bem-sucedida, o campo connectorOutputPayload da tarefa do conector terá um valor semelhante ao seguinte:

      [{
  "Success": true
}]

Exemplo: publique uma versão do percurso

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação PublishJourney e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value: 
    {
  "JourneyId": "0868BF36-3107-460E-9EF1-09633A0592E8",
  "JourneyVersion": 1.0
}

    4. Se a ação for bem-sucedida, o campo connectorOutputPayload da tarefa do conector terá um valor semelhante ao seguinte:

     [{
  "StatusId": "acb1734d-483e-400a-97d7-0501b94f03b2"
}]

Exemplo: crie um acionador para iniciar um percurso

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação CreateTriggeredSend e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value: 
    {
  "Key": "BU27_SendDefinition1",
  "ToAddress": "usr1@test.com",
  "SubscriberKey": "107",
  "SubscriberAttributes": "{\"FirstName\": \"John\", \"LastName\": \"P\"}"
}

    4. Se a ação for bem-sucedida, o campo connectorOutputPayload da tarefa do conector terá um valor semelhante ao seguinte:

     [{
  "Success": "True",
  "RecipientSendId": "5d06edb1-d07c-48ad-a1f2-d6350eb863f8",
  "Messages": "Queued"
}]

Exemplo: envie uma mensagem a um único destinatário

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação SendTransactionalMessageToRecipient e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value: 
    {
  "MessageKey": "T9999009",
  "DefinitionKey": "Send-Definition-SFMC-Demo-2",
  "RecipientContactKey": "107",
  "RecipientTo": "usr1@test.com",
  "Attributes": "FirstName :John"
}

    4. Se a ação for bem-sucedida, o campo connectorOutputPayload da tarefa do conector terá um valor semelhante ao seguinte:

    [{
  "RequestId": "d8fb9e9e-3ae2-412f-b01e-d198433cfc16"
}]

Exemplos de operações de entidades

Esta secção mostra como realizar algumas das operações de entidades neste conector.

Operações de entidades suportadas

Esta secção apresenta as operações de entidades suportadas pelo conetor do Salesforce Marketing Cloud e mostra como realizar algumas das operações de entidades neste conetor.

Entidade Operação
DataExtensionObject_Custom List, Get, Delete, Create, Update
Campanha Listar, obter e eliminar
CampaignAssets Listar, obter e eliminar
Viagens List, Get, Delete, Create, Update
Lista Listar, criar e atualizar
Publicação Lista
Subscritor Listar, criar
SubscriberList Lista
ListSubscriber Lista
JourneyActivities Get, Delete
Campanhas Criar
Assets List, Get, Delete, Create, Update

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, de seguida, clique em Concluído.
  4. Na secção Task Input da tarefa Connectors, pode definir o filterClause de acordo com o requisito do cliente.

    5. Tem de usar aspas simples (') para incluir o valor de uma cláusula de filtro e este tem de ser transmitido diretamente, como CategoryName='Content Builder'. Aqui, CategoryName é o nome da coluna e o criador de conteúdo é o valor.

    Pode usar a cláusula filter para filtrar registos com base nas colunas. Por exemplo, para filtrar registos, use a seguinte cláusula de filtro: Location='US' e region='us-east1'

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

Exemplo: obtenha um registo 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, de seguida, 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 secção Entrada da tarefa da tarefa Conetores, clique em EntityId e, em seguida, introduza 49851.0 no campo Valor predefinido.

    O valor do ID da entidade deve ser transmitido diretamente, como Id= 49851.0. Aqui, 49851.0 é o valor da chave principal exclusivo, que deve ser transmitido.

Exemplo: elimine um registo 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, de seguida, 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 secção Entrada da tarefa da tarefa Conetores, clique em EntityId e, em seguida, introduza 49851.0 no campo Valor predefinido.

    O valor do ID da entidade deve ser transmitido diretamente, como ID= 49851.0. Aqui, 49851.0 é o valor da chave principal exclusivo, que deve ser transmitido.

Exemplo: crie um registo 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, de seguida, clique em Concluído.
  4. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 connectorOutputPayloadresposta da tarefa do conector terá um valor semelhante ao seguinte:

    {
  "StudentID": 1
}

Exemplo: crie um registo 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, de seguida, clique em Concluído.
  4. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 connectorOutputPayloadresposta da tarefa do conector terá um valor semelhante ao seguinte:

    {
  "Id": 60188.0
}

Exemplo: crie um registo 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, de seguida, clique em Concluído.
  4. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 connectorOutputPayloadresposta da tarefa do conector terá um valor semelhante ao seguinte:

    {
  "Id": 247.0
}

Exemplo: crie um registo de percursos

  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, de seguida, clique em Concluído.
  4. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 connectorOutputPayloadresposta da tarefa do conector terá um valor semelhante ao seguinte:

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

Exemplo: crie um registo 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, de seguida, clique em Concluído.
  4. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 connectorOutputPayloadresposta da tarefa do conector terá um valor semelhante ao seguinte:

    {
  "Id": 4052023.0
}

Exemplo: crie um registo de subscritor

  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, de seguida, clique em Concluído.
  4. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 connectorOutputPayloadresposta da tarefa do conector terá um valor semelhante ao seguinte:

    {
  "Success": true
}

Exemplo: atualize um registo 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, de seguida, clique em Concluído.
  4. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 principal a ser transmitida. Para definir o ID da entidade, na secção Entrada da tarefa da tarefa Conetores, clique em entityId e, de seguida, introduza 10 no campo Valor predefinido.

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

    6. Se a integração for bem-sucedida, o parâmetro de connectorOutputPayloadresposta da tarefa do conector terá um valor semelhante ao seguinte:

    {
    "StudentID": 1
}

Exemplo: atualize um registo de recursos

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Recursos na Entity lista.
  3. Selecione a operação Update e, de seguida, clique em Concluído.
  4. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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, de seguida, introduza 52080 no campo Valor predefinido.

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

    {
  "Id": 52080.0
}

Exemplo: atualize um registo de viagens

  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, de seguida, clique em Concluído.
  4. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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 do Journeys . Para definir o ID da entidade, clique em entityId e, de seguida, introduza 0868BF36-3107-460E-9EF1-09633A0592E8 no campo Valor predefinido.

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

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

Exemplo: atualize um registo 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, de seguida, clique em Concluído.
  4. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza 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, de seguida, introduza 1234 no campo Valor predefinido.

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

    {
  "ID": 1234.0
}

Crie ligações com o Terraform

Pode usar o recurso do Terraform para criar uma nova associação.

Para saber como aplicar ou remover uma configuração do Terraform, consulte os comandos básicos do Terraform.

Para ver um modelo do Terraform de exemplo para a criação de ligações, consulte o modelo de exemplo.

Quando criar esta associação através do Terraform, tem de definir as seguintes variáveis no ficheiro de configuração do Terraform:

Nome do parâmetro Tipo de dados Obrigatória Descrição
apiintegration_type ENUM Falso O tipo de concessão para o fluxo OAuth. As entradas aceites são de servidor para servidor e de Web para app. Os valores suportados são: de servidor para servidor e de Web para app
esquema ENUM True Especifique as APIs do Salesforce Marketing Cloud com as quais estabelecer ligação. Os valores suportados são: REST, SOAP
account_id STRING Falso O identificador da conta ou o MID da unidade empresarial de destino.
display_child_data_extensions BOOLEAN Falso Apresenta as extensões de dados das contas secundárias, se estiverem definidas.
instância STRING Falso A instância da API do Salesforce Marketing Cloud usada. Nota: se a instância for superior a s10, tem de especificar o subdomínio.
list_data_extensions BOOLEAN Falso Um valor booleano que determina se as extensões de dados devem ser apresentadas como tabelas ou não.
query_all_accounts BOOLEAN Falso Consulta todas as contas, incluindo a principal e todas as secundárias, relativamente a um evento.
verbosidade STRING Falso Nível de verbosidade para a ligação, varia de 1 a 5. Um nível de detalhe mais elevado regista todos os detalhes de comunicação (pedido,resposta e certificados SSL).
subdomínio STRING Falso O subdomínio da API Salesforce Marketing Cloud.
proxy_enabled BOOLEAN Falso Selecione esta caixa de verificação para configurar um servidor proxy para a ligação.
proxy_auth_scheme ENUM Falso O tipo de autenticação a usar para autenticar no proxy ProxyServer. Os valores suportados são: BASIC, DIGEST, NONE
proxy_user STRING Falso Um nome de utilizador a ser usado para autenticar no proxy ProxyServer.
proxy_password SECRET Falso Uma palavra-passe a usar para autenticar no proxy ProxyServer.
proxy_ssltype ENUM Falso O tipo de SSL a usar quando se liga ao proxy ProxyServer. Os valores suportados são: AUTO, ALWAYS, NEVER, TUNNEL

Use a associação do Salesforce Marketing Cloud numa integração

Depois de criar a ligação, esta fica disponível no Apigee Integration e no Application Integration. Pode usar a ligação numa integração através da tarefa Conectores.

  • Para compreender como criar e usar a tarefa Connectors no Apigee Integration, consulte o artigo Tarefa Connectors.
  • Para compreender como criar e usar a tarefa Connectors na integração de aplicações, consulte o artigo Tarefa Connectors.

Obtenha ajuda da comunidade do Google Cloud

Pode publicar as suas perguntas e discutir este conector na comunidade do Google Cloud nos Fóruns do Cloud.

O que se segue?