Marketo

Com o conector do Marketo, você pode realizar operações de inserção, exclusão, atualização e leitura nos dados do Marketo.

Antes de começar

Antes de usar o conector do Marketo, faça o seguinte:

  • No seu projeto do Google Cloud, faça o seguinte:
    • Verifique se a conectividade de rede está configurada. Para informações sobre padrões de rede, consulte Conectividade de rede.
    • Conceda a função IAM roles/connectors.admin ao usuário que está configurando o conector.
    • Conceda os seguintes papéis de IAM à conta de serviço que você quer usar para o conector:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Uma conta de serviço é um tipo especial de Conta do Google destinada a representar um usuário não humano que precisa ser autenticado e autorizado a acessar dados nas APIs do Google. Se você não tiver uma conta de serviço, será necessário criar uma. Para mais informações, consulte Como criar uma conta de serviço.

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

      Para entender como ativar os serviços, consulte Como ativar serviços.

    Se esses serviços ou permissões não tiverem sido ativados no seu projeto, você precisará ativá-los ao configurar o conector.

Configurar o conector

Uma conexão é específica a uma fonte de dados. Isso significa que, se você tiver muitas fontes de dados, precisará criar uma conexão separada para cada uma. Para criar uma conexão, faça o seguinte:

  1. No console do Cloud, acesse a página Integration Connectors > Conexões e selecione ou crie um projeto do Google Cloud.

    Acessar a página "Conexões"

  2. Clique em + Criar novo para abrir a página Criar conexão.
  3. Na seção Local, escolha o local da conexão.
    1. Região: selecione um local na lista suspensa.

      Veja abaixo as regiões compatíveis com o conector:

      Para conferir a lista de todas as regiões com suporte, consulte Locais.

    2. Clique em Próxima.
  4. Na seção Detalhes da conexão, faça o seguinte:
    1. Conector: selecione Marketo na lista suspensa de conectores disponíveis.
    2. Versão do conector: selecione a versão do conector na lista suspensa de versões disponíveis.
    3. No campo Nome da conexão, insira um nome para a instância de conexão

      Os nomes de conexão precisam atender aos seguintes critérios:

      • Os nomes de conexões podem usar letras, números ou hifens.
      • As letras precisam ser minúsculas.
      • Os nomes das conexões precisam começar com uma letra e terminar com uma letra ou um número.
      • Os nomes das conexões não podem ter mais de 49 caracteres.
    4. Como opção, insira uma Descrição para a instância de conexão.
    5. Conta de serviço: selecione uma conta de serviço que tenha os papéis necessários.
    6. Opcionalmente, defina as Configurações do nó de conexão:

      • Número mínimo de nós: digite o número mínimo de nós de conexão.
      • Número máximo de nós: digite o número máximo de nós de conexão.

      Um nó é uma unidade (ou réplica) de uma conexão que processa transações. Mais nós são necessários para processar mais transações para uma conexão e, por outro lado, menos nós são necessários para processar menos transações. Para entender como os nós afetam os preços do conector, consulte Preços dos nós de conexão. Se você não inserir qualquer valor, por padrão, os nós mínimos serão definidos como 2 (para melhor disponibilidade) e os nós máximos serão definidos como 50.

    7. Outra opção é clicar em + Adicionar rótulo para adicionar um rótulo à conexão na forma de um par de chave-valor.
    8. Clique em Próxima.
  5. Na seção Destinos, insira os detalhes do host remoto (sistema de back-end) ao qual você quer se conectar.
    1. Tipo de destino: é possível especificar os detalhes de destino como endereço de host ou anexo de serviço. Selecione um dos tipos de destino a seguir:
      • Endereço do host: se você quiser especificar o nome do host ou o endereço IP do destino.
      • Anexo de serviço: se você quiser especificar o endpoint particular para seus endereços IP internos. O anexo de serviço permite ocultar seus endereços IP internos da rede externa. É possível criar um anexo de serviço no Google Cloud usando o recurso Private Service Connect. Para informações sobre como configurar um Private Service Connect, consulte Publicar serviços gerenciados.

      Com base no tipo de destino selecionado, insira o endereço do host ou o nome do anexo do serviço.

      Para inserir outros destinos, clique em +Adicionar destino.

    2. Clique em Próxima.
  6. Na seção Autenticação, insira os detalhes da autenticação.
    1. Selecione um Tipo de autenticação e insira os detalhes relevantes.

      A conexão do Marketo oferece suporte aos seguintes tipos de autenticação:

      • Credenciais do cliente OAuth 2.0
      • Nome de usuário e senha

      2. Para entender como configurar esses tipos de autenticação, consulte Configurar autenticação.

    2. Clique em Next.
  7. Revisão: revise os detalhes de conexão e autenticação.
  8. Clique em Criar.

