Marketo

Le connecteur Marketo vous permet d'effectuer des opérations d'insertion, de suppression, de mise à jour et de lecture sur les données Marketo.

Avant de commencer

Avant d'utiliser le connecteur Marketo, effectuez les tâches suivantes :

  • Dans votre projet Google Cloud :
    • Assurez-vous que la connectivité réseau est configurée. Pour en savoir plus sur les schémas de réseau, consultez Connectivité réseau.
    • Attribuez le rôle IAM roles/connectors.admin à l'utilisateur qui configure le connecteur.
    • Attribuez les rôles IAM suivants au compte de service que vous souhaitez utiliser pour le connecteur :
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Un compte de service est un type spécial de compte Google destiné à représenter un utilisateur non humain qui doit s'authentifier et obtenir les autorisations permettant d'accéder aux données des API Google. Si vous ne possédez pas de compte de service, vous devez en créer un. Pour plus d'informations, consultez Créer un compte de service.

    • Activez les services suivants :
      • secretmanager.googleapis.com (API Secret Manager)
      • connectors.googleapis.com (API Connectors)

      Pour savoir comment activer des services, consultez Activer des services.

    Si ces services ou autorisations n'ont pas encore été activés pour votre projet, vous êtes invité à les activer au moment de configurer le connecteur.

Configurer le connecteur

Une connexion est propre à une source de données. Cela signifie que si vous disposez de nombreuses sources de données, vous devez créer une connexion distincte pour chacune d'elles. Pour créer une connexion, procédez comme suit :

  1. Dans la console Cloud, accédez à la page Connecteurs d'intégration > Connexions, puis sélectionnez ou créez un projet Google Cloud.

    Accéder à la page "Connexions"

  2. Cliquez sur + Créer pour ouvrir la page Créer une connexion.
  3. Dans la section Emplacement, choisissez l'emplacement de la connexion.
    1. Région : sélectionnez un emplacement dans la liste déroulante.

      Les régions disponibles pour les connecteurs sont les suivantes :

      Pour obtenir la liste de toutes les régions disponibles, consultez Emplacements.

    2. Cliquez sur Suivant.
  4. Dans la section Détails de la connexion, procédez comme suit :
    1. Connecteur : sélectionnez Marketo dans la liste déroulante des connecteurs disponibles.
    2. Version du connecteur : sélectionnez la version du connecteur dans la liste déroulante des versions disponibles.
    3. Dans le champ Nom de connexion, indiquez le nom de l'instance de connexion.

      Les noms de connexion doivent répondre aux critères suivants :

      • Ils peuvent contenir des lettres, des chiffres ou des traits d'union.
      • Les lettres doivent être en minuscules.
      • Les noms de connexion doivent commencer par une lettre et se terminer par une lettre ou un chiffre.
      • Ils ne peuvent pas dépasser 49 caractères.
    4. (Facultatif) Saisissez une description de l'instance de connexion.
    5. Compte de service : sélectionnez un compte de service disposant des rôles requis.
    6. (Facultatif) Configurez les paramètres de nœuds de connexion :

      • Nombre minimal de nœuds : saisissez le nombre minimal de nœuds de connexion.
      • Nombre maximal de nœuds : saisissez le nombre maximal de nœuds de connexion.

      Un nœud est une unité (ou instance répliquée) de connexion qui traite des transactions. Pour traiter davantage de transactions pour une connexion, vous devez disposer de plus de nœuds. À l'inverse, moins de nœuds sont nécessaires si une connexion traite moins de transactions. Pour comprendre comment les nœuds affectent la tarification de votre connecteur, consultez Tarifs des nœuds de connexion. Si vous ne saisissez aucune valeur, le nombre minimal de nœuds est défini par défaut sur 2 (pour améliorer la disponibilité) et le nombre maximal de nœuds sur 50.

    7. (Facultatif) Cliquez sur + Ajouter une étiquette pour ajouter une étiquette à la connexion sous la forme d'une paire clé/valeur.
    8. Cliquez sur Suivant.
  5. Dans la section Destinations, saisissez des informations sur l'hôte distant (système backend) auquel vous souhaitez vous connecter.
    1. Type de destination : vous pouvez spécifier les détails de destination sous la forme d'une adresse hôte ou d'un rattachement de service. Sélectionnez l'un des types de destination suivants :
      • Adresse hôte : si vous souhaitez spécifier le nom d'hôte ou l'adresse IP de la destination.
      • Rattachement de service : si vous souhaitez spécifier le point de terminaison privé pour vos adresses IP internes. Le rattachement de service vous permet de masquer vos adresses IP internes dans le réseau externe. Vous pouvez créer un rattachement de service dans Google Cloud à l'aide de la fonctionnalité Private Service Connect. Pour en savoir plus sur la configuration d'une instance Private Service Connect, consultez Publier des services gérés.

      En fonction du type de destination sélectionné, saisissez l'adresse hôte ou le nom du rattachement de service.

      Pour saisir d'autres destinations, cliquez sur + Ajouter une destination.

    2. Cliquez sur Suivant.
  6. Dans la section Authentification, saisissez les informations d'authentification.
    1. Sélectionnez un type d'authentification, puis saisissez les informations appropriées.

      Les types d'authentification suivants sont compatibles avec la connexion Marketo :

      • Identifiants client OAuth2
      • Nom d'utilisateur et mot de passe

      2. Pour savoir comment configurer ces types d'authentification, consultez Configurer l'authentification.

    2. Cliquez sur Suivant.
  7. Vérifier : vérifiez vos informations de connexion et d'authentification.
  8. Cliquez sur Créer.

