Detalhes da Conexão do Marketo

Introdução

Versão do conector

Esta documentação é baseada na versão 21.0.8257 do conector.

Começando

Suporte à versão Marketo

O conector permite o acesso SQL92 às entidades disponíveis por meio da versão 1 da API REST e da versão 2.6 da API SOAP.

Estabelecendo uma Conexão

As APIs REST e SOAP são suportadas e podem ser escolhidas usando Schema propriedade.

Conectando-se à API REST do Marketo

Antes de se conectar à API REST do Marketo, você precisará criar um serviço personalizado.

Criando um Serviço Personalizado

Para criar um serviço personalizado, siga o procedimento abaixo:

1. Navegue até a área administrativa de seu aplicativo Marketo.
2. Clique em Users & Roles na seção Segurança.
3. Selecione o Roles aba e clique New Role para criar uma nova Função.
4. Insira um Nome de Função e selecione as permissões para a Função. As permissões da API do Access são específicas da API REST.
5. Agora que uma função de API foi criada, selecione Users e clique em Convidar novo usuário.
6. Insira as novas informações do usuário e selecione a papel que acabou de ser criada com acesso à API. A opção API Only pode ser selecionada para denotar o usuário como um usuário API Only.
7. Agora que um novo usuário foi criado, será necessário criar um novo serviço. Clique no LaunchPoint opção (Admin -> Integração -> LaunchPoint).
8. Clique em New Service.
9. Selecione o tipo de serviço Personalizado e insira um nome de exibição e uma descrição.
10. Selecione o usuário que você criou.

Obtendo Credenciais OAuth

Para obter o OAuthClientId e OAuthClientSecret, navegue até LaunchPoint opção na área Admin.

Clique no View Details link para o serviço desejado. Uma janela contendo as credenciais de autenticação é exibida.

Autenticação para a API REST

Depois de criar um serviço personalizado e obter suas credenciais OAuth, defina o seguinte para se conectar aos dados:

• Schema: Defina para REST.

• OAuthClientId: O ID do cliente OAuth associado ao seu serviço personalizado.

• OAuthClientSecret: O segredo do cliente OAuth associado ao seu serviço personalizado.

• RESTEndpoint: A URL do endpoint do serviço Web REST. Isso pode ser encontrado na área Admin do Marketo em Integração -> Opção Web Services na seção API REST.

  O Identity Endpoint não será necessário.

Conectando-se à API SOAP do Marketo

Para se conectar à API SOAP, você precisará fornecer credenciais válidas do Marketo. Especifique o seguinte para se conectar aos dados:

• Schema: Defina para SOAP.
• UserId: O ID de acesso do cliente é encontrado no painel SOAP API do administrador do Marketo em Integração.
• EncryptionKey: A chave de criptografia da Marketo SOAP API. Essa chave é gerada na página Admin do site Marketo.
• SOAPEndpoint: A URL do endpoint do serviço da Web SOAP, fornecida pelo Marketo na página Admin do site do Marketo.

Anotações Importantes

Procedimentos Armazenados

• Os recursos de procedimentos armazenados descritos nesta documentação não são suportados no momento.
• Como os procedimentos armazenados não são suportados atualmente, qualquer recurso dependente de procedimentos armazenados também não é suportado atualmente.

Arquivos de Configuração e Seus Caminhos

• Todas as referências para adicionar arquivos de configuração e seus caminhos referem-se a arquivos e locais no Harmony Agente onde o conector está instalado. Esses caminhos devem ser ajustados conforme apropriado, dependendo do agente e do sistema operacional. Se vários agentes forem usados em um grupo de agentes, arquivos idênticos serão necessários em cada agente.

Características Avançadas

Esta seção detalha uma seleção de recursos avançados do conector Marketo.

Visualizações definidas pelo usuário

O conector permite definir tabelas virtuais, denominadas visões definidas pelo usuário, cujo conteúdo é decidido por uma consultar pré-configurada. Essas exibições são úteis quando você não pode controlar diretamente as consultas enviadas aos drivers. Consulte Visualizações definidas pelo usuário para obter uma visão geral da criação e configuração de exibições personalizadas.

Configuração SSL

Use Configuração SSL para ajustar como o conector lida com as negociações de certificado TLS/SSL. Você pode escolher entre vários formatos de certificado; Veja o SSLServerCert propriedade em "Opções de cadeia de conexão" para obter mais informações.

Procurador

Para configurar o conector usando configurações de proxy do Agente Privado, selecione os Use Proxy Settings caixa de seleção na tela de configuração da conexão.

Visualizações Definidas pelo Usuário

O Jitterbit Connector for Marketo permite definir uma tabela virtual cujo conteúdo é decidido por uma consultar pré-configurada. Elas são chamadas de Visualizações Definidas pelo Usuário, que são úteis em situações onde você não pode controlar diretamente a consultar que está sendo emitida para o driver, por exemplo, ao usar o driver do Jitterbit. As Visualizações Definidas pelo Usuário podem ser usadas para definir predicados que são sempre aplicados. Se você especificar predicados adicionais na consultar para a visualização, eles serão combinados com a consultar já definida como parte da visualização.

