Marketo

El conector de Marketo te permite insertar, eliminar, actualizar y leer datos de Marketo.

Antes de empezar

Antes de usar el conector de Marketo, haz lo siguiente:

  • En tu proyecto de Google Cloud:
    • Asegúrate de que la conectividad de red esté configurada. Para obtener información sobre los patrones de red, consulta Conectividad de red.
    • Concede el rol de gestión de identidades y accesos roles/connectors.admin al usuario que configure el conector.
    • Concede los siguientes roles de gestión de identidades y accesos a la cuenta de servicio que quieras usar para el conector:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Una cuenta de servicio es un tipo especial de cuenta de Google diseñada para representar a un usuario no humano que necesita autenticarse y disponer de autorización para acceder a los datos de las APIs de Google. Si no tienes una cuenta de servicio, debes crearla. El conector y la cuenta de servicio deben pertenecer al mismo proyecto. Para obtener más información, consulta el artículo Crear una cuenta de servicio.

    • Habilita los siguientes servicios:
      • secretmanager.googleapis.com (API Secret Manager)
      • connectors.googleapis.com (API Connectors)

      Para saber cómo habilitar servicios, consulta Habilitar servicios.

    Si estos servicios o permisos no se han habilitado en tu proyecto anteriormente, se te pedirá que los habilites al configurar el conector.

Configurar el conector

Una conexión es específica de una fuente de datos. Esto significa que, si tiene muchas fuentes de datos, debe crear una conexión independiente para cada una de ellas. Para crear una conexión, sigue estos pasos:

  1. En la consola de Cloud, ve a la página Integration Connectors > Connections (Conectores de integración > Conexiones) y, a continuación, selecciona o crea un proyecto de Google Cloud.

    Ve a la página Conexiones.

  2. Haga clic en + Crear para abrir la página Crear conexión.
  3. En la sección Ubicación, elige la ubicación de la conexión.
    1. Región: selecciona una ubicación de la lista desplegable.

      Las regiones admitidas para los conectores son las siguientes:

      Para ver la lista de todas las regiones admitidas, consulta Ubicaciones.

    2. Haz clic en Siguiente.
  4. En la sección Detalles de la conexión, haz lo siguiente:
    1. Conector: selecciona Marketo en la lista desplegable de conectores disponibles.
    2. Versión del conector: seleccione la versión del conector en la lista desplegable de versiones disponibles.
    3. En el campo Connection Name (Nombre de conexión), introduce un nombre para la instancia de conexión.

      Los nombres de las conexiones deben cumplir los siguientes criterios:

      • Los nombres de conexión pueden contener letras, números o guiones.
      • Las letras deben estar en minúsculas.
      • Los nombres de conexión deben empezar por una letra y terminar por una letra o un número.
      • Los nombres de conexión no pueden tener más de 49 caracteres.
    4. Si quiere, puede introducir una Descripción para la instancia de conexión.
    5. Cuenta de servicio: selecciona una cuenta de servicio que tenga los roles necesarios.
    6. Si quieres, configura los ajustes del nodo de conexión:

      • Número mínimo de nodos: introduce el número mínimo de nodos de conexión.
      • Número máximo de nodos: introduce el número máximo de nodos de conexión.

      Un nodo es una unidad (o réplica) de una conexión que procesa transacciones. Se necesitan más nodos para procesar más transacciones en una conexión y, a la inversa, se necesitan menos nodos para procesar menos transacciones. Para saber cómo influyen los nodos en el precio de tu conector, consulta la sección Precios de los nodos de conexión. Si no introduces ningún valor, de forma predeterminada, el número mínimo de nodos se establece en 2 (para mejorar la disponibilidad) y el máximo en 50.

    7. También puedes hacer clic en + Añadir etiqueta para añadir una etiqueta a la conexión en forma de par clave-valor.
    8. Haz clic en Siguiente.
  5. En la sección Destinations (Destinos), introduce los detalles del host remoto (sistema backend) al que quieras conectarte.
    1. Tipo de destino: puede especificar los detalles del destino como una dirección de host o un adjunto de servicio. Selecciona uno de los siguientes tipos de destino:
      • Dirección del host: si quieres especificar el nombre de host o la dirección IP del destino.
      • Adjunto de servicio: si quieres especificar el punto final privado de tus direcciones IP internas. El adjunto de servicio te permite ocultar tus direcciones IP internas de la red externa. Puedes crear una vinculación de servicio en Google Cloud mediante la función Private Service Connect. Para obtener información sobre cómo configurar Private Service Connect, consulta Publicar servicios gestionados.

      Según el tipo de destino que hayas seleccionado, introduce la dirección del host o el nombre de la vinculación de servicio.

      Para introducir más destinos, haz clic en +Añadir destino.

    2. Haz clic en Siguiente.
  6. En la sección Autenticación, introduce los detalles de autenticación.
    1. Seleccione un Tipo de autenticación e introduzca los detalles pertinentes.

      La conexión de Marketo admite los siguientes tipos de autenticación:

      • Credenciales de cliente de OAuth 2.0
      • Nombre de usuario y contraseña

      2. Para saber cómo configurar estos tipos de autenticación, consulta Configurar la autenticación.

    2. Haz clic en Siguiente.
  7. Revisar: revisa los detalles de la conexión y la autenticación.
  8. Haz clic en Crear.