Configurer l'authentification

Saisissez les informations en fonction de l'authentification que vous souhaitez utiliser.

  • Identifiants client OAuth 2.0
    • ID client : ID client fourni par le connecteur pour l'application que vous avez créée
    • Code secret du client : secret Secret Manager contenant le code secret du client pour l'application connectée que vous avez créée
  • Nom d'utilisateur et mot de passe
    • UserId : ID utilisateur de l'API SOAP Marketo
    • EncryptionKey : secret Secret Manager contenant la clé de chiffrement de l'API SOAP Marketo

Limites du système

Le connecteur Marketo peut traiter une transaction par seconde et par nœud, et limite les transactions qui dépassent cette limite. Par défaut, Integration Connectors alloue deux nœuds (pour améliorer la disponibilité) à une connexion.

Pour en savoir plus sur les limites applicables à Integration Connectors, consultez Limites.

Utiliser la connexion Marketo dans une intégration

Une fois la connexion créée, elle devient disponible dans Apigee Integration et Application Integration. Vous pouvez utiliser la connexion dans une intégration au moyen de la tâche "Connecteurs".

  • Pour savoir comment créer et utiliser la tâche "Connecteurs" dans Apigee Integration, consultez Tâche "Connecteurs".
  • Pour savoir comment créer et utiliser la tâche "Connecteurs" dans Application Integration, consultez Tâche "Connecteurs".

Actions

Cette section liste les actions prises en charge par le connecteur. Pour savoir comment configurer les actions, consultez Exemples d'actions.

Action AddLandingPageContentSection

Cette action ajoute une section de contenu à la page de destination cible.

Paramètres d'entrée de l'action AddLandingPageContentSection

Nom du paramètre Type de données Obligatoire Description
LandingPageId STRING True ID de la page de destination.
ContentId STRING True ID de la section de contenu. ID HTML de la section.
Type STRING True Section du type de contenu. Valeurs autorisées : "Image", "Form", "Rectangle", "Snippet", "RichText" et "HTML".

Pour savoir comment configurer l'action AddLandingPageContentSection, consultez Exemples d'actions.

Action DeleteLandingPageContentSection

Cette action supprime la section du contenu de la page de destination dans Marketo.

Paramètres d'entrée de l'action DeleteLandingPageContentSection

Nom du paramètre Type de données Obligatoire Description
LandingPageId STRING True ID de la page de destination.
ContentId STRING True ID de la section de contenu. ID HTML de la section.

Pour savoir comment configurer l'action DeleteLandingPageContentSection, consultez Exemples d'actions.

Action UpdateEmailContent

Cette action met à jour le contenu d'un e-mail.

Paramètres d'entrée de l'action UpdateEmailContent

Nom du paramètre Type de données Obligatoire Description
EmailId STRING True Identifiant de l'e-mail.
FromEmail STRING True Adresse de l'expéditeur de l'e-mail.
FromName STRING True Nom de l'expéditeur de l'e-mail.
ReplyTo STRING True Adresse de réponse de l'e-mail.
Subject STRING True Objet de l'e-mail.