Configurar a autenticação

Digite os detalhes com base na autenticação que você quer usar.

  • Credenciais do cliente OAuth 2.0
    • ID do cliente: o ID do cliente fornecido pelo conector para o app que você criou.
    • Chave secreta do cliente: o secret do Secret Manager que contém a chave secreta do cliente para o app conectado que você criou.
  • Nome de usuário e senha
    • UserId: o ID do usuário da API SOAP da Marketo.
    • EncryptionKey: secret do Secret Manager que contém a chave de criptografia da API SOAP do Marketo.

Limitações do sistema

O conector do Marketo pode processar uma transação por segundo, por nó, e limita qualquer transação além desse limite. Por padrão, os Integration Connectors alocam dois nós (para melhor disponibilidade) para uma conexão.

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

Usar a conexão do Marketo em uma integração

Depois de criar a conexão, ela fica disponível na integração da Apigee e Application Integration. É possível usar a conexão em uma integração pela tarefa de conectores.

  • Para entender como criar e usar a tarefa "Connectors" na integração da Apigee, consulte Tarefa Connectors.
  • Para entender como criar e usar a tarefa "Conectores" na Application Integration, consulte Tarefa "Conectores".

Ações

Esta seção lista as ações compatíveis com o conector. Para entender como configurar as ações, consulte Exemplos de ação.

Ação "AddLandingPageContentSection"

Adiciona uma seção de conteúdo à página de destino de destino.

Parâmetros de entrada da ação AddLandingPageContentSection

Nome do parâmetro Tipo de dados Obrigatório Descrição
LandingPageId String Verdadeiro ID da página de destino
ContentId String Verdadeiro ID da seção de conteúdo. Também o ID HTML da seção.
Tipo String Verdadeiro Tipo de seção de conteúdo. Os valores permitidos são "Imagem", "Forma", "Retângulo", "Snippet", "RichText" e "HTML".

Para saber como configurar a ação AddLandingPageContentSection, consulte Exemplos de ação.

Ação DeleteLandingPageContentSection

Exclui a seção do conteúdo da página de destino no Marketo.

Parâmetros de entrada da ação DeleteLandingPageContentSection

Nome do parâmetro Tipo de dados Obrigatório Descrição
LandingPageId String Verdadeiro ID da página de destino.
ContentId String Verdadeiro ID da seção de conteúdo. Também o ID HTML da seção.

Para saber como configurar a ação DeleteLandingPageContentSection, consulte Exemplos de ação.

Ação "UpdateEmailContent"

Atualiza o conteúdo de um e-mail.

Parâmetros de entrada da ação UpdateEmailContent

Nome do parâmetro Tipo de dados Obrigatório Descrição
EmailId String Verdadeiro O ID do e-mail.
FromEmail String Verdadeiro Endereço de origem do e-mail
FromName String Verdadeiro Nome do remetente do e-mail
ReplyTo String Verdadeiro Endereço de resposta do e-mail
Assunto String Verdadeiro Linha de assunto do e-mail

Para saber como configurar a ação UpdateEmailContent, consulte Exemplos de ação.

Ação "UpdateLandingPageContentSection"

Adicione ou atualize a seção do conteúdo da página de destino no Marketo.

Parâmetros de entrada da ação UpdateLandingPageContentSection

Nome do parâmetro Tipo de dados Obrigatório Descrição
Type String Verdadeiro Tipo de seção de conteúdo.Os valores permitidos são Imagem, Formulário, Retângulo, Snippet, RichText e HTML.
Valor String Verdadeiro Tipo de seção de conteúdo.
LandingPageId String Verdadeiro ID da página de destino.
ContentId String Verdadeiro ID da seção de conteúdo. Também é o ID HTML da seção.

