Detalles de Conexión de Marketo¶

Introducción¶

Versión del conector

Esta documentación se basa en la versión 21.0.8257 del conector.

Empezando¶

Compatibilidad con la versión de Marketo

El conector permite el acceso de SQL92 a las entidades disponibles a través de la versión 1 de la API REST y la versión 2.6 de la API SOAP.

Establecer una Conexión¶

Las APIs de REST y SOAP son compatibles y se pueden elegir mediante Schema propiedad.

Conexión a la API REST de Marketo¶

Antes de poder conectarse a la API REST de Marketo, deberá crear un servicio personalizado.

Creación de un Servicio Personalizado¶

Para crear un servicio personalizado, siga el siguiente procedimiento:

1. Navegue al área de administración de su aplicación Marketo.
2. Haga clic en Users & Roles en la sección de Seguridad.
3. Seleccione el Roles pestaña y haga clic New Role para crear un nuevo Rol.
4. Introduzca un Nombre de función y seleccione los permisos para la función. Los permisos de la API de acceso son específicos de la API REST.
5. Ahora que se ha creado una función de API, seleccione Users pestaña y haga clic en Invitar nuevo usuario.
6. Ingrese la información del nuevo usuario y seleccione el rol que se acaba de crear con acceso a la API. La opción Solo API se puede seleccionar para indicar que el usuario es un usuario Solo API.
7. Ahora que se ha creado un nuevo usuario, será necesario crear un nuevo servicio. Haga clic en el LaunchPoint opción (Administrador -> Integración -> LaunchPoint).
8. Haga clic en New Service.
9. Seleccione el tipo de servicio personalizado e ingrese un nombre para mostrar y una descripción.
10. Seleccione el usuario que creó.

Obtención de Credenciales de OAuth¶

Para obtener el OAuthClientId y OAuthClientSecret, navegue hasta LaunchPoint opción en el área de administración.

Haga clic en el View Details enlace para el servicio deseado. Se muestra una ventana que contiene las credenciales de autenticación.

Autenticación en la API REST¶

Una vez que haya creado un servicio personalizado y obtenido sus credenciales de OAuth, configure lo siguiente para conectarse a los datos:

• Schema: Establézcalo en REST.

• OAuthClientId: El ID de cliente de OAuth asociado con su servicio personalizado.

• OAuthClientSecret: El secreto de cliente de OAuth asociado con su servicio personalizado.

• RESTEndpoint: la URL del extremo del servicio web REST. Esto se puede encontrar en su área de administración de Marketo en Integración -> Opción Web Services en la sección REST API.

  El Extremo de identidad no será necesario.

Conexión a la API SOAP de Marketo¶

Para conectarse a la API de SOAP, deberá proporcionar credenciales de Marketo válidas. Especifique lo siguiente para conectarse a los datos:

• Schema: Establézcalo en SOAP.
• UserId: El ID de acceso del cliente se encuentra dentro de su panel API SOAP de administrador de Marketo en Integración.
• EncryptionKey: La clave de cifrado de API SOAP de Marketo. Esta clave se genera en la página de administración del sitio web de Marketo.
• SOAPEndpoint: La URL del extremo del servicio web SOAP, proporcionada por Marketo en la página de administración del sitio web de Marketo.

Notas Importantes¶

Procedimientos Almacenados¶

• Las funciones de procedimientos almacenados descritas en esta documentación no se admiten actualmente.
• Debido a que los procedimientos almacenados no se admiten actualmente, cualquier característica que dependa de los procedimientos almacenados tampoco se admite actualmente.

Archivos de Configuración y Sus Rutas¶

• Todas las referencias a la adición de archivos de configuración y sus rutas se refieren a archivos y ubicaciones en Harmony Agente donde está instalado el conector. Estas rutas deben ajustarse según corresponda según el agente y el sistema operativo. Si se utilizan varios agentes en un grupo de agentes, se requerirán archivos idénticos en cada agente.

Características Avanzadas¶

Esta sección detalla una selección de características avanzadas del conector Marketo.

Vistas definidas por el usuario

El conector le permite definir tablas virtuales, llamadas vistas definidas por el usuario, cuyo contenido se decide mediante una consultar preconfigurada. Estas vistas son útiles cuando no puede controlar directamente las consultas que se envían a los controladores. Consulte Vistas definidas por el usuario para obtener una descripción general de la creación y configuración de vistas personalizadas.