Pour savoir comment configurer l'action UpdateEmailContent, consultez Exemples d'actions.

Action UpdateLandingPageContentSection

Cette action ajoute ou met à jour la section du contenu de la page de destination dans Marketo.

Paramètres d'entrée de l'action UpdateLandingPageContentSection

Nom du paramètre Type de données Obligatoire Description
Type STRING True Section du type de contenu. Valeurs autorisées : "Image", "Form", "Rectangle", "Snippet", "RichText" et "HTML".
Value STRING True Section du type de contenu.
LandingPageId STRING True ID de la page de destination.
ContentId STRING True ID de la section de contenu. ID HTML de la section.

Pour savoir comment configurer l'action UpdateLandingPageContentSection, consultez Exemples d'actions.

Action GetImportProgramMembersStatus

Cette action permet d'obtenir l'état d'une opération d'importation de membres d'un programme à partir d'un fichier pour Marketo.

Paramètres d'entrée de l'action GetImportProgramMembersStatus

Nom du paramètre Type de données Obligatoire Description
BatchId STRING True Identifiant du lot d'importation de prospects.

Pour savoir comment configurer l'action GetImportProgramMembersStatus, consultez Exemples d'actions.

Action ScheduleCampaign

Cette action planifie à distance la diffusion à un moment donné d'une campagne par lot.

Paramètres d'entrée de l'action ScheduleCampaign

Nom du paramètre Type de données Obligatoire Description
CampaignId STRING True ID de la campagne par lot à planifier.
RunAt STRING True Date et heure de diffusion de la campagne. Si cette valeur n'est pas définie, la campagne sera diffusée cinq minutes après l'appel.

Pour savoir comment configurer l'action ScheduleCampaign, consultez Exemples d'actions.

Action ListMembersOfList

Cette action détermine si les prospects figurent sur une liste dans Marketo.

Paramètres d'entrée de l'action ListMembersOfList

Nom du paramètre Type de données Obligatoire Description
ListId STRING True Identifiant de la liste à vérifier pour les prospects.
LeadId STRING True Liste d'ID de prospects séparés par une virgule à vérifier pour savoir s'ils figurent sur la liste spécifiée par ListId.

Pour savoir comment configurer l'action ListMembersOfList, consultez Exemples d'actions.

Action AssociateLead

Cette action associe un enregistrement de prospect Marketo connu à un cookie Munchkin et à l'historique d'activité Web correspondant.

Paramètres d'entrée de l'action AssociateLead

Nom du paramètre Type de données Obligatoire Description
LeadId STRING True ID du prospect à associer.
Cookie STRING True Valeur du cookie à associer.

Pour savoir comment configurer l'action AssociateLead, consultez Exemples d'actions.

Action MergeLeads

Cette action permet de fusionner plusieurs enregistrements de prospects connus en un seul.

Paramètres d'entrée de l'action MergeLeads

Nom du paramètre Type de données Obligatoire Description
WinningLeadId STRING True ID du prospect gagnant.
LoosingLeadId STRING True Liste d'ID de prospects perdants séparés par une virgule.

Pour savoir comment configurer l'action MergeLeads, consultez Exemples d'actions.

Action GetImportLeadsStatus

Cette action permet d'obtenir l'état d'une opération d'importation de prospects à partir d'un fichier pour Marketo.

Paramètres d'entrée de l'action GetImportLeadsStatus

Nom du paramètre Type de données Obligatoire Description
BatchId STRING True Identifiant du lot d'importation de prospects.

Pour savoir comment configurer l'action GetImportLeadsStatus, consultez Exemples d'actions.

Action CancelExportJob

Cette action annule un job d'exportation.

Paramètres d'entrée de l'action CancelExportJob

Nom du paramètre Type de données Obligatoire Description
JobId STRING True Identifiant du job d'exportation.
Type STRING True Type d'objet de BulkExtract. Valeurs disponibles : "Activities", "Leads" et "ProgramMembers". Valeurs autorisées : "Activities", "Leads" et "ProgramMembers".

Pour savoir comment configurer l'action CancelExportJob, consultez Exemples d'actions.

