Marketo

O conetor do Marketo permite-lhe realizar operações de inserção, eliminação, atualização e leitura em dados do Marketo.

Antes de começar

Antes de usar o conector do Marketo, conclua 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.

      As regiões suportadas para conetores incluem:

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

    2. Clicar em Seguinte.
  4. Na secção Detalhes da associação, conclua o seguinte:
    1. Conetor: selecione Marketo 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. Conta de serviço: selecione uma conta de serviço que tenha as funções necessárias.
    6. 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.

    7. Opcionalmente, clique em + Adicionar etiqueta para adicionar uma etiqueta à associação sob a forma de um par chave/valor.
    8. Clicar em Seguinte.
  5. Na secção Destinos, introduza os detalhes do anfitrião remoto (sistema de back-end) ao qual quer estabelecer ligação.
    1. Tipo de destino: pode especificar os detalhes do destino como um endereço de anfitrião ou um anexo de serviço. Selecione um dos seguintes tipos de destinos:
      • Endereço do anfitrião: se quiser especificar o nome de anfitrião ou o endereço IP do destino.
      • Associação de serviços: se quiser especificar o ponto final privado para os seus endereços IP internos. A associação de serviços permite-lhe ocultar os seus endereços IP internos da rede externa. Pode criar uma associação do serviço no Google Cloud através da funcionalidade Private Service Connect. Para obter informações sobre a configuração de um Private Service Connect, consulte o artigo Publique serviços geridos.

      Com base na sua seleção do tipo de destino, introduza o endereço do anfitrião ou o nome da associação de serviço.

      Para introduzir destinos adicionais, clique em +Adicionar destino.

    2. Clicar em Seguinte.
  6. Na secção Autenticação, introduza os detalhes de autenticação.
    1. Selecione um Tipo de autenticação e introduza os detalhes relevantes.

      Os seguintes tipos de autenticação são suportados pela ligação do Marketo:

      • Credenciais de cliente OAuth 2.0
      • Nome de utilizador e palavra-passe

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

    2. Clicar em Seguinte.
  7. Rever: reveja os detalhes da ligação e da autenticação.
  8. Clique em Criar.

Configure a autenticação

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

  • Credenciais de cliente OAuth 2.0
    • ID de cliente: o ID de cliente fornecido pelo conector para a app que criou.
    • Segredo do cliente: segredo do Secret Manager que contém o segredo do cliente da app associada que criou.
  • Nome de utilizador e palavra-passe
    • UserId: o ID do utilizador da API SOAP da Marketo.
    • EncryptionKey: segredo do Secret Manager que contém a chave de encriptação da API SOAP do Marketo.

Limitações do sistema

O conector do Marketo pode processar 1 transação 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.

Use a ligação do Marketo 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.

Ações

Esta secção apresenta as ações suportadas pelo conetor. Para compreender como configurar as ações, consulte os exemplos de ações.

Ação AddLandingPageContentSection

Adiciona uma secçã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ória Descrição
LandingPageId String True ID da página de destino
ContentId String True ID da secção de conteúdo. Também o ID HTML da secção.
Tipo String True Tipo de secção de conteúdo. Os valores permitidos são Image, Form, Rectangle, Snippet, RichText e HTML.

Por exemplo, para saber como configurar a ação AddLandingPageContentSection, consulte os exemplos de ações.

Ação DeleteLandingPageContentSection

Elimina a secçã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ória Descrição
LandingPageId String True ID da página de destino.
ContentId String True ID da secção de conteúdo. Também o ID HTML da secção.

Por exemplo, para saber como configurar a ação DeleteLandingPageContentSection, consulte os exemplos de ações.

Ação UpdateEmailContent

Atualiza o conteúdo de um email.

Parâmetros de entrada da ação UpdateEmailContent

Nome do parâmetro Tipo de dados Obrigatória Descrição
EmailId String True O ID do email.
FromEmail String True Endereço De: do email
FromName String True Nome do remetente do email
ReplyTo String True Endereço de resposta do email
Assunto String True Linha de assunto do email