Configuración SSL

Usar Configuración SSL para ajustar cómo el conector maneja las negociaciones de certificados TLS/SSL. Puede elegir entre varios formatos de certificado; ver el SSLServerCert propiedad en "Opciones de cadena de conexión" para obtener más información.

Apoderado

Para configurar el conector mediante Configuración de proxy de Agente Privado, Selecciona el Use Proxy Settings casilla de verificación en la pantalla de configuración de la conexión.

Vistas Definidas por el Usuario¶

El Conector Jitterbit para Marketo le permite definir una tabla virtual cuyos contenidos se deciden mediante una consultar preconfigurada. Estas se denominan Vistas definidas por el usuario, que son útiles en situaciones en las que no puede controlar directamente la consultar que se envía al controlador, por ejemplo, cuando se utiliza el controlador de Jitterbit. Las vistas definidas por el usuario se pueden utilizar para definir predicados que siempre se aplican. Si especifica predicados adicionales en la consultar a la vista, se combinan con la consultar ya definida como parte de la vista.

Hay dos formas de crear vistas definidas por el usuario:

• Cree un archivo de configuración con formato JSON que defina las vistas que desea.
• Declaraciones DDL.

Definición de Vistas Usando un Archivo de Configuración¶

Las vistas definidas por el usuario se definen en un archivo de configuración con formato JSON llamado UserDefinedViews.json. El conector detecta automáticamente las vistas especificadas en este archivo.

También puede tener múltiples definiciones de vista y controlarlas usando UserDefinedViews propiedad de conexión. Cuando utiliza esta propiedad, el conector solo ve las vistas especificadas.

Este archivo de configuración de vista definida por el usuario tiene el siguiente formato:

• Cada elemento raíz define el nombre de una vista.
• Cada elemento raíz contiene un elemento hijo, llamado query, que contiene la consultar SQL personalizada para la vista.

Por ejemplo:

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

Utilizar el UserDefinedViews propiedad de conexión para especificar la ubicación de su archivo de configuración JSON. Por ejemplo:

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

Esquema para Vistas Definidas por el Usuario¶

Las vistas definidas por el usuario se exponen en UserViews esquema por defecto. Esto se hace para evitar que el nombre de la vista entre en conflicto con una entidad real en el modelo de datos. Puede cambiar el nombre del esquema utilizado para UserViews configurando UserViewsSchemaName propiedad.

Trabajar con Vistas Definidas por el Usuario¶

Por ejemplo, una instrucción SQL con una vista definida por el usuario llamada UserViews.RCustomers solo enumera clientes en Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Un ejemplo de una consultar al controlador:

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

Dando como resultado la consultar efectiva a la fuente:

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

Ese es un ejemplo muy simple de una consultar a una vista definida por el usuario que es efectivamente una combinación de la consultar de vista y la definición de vista. Es posible componer estas consultas en patrones mucho más complejos. Todas las operaciones de SQL están permitidas en ambas consultas y se combinan cuando corresponde.

Configuración SSL¶

Personalización de la Configuración SSL¶

De forma predeterminada, el conector intenta negociar SSL/TLS comparando el certificado del servidor con el almacén de certificados de confianza del sistema.

Para especificar otro certificado, consulte SSLServerCert propiedad de los formatos disponibles para hacerlo.

Modelo de Datos SOAP¶

Jitterbit Connector for Marketo modela entidades de Marketo en tablas relacionales, vistas y procedimientos almacenados. Las limitaciones y los requisitos de la API se documentan en las siguientes secciones; puedes usar el SupportEnhancedSQL función, configurada de forma predeterminada, para eludir la mayoría de estas limitaciones.

Nota: Las operaciones masivas no son compatibles con el modelo de datos SOAP.

Mesas

Mesas describe las tablas disponibles.

Puntos de vista

Puntos de vista son tablas que no se pueden modificar. Normalmente, los datos de solo lectura se muestran como vistas.

Mesas¶

El conector modela los datos en Marketo en una lista de tablas que se pueden consultar mediante instrucciones SQL estándar.