Configurar la autenticación

Introduce los detalles en función de la autenticación que quieras usar.

  • Credenciales de cliente de OAuth 2.0
    • ID de cliente: el ID de cliente proporcionado por el conector de la aplicación que has creado.
    • Secreto de cliente: secreto de Secret Manager que contiene el secreto de cliente de la aplicación conectada que has creado.
  • Nombre de usuario y contraseña
    • UserId el ID de usuario de la API SOAP de Marketo.
    • EncryptionKey secreto de Secret Manager que contiene la clave de cifrado de la API SOAP de Marketo.

Limitaciones del sistema

El conector de Marketo puede procesar 1 transacción por segundo por nodo y limita las transacciones que superen este límite. De forma predeterminada, Integration Connectors asigna 2 nodos (para mejorar la disponibilidad) a una conexión.

Para obtener información sobre los límites aplicables a Integration Connectors, consulta Límites.

Usar la conexión de Marketo en una integración

Una vez que hayas creado la conexión, estará disponible tanto en Apigee Integration como en Application Integration. Puedes usar la conexión en una integración mediante la tarea Conectores.

  • Para saber cómo crear y usar la tarea Conectores en la integración de Apigee, consulta Tarea Conectores.
  • Para saber cómo crear y usar la tarea Conectores en Application Integration, consulta Tarea Conectores.

Acciones

En esta sección se enumeran las acciones que admite el conector. Para saber cómo configurar las acciones, consulta los ejemplos de acciones.

AddLandingPageContentSection action

Añade una sección de contenido a la página de destino.

Parámetros de entrada de la acción AddLandingPageContentSection

Nombre del parámetro Tipo de datos Obligatorio Descripción
LandingPageId Cadena Verdadero ID de la página de destino.
ContentId Cadena Verdadero ID de la sección de contenido. También el ID HTML de la sección.
Tipo Cadena Verdadero Tipo de sección de contenido. Los valores permitidos son Image, Form, Rectangle, Snippet, RichText y HTML.

Para ver un ejemplo de cómo configurar la acción AddLandingPageContentSection, consulta Ejemplos de acciones.

DeleteLandingPageContentSection action

Elimina la sección del contenido de la página de destino en Marketo.

Parámetros de entrada de la acción DeleteLandingPageContentSection

Nombre del parámetro Tipo de datos Obligatorio Descripción
LandingPageId Cadena Verdadero ID de la página de destino.
ContentId Cadena Verdadero ID de la sección de contenido. También el ID HTML de la sección.