Action EnqueueExportJob

Cette action place un job d'exportation dans la file d'attente et le démarre lorsque les ressources de calcul sont disponibles.

Paramètres d'entrée de l'action EnqueueExportJob

Nom du paramètre Type de données Obligatoire Description
JobId STRING True Identifiant du job d'exportation.
Type STRING True Type d'objet de BulkExtract. Valeurs disponibles : "Activities", "Leads" et "ProgramMembers". Valeurs autorisées : "Activities", "Leads" et "ProgramMembers".

Pour savoir comment configurer l'action EnqueueExportJob, consultez Exemples d'actions.

Action GetExportJobStatus

Cette action renvoie l'état d'un job d'exportation. L'état du job est disponible pendant 30 jours une l'état "Terminé" ou "Échec" atteint.

Paramètres d'entrée de l'action GetExportJobStatus

Nom du paramètre Type de données Obligatoire Description
JobId STRING True Identifiant du job d'exportation.
Type STRING True Type d'objet de BulkExtract. Valeurs disponibles : "Activities", "Leads" et "ProgramMembers". Valeurs autorisées : "Activities", "Leads" et "ProgramMembers".

Pour savoir comment configurer l'action GetExportJobStatus, consultez Exemples d'actions.

Action CreateEmailTemplate

Cette action crée un modèle d'e-mail.

Paramètres d'entrée de l'action CreateEmailTemplate

Nom du paramètre Type de données Obligatoire Description
FolderId STRING True ID du dossier.
FolderType STRING True Type de dossier.
Name STRING True Nom du modèle d'e-mail. Doit être unique dans le dossier parent.
File STRING True Fichier multipart. Contenu HTML du modèle.

Pour savoir comment configurer l'action CreateEmailTemplate, consultez Exemples d'actions.

Action UpdateLeadProgramStatus

Cette action modifie l'état du programme d'une liste de prospects dans un programme cible. Seul l'état des membres existants du programme peut être modifié avec cette API.

Paramètres d'entrée de l'action UpdateLeadProgramStatus

Nom du paramètre Type de données Obligatoire Description
ProgramId STRING True ID de la campagne par lot à planifier.
LeadIds STRING True Liste d'ID de prospects séparés par une virgule pour l'entrée.
Status STRING True État du programme de l'enregistrement.

Pour savoir comment configurer l'action UpdateLeadProgramStatus, consultez Exemples d'actions.

Action RemoveLeadsFromList

Cette action supprime les prospects d'une liste dans Marketo.

Paramètres d'entrée de l'action RemoveLeadsFromList

Nom du paramètre Type de données Obligatoire Description
ListId STRING True Identifiant de la liste dans laquelle vous souhaitez supprimer des prospects.
LeadId STRING True Liste d'ID de prospects séparés par une virgule à supprimer de la liste spécifiée par ListId.

Pour savoir comment configurer l'action RemoveLeadsFromList, consultez Exemples d'actions.

Action ImportCustomObjectsFromFile

Cette action importe des objets personnalisés à partir d'un fichier dans Marketo.

Paramètres d'entrée de l'action ImportCustomObjectsFromFile

Nom du paramètre Type de données Obligatoire Description
File STRING True Chemin d'accès au fichier contenant les objets personnalisés à importer dans Marketo. Par exemple : "C:\temp\custom_object_import.csv".
TableName STRING True Nom de la table d'objets personnalisés. Exemple : CustomObject_test
Format STRING True Format du fichier qui sera utilisé pour importer des objets personnalisés dans Marketo. Valeurs autorisées : "csv", "tsv" et "ssv".
Content STRING True Contenu à importer comme flux d'entrée (InputStream) quand le fichier (File) n'est pas spécifié.

Pour savoir comment configurer l'action ImportCustomObjectsFromFile, consultez Exemples d'actions.

Exemples d'actions

Cette section explique comment effectuer certaines actions dans ce connecteur.

Exemple : AddLandingPageContentSection

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action AddLandingPageContentSection , puis cliquez sur OK.
  3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input : 
    {
  "LandingPageId": "1005",
  "ContentId": "1120",
  "Type": "HTML"
}

    4. Cet exemple montre les enregistrements d'objets spécifiques. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche CampaignTest aura une valeur semblable à la suivante :

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