Generalmente, consultar tablas de Marketo es lo mismo que consultar una tabla en una base de datos relacional. A veces hay casos especiales, por ejemplo, incluir una determinada columna en la cláusula WHERE puede ser necesario para obtener datos para ciertas columnas de la tabla. Esto suele ser necesario para situaciones en las que se debe realizar una solicitud separada para cada fila para obtener ciertas columnas. Estos tipos de situaciones están claramente documentados en la parte superior de la página de la tabla vinculada a continuación.

Conector Jitterbit para Tablas Marketo¶

Dirige¶

Cree, actualice, elimine y consultar clientes potenciales para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Todas las columnas deben especificarse mediante el operador '='. Las columnas ID y Correo permiten especificar varios valores mediante el operador lógico OR. La columna OldestUpdatedAt actúa como criterio "desde" y se puede especificar un rango agregando la columna LatestUpdatedAt, que especifica el criterio "hasta".

El tiempo de respuesta del servidor se puede mejorar identificando solo las filas y columnas que desea recuperar.

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

Insertar¶

Para crear un nuevo registro de Cliente potencial, especifique la información sobre el Cliente potencial que se ingresará en la base de datos.

El siguiente ejemplo muestra cómo insertar un nuevo cliente potencial:

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

Actualizar¶

Cualquier campo que no sea de solo lectura se puede actualizar.

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

Borrar¶

La API de Marketo no admite directamente la eliminación de un cliente potencial. Sin embargo, un Cliente potencial se puede eliminar mediante la creación de una campaña, que se ejecutará a través de una llamada a la API, que activa la eliminación de un Cliente potencial como parte del flujo de la campaña. Los detalles sobre cómo crear una campaña como esta se pueden encontrar aquí: http://developers.marketo.com/blog/delete-a-lead-with-the-marketo-api/

Una vez que se crea la campaña dentro de Marketo, se puede realizar una solicitud de eliminación especificando la campaña con la columna CampaignId o CampaignName, junto con la columna ID o Correo de los clientes potenciales que se eliminarán.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Programas¶

Consultar y actualizar Programas para una organización Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar las siguientes columnas en la cláusula WHERE de una consultar SELECT: Id, Name, CreatedAt, UpdatedAt, CRMId, TagType, TagValue, WorkspaceName, WorkspaceId e includearchive. Las columnas Id, Name y CRMId permiten especificar varios valores mediante el operador lógico OR. Los filtros CreatedAt y UpdateAt se pueden especificar dos veces para crear un intervalo de fechas.

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

Actualizar¶

Cualquier campo que no sea de solo lectura se puede actualizar.

Tenga en cuenta que las columnas Tag*** y Cost*** solo toman un único valor. Por lo tanto, no toman una lista separada por comas al realizar una actualización.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Puntos de Vista¶

Las vistas se componen de columnas y pseudocolumnas. Las vistas son similares a las tablas en la forma en que se representan los datos; sin embargo, las vistas no admiten actualizaciones. Las entidades que se representan como vistas suelen ser entidades de solo lectura. A menudo, un procedimiento almacenado* está disponible para actualizar los datos si dicha funcionalidad es aplicable a la fuente de datos.

Las consultas se pueden ejecutar contra una vista como si fuera una tabla normal, y los datos que regresan son similares en ese sentido. Para obtener más información sobre las tablas y los procedimientos almacenados, vaya a sus entradas correspondientes en este documento de ayuda.

Conector Jitterbit para Marketo Views¶

Actividades¶

Actividades de consulta para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt, ActivityCreatedAt. ActivityNameFilter o ExcludeActivities se pueden especificar como una columna adicional en la cláusula WHERE. Puede encontrar una lista de tipos de actividades disponibles aquí: http://developers.marketo.com/activity-types/. Las columnas LeadId, Correo, ActivityNameFilter y ExcludeActivities permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='. De lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_AddToList¶

Consulta de actividades Agregar a la lista para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_AddToSFDCCampaign¶

Consulta Agregar a actividades de campaña de SFDC para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_ChangeDataValue¶

Query Change Data Value Activities para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_ChangeOwner¶

Consulta de actividades de cambio de propietario para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_ChangeRevenueStage¶

Consulta de actividades de etapa de ingresos de cambio para una organización de Marketo.

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_ChangeScore¶

Consulta de actividades de puntaje de cambio para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_ChangeStatusInProgression¶

Consultar el estado de cambio en las actividades de progreso para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Activities_ChangeStatusInSFDCCampaign¶

Estado de cambio de consulta en actividades de campaña de SFDC para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_ClickCorreo Electrónico¶