Por exemplo, para saber como configurar a ação UpdateEmailContent, consulte os exemplos de ações.

Ação UpdateLandingPageContentSection

Adicione ou atualize a secçã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ória Descrição
Tipo String True Secção do tipo de conteúdo.Os valores permitidos são Image, Form, Rectangle, Snippet, RichText e HTML.
Valor String True Tipo de secção de conteúdo.
LandingPageId String True ID da página de destino.
ContentId String True ID da secção de conteúdo. Também o ID HTML da secção.

Por exemplo, para saber como configurar a ação UpdateLandingPageContentSection, consulte os exemplos de ações.

Ação GetImportProgramMembersStatus

Obtém o estado dos membros de um programa de importação a partir da operação de ficheiro para o Marketo.

Parâmetros de entrada da ação GetImportProgramMembersStatus

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

Por exemplo, para saber como configurar a ação GetImportProgramMembersStatus, consulte os exemplos de ações.

Ação ScheduleCampaign

Agenda remotamente a execução de uma campanha em lote a uma determinada hora.

Introduza os parâmetros da ação ScheduleCampaign

Nome do parâmetro Tipo de dados Obrigatória Descrição
CampaignId String True ID da campanha em lote a agendar.
RunAt String True Data/hora em que a campanha deve ser apresentada. Se não estiver definido, a campanha é executada cinco minutos após a chamada ser feita.

Por exemplo, para saber como configurar a ação ScheduleCampaign, consulte os exemplos de ações.

Ação ListMembersOfList

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

Parâmetros de entrada da ação ListMembersOfList

Nome do parâmetro Tipo de dados Obrigatória Descrição
ListId String True O ID da lista para verificar leads.
LeadId String True Uma lista de IDs de leads separados por vírgulas a verificar se estão na lista especificada por ListId.

Por exemplo, para saber como configurar a ação ListMembersOfList, consulte os exemplos de ações.

Ação AssociateLead

Associa um registo de lead conhecido do Marketo a um cookie munchkin e ao respetivo histórico de atividade Web associado

Parâmetros de entrada da ação AssociateLead

Nome do parâmetro Tipo de dados Obrigatória Descrição
LeadId String True ID do lead a associar.
Cookie String True O valor do cookie a associar

Por exemplo, para saber como configurar a ação AssociateLead, consulte os exemplos de ações.

Ação MergeLeads

Unir dois ou mais registos de leads conhecidos num único registo de lead.

Introduza os parâmetros da ação MergeLeads

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

Por exemplo, para saber como configurar a ação MergeLeads, consulte os exemplos de ações.

Ação GetImportLeadsStatus

Obtém o estado de uma operação de importação de leads a partir de um ficheiro para o Marketo.

Parâmetros de entrada da ação GetImportLeadsStatus

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

Por exemplo, para saber como configurar a ação GetImportLeadsStatus, consulte os exemplos de ações.

Ação CancelExportJob

Cancela um trabalho de exportação.

Parâmetros de entrada da ação CancelExportJob

Nome do parâmetro Tipo de dados Obrigatória Descrição
JobId String True O ID da tarefa de exportação.
Tipo String True O tipo de objeto do BulkExtract. Os valores disponíveis são : Activities, Leads, ProgramMembers Os valores permitidos são Activities, Leads e ProgramMembers.

Por exemplo, para saber como configurar a ação CancelExportJob, consulte os exemplos de ações.

Ação EnqueueExportJob

Coloca uma tarefa de exportação na fila e inicia a tarefa quando os recursos de computação ficam disponíveis.

Introduza os parâmetros da ação EnqueueExportJob

Nome do parâmetro Tipo de dados Obrigatória Descrição
JobId String True O ID da tarefa de exportação.
Tipo String True O tipo de objeto do BulkExtract. Os valores disponíveis são : Activities, Leads e ProgramMembers. Os valores permitidos são Activities, Leads e ProgramMembers.

Por exemplo, para saber como configurar a ação EnqueueExportJob, consulte os exemplos de ações.

Ação GetExportJobStatus