Para ver un ejemplo de cómo configurar la acción DeleteLandingPageContentSection, consulta Ejemplos de acciones.

Acción UpdateEmailContent

Actualiza el contenido de un correo.

Parámetros de entrada de la acción UpdateEmailContent

Nombre del parámetro Tipo de datos Obligatorio Descripción
EmailId Cadena Verdadero ID del correo.
FromEmail Cadena Verdadero Dirección del remitente del correo
FromName Cadena Verdadero Nombre del remitente del correo
ReplyTo Cadena Verdadero Dirección de respuesta del correo
Asunto Cadena Verdadero Asunto del correo

Para ver un ejemplo de cómo configurar la acción UpdateEmailContent, consulta Ejemplos de acciones.

Acción UpdateLandingPageContentSection

Añada o actualice la sección del contenido de la página de destino en Marketo.

Parámetros de entrada de la acción UpdateLandingPageContentSection

Nombre del parámetro Tipo de datos Obligatorio Descripción
Tipo Cadena Verdadero Tipo de sección de contenido.Los valores permitidos son Image, Form, Rectangle, Snippet, RichText y HTML.
Valor Cadena Verdadero Tipo de sección de contenido.
LandingPageId Cadena Verdadero ID de la página de destino.
ContentId Cadena Verdadero ID de la sección de contenido. También el ID HTML de la sección.

Para ver un ejemplo de cómo configurar la acción UpdateLandingPageContentSection, consulta Ejemplos de acciones.

Acción GetImportProgramMembersStatus

Obtiene el estado de los miembros de un programa de importación de una operación de archivo de Marketo.

Parámetros de entrada de la acción GetImportProgramMembersStatus

Nombre del parámetro Tipo de datos Obligatorio Descripción
BatchId Cadena Verdadero ID del lote de importación de clientes potenciales.

Para ver un ejemplo de cómo configurar la acción GetImportProgramMembersStatus, consulta Ejemplos de acciones.

Acción ScheduleCampaign

Programa de forma remota una campaña por lotes para que se publique a una hora determinada.

Parámetros de entrada de la acción ScheduleCampaign

Nombre del parámetro Tipo de datos Obligatorio Descripción
CampaignId Cadena Verdadero ID de la campaña por lotes que se va a programar.
RunAt Cadena Verdadero Fecha y hora en las que se debe publicar la campaña. Si no se define, la campaña se publicará cinco minutos después de que se haga la llamada.

Para ver un ejemplo de cómo configurar la acción ScheduleCampaign, consulta Ejemplos de acciones.

Acción ListMembersOfList

Determina si los clientes potenciales se encuentran en una lista de Marketo.

Parámetros de entrada de la acción ListMembersOfList

Nombre del parámetro Tipo de datos Obligatorio Descripción
ListId Cadena Verdadero ID de la lista en la que se buscarán clientes potenciales.
LeadId Cadena Verdadero Lista de IDs de clientes potenciales separados por comas que se comprobarán para ver si están en la lista especificada por ListId.

Para ver un ejemplo de cómo configurar la acción ListMembersOfList, consulta Ejemplos de acciones.

AssociateLead action

Asocia un registro de cliente potencial de Marketo conocido a una cookie munchkin y a su historial de actividad web asociado.

Parámetros de entrada de la acción AssociateLead

Nombre del parámetro Tipo de datos Obligatorio Descripción
LeadId Cadena Verdadero ID del cliente potencial que se va a asociar.
Cookie Cadena Verdadero El valor de la cookie que se va a asociar.

Para ver un ejemplo de cómo configurar la acción AssociateLead, consulta Ejemplos de acciones.

Acción MergeLeads

Combina dos o más registros de clientes conocidos en un único registro de cliente.

Parámetros de entrada de la acción MergeLeads