Consulta Haga clic en Actividades de Correo para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_ClickLink¶

Consulta las actividades de enlace de clic para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_ConvertLead¶

Query Convert Lead Activities para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_CrearTarea¶

Consulta Crear actividades de tareas para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_EmailBouncedSoft¶

Consulta de actividades blandas de Correo rebotado para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_Correo Electrónico Entregado¶

Consulta de actividades enviadas Correo para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_Momentos Interesantes¶

Consulta de Actividades de Momentos Interesantes para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_MergeLeads¶

Query Merge Leads Activities para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_Nuevos Clientes Potenciales¶

Consultar actividades de nuevos clientes potenciales para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_Correo Electrónico Abierto¶

Consulta de actividades de Correo abiertas para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_RemoveFromFlow¶

Consulta Quitar de las actividades de flujo para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_RemoveFromList¶

Consulta Quitar de la lista Actividades para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Activities_RemoveFromSFDCCampaign¶

Consulta Quitar de las actividades de campaña de SFDC para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_SendAlert¶

Consulta de actividades de envío de alertas para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_EnviarCorreo Electrónico¶

Consulta de actividades de envío de Correo para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_SFDCActividad¶

Consulta las actividades de actividad de SFDC para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_SFDCMergeLeads¶

Consultar actividades de fusión de clientes potenciales de SFDC para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades_Visita la Página Web¶

Consulta las actividades de la página web de una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar una (y solo una) de las siguientes columnas en la cláusula WHERE de una consultar SELECT: LeadId, Correo, StaticListId, StaticListName, OldestCreatedAt o ActivityCreatedAt. Las columnas LeadId y Correo permiten que el operador lógico OR especifique varios valores. Todas las columnas deben especificarse mediante el operador '='; de lo contrario, se lanzará una excepción.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Campañas¶

Campañas de consulta para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite que las columnas Fuente y Nombre se utilicen en la cláusula WHERE de una consultar SELECT. Utilice la columna Fuente para identificar las campañas que se crearon en Marketo o por Ventas. La columna Nombre permite el uso del operador '=' o 'LIKE'. El operador '=' denota una coincidencia exacta; el operador 'LIKE' denota una coincidencia parcial del nombre.

SELECT * FROM Campaigns WHERE Name LIKE 'test'

Columnas¶

Canales¶

Canales de consulta para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite que la columna TagValue se use en la cláusula WHERE de una consultar SELECT. La columna TagValue permite especificar varios valores mediante el operador lógico OR. Tenga en cuenta que solo se admite el operador '='.

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

Columnas¶

Oportunidades¶

Consulta Oportunidades para una organización Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar las siguientes columnas en la cláusula WHERE de una consultar SELECT: Id, Name, CreatedAt, UpdatedAt, Type y Stage. Los filtros CreatedAt y UpdatedAt se pueden especificar dos veces para crear un intervalo de fechas.

SELECT * FROM Opportunities WHERE Stage='Commercial'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

OportunidadPersonaRoles¶

Consultar roles de personas de oportunidades para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar las siguientes columnas en la cláusula WHERE de una consultar SELECT: Id, CreatedAt, UpdatedAt, OpportunityId y Role. Los filtros CreatedAt y UpdatedAt se pueden especificar dos veces para crear un intervalo de fechas.

SELECT * FROM OpportunityPersonRoles WHERE Role='Business User'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Etiquetas¶

Etiquetas de consulta para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Marketo permite usar las columnas Tipo y Valor en la cláusula WHERE de una consultar SELECT. La columna Valor permite especificar varios valores mediante el operador lógico OR. Tenga en cuenta que solo se admite el operador '='.

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

Columnas¶

Modelo de Datos REST¶

Jitterbit Connector for Marketo modela entidades de Marketo en tablas relacionales, vistas y procedimientos almacenados. Las limitaciones y los requisitos de la API se documentan en las siguientes secciones; puedes usar el SupportEnhancedSQL función, configurada de forma predeterminada, para eludir la mayoría de estas limitaciones.

Nota: Las operaciones masivas son compatibles con todas las tablas en el modelo de datos REST.

Mesas

Mesas describe las tablas disponibles. Las tablas Clientes potenciales, Objetos personalizados y Actividad personalizada son tablas dinámicas. El modelo de datos ilustra una muestra de cómo podría verse su modelo de datos de Marketo.