Devolve o estado de uma tarefa de exportação. O estado da tarefa está disponível durante 30 dias após ter sido atingido o estado Concluído ou Falhou.

Parâmetros de entrada da ação GetExportJobStatus

Nome do parâmetro Tipo de dados Obrigatória Descrição
JobId String True O ID da tarefa de exportação.
Tipo String True O tipo de objeto do BulkExtract. Os valores disponíveis são : Activities, Leads e ProgramMembers. Os valores permitidos são Activities, Leads e ProgramMembers.

Por exemplo, para saber como configurar a ação GetExportJobStatus, consulte os exemplos de ações.

Ação CreateEmailTemplate

Cria um novo modelo de email.

Parâmetros de entrada da ação CreateEmailTemplate

Nome do parâmetro Tipo de dados Obrigatória Descrição
FolderId String True O ID da pasta
FolderType String True O tipo de pasta.
Nome String True O nome do modelo de email. Tem de ser único na pasta principal.
Ficheiro String True Ficheiro multipartes. Conteúdo HTML para o modelo.

Por exemplo, para saber como configurar a ação CreateEmailTemplate, consulte os exemplos de ações.

Ação UpdateLeadProgramStatus

Altera o estado do programa de uma lista de leads num programa de destino. Apenas os membros existentes do programa podem ter o respetivo estado alterado com esta API.

Parâmetros de entrada da ação UpdateLeadProgramStatus

Nome do parâmetro Tipo de dados Obrigatória Descrição
ProgramId String True ID da campanha em lote a agendar.
LeadIds String True Uma lista de IDs de leads separados por vírgulas para introdução.
Estado String True Estado do programa do registo.

Por exemplo, para saber 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ória Descrição
ListId String True O ID da lista da qual remover leads.
LeadId String True Uma lista de IDs de leads separados por vírgulas a serem removidos da lista especificada por ListId.

Por exemplo, para saber como configurar a ação RemoveLeadsFromList, consulte os exemplos de ações.

Ação ImportCustomObjectsFromFile

Importa objetos personalizados de um ficheiro para o Marketo.

Parâmetros de entrada da ação ImportCustomObjectsFromFile

Nome do parâmetro Tipo de dados Obrigatória Descrição
Ficheiro String True O caminho para o ficheiro que contém objetos personalizados a importar para o Marketo, ou seja, "C:\temp\custom_object_import.csv".
TableName String True O nome da tabela de objetos personalizados. Por exemplo: CustomObject_test
Formato String True O formato do ficheiro que vai ser usado para importar objetos personalizados para o Marketo. Os valores permitidos são csv, tsv e ssv.
Conteúdo String True O conteúdo como InputStream a carregar quando o ficheiro não é especificado.

Por exemplo, para saber como configurar a ação ImportCustomObjectsFromFile, consulte Exemplos de ações.

Exemplos de ações

Esta secçã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, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input: 
    {
  "LandingPageId": "1005",
  "ContentId": "1120",
  "Type": "HTML"
}

    4. Este exemplo mostra os registos de objetos específicos. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:CampaignTestconnectorOutputPayload

     