Exemple : DeleteLandingPageContentSection

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action DeleteLandingPageContentSection, puis cliquez sur OK.
  3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input : 
    {
  "LandingPageId": "1005",
  "ContentId": "1009"
}

    4. Cet exemple montre les enregistrements d'objets spécifiques. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche DeleteLandingPageContentSection aura une valeur semblable à la suivante :

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

Exemple : UpdateEmailContent

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action UpdateEmailContent , puis cliquez sur OK.
  3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input : 
     {
  "EmailId": "1001",
  "FromName": "test",
  "FromEmail": "222larabrown@gmail.com",
  "Subject": "TestSubject Line",
  "ReplyTo": "222larabrown@gmail.com"
}

    4. Cet exemple montre les enregistrements d'objets spécifiques. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche UpdateEmailContent aura une valeur semblable à la suivante :

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

Exemple : UpdateLandingPageContentSection

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action UpdateLandingPageContentSection , puis cliquez sur OK.
  3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input : 
    {
  "Type": "HTML",
  "Value": "
Test Update
",
  "LandingPageId": "1005",
  "ContentId": "1120"
}

    4. Cet exemple montre les enregistrements d'objets spécifiques. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche UpdateLandingPageContentSection aura une valeur semblable à la suivante :

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

Exemple : GetImportProgramMembersStatus

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action GetImportProgramMembersStatus , puis cliquez sur OK.
  3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input : 
    {
  "BatchId": "1029"
}

    4. Cet exemple montre les enregistrements d'objets spécifiques. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche GetImportProgramMembersStatus aura une valeur semblable à la suivante :

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

Exemple : ScheduleCampaign

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action ScheduleCampaign , puis cliquez sur OK.
  3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input : 
    {
  "CampaignId": "1065",
  "RunAt": "2024-05-23T18:05:00+0000"
}

    4. Cet exemple montre les enregistrements d'objets spécifiques. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ScheduleCampaign aura une valeur semblable à la suivante :

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

Exemple : ListMembersOfList

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action ListMembersOfList , puis cliquez sur OK.
  3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input : 
    {
  "ListId": "1003",
  "LeadId": "13,25,21"
}

    4. Cet exemple montre les enregistrements d'objets spécifiques. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ListMembersOfList aura une valeur semblable à la suivante :

     
[{
  "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"
}]

Exemple : AssociateLead

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action AssociateLead , puis cliquez sur OK.
  3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input : 
    {
  "LeadId": 582.0,
  "Cookie": "id:703-VQQ-088%26token:_mch-marketo.com-_mch-mktoweb.com-1717156982039-98850"
}

    4. Cet exemple montre les enregistrements d'objets spécifiques. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche AssociateLead aura une valeur semblable à la suivante :

     
 [{
  "Status": "Success"
}]

Exemple : MergeLeads

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action MergeLeads , puis cliquez sur OK.
  3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input : 
     {
  "LoosingLeadId": "10",
  "WinningLeadId": "45"
}

    4. Cet exemple montre les enregistrements d'objets spécifiques. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche MergeLeads aura une valeur semblable à la suivante :

     
  [{
  "Status": "Success"
}]

Exemple : GetImportLeadsStatus

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action GetImportLeadsStatus , puis cliquez sur OK.
  3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input : 
    {
  "BatchId": "1022"
}

    4. Cet exemple montre les enregistrements d'objets spécifiques. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche GetImportLeadsStatus aura une valeur semblable à la suivante :

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

Exemple : CancelExportJob

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action CancelExportJob , puis cliquez sur OK.
  3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input : 
    {
  "JobId": "ddf64e6f-0e9c-4254-91a9-32277349a22b",
  "Type": "Leads"
}

    4. Cet exemple montre les enregistrements d'objets spécifiques. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche CancelExportJob aura une valeur semblable à la suivante :

     
[{
  "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
}]

Exemple : EnqueueExportJob

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action EnqueueExportJob , puis cliquez sur OK.
  3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input : 
    {
  "JobId": "d04f60fb-5e68-40b5-9928-76fdb9034303",
  "Type": "Leads"
}

    4. Cet exemple montre les enregistrements d'objets spécifiques. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche EnqueueExportJob aura une valeur semblable à la suivante :

     
[{
  "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
}]