El modelo de datos real se obtendrá dinámicamente en función de sus credenciales de usuario y su cuenta de Marketo.

Puntos de vista

Puntos de vista son tablas que no se pueden modificar. Normalmente, los datos de solo lectura se muestran como vistas.

Procedimientos almacenados

NOTE: Los procedimientos almacenados no se admiten actualmente. Consulte la nota anterior para detalles.

Procedimientos almacenados son interfaces similares a funciones para Marketo. Se pueden utilizar para buscar, actualizar y modificar información en Marketo.

Mesas¶

El conector modela los datos en Marketo en una lista de tablas que se pueden consultar mediante instrucciones SQL estándar.

Generalmente, consultar tablas de Marketo es lo mismo que consultar una tabla en una base de datos relacional. A veces hay casos especiales, por ejemplo, incluir una determinada columna en la cláusula WHERE puede ser necesario para obtener datos para ciertas columnas de la tabla. Esto suele ser necesario para situaciones en las que se debe realizar una solicitud separada para cada fila para obtener ciertas columnas. Estos tipos de situaciones están claramente documentados en la parte superior de la página de la tabla vinculada a continuación.

Conector Jitterbit para Tablas Marketo¶

Actividades Personalizadas¶

Consulta de actividades personalizadas para una organización de Marketo.

Información Específica de la Tabla¶

Cada actividad personalizada contenida dentro de su organización Marketo se devolverá como su propia tabla. Cada nombre de tabla tendrá el prefijo 'Actividad_' seguido del nombre de su actividad personalizada.

Seleccionar¶

Las actividades personalizadas se pueden recuperar realizando una consultar SELECT en la tabla de actividades personalizadas.

SELECT * FROM Activity_MyCustomActivity

Insertar¶

Las actividades personalizadas se pueden agregar realizando un INSERT. Para crear un nuevo registro de actividad personalizada, especifique la información sobre la actividad personalizada que se ingresará en la base de datos.

Se requieren las siguientes propiedades al crear un registro de actividad personalizado: ActivityDate, LeadId y PrimaryAttributeValue (tenga en cuenta que el nombre de esta columna cambia según el nombre que designó para el campo principal de la actividad).

El siguiente ejemplo muestra cómo insertar una nueva actividad personalizada llamada MyCustomActivity:

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

Actualizar¶

Las ACTUALIZACIONES no se admiten en actividades personalizadas.

Borrar¶

DELETE no se admite en actividades personalizadas.

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Objetos Personalizados¶

Cree, actualice, elimine y consultar objetos personalizados para una organización de Marketo.

Información Específica de la Tabla¶

Cada objeto personalizado contenido dentro de su organización Marketo se devolverá como su propia tabla. Cada nombre de tabla tendrá el prefijo 'CustomObject_' seguido del nombre de su objeto personalizado.

Seleccionar¶

La API REST de Marketo requiere que se especifique un filtro para recuperar objetos personalizados. El filtro debe contener al menos una columna que sea la clave, un dedupeField o una columna que se pueda buscar. Solo se admite el operador '=' en estos tipos de filtro. Se pueden especificar otros filtros además de este, pero se debe especificar al menos uno de los filtros mencionados anteriormente. Todas las columnas filtrables permiten especificar varios valores mediante el operador IN o el operador lógico OR.

El tiempo de respuesta del servidor se puede mejorar identificando solo las filas y columnas que desea recuperar.

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

Insertar¶

Para crear un nuevo registro de objeto personalizado, especifique la información sobre el objeto personalizado que se ingresará en la base de datos.

El siguiente ejemplo muestra cómo insertar un nuevo objeto personalizado llamado MyCustomBikeObject:

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

Actualizar¶

Cualquier campo que no sea de solo lectura se puede actualizar.

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

Borrar¶

Eliminar se utiliza para eliminar objetos personalizados de Marketo. Para realizar una eliminación, se debe especificar la clave de la tabla o una columna dedupeField.

DELETE FROM MyCustomBikeObject WHERE VIN='99999'

Columnas¶

Correos¶

Consulta de Correos para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Nota: Todas las columnas filtrables deben especificarse con el operador '='.

Recupere una lista de correos de la instancia de destino, filtrable por nombre.

SELECT * FROM Emails