Para saber como configurar a ação UpdateLandingPageContentSection, consulte Exemplos de ação.

Ação GetImportProgramMembersStatus

Recebe o status de membros de um programa de importação da operação de arquivo para o Marketo.

Parâmetros de entrada da ação GetImportProgramMembersStatus

Nome do parâmetro Tipo de dados Obrigatório Descrição
BatchId String Verdadeiro O ID do lote de leads de importação.

Para saber como configurar a ação GetImportProgramMembersStatus, consulte Exemplos de ação.

Ação "Programar campanha"

Programa remotamente uma campanha em lote para ser executada em um determinado horário.

Parâmetros de entrada da ação ScheduleCampaign

Nome do parâmetro Tipo de dados Obrigatório Descrição
CampaignId String Verdadeiro ID da campanha em lote a ser programada.
RunAt String Verdadeiro Data e hora de veiculação da campanha. Se não for definido, a campanha será veiculada cinco minutos após a chamada.

Para saber como configurar a ação ScheduleCampaign, consulte Exemplos de ação.

Ação "ListMembersOfList"

Determina se os leads estão contidos em uma lista no Marketo.

Parâmetros de entrada da ação ListMembersOfList

Nome do parâmetro Tipo de dados Obrigatório Descrição
ListId String Verdadeiro O ID da lista a ser verificada em busca de leads.
LeadId String Verdadeiro Uma lista separada por vírgulas de IDs de leads a serem verificados se estão na lista especificada por ListId.

Para saber como configurar a ação ListMembersOfList, consulte Exemplos de ação.

Ação "Associar lead"

Associa um registro de lead conhecido do Marketo a um cookie Munchkin e ao histórico de atividade da Web associado

Parâmetros de entrada da ação AssociateLead

Nome do parâmetro Tipo de dados Obrigatório Descrição
LeadId String Verdadeiro ID do lead a ser associado.
Cookie String Verdadeiro O valor do cookie a ser associado

Para saber como configurar a ação AssociateLead, consulte Exemplos de ação.

Ação "MergeLeads"

Une dois ou mais registros de lead conhecidos em um único registro.

Parâmetros de entrada da ação MergeLeads

Nome do parâmetro Tipo de dados Obrigatório Descrição
WinningLeadId String Verdadeiro O ID do registro de lead vencedor
LoosingLeadId String Verdadeiro Uma lista separada por vírgulas de IDs de leads perdidos

Para saber como configurar a ação MergeLeads, consulte Exemplos de ação.

Ação GetImportLeadsStatus

Recebe o status de uma operação de arquivo de leads de importação para o Marketo.

Parâmetros de entrada da ação GetImportLeadsStatus

Nome do parâmetro Tipo de dados Obrigatório Descrição
BatchId String Verdadeiro O ID do lote de leads de importação.

Para saber como configurar a ação GetImportLeadsStatus, consulte Exemplos de ação.

Ação CancelExportJob

Cancela um job de exportação.

Parâmetros de entrada da ação CancelExportJob

Nome do parâmetro Tipo de dados Obrigatório Descrição
JobId String Verdadeiro O ID do job de exportação.
Tipo String Verdadeiro O tipo de objeto do BulkExtract. Os valores disponíveis são : atividades, leads e membros de programa. Os valores permitidos são atividades, leads e membros de programa.

Para saber como configurar a ação CancelExportJob, consulte Exemplos de ação.

Ação EnqueueExportJob

Coloca um job de exportação na fila e o inicia quando os recursos de computação ficam disponíveis.

Parâmetros de entrada da ação EnqueueExportJob

Nome do parâmetro Tipo de dados Obrigatório Descrição
JobId String Verdadeiro O ID do job de exportação.
Tipo String Verdadeiro O tipo de objeto do BulkExtract. Os valores disponíveis são : atividades, leads e membros do programa. Os valores permitidos são "Activities", "Leads" e "ProgramMembers".

Para saber como configurar a ação EnqueueExportJob, consulte Exemplos de ação.

Ação GetExportJobStatus

Retorna o status de um job de exportação. O status do job fica disponível por 30 dias após a conclusão ou falha.

Parâmetros de entrada da ação GetExportJobStatus