[{
  "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, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input: 
    {
  "LandingPageId": "1005",
  "ContentId": "1009"
}

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

     
[{
  "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, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados Open Data Mapping Editor e, de seguida, introduza 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 registos de objetos específicos. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:UpdateEmailContentconnectorOutputPayload

     
[{
  "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, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input: 
    {
  "Type": "HTML",
  "Value": "
Test Update
",
  "LandingPageId": "1005",
  "ContentId": "1120"
}

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

     
[{
  "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, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input: 
    {
  "BatchId": "1029"
}

    4. Este exemplo mostra os registos de objetos específicos. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:GetImportProgramMembersStatusconnectorOutputPayload

     
[{
  "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, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input: 
    {
  "CampaignId": "1065",
  "RunAt": "2024-05-23T18:05:00+0000"
}

    4. Este exemplo mostra os registos de objetos específicos. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:ScheduleCampaignconnectorOutputPayload

     
[{
  "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, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input: 
    {
  "ListId": "1003",
  "LeadId": "13,25,21"
}

    4. Este exemplo mostra os registos de objetos específicos. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:ListMembersOfListconnectorOutputPayload

     
[{
  "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, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados Open Data Mapping Editor e, de seguida, introduza 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 registos de objetos específicos. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:AssociateLeadconnectorOutputPayload

     
 [{
  "Status": "Success"
}]

Exemplo: MergeLeads

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

    4. Este exemplo mostra os registos de objetos específicos. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:MergeLeadsconnectorOutputPayload

     
  [{
  "Status": "Success"
}]

Exemplo: GetImportLeadsStatus

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

    4. Este exemplo mostra os registos de objetos específicos. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:GetImportLeadsStatusconnectorOutputPayload

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

Exemplo: cancelar uma tarefa de exportação

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

    4. Este exemplo mostra os registos de objetos específicos. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:CancelExportJobconnectorOutputPayload

     
[{
  "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, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input: 
    {
  "JobId": "d04f60fb-5e68-40b5-9928-76fdb9034303",
  "Type": "Leads"
}

    4. Este exemplo mostra os registos de objetos específicos. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:EnqueueExportJobconnectorOutputPayload

     
[{
  "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, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input: 
    {
  "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
  "Type": "Leads"
}

    4. Este exemplo mostra os registos de objetos específicos. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:GetExportJobStatusconnectorOutputPayload

     
[{
  "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, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados Open Data Mapping Editor e, de seguida, introduza 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 registos de objetos específicos. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:CreateEmailTemplateconnectorOutputPayload

     
[{
  "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, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input: 
    {
  "ProgramId": "1002",
  "Status": "Member",
  "LeadIds": "3"
}

    4. Este exemplo mostra os registos de objetos específicos. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:UpdateLeadProgramStatusconnectorOutputPayload

     
[{
  "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, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input: 
     {
  "ListId": "1026",
  "LeadId": "57"
}

    4. Este exemplo mostra os registos de objetos específicos. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:RemoveLeadsFromListconnectorOutputPayload

     
[{
  "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, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input: 
    {
  "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
  "Type": "Leads"
}

    4. Este exemplo mostra os registos de objetos específicos. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:ImportCustomObjectsFromFileconnectorOutputPayload

     
[{
  "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 entidades

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

Quando usa uma operação de lista e espera um volume de dados elevado, recomendamos que especifique 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 ordenar o conjunto de resultados, tem de aplicar primeiro a cláusula de filtro.

Exemplo: listar todos os emails

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

Exemplo: obtenha campanhas inteligentes individuais

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione SmartCampaigns na lista Entity.
  3. Selecione a operação Get e, de seguida, clique em Concluído.
  4. Defina o ID da entidade para obter campanhas inteligentes únicas. Para definir o ID da entidade, na secção Mapeador de dados do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e, em seguida, introduza 1002 no campo Valor de entrada e escolha EntityId como variável local.

Exemplo: elimine emails

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Emails na lista Entity.
  3. Selecione a operação Delete e, de seguida, clique em Concluído.
  4. Defina o ID da entidade como Eliminar emails. Para definir o ID da entidade, na secção Mapeador de dados do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e, em seguida, introduza 1048.0 no campo Valor de entrada e escolha EntityId como variável local.

Exemplo: criar emails

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Emails na lista Entity.
  3. Selecione a operação Create e, de seguida, clique em Concluído.
  4. Na secção Mapeador de dados da Tarefa, clique no editor OpenDataMapping e, de seguida, introduza 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, de seguida, clique em Concluído.
  4. Defina o EntityID para atualizar um EmailTemplates. Para definir o EntityID, na secção Mapeador de dados de Tarefas, clique em EntityID e, em seguida, introduza 1034.0 no campo indicado.
  5. Na secção Mapeador de dados da Tarefa, clique no editor de OpenDataMapping e, de seguida, introduza um valor semelhante ao seguinte em field: 
     
{
"Name": "temp email updated",
"Description": "updation"
}

    6. A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conetor:

    {
"Id": 1034.0
}

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?