Nombre del parámetro Tipo de datos Obligatorio Descripción
WinningLeadId Cadena Verdadero ID del registro de cliente potencial ganador
LoosingLeadId Cadena Verdadero Lista separada por comas de IDs de clientes potenciales perdidos

Para ver un ejemplo de cómo configurar la acción MergeLeads, consulta Ejemplos de acciones.

Acción GetImportLeadsStatus

Obtiene el estado de una operación de importación de clientes potenciales de un archivo de Marketo.

Parámetros de entrada de la acción GetImportLeadsStatus

Nombre del parámetro Tipo de datos Obligatorio Descripción
BatchId Cadena Verdadero ID del lote de importación de clientes potenciales.

Para ver un ejemplo de cómo configurar la acción GetImportLeadsStatus, consulta Ejemplos de acciones.

Acción CancelExportJob

Cancela una tarea de exportación.

Parámetros de entrada de la acción CancelExportJob

Nombre del parámetro Tipo de datos Obligatorio Descripción
JobId Cadena Verdadero Es el ID del trabajo de exportación.
Tipo Cadena Verdadero El tipo de objeto de BulkExtract. Los valores disponibles son Activities, Leads y ProgramMembers. Los valores permitidos son Activities, Leads y ProgramMembers.

Para ver un ejemplo de cómo configurar la acción CancelExportJob, consulta Ejemplos de acciones.

Acción EnqueueExportJob

Coloca una tarea de exportación en la cola e inicia la tarea cuando haya recursos informáticos disponibles.

Parámetros de entrada de la acción EnqueueExportJob

Nombre del parámetro Tipo de datos Obligatorio Descripción
JobId Cadena Verdadero Es el ID del trabajo de exportación.
Tipo Cadena Verdadero El tipo de objeto de BulkExtract. Los valores disponibles son Activities, Leads y ProgramMembers. Los valores permitidos son Activities, Leads y ProgramMembers.

Para ver un ejemplo de cómo configurar la acción EnqueueExportJob, consulta Ejemplos de acciones.

Acción GetExportJobStatus

Devuelve el estado de una tarea de exportación. El estado de la tarea está disponible durante 30 días después de que se haya completado o haya fallado.

Parámetros de entrada de la acción GetExportJobStatus

Nombre del parámetro Tipo de datos Obligatorio Descripción
JobId Cadena Verdadero Es el ID del trabajo de exportación.
Tipo Cadena Verdadero El tipo de objeto de BulkExtract. Los valores disponibles son Activities, Leads y ProgramMembers. Los valores permitidos son Activities, Leads y ProgramMembers.

Para ver un ejemplo de cómo configurar la acción GetExportJobStatus, consulta Ejemplos de acciones.

Acción CreateEmailTemplate

Crea una plantilla de correo.

Parámetros de entrada de la acción CreateEmailTemplate

Nombre del parámetro Tipo de datos Obligatorio Descripción
FolderId Cadena Verdadero ID de la carpeta
FolderType Cadena Verdadero Tipo de carpeta.
Nombre Cadena Verdadero El nombre de la plantilla de correo. Debe ser único en la carpeta principal.
Archivo Cadena Verdadero Archivo multiparte. Contenido HTML de la plantilla.

Para ver un ejemplo de cómo configurar la acción CreateEmailTemplate, consulta Ejemplos de acciones.

Acción UpdateLeadProgramStatus

Cambia el estado del programa de una lista de clientes potenciales en un programa de destino. Solo se puede cambiar el estado de los miembros actuales del programa con esta API.

Parámetros de entrada de la acción UpdateLeadProgramStatus

Nombre del parámetro Tipo de datos Obligatorio Descripción
ProgramId Cadena Verdadero ID de la campaña por lotes que se va a programar.
LeadIds Cadena Verdadero Lista separada por comas de IDs de clientes potenciales.
Estado Cadena Verdadero Estado del programa del registro.