Nome do parâmetro Tipo de dados Obrigatório Descrição
JobId String Verdadeiro O ID do job de exportação.
Tipo String Verdadeiro O tipo de objeto do BulkExtract. Os valores disponíveis são : atividades, leads e membros do programa. Os valores permitidos são "Activities", "Leads" e "ProgramMembers".

Para saber como configurar a ação GetExportJobStatus, consulte Exemplos de ação.

Ação CreateEmailTemplate

Cria um novo modelo de e-mail.

Parâmetros de entrada da ação CreateEmailTemplate

Nome do parâmetro Tipo de dados Obrigatório Descrição
FolderId String Verdadeiro O ID da pasta
FolderType String Verdadeiro O tipo da pasta.
Nome String Verdadeiro O nome da modelo de e-mail. Precisa ser exclusivo na pasta pai.
Arquivo String Verdadeiro Arquivo de várias partes. Conteúdo HTML do modelo.

Para saber como configurar a ação CreateEmailTemplate, consulte Exemplos de ação.

Ação "UpdateLeadProgramStatus"

Muda o status do programa de uma lista de leads em um programa de destino. Somente o status dos membros atuais do programa pode ser alterado com essa API.

Parâmetros de entrada da ação UpdateLeadProgramStatus

Nome do parâmetro Tipo de dados Obrigatório Descrição
ProgramId String Verdadeiro ID da campanha em lote a ser programada.
LeadIds String Verdadeiro Uma lista separada por vírgulas de IDs de leads para entrada.
Status String Verdadeiro Programar o status do registro.

Para saber como configurar a ação UpdateLeadProgramStatus, consulte Exemplos de ação.

Ação "RemoveLeadsFromList"

Remove leads de uma lista no Marketo.

Parâmetros de entrada da ação RemoveLeadsFromList

Nome do parâmetro Tipo de dados Obrigatório Descrição
ListId String Verdadeiro O ID da lista de onde os leads serão removidos.
LeadId String Verdadeiro Uma lista separada por vírgulas de IDs de leads a serem removidos da lista especificada por ListId.

Para saber como configurar a ação RemoveLeadsFromList, consulte Exemplos de ação.

Ação ImportCustomObjectsFromFile

Importa objetos personalizados de um arquivo para o Marketo.

Parâmetros de entrada da ação ImportCustomObjectsFromFile

Nome do parâmetro Tipo de dados Obrigatório Descrição
Arquivo String Verdadeiro O caminho do arquivo que contém objetos personalizados a serem importados para o Marketo, por exemplo, "C:\temp\custom_object_import.csv".
TableName String Verdadeiro O nome da tabela de objetos personalizados. Exemplo: CustomObject_test
Formato String Verdadeiro O formato do arquivo que será usado para importar objetos personalizados para o Marketo. Os valores permitidos são csv, tsv e ssv.
Conteúdo String Verdadeiro O conteúdo como InputStream a ser enviado quando o arquivo não for especificado.

Para saber como configurar a ação ImportCustomObjectsFromFile, consulte Exemplos de ação.

Exemplos de ações

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

Exemplo: AddLandingPageContentSection

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação AddLandingPageContentSection e clique em Concluído.
  3. Na seção Mapeamento de dados, Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input: 
    {
  "LandingPageId": "1005",
  "ContentId": "1120",
  "Type": "HTML"
}

    4. Este exemplo mostra os registros de objeto específicos. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa CampaignTest terá um valor semelhante a este:

     
[{
  "Id": "1130",
  "json:repeatelementorder": "id",
  "requestsuccess": "true",
  "@affectedrows": "1"
}]

Exemplo: DeleteLandingPageContentSection

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação DeleteLandingPageContentSection e clique em Concluído.
  3. Na seção Mapeamento de dados, Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input: 
    {
  "LandingPageId": "1005",
  "ContentId": "1009"
}

    4. Este exemplo mostra os registros de objeto específicos. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa DeleteLandingPageContentSection terá um valor semelhante a este:

     
[{
  "Id": "1005",
  "json:repeatelementorder": "id",
  "requestsuccess": "true",
  "@affectedrows": "1"
}]

