Marketo

Com o conector do Marketo, você realiza 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 o papel do 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. O conector e a conta de serviço precisam pertencer ao mesmo projeto. 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 exceder 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.

      Os seguintes tipos de autenticação são compatíveis com a conexão do Marketo:

      • 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 do 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, o Integration Connectors aloca 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 no Application Integration. É possível usar a conexão em uma integração pela tarefa "Conectores".

  • Para entender como criar e usar a tarefa "Conectores" na integração da Apigee, consulte Tarefa "Conectores".
  • 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ções.

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 Image, Form, Rectangle, Snippet, RichText e HTML.

Para ver um exemplo de como configurar a ação AddLandingPageContentSection, consulte Exemplos de ações.

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 ver um exemplo de como configurar a ação DeleteLandingPageContentSection, consulte Exemplos de ações.

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 do remetente 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 ver um exemplo de como configurar a ação UpdateEmailContent, consulte Exemplos de ações.

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 Image, Form, Rectangle, 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 ver um exemplo de como configurar a ação UpdateLandingPageContentSection, consulte Exemplos de ações.

Ação "GetImportProgramMembersStatus"

Recebe o status de uma operação de importação de membros do programa de um 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 importação de leads.

Para ver um exemplo de como configurar a ação GetImportProgramMembersStatus, consulte Exemplos de ações.

Ação ScheduleCampaign

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 em que a campanha será veiculada. Se não for definido, a campanha será veiculada cinco minutos após a chamada.

Para ver um exemplo de como configurar a ação ScheduleCampaign, consulte Exemplos de ações.

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 para verificar leads.
LeadId String Verdadeiro Uma lista separada por vírgulas de IDs de lead a serem verificados para saber se estão na lista especificada por "ListId".

Para ver um exemplo de como configurar a ação ListMembersOfList, consulte Exemplos de ações.

Ação AssociateLead

Associa um registro de lead conhecido do Marketo a um cookie munchkin e ao histórico de atividades 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 ver um exemplo de como configurar a ação AssociateLead, consulte Exemplos de ações.

Ação MergeLeads

Mescla 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 lead perdidos

Para ver um exemplo de como configurar a ação MergeLeads, consulte Exemplos de ações.

Ação GetImportLeadsStatus

Recebe o status de uma operação de importação de leads de arquivo 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 importação de leads.

Para ver um exemplo de como configurar a ação GetImportLeadsStatus, consulte Exemplos de ações.

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 : Activities, Leads, ProgramMembers. Os valores permitidos são Activities, Leads, ProgramMembers.

Para ver um exemplo de como configurar a ação CancelExportJob, consulte Exemplos de ações.

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 : Activities, Leads, ProgramMembers. Os valores permitidos são "Activities", "Leads" e "ProgramMembers".

Para ver um exemplo de como configurar a ação EnqueueExportJob, consulte Exemplos de ações.

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 : Activities, Leads, ProgramMembers. Os valores permitidos são "Activities", "Leads" e "ProgramMembers".

Para ver um exemplo de como configurar a ação GetExportJobStatus, consulte Exemplos de ações.

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 do modelo de e-mail. Precisa ser exclusivo na pasta mãe.
Arquivo String Verdadeiro Arquivo de várias partes. Conteúdo HTML do modelo.

Para ver um exemplo de como configurar a ação CreateEmailTemplate, consulte Exemplos de ações.

Ação UpdateLeadProgramStatus

Muda o status do programa de uma lista de leads em um programa de destino. Somente os membros atuais do programa podem ter o status 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 lead para entrada.
Status String Verdadeiro Status do programa do registro.

Para ver exemplos de como configurar a ação UpdateLeadProgramStatus, consulte Exemplos de ações.

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 remover os leads.
LeadId String Verdadeiro Uma lista separada por vírgulas de IDs de lead a serem removidos da lista especificada por "ListId".

Para ver um exemplo de como configurar a ação RemoveLeadsFromList, consulte Exemplos de ações.

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 para o arquivo que contém os objetos personalizados a serem importados para o Marketo, ou seja, "C:\temp\custom_object_import.csv".
TableName String Verdadeiro O nome da tabela de objetos personalizados. Ex: 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 é especificado.

Para ver exemplos de como configurar a ação ImportCustomObjectsFromFile, consulte Exemplos de ações.

Exemplos de ações

Nesta seção, descrevemos como executar 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: AssociateLead

  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

Nesta seção, mostramos como realizar algumas das operações de entidade neste conector.

Quando você usa uma operação de lista e espera um volume alto de dados, 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 aplique 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 uma única SmartCampaign

  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 Data Mapping, clique em Open Data Mapping Editor e digite 1002 no campo Input Value. Escolha 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 Data Mapping, clique em Open Data Mapping Editor e digite 1048.0 no campo Input Value. Escolha 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 em 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 como "Update a EmailTemplates". Para definir o EntityID, na seção Data mapper de Tasks, clique em EntityID e insira 1034.0 no campo indicado.
  5. Na seção Mapeador de dados da Tarefa, clique no editor OpenDataMapping e insira um valor semelhante ao seguinte em field: 
     
{
"Name": "temp email updated",
"Description": "updation"
}

    6. A execução deste exemplo retorna uma resposta semelhante à seguinte 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