Para ver un ejemplo de cómo configurar la acción UpdateLeadProgramStatus, consulte Ejemplos de acciones.

RemoveLeadsFromList action

Elimina clientes potenciales de una lista en Marketo.

Parámetros de entrada de la acción RemoveLeadsFromList

Nombre del parámetro Tipo de datos Obligatorio Descripción
ListId Cadena Verdadero Es el ID de la lista de la que se van a quitar clientes potenciales.
LeadId Cadena Verdadero Lista separada por comas de los IDs de las oportunidades que se van a quitar de la lista especificada por ListId.

Para ver un ejemplo de cómo configurar la acción RemoveLeadsFromList, consulta Ejemplos de acciones.

Acción ImportCustomObjectsFromFile

Importa objetos personalizados de un archivo a Marketo.

Parámetros de entrada de la acción ImportCustomObjectsFromFile

Nombre del parámetro Tipo de datos Obligatorio Descripción
Archivo Cadena Verdadero Ruta al archivo que contiene los objetos personalizados que se van a importar en Marketo. Por ejemplo, "C:\temp\custom_object_import.csv".
TableName Cadena Verdadero Nombre de la tabla de objetos personalizados. Ejemplo: CustomObject_test
Formato Cadena Verdadero El formato del archivo que se usará para importar objetos personalizados en Marketo. Los valores permitidos son csv, tsv y ssv.
Contenido Cadena Verdadero El contenido como InputStream que se va a subir cuando no se especifica File.

Para ver un ejemplo de cómo configurar la acción ImportCustomObjectsFromFile, consulte Ejemplos de acciones.

Ejemplos de acciones

En esta sección se describe cómo realizar algunas de las acciones de este conector.

Ejemplo: AddLandingPageContentSection

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Seleccione la acción AddLandingPageContentSection y, a continuación, haga clic en Hecho.
  3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input: 
    {
  "LandingPageId": "1005",
  "ContentId": "1120",
  "Type": "HTML"
}

    4. En este ejemplo se muestran los registros de objetos específicos. Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea CampaignTest tendrá un valor similar al siguiente:

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

Ejemplo: DeleteLandingPageContentSection

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Seleccione la acción DeleteLandingPageContentSection y, a continuación, haga clic en Hecho.
  3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input: 
    {
  "LandingPageId": "1005",
  "ContentId": "1009"
}

    4. En este ejemplo se muestran los registros de objetos específicos. Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea DeleteLandingPageContentSection tendrá un valor similar al siguiente:

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

Ejemplo: UpdateEmailContent

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Seleccione la acción UpdateEmailContent y, a continuación, haga clic en Hecho.
  3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input: 
     {
  "EmailId": "1001",
  "FromName": "test",
  "FromEmail": "222larabrown@gmail.com",
  "Subject": "TestSubject Line",
  "ReplyTo": "222larabrown@gmail.com"
}

    4. En este ejemplo se muestran los registros de objetos específicos. Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea UpdateEmailContent tendrá un valor similar al siguiente:

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

Ejemplo: UpdateLandingPageContentSection

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Seleccione la acción UpdateLandingPageContentSection y, a continuación, haga clic en Hecho.
  3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input: 
    {
  "Type": "HTML",
  "Value": "
Test Update
",
  "LandingPageId": "1005",
  "ContentId": "1120"
}

    4. En este ejemplo se muestran los registros de objetos específicos. Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea UpdateLandingPageContentSection tendrá un valor similar al siguiente:

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

Ejemplo: GetImportProgramMembersStatus

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Seleccione la acción GetImportProgramMembersStatus y, a continuación, haga clic en Hecho.
  3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input: 
    {
  "BatchId": "1029"
}

    4. En este ejemplo se muestran los registros de objetos específicos. Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea GetImportProgramMembersStatus tendrá un valor similar al siguiente:

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