Exemplo: UpdateEmailContent

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação UpdateEmailContent e clique em Concluído.
  3. Na seção Mapeamento de dados, Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input: 
     {
  "EmailId": "1001",
  "FromName": "test",
  "FromEmail": "222larabrown@gmail.com",
  "Subject": "TestSubject Line",
  "ReplyTo": "222larabrown@gmail.com"
}

    4. Este exemplo mostra os registros de objeto específicos. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa UpdateEmailContent terá um valor semelhante a este:

     
[{
  "Id": "1001",
  "json:repeatelementorder": "id",
  "requestsuccess": "true"
}]

Exemplo: UpdateLandingPageContentSection

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação UpdateLandingPageContentSection e clique em Concluído.
  3. Na seção Mapeamento de dados, Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input: 
    {
  "Type": "HTML",
  "Value": "
Test Update
",
  "LandingPageId": "1005",
  "ContentId": "1120"
}

    4. Este exemplo mostra os registros de objeto específicos. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa UpdateLandingPageContentSection terá um valor semelhante a este:

     
[{
  "Id": "1005",
  "json:repeatelementorder": "id",
  "requestsuccess": "true",
  "@affectedrows": "1"
}]

Exemplo: GetImportProgramMembersStatus

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação GetImportProgramMembersStatus e clique em Concluído.
  3. Na seção Mapeamento de dados, Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input: 
    {
  "BatchId": "1029"
}

    4. Este exemplo mostra os registros de objeto específicos. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa GetImportProgramMembersStatus terá um valor semelhante a este:

     
[{
  "BatchId": "1029",
  "Status": "Complete",
  "NumOfLeadsProcessed": "3",
  "NumOfRowsFailed": "0",
  "NumOfRowsWithWarning": "3",
  "Message": "Import succeeded, 3 records imported (3 members), 3 warning.",
  "importid": "1029",
  "requestsuccess": "true"
}]

Exemplo: ScheduleCampaign

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação ScheduleCampaign e clique em Concluído.
  3. Na seção Mapeamento de dados, Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input: 
    {
  "CampaignId": "1065",
  "RunAt": "2024-05-23T18:05:00+0000"
}

    4. Este exemplo mostra os registros de objeto específicos. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa ScheduleCampaign terá um valor semelhante a este:

     
[{
  "Success": "true",
  "id": "1065",
  "json:repeatelementorder": "id",
  "requestsuccess": "true"
}]

Exemplo: ListMembersOfList

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação ListMembersOfList e clique em Concluído.
  3. Na seção Mapeamento de dados, Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input: 
    {
  "ListId": "1003",
  "LeadId": "13,25,21"
}

    4. Este exemplo mostra os registros de objeto específicos. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa ListMembersOfList terá um valor semelhante a este:

     
[{
  "LeadId": "13",
  "Status": "notmemberof",
  "ReasonCode": null,
  "ReasonMessage": null,
  "id": "13",
  "requestsuccess": "true"
}, {
  "LeadId": "25",
  "Status": "notmemberof",
  "ReasonCode": null,
  "ReasonMessage": null,
  "id": "25",
  "requestsuccess": "true"
}, {
  "LeadId": "21",
  "Status": "notmemberof",
  "ReasonCode": null,
  "ReasonMessage": null,
  "id": "21",
  "requestsuccess": "true"
}]

Exemplo: associado a lead

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação AssociateLead e clique em Concluído.
  3. Na seção Mapeamento de dados, Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input: 
    {
  "LeadId": 582.0,
  "Cookie": "id:703-VQQ-088%26token:_mch-marketo.com-_mch-mktoweb.com-1717156982039-98850"
}

    4. Este exemplo mostra os registros de objeto específicos. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa AssociateLead terá um valor semelhante a este:

     
 [{
  "Status": "Success"
}]

Exemplo: MergeLeads

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação MergeLeads e clique em Concluído.
  3. Na seção Mapeamento de dados, Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input: 
     {
  "LoosingLeadId": "10",
  "WinningLeadId": "45"
}

    4. Este exemplo mostra os registros de objeto específicos. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa MergeLeads terá um valor semelhante a este:

     
  [{
  "Status": "Success"
}]