Há duas maneiras de criar exibições definidas pelo usuário:

• Crie um arquivo de configuração em formato JSON definindo as visualizações desejadas.
• declarações DDL.

Definindo Visualizações Usando um Arquivo de Configuração

As visualizações definidas pelo usuário são definidas em um arquivo de configuração formatado em JSON chamado UserDefinedViews.json. O conector detecta automaticamente as visualizações especificadas neste arquivo.

Você também pode ter várias definições de exibição e controlá-las usando o UserDefinedViews propriedade de conexão. Quando você usa essa propriedade, apenas as exibições especificadas são vistas pelo conector.

Este arquivo de configuração de exibição definida pelo usuário é formatado da seguinte forma:

• Cada elemento raiz define o nome de uma visualização.
• Cada elemento raiz contém um elemento filho, chamado query, que contém a consultar SQL personalizada para a exibição.

Por exemplo:

{
    "MyView": {
        "query": "SELECT * FROM Leads WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Use o UserDefinedViews propriedade de conexão para especificar a localização do seu arquivo de configuração JSON. Por exemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Esquema para Exibições Definidas pelo Usuário

As visualizações definidas pelo usuário são expostas no UserViews esquema por padrão. Isso é feito para evitar que o nome da exibição entre em conflito com uma entidade real no modelo de dados. Você pode alterar o nome do esquema usado para UserViews definindo o UserViewsSchemaName propriedade.

Trabalhando com Exibições Definidas pelo Usuário

Por exemplo, uma instrução SQL com uma Visualização Definida pelo Usuário chamada UserViews.RCustomers lista apenas clientes em Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Exemplo de consultar ao driver:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Resultando na consultar efetiva à fonte:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Esse é um exemplo muito simples de uma consultar a uma exibição definida pelo usuário que é efetivamente uma combinação da consultar de exibição e da definição de exibição. É possível compor essas consultas em padrões muito mais complexos. Todas as operações SQL são permitidas em ambas as consultas e são combinadas quando apropriado.

Configuração SSL

Personalizando a Configuração SSL

Por padrão, o conector tenta negociar SSL/TLS verificando o certificado do servidor em relação ao armazenamento de certificados confiáveis do sistema.

Para especificar outro certificado, consulte o SSLServerCert propriedade para os formatos disponíveis para fazê-lo.

Modelo de Dados SOAP

O Jitterbit Connector for Marketo modela entidades Marketo em tabelas relacionais, exibições e procedimentos armazenados. As limitações e requisitos da API estão documentados nas seções a seguir; você pode usar o SupportEnhancedSQL recurso, definido por padrão, para contornar a maioria dessas limitações.

Observação: As operações em massa não são compatíveis com o modelo de dados SOAP.

Mesas

Tabelas descreve as tabelas disponíveis.

Visualizações

Visualizações são tabelas que não podem ser modificadas. Normalmente, os dados somente leitura são mostrados como exibições.

Tabelas

O conector modela os dados no Marketo em uma lista de tabelas que podem ser consultadas usando instruções SQL padrão.

Geralmente, consultar tabelas do Marketo é o mesmo que consultar uma tabela em um banco de dados relacional. Às vezes, há casos especiais, por exemplo, incluir uma determinada coluna na cláusula WHERE pode ser necessário para obter dados para determinadas colunas na tabela. Isso geralmente é necessário para situações em que uma solicitação separada deve ser feita para cada linha para obter determinadas colunas. Esses tipos de situações estão claramente documentados na parte superior da página da tabela vinculada abaixo.

Conector Jitterbit para Tabelas Marketo

Pistas

Crie, atualize, exclua e consultar Leads para uma organização Marketo.

Informações Específicas da Tabela

Selecione

Todas as colunas devem ser especificadas usando o operador '='. As colunas ID e E-mail permitem que vários valores sejam especificados usando o operador lógico OR. A coluna OldestUpdatedAt atua como um critério "desde" e um intervalo pode ser especificado adicionando a coluna LatestUpdatedAt, que especifica os critérios "até".

O tempo de resposta do servidor pode ser melhorado identificando apenas as linhas e colunas que você deseja recuperar.

SELECT Id, FirstName, LastName FROM Leads WHERE Email='test@lead1.com' OR Email='test@lead4.com'

Inserir

Para criar um novo registro de Lead, especifique as informações sobre o Lead a serem inseridas no banco de dados.

O exemplo a seguir demonstra como inserir um novo Lead:

INSERT INTO Leads (Email, FirstName, LastName) VALUES ('john@mark.com', 'John', 'Mark')

Atualizar

Qualquer campo que não seja somente leitura pode ser atualizado.

UPDATE Leads SET MobilePhone='111-222-3333' WHERE Id='1'

Excluir

A exclusão de um lead não é suportada diretamente pela API do Marketo. No entanto, um Lead pode ser excluído criando uma campanha, a ser executada por meio de uma chamada de API, que aciona a exclusão de um Lead como parte do fluxo da campanha. Detalhes sobre como criar uma campanha como esta podem ser encontrados aqui: http://developers.marketo.com/blog/delete-a-lead-with-the-marketo-api/

Depois que a campanha é criada no Marketo, uma solicitação de exclusão pode ser feita especificando a campanha com a coluna CampaignId ou CampaignName, juntamente com a coluna ID ou E-mail dos leads a serem excluídos.

DELETE FROM Leads WHERE Id='1000195' AND CampaignId='1027'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Programas

Consultar e atualizar Programas para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que as seguintes colunas sejam usadas na cláusula WHERE de uma consultar SELECT: Id, Name, CreatedAt, UpdatedAt, CRMId, TagType, TagValue, WorkspaceName, WorkspaceId e IncludeArchive. As colunas Id, Name e CRMId permitem que vários valores sejam especificados usando o operador lógico OR. Os filtros CreatedAt e UpdateAt podem ser especificados duas vezes para criar um intervalo de datas.

SELECT * FROM Programs WHERE CreatedAt > '08/01/2014' AND CreatedAt <= '08/31/2014'

Atualizar

Qualquer campo que não seja somente leitura pode ser atualizado.

Observe que as colunas Tag*** e Cost*** aceitam apenas um único valor. Portanto, eles não usam uma lista separada por vírgulas ao executar uma atualização.

UPDATE Programs SET TagType='Program Owner', TagValue='Admin', CostMonth='11/2014', CostAmount='30' WHERE Id='1002'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Visualizações

As exibições são compostas por colunas e pseudocolunas. As exibições são semelhantes às tabelas na forma como os dados são representados; no entanto, as exibições não oferecem suporte a atualizações. Entidades que são representadas como exibições são normalmente entidades somente leitura. Frequentemente, um procedimento armazenado* está disponível para atualizar os dados se tal funcionalidade for aplicável à fonte de dados.

As consultas podem ser executadas em uma exibição como se fosse uma tabela normal, e os dados retornados são semelhantes nesse aspecto. Para saber mais sobre tabelas e procedimentos armazenados, navegue até as entradas correspondentes neste documento de ajuda.

Conector Jitterbit para Marketo Views

Atividades

Atividades de consulta para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt, ActivityCreatedAt. ActivityNameFilter ou ExcludeActivities podem ser especificados como uma coluna adicional na cláusula WHERE. Uma lista de tipos de atividades disponíveis pode ser encontrada aqui: http://developers.marketo.com/activity-types/. As colunas LeadId, E-mail, ActivityNameFilter e ExcludeActivities permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='. Caso contrário, uma exceção será lançada.

SELECT * FROM Activities WHERE LeadId='1' OR LeadId='2'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_AddToList

Query Add To List Activities para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_AddToList WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_AddToSFDCCampaign

Query Add To SFDC Campaign Activities para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_AddToSFDCCampaign WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_ChangeDataValue

Query Change Data Value Activities para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_ChangeDataValue WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_ChangeProprietário

Consulta Alterar atividades do proprietário para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_ChangeOwner WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_ChangeRevenueStage

Consulta Alterar atividades do estágio de receita para uma organização Marketo.

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_ChangeScore

Query Change Score Activities para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_ChangeScore WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_ChangeStatusInProgression

Query Change Status In Progress Activities para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_ChangeStatusInProgression WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_ChangeStatusInSFDCCampaign

Status de mudança de consulta em atividades de campanha SFDC para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_ChangeStatusInSFDCCampaign WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_ClickEmail

Query Click E-mail Activities para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_ClickEmail WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_ClickLink

Query Click Link Activities para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_ClickLink WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_ConvertLead

Query Convert Lead Activities para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_ConvertLead WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_CreateTask

Query Create Task Activities para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_CreateTask WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_EmailBouncedSoft

Query E-mail Bounced Soft Activities para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_EmailBouncedSoft WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_EmailDelivered

Consultar atividades entregues E-mail para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_EmailDelivered WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Atividades_MomentosInteressantes

Consulta Momentos Interessantes Atividades para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_InterestingMoments WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_MergeLeads

Query Merge Leads Activities para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_MergeLeads WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_NewLeads

Consultar novas atividades de lead para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_NewLeads WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_OpenEmail

Consultar atividades E-mail aberto para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_OpenEmail WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_RemoveFromFlow

Consulta Remover das atividades de fluxo para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_RemoveFromFlow WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_RemoveFromList

Consulta Remover da lista Atividades para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_RemoveFromList WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_RemoveFromSFDCCampaign

Consulta Remover das atividades da campanha SFDC para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_RemoveFromSFDCCampaign WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_SendAlert

Query Send Alert Activities para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_SendAlert WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_SendEmail

Atividades de envio E-mail de consulta para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_SendEmail WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_SFDCActivity

Consultar atividades de atividade SFDC para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_SFDCActivity WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Atividades_SFDCMergeLeads

Query SFDC Merge Leads Activities para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_SFDCMergeLeads WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Activities_VisitWebpage

Query Visit Webpage Activities para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que uma (e apenas uma) das seguintes colunas seja usada na cláusula WHERE de uma consultar SELECT : LeadId, E-mail, StaticListId, StaticListName, OldestCreatedAt ou ActivityCreatedAt. As colunas LeadId e E-mail permitem que vários valores sejam especificados pelo operador lógico OR. Todas as colunas devem ser especificadas usando o operador '='; caso contrário, uma exceção será lançada.

SELECT * FROM Activities_VisitWebpage WHERE Email='test@server.com' OR Email='testlead@server.com'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Campanhas

Campanhas de consulta para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que as colunas Source e Name sejam usadas na cláusula WHERE de uma consultar SELECT. Use a coluna Origem para identificar as campanhas que foram criadas no Marketo ou por Vendas. A coluna Nome permite o uso do operador '=' ou 'LIKE'. O operador '=' denota uma correspondência exata; o operador 'LIKE' denota uma correspondência parcial do nome.

SELECT * FROM Campaigns WHERE Name LIKE 'test'

Colunas

Canais

Canais de consulta para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que a coluna TagValue seja usada na cláusula WHERE de uma consultar SELECT. A coluna TagValue permite que vários valores sejam especificados usando o operador lógico OR. Observe que apenas o operador '=' é suportado.

SELECT * FROM Channels WHERE TagValue='Email Blast' OR TagValue='Blog' OR TagValue='Webinar'

Colunas

Oportunidades

Oportunidades de consulta para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que as seguintes colunas sejam usadas na cláusula WHERE de uma consultar SELECT: Id, Name, CreatedAt, UpdatedAt, Type e Stage. Os filtros CreatedAt e UpdatedAt podem ser especificados duas vezes para criar um intervalo de datas.

SELECT * FROM Opportunities WHERE Stage='Commercial'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

OportunidadePessoaFunções

Consultar funções de pessoa de oportunidade para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que as seguintes colunas sejam usadas na cláusula WHERE de uma consultar SELECT: Id, CreatedAt, UpdatedAt, OpportunityId e Role. Os filtros CreatedAt e UpdatedAt podem ser especificados duas vezes para criar um intervalo de datas.

SELECT * FROM OpportunityPersonRoles WHERE Role='Business User'

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Tag

Tags de consulta para uma organização Marketo.

Informações Específicas da Tabela

Selecione

O Marketo permite que as colunas Tipo e Valor sejam usadas na cláusula WHERE de uma consultar SELECT. A coluna Value permite que vários valores sejam especificados usando o operador lógico OR. Observe que apenas o operador '=' é compatível.

SELECT * FROM Tags WHERE Type='TestTag' AND Value='Value1' OR Value='Value2'

Colunas

Modelo de Dados REST

O Jitterbit Connector for Marketo modela entidades Marketo em tabelas relacionais, exibições e procedimentos armazenados. As limitações e requisitos da API estão documentados nas seções a seguir; você pode usar o SupportEnhancedSQL recurso, definido por padrão, para contornar a maioria dessas limitações.

Observação: Operações em massa são suportadas para todas as tabelas no modelo de dados REST.

Mesas

Tabelas descreve as tabelas disponíveis. As tabelas Leads, CustomObjects e Custom Activity são tabelas dinâmicas. O modelo de dados ilustra uma amostra da aparência do seu modelo de dados do Marketo.

O modelo de dados real será obtido dinamicamente com base em suas credenciais de usuário e conta Marketo.

Visualizações

Visualizações são tabelas que não podem ser modificadas. Normalmente, os dados somente leitura são mostrados como exibições.

Procedimentos armazenados

NOTE: Procedimentos armazenados não são suportados atualmente. Veja a nota para detalhes.

Procedimentos armazenados são interfaces semelhantes a funções para o Marketo. Eles podem ser usados para pesquisar, atualizar e modificar informações no Marketo.

Tabelas

O conector modela os dados no Marketo em uma lista de tabelas que podem ser consultadas usando instruções SQL padrão.

Geralmente, consultar tabelas do Marketo é o mesmo que consultar uma tabela em um banco de dados relacional. Às vezes, há casos especiais, por exemplo, incluir uma determinada coluna na cláusula WHERE pode ser necessário para obter dados para determinadas colunas na tabela. Isso geralmente é necessário para situações em que uma solicitação separada deve ser feita para cada linha para obter determinadas colunas. Esses tipos de situações estão claramente documentados na parte superior da página da tabela vinculada abaixo.

Conector Jitterbit para Tabelas Marketo

CustomActivities

Consultar atividades personalizadas para uma organização Marketo.

Informações Específicas da Tabela

Cada atividade personalizada contida em sua organização Marketo será retornada como sua própria tabela. Cada nome de tabela será prefixado com 'Atividade_' seguido pelo nome de sua atividade personalizada.

Selecione

As atividades personalizadas podem ser recuperadas executando uma consultar SELECT na tabela de atividades personalizadas.

SELECT * FROM Activity_MyCustomActivity

Inserir

As atividades personalizadas podem ser adicionadas executando um INSERT. Para criar um novo registro de atividade personalizada, especifique as informações sobre a atividade personalizada a serem inseridas no banco de dados.

As seguintes propriedades são necessárias ao criar um registro de atividade personalizado: ActivityDate, LeadId e PrimaryAttributeValue (observe que o nome desta coluna muda com base no nome que você designou para o campo principal da atividade).

O exemplo a seguir demonstra como inserir uma nova atividade personalizada chamada MyCustomActivity:

INSERT INTO Activity_MyCustomActivity (ActivityDate, PrimaryFieldValue, LeadId, MyInt, Email) VALUES ('11/08/2016', '123', '1', 12345, 'insert@test.com')

Atualizar

As ATUALIZAÇÕES não são suportadas em atividades personalizadas.

Excluir

DELETEs não são suportados em atividades personalizadas.

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Objetos Personalizados

Crie, atualize, exclua e consultar objetos personalizados para uma organização Marketo.

Informações Específicas da Tabela

Cada objeto customizado contido em sua organização Marketo será retornado como sua própria tabela. Cada nome de tabela será prefixado com 'CustomObject_' seguido pelo nome de seu objeto personalizado.

Selecione

A API REST do Marketo requer que um filtro seja especificado para recuperar objetos customizados. O filtro deve conter pelo menos uma coluna que seja Key, um dedupeField ou uma coluna pesquisável. Somente o operador '=' é compatível com esses tipos de filtro. Outros filtros podem ser especificados além deste, mas pelo menos um dos filtros mencionados anteriormente deve ser especificado. Todas as colunas filtráveis permitem que vários valores sejam especificados usando o operador IN ou o operador lógico OR.

O tempo de resposta do servidor pode ser melhorado identificando apenas as linhas e colunas que você deseja recuperar.

SELECT Make, Model, Year, Color FROM CustomObject_MyCustomBikeObject WHERE VIN='12345'

Inserir

Para criar um novo registro de objeto personalizado, especifique as informações sobre o objeto personalizado a serem inseridos no banco de dados.

O exemplo a seguir demonstra como inserir um novo objeto personalizado chamado MyCustomBikeObject:

INSERT INTO MyCustomBikeObject (VIN, Make, Model, Color) VALUES ('99999', 'Yamaha', 'FZ-09', 'Blue')

Atualizar

Qualquer campo que não seja somente leitura pode ser atualizado.

UPDATE MyCustomBikeObject SET Year=2016 WHERE VIN='99999'

Excluir

Excluir é usado para remover objetos personalizados do Marketo. Para executar uma exclusão, a chave da tabela ou uma coluna dedupeField deve ser especificada.

DELETE FROM MyCustomBikeObject WHERE VIN='99999'

Colunas

E-mails

E-mails de consulta para uma organização Marketo.

Informações Específicas da Tabela

Selecione

Observação: Todas as colunas filtráveis devem ser especificadas usando o operador '='.

Recupere uma lista de e-mails da instância de destino, filtrável por nome.

SELECT * FROM Emails

SELECT * FROM Emails WHERE Name = 'CRUD Test'

Recupere o registro e-mail para o ID de destino fornecido.

SELECT * FROM Emails WHERE ID = 1192

Inserir

Para criar um novo E-mail, especifique pelo menos a coluna Name, Template, FolderId e FolderType.

INSERT INTO Emails (Name, Template, FolderId, FolderType) Values ('My Email', '1078', 2307, 'Folder')

Atualizar

Qualquer campo que não seja somente leitura pode ser atualizado.

UPDATE Emails SET Description='Testing Update' WHERE ID = 1192

Excluir

Para excluir um E-mail, você deve especificar o campo ID.

DELETE FROM Emails WHERE Id=1192

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Modelos de E-mail

Consultar, atualizar e excluir EmailTemplates para uma organização Marketo.

Informações Específicas da Tabela

Selecione

Observação: Todas as colunas filtráveis devem ser especificadas usando o operador '='.

Recupere uma lista de modelos e-mail da instância de destino, filtrável por nome e status.

SELECT * FROM EmailTemplates

SELECT * FROM EmailTemplates WHERE Name = 'CRUD Test'

Recupere o registro e-mail para o ID de destino fornecido.

SELECT * FROM EmailTemplates WHERE ID = 1192

Atualizar

Qualquer campo que não seja somente leitura pode ser atualizado.

UPDATE EmailTemplates SET Name = 'Update Test' Description = 'Testing Update' WHERE ID = 1192

Excluir

Para excluir um E-mail, você deve especificar o campo ID.

DELETE FROM EmailTemplates WHERE ID = 1192

Colunas

Pastas

Crie, atualize, exclua e consultar pastas para uma organização Marketo.

Informações Específicas da Tabela

Selecione

Observação: Todas as colunas filtráveis devem ser especificadas usando o operador '='.

Recupere todas as pastas em dois níveis da hierarquia de pastas.

SELECT * FROM Folders

Recupere todas as pastas em uma pasta raiz específica.

SELECT * FROM Folders WHERE RootFolderId=38 AND MaxDepth=5

Inserir

Para criar uma nova pasta, especifique pelo menos a coluna Name, ParentId e ParentType.

INSERT INTO Folders(Name,ParentId,ParentType) Values('New_Folder_Marketo__Driver', 38, 'Folder')

Atualizar

Qualquer campo que não seja somente leitura pode ser atualizado.

Update Folders Set Description='Updated Folder', IsArchive=true WHERE Id=1996

Excluir

Para excluir uma pasta, você deve especificar o campo ID. As exclusões podem ser feitas em pastas únicas se estiverem vazias, o que significa que não contêm ativos ou subpastas. Se uma pasta for do tipo Programa ou tiver o campo isSystem definido como true, ela não poderá ser excluída.

DELETE FROM Folders WHERE Id=1996

Colunas

Pseudo-colunas

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Formulários

Crie, atualize, exclua e consultar Formulários para uma organização Marketo.

Informações Específicas da Tabela

Selecione

Observação: Todas as colunas filtráveis devem ser especificadas usando o operador '='.

Recupere uma lista de formulários acessíveis da instância de destino.

SELECT * FROM Forms

Recupere o formulário para o ID fornecido.

SELECT * FROM Forms WHERE ID = '1214'

Inserir

Para criar um novo formulário, especifique pelo menos a coluna Name, FolderId e FolderType.

INSERT INTO Forms (Name, Description, FolderId, FolderType) Values ('My Snippet','Test Snippet insert', 1089, 'Program')

Atualizar

Qualquer campo que não seja somente leitura pode ser atualizado.

UPDATE Forms SET Description='Testing Update', Name='Test Update' WHERE ID = '1214'

Excluir

Para excluir um Snippet, você deve especificar o campo ID.

DELETE FROM Forms WHERE ID = '1214'

Colunas

Landing Pages

Crie, atualize, exclua e consultar Landing Pages para uma organização Marketo.

Informações Específicas da Tabela

Selecione

Observação: Todas as colunas filtráveis devem ser especificadas usando o operador '='.

Recupere uma lista de páginas iniciais acessíveis da instância de destino, filtrável por Status e pasta.

SELECT * FROM LandingPages

SELECT * FROM LandingPages WHERE Status='draft'

SELECT * FROM LandingPages WHERE FolderId=1184 AND FolderType='Program'

Recupere o registro da página de aterrissagem para o nome fornecido ou um ID de destino.

SELECT * FROM LandingPages WHERE Id=1234

SELECT * FROM LandingPages WHERE Name='Agenda'

Inserir

Para criar uma nova LandingPage, especifique pelo menos a coluna Name, FolderId, FolderType e Template.

INSERT INTO LandingPages (CustomHeadHTML,Description,FacebookOgTags,FolderId,FolderType,Keywords,MobileEnabled,Name,FormPrefill,Robots,Template,Title,URL,Workspace) Values ('<!DOCTYPE html>\n<html>\n<body>\n<h1>My First Heading</h1>\n<p>My first paragraph.</p>\n</body></html>','Testing  Insert operation','',1184,'Program','',false,'Test Insert',false,'index, nofollow',1,'Insert Operation','http://na-ab23.marketo.com/lp/119-IEY-862/LPtest_08.html','CRH')

Atualizar

Qualquer campo que não seja somente leitura pode ser atualizado.

UPDATE LandingPages SET CustomHeadHTML='<!DOCTYPE html>\n<html>\n<body>\n<h1>My First Heading</h1>\n<p>My first paragraph.</p>\n</body></html>', Description='Testing Update', FacebookOgTags='', Keywords='', MobileEnabled=false, Name='Test Update', Robots='index, nofollow',Title='Update Operation', URL='http://na-ab23.marketo.com/lp/119-IEY-862/LPtest_08.html' where Id=1103

Excluir

Para excluir uma LandingPage, você deve especificar o campo ID.

DELETE FROM LandingPages WHERE Id=1996

Colunas

Modelos de Página de Destino

Crie, atualize, exclua e consultar LandingPageTemplates para uma organização Marketo.

Informações Específicas da Tabela

Selecione

Observação: Todas as colunas filtráveis devem ser especificadas usando o operador '='.

Recupere uma lista de modelos de página de aterrissagem acessíveis da instância de destino, filtráveis por nome, status e pasta.

SELECT * FROM LandingPageTemplates

SELECT * FROM LandingPageTemplates WHERE Status='draft'

SELECT * FROM LandingPageTemplates WHERE FolderId=1184 AND FolderType='Program'

Recupere o registro do modelo da página de aterrissagem para o nome fornecido ou um ID de destino.

SELECT * FROM LandingPageTemplates WHERE Id=1234

SELECT * FROM LandingPageTemplates WHERE Name='Agenda'

Inserir

Para criar um novo LandingPageTemplate, especifique pelo menos a coluna Name, FolderId, FolderType e TemplateType.

INSERT INTO LandingPageTemplates (Description, EnableMunchkin, FolderId, FolderType, Name, TemplateType) VALUES ('Testing Insert', true, 19, 'Folder', 'Test Insert 1', 'guided')

Atualizar

Qualquer campo que não seja somente leitura pode ser atualizado.

UPDATE LandingPageTemplates SET Description='Testing Update', EnableMunchkin=false, Name='Test Update' WHERE ID = 1312

Excluir

Para excluir um LandingPageTemplate, você deve especificar o campo ID.

DELETE FROM LandingPageTemplates WHERE ID = 1312

Colunas

Pistas

Crie, atualize, exclua e consultar Leads para uma organização Marketo.

Informações Específicas da Tabela

Selecione

Todas as colunas devem ser especificadas usando o operador '='. Todas as colunas filtráveis permitem que vários valores sejam especificados usando o operador IN ou o operador lógico OR.

O tempo de resposta do servidor pode ser melhorado identificando apenas as linhas e colunas que você deseja recuperar.

SELECT Id, FirstName, LastName FROM Leads WHERE ID IN (1, 2, 5, 10)

Se um filtro não for especificado, a tabela Activities_NewLead será consultada para recuperar uma lista de IDs de leads. Depois que os IDs de leads forem compilados, a tabela de leads será consultada usando a lista compilada de IDs de leads. A coluna 'CreatedAt' pode ser usada como um filtro para especificar o intervalo de data e hora criado de Leads a serem recuperados. Quando o '>' ou o operador '>=' for especificado, o valor datetime será enviado na solicitação da tabela Activities_NewLead. Observe que isso requer chamadas de API adicionais e pelo menos dobrará a quantidade de chamadas de API feitas, pois uma solicitação Activities_NewLead deve ser feita para cada solicitação de Leads feita. O tamanho máximo do lote por solicitação para a API REST é 300, portanto, para obter uma estimativa aproximada do número de chamadas de API necessárias, a seguinte fórmula pode ser usada: (Total Number of Leads / 300) * 2

A coluna 'UpdatedAt' também pode ser usada como um filtro para especificar o intervalo de data e hora atualizado de Leads a serem recuperados. Quando especificada, a tabela Activities_LeadChanges será consultada para recuperar uma lista de IDs de leads. Depois que os IDs de leads forem compilados, a tabela de leads será consultada usando a lista compilada de IDs de leads. Quando o '>' ou o operador '>=' for especificado, o valor datetime será enviado na solicitação da tabela Activities_LeadChanges. Observe que isso requer chamadas de API adicionais e pelo menos dobrará a quantidade de chamadas de API feitas, pois uma solicitação Activities_LeadChanges deve ser feita para cada solicitação de Leads feita. Na maioria dos casos, o total de chamadas de API mais do que dobrará, pois os valores individuais de um lead são retornados como um registro). Portanto, para obter uma lista completa de IDs de leads, várias solicitações Activities_LeadChanges podem precisar ser feitas. O tamanho máximo do lote por solicitação para a API REST é 300, portanto, para obter uma estimativa mínima do número de chamadas de API necessárias, a seguinte fórmula pode ser usada: (Total Number of Leads / 300) * 2

Como alternativa, a API SOAP pode ser usada para recuperar uma lista de IDs de lead definindo "UseSOAPForLeadIds=True" na propriedade 'Outro'. Quando especificado, a API SOAP será usada (desde que os detalhes da conexão SOAP sejam especificados) para compilar uma lista de IDs de leads que serão usados como um filtro para a API REST. Observe que a API SOAP é significativamente mais lenta que a API REST, embora essa abordagem híbrida seja mais rápida do que usar apenas a API SOAP sozinha. O tamanho máximo do lote por solicitação para a API SOAP é 1.000, portanto, para obter uma estimativa mínima do número de chamadas de API necessárias, a seguinte fórmula pode ser usada: (Número total de leads / 1.000) + (Número total de leads / 300 )

Para ignorar a utilização de várias chamadas de API e obter o melhor desempenho, crie uma lista estática de leads no Marketo e especifique o ListId para recuperá-los.

Inserir

Para criar um novo registro de Lead, especifique as informações sobre o Lead a serem inseridas no banco de dados.

O exemplo a seguir demonstra como inserir um novo Lead:

INSERT INTO Leads (Email, FirstName, LastName) VALUES ('john@mark.com', 'John', 'Mark')

Atualizar

Qualquer campo que não seja somente leitura pode ser atualizado. As atualizações podem ser realizadas usando uma chave externa que é qualquer coluna 'Filtrável', como E-mail.

O exemplo a seguir demonstra como atualizar usando a coluna 'Id' como campo de pesquisa.

UPDATE Leads SET MobilePhone='111-222-3333' WHERE ID = 1

O exemplo a seguir demonstra como atualizar usando a coluna ' E-mail' como campo de pesquisa.

UPDATE Leads SET MobilePhone='111-222-3333' WHERE Email = 'john@mark.com'

Além disso, você pode usar um campo personalizado como campo de pesquisa. Nesse caso, você precisará definir a coluna 'LookupField' também com o nome do campo personalizado que está usando. O exemplo a seguir demonstra como atualizar usando um campo personalizado chamado 'MyCustomField' como o campo de pesquisa.

UPDATE Leads SET MobilePhone='111-222-3333' WHERE LookupField = 'MyCustomField' AND MyCustomField = 'my_value'

Excluir

Excluir é usado para remover leads do Marketo. Para realizar uma exclusão, o campo ID do lead é obrigatório.

DELETE FROM Leads WHERE ID = 1

GetDeleted

GetDeleted é usado para obter leads excluídos do Marketo. Para obter leads excluídos, você precisa especificar o filtro UpdatedAt. Se não for especificado, ele buscará os dados dos últimos 14 dias.

GetDeleted FROM Leads

Colunas

ListStaticMemberShip

Crie, exclua e consultar membros da lista estática de consultar para uma organização Marketo.

Informações Específicas da Tabela

Selecione

Observação: Todas as colunas filtráveis devem ser especificadas usando o operador '='.

Recupere uma lista de Static MemberShip da instância de destino, filtrável por ID e ListId.

SELECT * FROM ListStaticMemberShip

SELECT * FROM ListStaticMemberShip WHERE ListId = 1014 

SELECT * FROM ListStaticMemberShip WHERE ListId = 1014 and ID = 1016

Inserir

Para criar um novo MemberShip estático, especifique pelo menos a coluna ListId e ID.

INSERT INTO ListStaticMemberShip (ListId,Id) VALUES(1014,1014)

Excluir

Para excluir um ListStaticMemberShip, você deve especificar o campo ID e ListId.

Delete From ListStaticMemberShip WHERE Listid = 1014 and ID = 1014

Colunas

Contas Nomeadas

Consultar contas nomeadas para uma organização Marketo.

Informações Específicas da Tabela

Selecione

Um filtro deve ser especificado ao recuperar contas nomeadas. Filtros válidos são quaisquer colunas pesquisáveis que incluem MarketoGUID, Nome, Indústria, Estado, Cidade, etc.

SELECT * FROM NamedAccounts WHERE Name='MyAccount'

Inserir

Para criar um novo registro NamedAccount, especifique as informações sobre a conta nomeada a serem inseridas no banco de dados.

O exemplo a seguir demonstra como inserir uma nova NamedAccount:

INSERT INTO NamedAccounts (Name, City, Country, Industry) VALUES ('MyAccount', 'MyCity', 'USA', 'Tech')

Atualizar

Qualquer campo que não seja somente leitura pode ser atualizado.

UPDATE NamedAccounts SET NumberOfEmployees=100, State='NC', AnnualRevenue='10000000.00' WHERE Name='MyAccount'

Excluir

Excluir é usado para remover contas nomeadas do Marketo. Para realizar uma exclusão, é necessário o campo MarketoGUID ou o campo Nome.

DELETE FROM NamedAccounts WHERE Name=='MyAccount'

Colunas

Oportunidades

Oportunidades de consulta para uma organização Marketo.

Informações Específicas da Tabela

Observação: esta tabela está disponível apenas para assinaturas do Marketo que não possuem uma sincronização de CRM nativa habilitada. Se a sincronização estiver habilitada, um erro será retornado ao tentar consultar a tabela informando que a API está desabilitada.

Selecione

Um filtro deve ser especificado ao recuperar oportunidades. Os filtros válidos são quaisquer colunas pesquisáveis que incluem MarketoGUID, ExternalOpportunityId, ExternalCompanyId ou ExternalSalesPersonId.

SELECT * FROM Opportunities WHERE ExternalOpportunityId='CDATA1'

Inserir

Para criar um novo registro de Oportunidade, especifique as informações sobre a Oportunidade a serem inseridas no banco de dados.

O exemplo a seguir demonstra como inserir uma nova Oportunidade:

INSERT INTO Opportunities (ExternalOpportunityId, Description, ExternalCompanyId, Name) VALUES ('CDATA1', ' Software Inc Opportunity', 'CDATA', '')

Atualizar

Qualquer campo que não seja somente leitura pode ser atualizado.

UPDATE Opportunities SET IsWon=true, FiscalYear=2016, Amount='1000.00' WHERE ExternalOpportunityId='Opportunity1'

Excluir

Excluir é usado para remover oportunidades do Marketo. Para executar uma exclusão, é necessário o campo ID ou o campo ExternalOpportunityId.

DELETE FROM Opportunities WHERE ExternalOpportunityId=='Opportunity1'