Ejemplo: ScheduleCampaign

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Seleccione la acción ScheduleCampaign y, a continuación, haga clic en Hecho.
  3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input: 
    {
  "CampaignId": "1065",
  "RunAt": "2024-05-23T18:05:00+0000"
}

    4. En este ejemplo se muestran los registros de objetos específicos. Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ScheduleCampaign tendrá un valor similar al siguiente:

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

Ejemplo: ListMembersOfList

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Seleccione la acción ListMembersOfList y, a continuación, haga clic en Hecho.
  3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input: 
    {
  "ListId": "1003",
  "LeadId": "13,25,21"
}

    4. En este ejemplo se muestran los registros de objetos específicos. Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ListMembersOfList tendrá un valor similar al siguiente:

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

Ejemplo: AssociateLead

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Seleccione la acción AssociateLead y, a continuación, haga clic en Hecho.
  3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input: 
    {
  "LeadId": 582.0,
  "Cookie": "id:703-VQQ-088%26token:_mch-marketo.com-_mch-mktoweb.com-1717156982039-98850"
}

    4. En este ejemplo se muestran los registros de objetos específicos. Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea AssociateLead tendrá un valor similar al siguiente:

     
 [{
  "Status": "Success"
}]

Ejemplo: MergeLeads

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Seleccione la acción MergeLeads y, a continuación, haga clic en Hecho.
  3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input: 
     {
  "LoosingLeadId": "10",
  "WinningLeadId": "45"
}

    4. En este ejemplo se muestran los registros de objetos específicos. Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea MergeLeads tendrá un valor similar al siguiente:

     
  [{
  "Status": "Success"
}]

Ejemplo: GetImportLeadsStatus

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Seleccione la acción GetImportLeadsStatus y, a continuación, haga clic en Hecho.
  3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input: 
    {
  "BatchId": "1022"
}

    4. En este ejemplo se muestran los registros de objetos específicos. Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea GetImportLeadsStatus tendrá un valor similar al siguiente:

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

Ejemplo: cancelar una tarea de exportación

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Seleccione la acción CancelExportJob y, a continuación, haga clic en Hecho.
  3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input: 
    {
  "JobId": "ddf64e6f-0e9c-4254-91a9-32277349a22b",
  "Type": "Leads"
}

    4. En este ejemplo se muestran los registros de objetos específicos. Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea CancelExportJob tendrá un valor similar al siguiente:

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

Ejemplo: EnqueueExportJob

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Seleccione la acción EnqueueExportJob y, a continuación, haga clic en Hecho.
  3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input: 
    {
  "JobId": "d04f60fb-5e68-40b5-9928-76fdb9034303",
  "Type": "Leads"
}

    4. En este ejemplo se muestran los registros de objetos específicos. Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea EnqueueExportJob tendrá un valor similar al siguiente:

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

Ejemplo: GetExportJobStatus

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Seleccione la acción GetExportJobStatus y, a continuación, haga clic en Hecho.
  3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input: 
    {
  "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
  "Type": "Leads"
}

    4. En este ejemplo se muestran los registros de objetos específicos. Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea GetExportJobStatus tendrá un valor similar al siguiente:

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