SELECT * FROM Emails WHERE Name = 'CRUD Test'

Recupere el registro de correo para el Id. de destino dado.

SELECT * FROM Emails WHERE ID = 1192

Insertar¶

Para crear un nuevo Correo, especifique al menos la columna Nombre, Plantilla, ID de carpeta y Tipo de carpeta.

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

Actualizar¶

Cualquier campo que no sea de solo lectura se puede actualizar.

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

Borrar¶

Para eliminar un Correo, debe especificar el campo ID.

DELETE FROM Emails WHERE Id=1192

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Plantillas de Correo Electrónico¶

Consulte, actualice y elimine plantillas de correo electrónico para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Nota: Todas las columnas filtrables deben especificarse con el operador '='.

Recupere una lista de plantillas de correo de la instancia de destino, filtrable por nombre y estado.

SELECT * FROM EmailTemplates

SELECT * FROM EmailTemplates WHERE Name = 'CRUD Test'

Recupere el registro de correo para el Id. de destino dado.

SELECT * FROM EmailTemplates WHERE ID = 1192

Actualizar¶

Cualquier campo que no sea de solo lectura se puede actualizar.

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

Borrar¶

Para eliminar un Correo, debe especificar el campo ID.

DELETE FROM EmailTemplates WHERE ID = 1192

Columnas¶

Carpetas¶

Cree, actualice, elimine y consultar carpetas para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Nota: Todas las columnas filtrables deben especificarse con el operador '='.

Recupere todas las carpetas dentro de dos niveles de la jerarquía de carpetas.

SELECT * FROM Folders

Recupere todas las carpetas de una carpeta raíz específica.

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

Insertar¶

Para crear una nueva carpeta, especifique al menos la columna Nombre, ParentId y ParentType.

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

Actualizar¶

Cualquier campo que no sea de solo lectura se puede actualizar.

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

Borrar¶

Para eliminar una carpeta debe especificar el campo ID. Las eliminaciones se pueden realizar en carpetas individuales si están vacías, lo que significa que no contienen recursos ni subcarpetas. Si una carpeta es del tipo Programa o tiene el campo isSystem establecido en verdadero, no se puede eliminar.

DELETE FROM Folders WHERE Id=1996

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Formularios¶

Cree, actualice, elimine y consultar Formularios para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Nota: Todas las columnas filtrables deben especificarse con el operador '='.

Recupere una lista de formularios accesibles de la instancia de destino.

SELECT * FROM Forms

Recupere el formulario para el Id dado.

SELECT * FROM Forms WHERE ID = '1214'

Insertar¶

Para crear un nuevo formulario, especifique al menos la columna Nombre, FolderId y FolderType.

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

Actualizar¶

Cualquier campo que no sea de solo lectura se puede actualizar.

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

Borrar¶

Para eliminar un Snippet, debe especificar el campo ID.

DELETE FROM Forms WHERE ID = '1214'

Columnas¶

Páginas de Destino¶

Cree, actualice, elimine y consultar páginas de destino para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Nota: Todas las columnas filtrables deben especificarse con el operador '='.

Recupere una lista de páginas de destino accesibles desde la instancia de destino, filtrable por estado y carpeta.

SELECT * FROM LandingPages

SELECT * FROM LandingPages WHERE Status='draft'

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

Recupere el registro página de aterrizaje para el nombre dado o una identificación de destino.

SELECT * FROM LandingPages WHERE Id=1234

SELECT * FROM LandingPages WHERE Name='Agenda'

Insertar¶

Para crear una página de destino nueva, especifique al menos la columna Nombre, ID de carpeta, Tipo de carpeta y Plantilla.

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')

Actualizar¶

Cualquier campo que no sea de solo lectura se puede actualizar.

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

Borrar¶

Para eliminar una LandingPage, debe especificar el campo ID.

DELETE FROM LandingPages WHERE Id=1996

Columnas¶

Plantillas de Página de Destino¶

Cree, actualice, elimine y consultar LandingPageTemplates para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Nota: Todas las columnas filtrables deben especificarse con el operador '='.

Recupere una lista de plantillas página de aterrizaje accesibles desde la instancia de destino, filtrable por nombre, estado y carpeta.

SELECT * FROM LandingPageTemplates

SELECT * FROM LandingPageTemplates WHERE Status='draft'

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