Exemple : GetExportJobStatus

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action GetExportJobStatus , puis cliquez sur OK.
  3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input : 
    {
  "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
  "Type": "Leads"
}

    4. Cet exemple montre les enregistrements d'objets spécifiques. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche GetExportJobStatus aura une valeur semblable à la suivante :

     
[{
  "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
}]

Exemple : CreateEmailTemplate

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action CreateEmailTemplate , puis cliquez sur OK.
  3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ 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. Cet exemple montre les enregistrements d'objets spécifiques. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche CreateEmailTemplate aura une valeur semblable à la suivante :

     
[{
  "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"
}]

Exemple : UpdateLeadProgramStatus

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action UpdateLeadProgramStatus , puis cliquez sur OK.
  3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input : 
    {
  "ProgramId": "1002",
  "Status": "Member",
  "LeadIds": "3"
}

    4. Cet exemple montre les enregistrements d'objets spécifiques. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche UpdateLeadProgramStatus aura une valeur semblable à la suivante :

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

Exemple : RemoveLeadsFromList

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action RemoveLeadsFromList , puis cliquez sur OK.
  3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input : 
     {
  "ListId": "1026",
  "LeadId": "57"
}

    4. Cet exemple montre les enregistrements d'objets spécifiques. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche RemoveLeadsFromList aura une valeur semblable à la suivante :

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

Exemple : ImportCustomObjectsFromFile

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action ImportCustomObjectsFromFile , puis cliquez sur OK.
  3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input : 
    {
  "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
  "Type": "Leads"
}

    4. Cet exemple montre les enregistrements d'objets spécifiques. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ImportCustomObjectsFromFile aura une valeur semblable à la suivante :

     
[{
  "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
}]

Exemples d'opérations d'entité

Cette section explique comment effectuer certaines opérations d'entité dans ce connecteur.

Lorsque vous utilisez une opération de création de liste et que vous prévoyez un volume de données élevé, nous vous recommandons de spécifier une clause de filtre pour les entités suivantes : LeadsLists, LeadPrograms, Activities, LandingPageContentSec, LeadChanges, LeadChangesFields, Emails, LandingPages, Forms, Programs, Leads, LandingPageTemplateCon, OpportunityRoles, SalesPersons, Tokens, ListStaticMemberShip, Opportunities, LeadChangesAttributes et Segments. De plus, pour trier l'ensemble de résultats, vous devez d'abord appliquer la clause de filtre.

Exemple : Lister tous les Emails

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Emails" dans la liste Entity.
  3. Sélectionnez l'opération List, puis cliquez sur OK.

Exemple : Récupérer une seule SmartCampaign

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "SmartCampaigns" dans la liste Entity.
  3. Sélectionnez l'opération Get, puis cliquez sur OK.
  4. Définissez l'ID d'entité sur "Get single SmartCampaigns". Pour définir l'ID d'entité, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez 1002 dans le champ Valeur d'entrée et choisissez "EntityId" comme variable locale.

Exemple : Supprimer des Emails

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Emails" dans la liste Entity.
  3. Sélectionnez l'opération Delete, puis cliquez sur OK.
  4. Définissez l'ID d'entité sur "Delete Emails". Pour définir l'ID d'entité, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez 1048.0 dans le champ Valeur d'entrée et choisissez "EntityId" comme variable locale.

Exemple : Créer des Emails

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Emails" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche, cliquez sur l'éditeur OpenDataMapping, puis saisissez une valeur semblable à la suivante dans le 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"
}

Exemple : Mettre à jour des EmailTemplates

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "EmailTemplates" dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Définissez l'ID d'entité sur "Update a EmailTemplates". Pour définir l'ID d'entité, dans la section Data Mapper des tâches, cliquez sur EntityID, puis saisissez 1034.0 dans le champ indiqué.
  5. Dans la section Data Mapper de la tâche, cliquez sur l'éditeur OpenDataMapping, puis saisissez une valeur semblable à la suivante dans le field: 
     
{
"Name": "temp email updated",
"Description": "updation"
}

    6. L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

    {
"Id": 1034.0
}

Demander de l'aide à la communauté Google Cloud

Vous pouvez publier vos questions et discuter de ce connecteur sur les forums Cloud de la communauté Google Cloud.

Étapes suivantes