Exemplo: GetImportLeadsStatus

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação GetImportLeadsStatus e clique em Concluído.
  3. Na seção Mapeamento de dados, Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input: 
    {
  "BatchId": "1022"
}

    4. Este exemplo mostra os registros de objeto específicos. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa GetImportLeadsStatus terá um valor semelhante a este:

     
 [{
  "BatchId": "1022",
  "Status": "Complete",
  "NumOfLeadsProcessed": "3",
  "NumOfRowsFailed": "0",
  "NumOfRowsWithWarning": "0",
  "Message": "Import succeeded, 3 records imported (3 members)",
  "importid": "1022",
  "requestsuccess": "true"
}]

Exemplo: cancelar um job de exportação

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação CancelExportJob e clique em Concluído.
  3. Na seção Mapeamento de dados, Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input: 
    {
  "JobId": "ddf64e6f-0e9c-4254-91a9-32277349a22b",
  "Type": "Leads"
}

    4. Este exemplo mostra os registros de objeto específicos. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa CancelExportJob terá um valor semelhante a este:

     
[{
  "JobId": "ddf64e6f-0e9c-4254-91a9-32277349a22b",
  "JobStatus": "Cancelled",
  "Format": "CSV",
  "CreatedAt": "2024-05-28T05:45:13Z",
  "StartedAt": null,
  "QueuedAt": null,
  "exportid": null,
  "json:repeatelementorder": null,
  "status": null,
  "requestsuccess": null
}]

Exemplo: EnqueueExportJob

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação EnqueueExportJob e clique em Concluído.
  3. Na seção Mapeamento de dados, Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input: 
    {
  "JobId": "d04f60fb-5e68-40b5-9928-76fdb9034303",
  "Type": "Leads"
}

    4. Este exemplo mostra os registros de objeto específicos. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa EnqueueExportJob terá um valor semelhante a este:

     
[{
  "JobId": "d04f60fb-5e68-40b5-9928-76fdb9034303",
  "JobStatus": "Queued",
  "Format": "CSV",
  "CreatedAt": "2024-05-27T12:12:53Z",
  "QueuedAt": "2024-05-27T12:13:20Z",
  "exportid": null,
  "json:repeatelementorder": null,
  "status": null,
  "requestsuccess": null
}]

Exemplo: GetExportJobStatus

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação GetExportJobStatus e clique em Concluído.
  3. Na seção Mapeamento de dados, Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input: 
    {
  "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
  "Type": "Leads"
}

    4. Este exemplo mostra os registros de objeto específicos. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa GetExportJobStatus terá um valor semelhante a este:

     
[{
  "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
  "Format": "CSV",
  "CreatedAt": "2024-05-23T10:12:09Z",
  "JobStatus": "Created",
  "QueuedAt": null,
  "StartedAt": null,
  "FinishedAt": null,
  "NumberOfRecords": null,
  "FileSize": null,
  "exportid": null,
  "status": null,
  "requestsuccess": null
}]

Exemplo: CreateEmailTemplate

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação CreateEmailTemplate e clique em Concluído.
  3. Na seção Mapeamento de dados, Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input: 
    {
  "FolderId": 27.0,
  "FolderType": "Folder",
  "Content": "\n\n\n \n
My First Heading
\n
My first paragraph.

\n \n\n",
  "Name": "Test1718166502676",
  "Filename": "FileName1718166502678"
}

    4. Este exemplo mostra os registros de objeto específicos. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa CreateEmailTemplate terá um valor semelhante a este:

     
[{
  "Id": "1048",
  "createdat": "2024-06-12T04:28:23Z+0000",
  "folder_type": "Folder",
  "workspace": "Default",
  "folder_foldername": "Templates",
  "name": "Test1718166502676",
  "version": "2",
  "requestsuccess": "true",
  "url": "https://app-abc.marketo.com/#ET1048B2ZN27",
  "folder_value": "27",
  "updatedat": "2024-06-12T04:28:23Z+0000",
  "status": "draft"
}]

Exemplo: UpdateLeadProgramStatus

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação UpdateLeadProgramStatus e clique em Concluído.
  3. Na seção Mapeamento de dados, Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input: 
    {
  "ProgramId": "1002",
  "Status": "Member",
  "LeadIds": "3"
}

    4. Este exemplo mostra os registros de objeto específicos. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa UpdateLeadProgramStatus terá um valor semelhante a este:

     