Ejemplo: CreateEmailTemplate

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Seleccione la acción CreateEmailTemplate y, a continuación, haga clic en Hecho.
  3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input: 
    {
  "FolderId": 27.0,
  "FolderType": "Folder",
  "Content": "\n\n\n \n
My First Heading
\n
My first paragraph.

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

    4. En este ejemplo se muestran los registros de objetos específicos. Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea CreateEmailTemplate tendrá un valor similar al siguiente:

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

Ejemplo: UpdateLeadProgramStatus

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Seleccione la acción UpdateLeadProgramStatus y, a continuación, haga clic en Hecho.
  3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input: 
    {
  "ProgramId": "1002",
  "Status": "Member",
  "LeadIds": "3"
}

    4. En este ejemplo se muestran los registros de objetos específicos. Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea UpdateLeadProgramStatus tendrá un valor similar al siguiente:

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

Ejemplo: RemoveLeadsFromList

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Seleccione la acción RemoveLeadsFromList y, a continuación, haga clic en Hecho.
  3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input: 
     {
  "ListId": "1026",
  "LeadId": "57"
}

    4. En este ejemplo se muestran los registros de objetos específicos. Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea RemoveLeadsFromList tendrá un valor similar al siguiente:

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

Ejemplo: ImportCustomObjectsFromFile

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Seleccione la acción ImportCustomObjectsFromFile y, a continuación, haga clic en Hecho.
  3. En la sección Asignación de datos Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input: 
    {
  "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
  "Type": "Leads"
}

    4. En este ejemplo se muestran los registros de objetos específicos. Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ImportCustomObjectsFromFile tendrá un valor similar al siguiente:

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

Ejemplos de operaciones de entidades

En esta sección se muestra cómo realizar algunas de las operaciones de entidad en este conector.

Cuando uses una operación de lista y preveas que el volumen de datos será elevado, te recomendamos que especifiques una cláusula de filtro para las siguientes entidades: LeadsLists, LeadPrograms, Activities, LandingPageContentSec, LeadChanges, LeadChangesFields, Emails, LandingPages, Forms, Programs, Leads, LandingPageTemplateCon, OpportunityRoles, SalesPersons, Tokens, ListStaticMemberShip, Opportunities, LeadChangesAttributes y Segments. Además, para ordenar el conjunto de resultados, primero debe aplicar la cláusula de filtro.

Ejemplo: listar todos los correos

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Correos en la lista Entity.
  3. Selecciona la operación List y, a continuación, haz clic en Hecho.

Ejemplo: Obtener una sola SmartCampaigns

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona SmartCampaigns en la lista Entity.
  3. Selecciona la operación Get y, a continuación, haz clic en Hecho.
  4. Define el ID de entidad en Get single SmartCampaigns. Para definir el ID de entidad, en la sección Asignación de datos de Asignador de datos, haga clic en Abrir editor de asignación de datos. A continuación, introduzca 1002 en el campo Valor de entrada y elija EntityId como variable local.

Ejemplo: eliminar correos

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Correos en la lista Entity.
  3. Selecciona la operación Delete y, a continuación, haz clic en Hecho.
  4. Define el ID de entidad como Delete Emails. Para definir el ID de entidad, en la sección Asignación de datos de Asignador de datos, haga clic en Abrir editor de asignación de datos. A continuación, introduzca 1048.0 en el campo Valor de entrada y elija EntityId como variable local.

Ejemplo: crear correos

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Correos en la lista Entity.
  3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
  4. En la sección Asignador de datos de la Tarea, haz clic en el editor de OpenDataMapping y, a continuación, introduce un valor similar al siguiente en el field: 
     {
"Template": 1.0,
"FolderId": 1002.0,
"Name": "Test Email",
"FolderType": "Program"
}

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

    {
"Id": "1048.0"
}

Ejemplo: Update EmailTemplates

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona EmailTemplates en la lista Entity.
  3. Selecciona la operación Update y, a continuación, haz clic en Hecho.
  4. Define EntityID para actualizar EmailTemplates. Para definir el EntityID, en la sección Mapeador de datos de Tareas, haz clic en EntityID y, a continuación, introduce 1034.0 en el campo correspondiente.
  5. En la sección Asignador de datos de la Tarea, haz clic en el editor OpenDataMapping y, a continuación, introduce un valor similar al siguiente en field: 
     
{
"Name": "temp email updated",
"Description": "updation"
}

    6. Al ejecutar este ejemplo, se devuelve una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea Connector:

    {
"Id": 1034.0
}

Obtener ayuda de la comunidad de Google Cloud

Puedes publicar tus preguntas y hablar sobre este conector en la comunidad de Google Cloud, en los foros de Cloud.

Siguientes pasos