Recupere el registro de la modelo página de aterrizaje para el nombre dado o una identificación de destino.

SELECT * FROM LandingPageTemplates WHERE Id=1234

SELECT * FROM LandingPageTemplates WHERE Name='Agenda'

Insertar¶

Para crear una LandingPageTemplate nueva, especifique al menos la columna Name, FolderId, FolderType y TemplateType.

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

Actualizar¶

Cualquier campo que no sea de solo lectura se puede actualizar.

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

Borrar¶

Para eliminar una LandingPageTemplate, debe especificar el campo ID.

DELETE FROM LandingPageTemplates WHERE ID = 1312

Columnas¶

Dirige¶

Cree, actualice, elimine y consultar clientes potenciales para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Todas las columnas deben especificarse mediante el operador '='. Todas las columnas filtrables permiten especificar varios valores mediante el operador IN o el operador lógico OR.

El tiempo de respuesta del servidor se puede mejorar identificando solo las filas y columnas que desea recuperar.

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

Si no se especifica un filtro, se consultará la tabla Activities_NewLead para recuperar una lista de ID de clientes potenciales. Una vez que se hayan compilado los Id. de prospectos, se consultará la tabla de prospectos utilizando la lista compilada de Id. de prospectos. La columna 'Creado en' se puede usar como filtro para especificar el rango de fecha y hora creado de los clientes potenciales para recuperar. Cuando el '>' o se especifica el operador '>=', el valor de fecha y hora se enviará en la solicitud de tabla Activities_NewLead. Tenga en cuenta que esto requiere llamadas API adicionales y al menos duplicará la cantidad de llamadas API realizadas, ya que se debe realizar una solicitud Activities_NewLead para cada solicitud de cliente potencial realizada. El tamaño de lote máximo por solicitud para la API REST es 300, por lo que para obtener una estimación aproximada de la cantidad de llamadas API requeridas, se puede usar la siguiente fórmula: (Número total de clientes potenciales / 300) * 2

La columna 'Actualizado en' también se puede usar como filtro para especificar el rango de fecha y hora actualizado de los Clientes potenciales para recuperar. Cuando se especifica, se consultará la tabla Activities_LeadChanges para recuperar una lista de ID de clientes potenciales. Una vez que se hayan compilado los Id. de prospectos, se consultará la tabla de prospectos utilizando la lista compilada de Id. de prospectos. Cuando el '>' o se especifica el operador '>=', el valor de fecha y hora se enviará en la solicitud de tabla Activities_LeadChanges. Tenga en cuenta que esto requiere llamadas API adicionales y al menos duplicará la cantidad de llamadas API realizadas, ya que se debe realizar una solicitud Activities_LeadChanges para cada solicitud de cliente potencial realizada. En la mayoría de los casos, el total de llamadas a la API se duplicará con creces, ya que los valores individuales de un cliente potencial se devuelven como un registro). Por lo tanto, para obtener una lista completa de ID de clientes potenciales, es posible que se deban realizar varias solicitudes de Activities_LeadChanges. El tamaño de lote máximo por solicitud para la API de REST es 300, por lo que para obtener una estimación mínima de la cantidad de llamadas a la API requeridas, se puede usar la siguiente fórmula: (Número total de clientes potenciales / 300) * 2

Alternativamente, la API de SOAP se puede usar para recuperar una lista de Id. de prospectos configurando "UseSOAPForLeadIds=True" en la propiedad "Otro". Cuando se especifique, se usará la API de SOAP (siempre que se especifiquen los detalles de la conexión de SOAP ) para compilar una lista de ID de clientes potenciales que luego se usará como filtro para la API de REST. Tenga en cuenta que la API SOAP es significativamente más lenta que la API REST, aunque este enfoque híbrido es más rápido que usar solo la API SOAP. El tamaño de lote máximo por solicitud para la API de SOAP es 1000, por lo que para obtener una estimación mínima de la cantidad de llamadas a la API requeridas, se puede usar la siguiente fórmula: (Número total de clientes potenciales / 1000) + (Número total de clientes potenciales / 300 )

Para omitir el uso de múltiples llamadas API y para obtener el mejor rendimiento, cree una lista estática de clientes potenciales dentro de Marketo y luego especifique ListId para recuperarlos.

Insertar¶

Para crear un nuevo registro de Cliente potencial, especifique la información sobre el Cliente potencial que se ingresará en la base de datos.