[{
  "Success": "true",
  "id": "3",
  "status": "updated",
  "requestsuccess": "true"
}]

Exemplo: RemoveLeadsFromList

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação RemoveLeadsFromList e clique em Concluído.
  3. Na seção Mapeamento de dados, Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input: 
     {
  "ListId": "1026",
  "LeadId": "57"
}

    4. Este exemplo mostra os registros de objeto específicos. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa RemoveLeadsFromList terá um valor semelhante a este:

     
[{
  "LeadId": "57",
  "Status": "skipped",
  "ReasonCode": "1015",
  "ReasonMessage": "Lead not in list",
  "id": "57",
  "requestsuccess": "true"
}]

Exemplo: ImportCustomObjectsFromFile

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação ImportCustomObjectsFromFile e clique em Concluído.
  3. Na seção Mapeamento de dados, Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input: 
    {
  "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
  "Type": "Leads"
}

    4. Este exemplo mostra os registros de objeto específicos. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa ImportCustomObjectsFromFile terá um valor semelhante a este:

     
[{
  "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
  "Format": "CSV",
  "CreatedAt": "2024-05-23T10:12:09Z",
  "JobStatus": "Created",
  "QueuedAt": null,
  "StartedAt": null,
  "FinishedAt": null,
  "NumberOfRecords": null,
  "FileSize": null,
  "exportid": null,
  "status": null,
  "requestsuccess": null
}]

Exemplos de operações de entidade

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

Quando você usa uma operação de lista e espera que o volume de dados seja alto, recomendamos especificar uma cláusula de filtro para as seguintes entidades: LeadsLists, LeadPrograms, Activities, LandingPageContentSec, LeadChanges, LeadChangesFields, Emails, LandingPages, Forms, Programs, Leads, LandingPageTemplateCon, OpportunityRoles, SalesPersons, Tokens, ListStaticMemberShip, Opportunities, LeadChangesAttributes e Segments. Além disso, para classificar o conjunto de resultados, primeiro é necessário aplicar a cláusula de filtro.

Exemplo: listar todos os e-mails

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione "E-mails" na lista Entity.
  3. Selecione a operação List e clique em Concluído.

Exemplo: receber campanhas inteligentes únicas

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione "Smart Campaigns" na lista Entity.
  3. Selecione a operação Get e clique em Concluído.
  4. Defina o ID da entidade como "Get single SmartCampaigns". Para definir o ID da entidade, na seção Data Mapper do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e digite 1002 no campo Valor de entrada e escolha o EntityId como variável local.

Exemplo: excluir e-mails

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione "E-mails" na lista Entity.
  3. Selecione a operação Delete e clique em Concluído.
  4. Defina o ID da entidade como "Excluir e-mails". Para definir o ID da entidade, na seção Data Mapper do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e digite 1048.0 no campo Valor de entrada e escolha o EntityId como variável local.

Exemplo: criar e-mails

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione "E-mails" na lista Entity.
  3. Selecione a operação Create e clique em Concluído.
  4. Na seção Mapeador de dados da Tarefa, clique no editor OpenDataMapping e insira um valor semelhante ao seguinte no field:: 
     {
"Template": 1.0,
"FolderId": 1002.0,
"Name": "Test Email",
"FolderType": "Program"
}

    Running this example, returns a response similar to the following in the Connector
task's connectorOutputPayload output variable:
    

    {
"Id": "1048.0"
}

Exemplo: atualizar EmailTemplates

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione EmailTemplates na lista Entity.
  3. Selecione a operação Update e clique em Concluído.
  4. Defina o EntityID para atualizar um EmailTemplates. Para definir o EntityID, na seção Data mapper das Tarefas, clique em EntityID e insira 1034.0 no campo fornecido.
  5. Na seção Mapeador de dados da Tarefa, clique no editor OpenDataMapping e insira um valor semelhante ao seguinte no field: 
     
{
"Name": "temp email updated",
"Description": "updation"
}

    6. A execução desse exemplo retorna uma resposta semelhante a esta na variável de saída connectorOutputPayload da tarefa do conector:

    {
"Id": 1034.0
}

Receber ajuda da comunidade do Google Cloud

Poste suas dúvidas e converse sobre esse conector na comunidade do Google Cloud em Fóruns do Cloud.

A seguir