El siguiente ejemplo muestra cómo insertar un nuevo cliente potencial:

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

Actualizar¶

Cualquier campo que no sea de solo lectura se puede actualizar. Las actualizaciones se pueden realizar utilizando una clave externa que es cualquier columna 'Filtrable', como Correo.

El siguiente ejemplo muestra cómo actualizar utilizando la columna 'Id' como campo de búsqueda.

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

El siguiente ejemplo muestra cómo actualizar utilizando la columna ' Correo' como campo de búsqueda.

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

Además, puede utilizar un campo personalizado como campo de búsqueda. En tal caso, deberá configurar la columna 'LookupField' también con el nombre del campo personalizado que está utilizando. El siguiente ejemplo muestra cómo actualizar el uso de un campo personalizado llamado 'MyCustomField' como campo de búsqueda.

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

Borrar¶

Eliminar se utiliza para eliminar clientes potenciales de Marketo. Para realizar una eliminación, se requiere el campo ID de cliente potencial.

DELETE FROM Leads WHERE ID = 1

ObtenerEliminado¶

GetDeleted se utiliza para obtener clientes potenciales eliminados de Marketo. Para obtener clientes potenciales eliminados, debe especificar el filtro UpdatedAt. Si no se especifica, obtendrá datos de los últimos 14 días.

GetDeleted FROM Leads

Columnas¶

ListStaticMiembroBarco¶

Cree, elimine y consultar miembros de la lista estática de consultar para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Nota: Todas las columnas filtrables deben especificarse con el operador '='.

Recupere una lista de miembros estáticos de la instancia de destino, filtrable por ID y ListId.

SELECT * FROM ListStaticMemberShip

SELECT * FROM ListStaticMemberShip WHERE ListId = 1014 

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

Insertar¶

Para crear una nueva membresía estática, especifique al menos la columna ListId e ID.

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

Borrar¶

Para eliminar un ListStaticMemberShip, debe especificar el campo ID y ListId.

Delete From ListStaticMemberShip WHERE Listid = 1014 and ID = 1014

Columnas¶

Cuentas con Nombre¶

Consulta de cuentas designadas para una organización de Marketo.

Información Específica de la Tabla¶

Seleccionar¶

Se debe especificar un filtro al recuperar cuentas nombradas. Los filtros válidos son cualquier columna de búsqueda que incluya MarketoGUID, nombre, industria, estado, ciudad, etc.

SELECT * FROM NamedAccounts WHERE Name='MyAccount'

Insertar¶

Para crear un nuevo registro NamedAccount, especifique la información sobre la cuenta nombrada que se ingresará en la base de datos.

El siguiente ejemplo muestra cómo insertar una nueva NamedAccount:

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

Actualizar¶

Cualquier campo que no sea de solo lectura se puede actualizar.

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

Borrar¶

Eliminar se utiliza para eliminar cuentas con nombre de Marketo. Para realizar una eliminación, se requiere el campo MarketoGUID o el campo Nombre.

DELETE FROM NamedAccounts WHERE Name=='MyAccount'

Columnas¶

Oportunidades¶

Consulta Oportunidades para una organización Marketo.

Información Específica de la Tabla¶

Nota: Esta tabla solo está disponible para las suscripciones de Marketo que no tienen habilitada una sincronización CRM nativa. Si la sincronización está habilitada, se devolverá un error al intentar consultar la tabla que indica que la API está deshabilitada.

Seleccionar¶

Se debe especificar un filtro al recuperar oportunidades. Los filtros válidos son cualquier columna de búsqueda que incluya MarketoGUID, ExternalOpportunityId, ExternalCompanyId o ExternalSalesPersonId.

SELECT * FROM Opportunities WHERE ExternalOpportunityId='CDATA1'

Insertar¶

Para crear un nuevo registro de Oportunidad, especifique la información sobre la Oportunidad que se ingresará en la base de datos.

El siguiente ejemplo muestra cómo insertar una nueva oportunidad:

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

Actualizar¶

Cualquier campo que no sea de solo lectura se puede actualizar.

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

Borrar¶

Eliminar se utiliza para eliminar oportunidades de Marketo. Para realizar una eliminación, se requiere el campo ID o el campo ExternalOpportunityId.

DELETE FROM Opportunities WHERE ExternalOpportunityId=='Opportunity1'