Marketo

Il connettore Marketo ti consente di eseguire operazioni di inserimento, eliminazione, aggiornamento e lettura sui dati di Marketo.

Prima di iniziare

Prima di utilizzare il connettore Marketo, svolgi le seguenti attività:

  • Nel tuo progetto Google Cloud:
    • Assicurati che la connettività di rete sia configurata. Per informazioni sui pattern di rete, consulta Connettività di rete.
    • Concedi il ruolo IAM roles/connectors.admin all'utente che configura il connettore.
    • Concedi i seguenti ruoli IAM al account di servizio che vuoi utilizzare per il connettore:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Un account di servizio è un tipo speciale di Account Google destinato a rappresentare un utente "non umano" che deve eseguire l'autenticazione ed essere autorizzato ad accedere ai dati nelle API Google. Se non hai un account di servizio, devi crearne uno. Per maggiori informazioni, consulta Creare un account di servizio.

    • Attiva i seguenti servizi:
      • secretmanager.googleapis.com (API Secret Manager)
      • connectors.googleapis.com (API Connectors)

      Per scoprire come attivare i servizi, consulta Abilitazione dei servizi.

    Se questi servizi o autorizzazioni non sono stati attivati in precedenza per il tuo progetto, ti verrà chiesto di attivarli durante la configurazione del connettore.

Configura il connettore

Una connessione è specifica per un'origine dati. Ciò significa che se hai molte origini dati, devi creare una connessione distinta per ciascuna. Per creare una connessione:

  1. Nella console Cloud, vai alla pagina Connettori di integrazione > Connessioni e seleziona o crea un progetto Google Cloud.

    Vai alla pagina Connessioni

  2. Fai clic su + Crea nuovo per aprire la pagina Crea connessione.
  3. Nella sezione Località, scegli la località della connessione.
    1. Regione: seleziona una località dall'elenco a discesa.

      Le regioni supportate per i connettori includono:

      Per l'elenco di tutte le regioni supportate, consulta Località.

    2. Fai clic su Avanti.
  4. Nella sezione Dettagli connessione, completa quanto segue:
    1. Connettore: seleziona Marketo dall'elenco a discesa dei connettori disponibili.
    2. Versione del connettore: seleziona la versione del connettore dall'elenco a discesa delle versioni disponibili.
    3. Nel campo Nome connessione, inserisci un nome per l'istanza di connessione.

      I nomi delle connessioni devono soddisfare i seguenti criteri:

      • I nomi delle connessioni possono contenere lettere, numeri o trattini.
      • Le lettere devono essere minuscole.
      • I nomi delle connessioni devono iniziare con una lettera e terminare con una lettera o un numero.
      • I nomi delle connessioni non possono contenere più di 49 caratteri.
    4. (Facoltativo) Inserisci una Descrizione per l'istanza di connessione.
    5. Account di servizio: seleziona un account di servizio con i ruoli richiesti.
    6. (Facoltativo) Configura le impostazioni del nodo di connessione:

      • Numero minimo di nodi: inserisci il numero minimo di nodi di connessione.
      • Numero massimo di nodi: inserisci il numero massimo di nodi di connessione.

      Un nodo è un'unità (o una replica) di una connessione che elabora le transazioni. Sono necessari più nodi per elaborare più transazioni per una connessione e, al contrario, sono necessari meno nodi per elaborare meno transazioni. Per capire in che modo i nodi influiscono sui prezzi dei connettori, consulta Prezzi per i nodi di connessione. Se non inserisci alcun valore, per impostazione predefinita il numero minimo di nodi è impostato su 2 (per una maggiore disponibilità) e il numero massimo di nodi è impostato su 50.

    7. Se vuoi, fai clic su + Aggiungi etichetta per aggiungere un'etichetta alla connessione sotto forma di coppia chiave/valore.
    8. Fai clic su Avanti.
  5. Nella sezione Destinazioni, inserisci i dettagli dell'host remoto (sistema di backend) a cui vuoi connetterti.
    1. Tipo di destinazione: puoi specificare i dettagli della destinazione come indirizzo host o allegato del servizio. Seleziona uno dei seguenti tipi di destinazione:
      • Indirizzo host: se vuoi specificare il nome host o l'indirizzo IP della destinazione.
      • Allegato del servizio: se vuoi specificare l'endpoint privato per i tuoi indirizzi IP interni. L'attacco del servizio ti consente di nascondere i tuoi indirizzi IP interni alla rete esterna. Puoi creare un collegamento a un servizio in Google Cloud utilizzando la funzionalità Private Service Connect. Per informazioni sulla configurazione di Private Service Connect, consulta Pubblicare servizi gestiti.

      In base al tipo di destinazione selezionato, inserisci l'indirizzo host o il nome dell'allegato del servizio.

      Per inserire altre destinazioni, fai clic su + Aggiungi destinazione.

    2. Fai clic su Avanti.
  6. Nella sezione Autenticazione, inserisci i dettagli di autenticazione.
    1. Seleziona un Tipo di autenticazione e inserisci i dettagli pertinenti.

      La connessione Marketo supporta i seguenti tipi di autenticazione:

      • Credenziali client OAuth 2.0
      • Nome utente e password

      2. Per capire come configurare questi tipi di autenticazione, consulta Configurare l'autenticazione.

    2. Fai clic su Avanti.
  7. Rivedi: controlla i dettagli di connessione e autenticazione.
  8. Fai clic su Crea.

Configura autenticazione

Inserisci i dettagli in base all'autenticazione che vuoi utilizzare.

  • Le credenziali client OAuth 2.0
    • ID client: l'ID client fornito dal connettore per l'app che hai creato.
    • Client secret: il secret di Secret Manager contenente il client secret per l'app collegata che hai creato.
  • Nome utente e password
    • UserId: l'ID utente dell'API SOAP Marketo.
    • EncryptionKey: il secret di Secret Manager contenente la chiave di crittografia dell'API SOAP di Marketo.

Limitazioni del sistema

Il connettore Marketo può elaborare una transazione al secondo per nodo e limita le transazioni oltre questo limite. Per impostazione predefinita, Integration Connectors alloca 2 nodi (per una maggiore disponibilità) per una connessione.

Per informazioni sui limiti applicabili a Integration Connectors, vedi Limiti.

Utilizzare la connessione Marketo in un'integrazione

Una volta creata, la connessione diventa disponibile sia nell'Apigee Integration sia nell'Application Integration. Puoi utilizzare la connessione in un'integrazione tramite l'attività Connettori.

  • Per informazioni su come creare e utilizzare l'attività Connectors in Apigee Integration, consulta Attività Connectors.
  • Per informazioni su come creare e utilizzare l'attività Connettori in Application Integration, consulta Attività Connettori.

Azioni

Questa sezione elenca le azioni supportate dal connettore. Per capire come configurare le azioni, consulta Esempi di azioni.

Azione AddLandingPageContentSection

Aggiunge una sezione di contenuti alla pagina di destinazione target.

Parametri di input dell'azione AddLandingPageContentSection

Nome parametro Tipo di dati Obbligatorio Descrizione
LandingPageId Stringa Vero ID della pagina di destinazione
ContentId Stringa Vero ID della sezione di contenuti. Anche l'ID HTML della sezione.
Tipo Stringa Vero Tipo di sezione di contenuti. I valori consentiti sono Immagine, Modulo, Rettangolo, Snippet, RichText, HTML.

Ad esempio, per scoprire come configurare l'azione AddLandingPageContentSection, consulta Esempi di azioni.

Azione DeleteLandingPageContentSection

Consente di eliminare la sezione dei contenuti della pagina di destinazione in Marketo.

Parametri di input dell'azione DeleteLandingPageContentSection

Nome parametro Tipo di dati Obbligatorio Descrizione
LandingPageId Stringa Vero ID della pagina di destinazione.
ContentId Stringa Vero ID della sezione di contenuti. Anche l'ID HTML della sezione.

Ad esempio, per scoprire come configurare l'azione DeleteLandingPageContentSection, consulta Esempi di azioni.

Azione AggiornaEmailContent

Aggiorna i contenuti di un'email.

Parametri di input dell'azione AggiornaContenutoEmail

Nome parametro Tipo di dati Obbligatorio Descrizione
EmailId Stringa Vero L'ID dell'email.
FromEmail Stringa Vero Indirizzo mittente dell'email
FromName Stringa Vero Nome mittente dell'email
ReplyTo Stringa Vero Indirizzo per risposte dell'email
Oggetto Stringa Vero Oggetto dell'email

Ad esempio, per scoprire come configurare l'azione UpdateEmailContent, consulta Esempi di azioni.

Azione UpdateLandingPageContentSection

Aggiungi o aggiorna la sezione dei contenuti della pagina di destinazione in Marketo.

Parametri di input dell'azione UpdateLandingPageContentSection

Nome parametro Tipo di dati Obbligatorio Descrizione
Tipo Stringa Vero Tipo di sezione di contenuti.I valori consentiti sono Immagine, Modulo, Rettangolo, Snippet, Testo avanzato, HTML.
Valore Stringa Vero Tipo di sezione di contenuti.
LandingPageId Stringa Vero ID della pagina di destinazione.
ContentId Stringa Vero ID della sezione di contenuti. Anche l'ID HTML della sezione.

Ad esempio, per scoprire come configurare l'azione UpdateLandingPageContentSection, consulta Esempi di azioni.

Azione GetImportProgramMembersStatus

Recupera lo stato dei membri di un programma di importazione dall'operazione del file per Marketo.

Parametri di input dell'azione GetImportProgramMembersStatus

Nome parametro Tipo di dati Obbligatorio Descrizione
BatchId Stringa Vero L'ID del batch di lead di importazione.

Ad esempio, per scoprire come configurare l'azione GetImportProgramMembersStatus, consulta Esempi di azioni.

Azione ScheduleCampaign

Pianifica da remoto l'esecuzione di una campagna batch in un determinato momento.

Parametri di input dell'azione ScheduleCampaign

Nome parametro Tipo di dati Obbligatorio Descrizione
CampaignId Stringa Vero ID della campagna batch da pianificare.
RunAt Stringa Vero Data e ora di pubblicazione della campagna. Se non viene impostato, la campagna verrà pubblicata cinque minuti dopo l'esecuzione della chiamata.

Ad esempio, per scoprire come configurare l'azione ScheduleCampaign, consulta Esempi di azioni.

Azione ElencaMembriElenco

Determina se i lead sono contenuti in un elenco in Marketo.

Parametri di input dell'azione ListMembersOfList

Nome parametro Tipo di dati Obbligatorio Descrizione
ListId Stringa Vero L'ID dell'elenco in cui cercare i lead.
LeadId Stringa Vero Un elenco separato da virgole di ID lead da verificare se sono presenti nell'elenco specificato da ListId.

Ad esempio, per scoprire come configurare l'azione ListMembersOfList, consulta Esempi di azioni.

Azione AssociateLead

Associa un record di lead Marketo noto a un cookie munchkin e alla relativa cronologia delle attività web associata

Parametri di input dell'azione AssociateLead

Nome parametro Tipo di dati Obbligatorio Descrizione
LeadId Stringa Vero ID del lead da associare.
Cookie Stringa Vero Il valore del cookie da associare

Ad esempio, per scoprire come configurare l'azione AssociateLead, consulta Esempi di azioni.

Azione MergeLeads

Unisce due o più record di lead noti in un unico record di lead.

Parametri di input dell'azione MergeLeads

Nome parametro Tipo di dati Obbligatorio Descrizione
WinningLeadId Stringa Vero L'ID del record del lead vincente
LoosingLeadId Stringa Vero Un elenco separato da virgole di ID lead persi

Ad esempio, per scoprire come configurare l'azione MergeLeads, consulta Esempi di azioni.

Azione GetImportLeadsStatus

Recupera lo stato di un'operazione di importazione dei lead da file per Marketo.

Parametri di input dell'azione GetImportLeadsStatus

Nome parametro Tipo di dati Obbligatorio Descrizione
BatchId Stringa Vero L'ID del batch di lead di importazione.

Ad esempio, per scoprire come configurare l'azione GetImportLeadsStatus, consulta Esempi di azioni.

Azione CancelExportJob

Annullare un job di esportazione.

Parametri di input dell'azione CancelExportJob

Nome parametro Tipo di dati Obbligatorio Descrizione
JobId Stringa Vero L'ID del job di esportazione.
Tipo Stringa Vero Il tipo di oggetto di BulkExtract. I valori disponibili sono : Attività, Lead, Membri del programma. I valori consentiti sono Attività, Lead, Membri del programma.

Ad esempio, per scoprire come configurare l'azione CancelExportJob, consulta Esempi di azioni.

Azione EnqueueExportJob

Mette in coda un job di esportazione e lo avvia quando le risorse di calcolo diventano disponibili.

Parametri di input dell'azione EnqueueExportJob

Nome parametro Tipo di dati Obbligatorio Descrizione
JobId Stringa Vero L'ID del job di esportazione.
Tipo Stringa Vero Il tipo di oggetto di BulkExtract. I valori disponibili sono : Attività, Lead, Membri del programma. I valori consentiti sono Attività, Lead, Membri del programma.

Ad esempio, per scoprire come configurare l'azione EnqueueExportJob, consulta Esempi di azioni.

Azione GetExportJobStatus

Restituisce lo stato di un job di esportazione. Lo stato del job è disponibile per 30 giorni dopo il raggiungimento dello stato Completato o Non riuscito.

Parametri di input dell'azione GetExportJobStatus

Nome parametro Tipo di dati Obbligatorio Descrizione
JobId Stringa Vero L'ID del job di esportazione.
Tipo Stringa Vero Il tipo di oggetto di BulkExtract. I valori disponibili sono : Attività, Lead, Membri del programma. I valori consentiti sono Attività, Lead, Membri del programma.

Ad esempio, per scoprire come configurare l'azione GetExportJobStatus, consulta Esempi di azioni.

Azione CreateEmailTemplate

Crea un nuovo modello email.

Parametri di input dell'azione CreateEmailTemplate

Nome parametro Tipo di dati Obbligatorio Descrizione
FolderId Stringa Vero L'ID della cartella
FolderType Stringa Vero Il tipo di cartella.
Nome Stringa Vero Il nome del modello email. Deve essere univoco nella cartella principale.
File Stringa Vero File multiparte. Contenuti HTML per il modello.

Ad esempio, per scoprire come configurare l'azione CreateEmailTemplate, consulta Esempi di azioni.

Azione UpdateLeadProgramStatus

Modifica lo stato del programma di un elenco di lead in un programma target. Solo gli abbonati esistenti al programma possono avere lo stato modificato con questa API.

Parametri di input dell'azione UpdateLeadProgramStatus

Nome parametro Tipo di dati Obbligatorio Descrizione
ProgramId Stringa Vero ID della campagna batch da pianificare.
LeadIds Stringa Vero Un elenco separato da virgole di ID lead da inserire.
Stato Stringa Vero Stato del programma della registrazione.

Ad esempio, per scoprire come configurare l'azione UpdateLeadProgramStatus, consulta Esempi di azioni.

Azione RemoveLeadsFromList

Rimuove i lead da un elenco in Marketo.

Parametri di input dell'azione RemoveLeadsFromList

Nome parametro Tipo di dati Obbligatorio Descrizione
ListId Stringa Vero L'ID dell'elenco da cui rimuovere i lead.
LeadId Stringa Vero Un elenco separato da virgole di ID lead da rimuovere dall'elenco specificato da ListId.

Ad esempio, per scoprire come configurare l'azione RemoveLeadsFromList, consulta Esempi di azioni.

Azione ImportCustomObjectsFromFile

Importa oggetti personalizzati da un file in Marketo.

Parametri di input dell'azione ImportCustomObjectsFromFile

Nome parametro Tipo di dati Obbligatorio Descrizione
File Stringa Vero Il percorso del file contenente gli oggetti personalizzati da importare in Marketo, ad esempio "C:\temp\custom_object_import.csv".
TableName Stringa Vero Il nome della tabella degli oggetti personalizzati. Esempio: CustomObject_test
Formato Stringa Vero Il formato del file che verrà utilizzato per importare gli oggetti personalizzati in Marketo. I valori consentiti sono csv, tsv, ssv.
Contenuti Stringa Vero I contenuti come InputStream da caricare quando non è specificato File.

Ad esempio, per scoprire come configurare l'azione ImportCustomObjectsFromFile, consulta Esempi di azioni.

Esempi di azioni

Questa sezione descrive come eseguire alcune delle azioni in questo connettore.

Esempio: AddLandingPageContentSection

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione AddLandingPageContentSection e poi fai clic su Fine.
  3. Nella sezione Mappatura dei dati, Open Data Mapping Editor e poi inserisci un valore simile al seguente nel Input campo: 
    {
  "LandingPageId": "1005",
  "ContentId": "1120",
  "Type": "HTML"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task CampaignTest avrà un valore simile al seguente:

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

Esempio: DeleteLandingPageContentSection

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione DeleteLandingPageContentSection e poi fai clic su Fine.
  3. Nella sezione Mappatura dei dati, Open Data Mapping Editor e poi inserisci un valore simile al seguente nel Input campo: 
    {
  "LandingPageId": "1005",
  "ContentId": "1009"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task DeleteLandingPageContentSection avrà un valore simile al seguente:

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

Esempio: UpdateEmailContent

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione UpdateEmailContent e poi fai clic su Fine.
  3. Nella sezione Mappatura dei dati, Open Data Mapping Editor e poi inserisci un valore simile al seguente nel Input campo: 
     {
  "EmailId": "1001",
  "FromName": "test",
  "FromEmail": "222larabrown@gmail.com",
  "Subject": "TestSubject Line",
  "ReplyTo": "222larabrown@gmail.com"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task UpdateEmailContent avrà un valore simile al seguente:

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

Esempio: UpdateLandingPageContentSection

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione UpdateLandingPageContentSection e poi fai clic su Fine.
  3. Nella sezione Mappatura dei dati, Open Data Mapping Editor e poi inserisci un valore simile al seguente nel Input campo: 
    {
  "Type": "HTML",
  "Value": "
Test Update
",
  "LandingPageId": "1005",
  "ContentId": "1120"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task UpdateLandingPageContentSection avrà un valore simile al seguente:

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

Esempio: GetImportProgramMembersStatus

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione GetImportProgramMembersStatus e poi fai clic su Fine.
  3. Nella sezione Mappatura dei dati, Open Data Mapping Editor e poi inserisci un valore simile al seguente nel Input campo: 
    {
  "BatchId": "1029"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task GetImportProgramMembersStatus avrà un valore simile al seguente:

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

Esempio: pianifica la campagna

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione ScheduleCampaign e poi fai clic su Fine.
  3. Nella sezione Mappatura dei dati, Open Data Mapping Editor e poi inserisci un valore simile al seguente nel Input campo: 
    {
  "CampaignId": "1065",
  "RunAt": "2024-05-23T18:05:00+0000"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task ScheduleCampaign avrà un valore simile al seguente:

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

Esempio: ListMembersOfList

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione ListMembersOfList e poi fai clic su Fine.
  3. Nella sezione Mappatura dei dati, Open Data Mapping Editor e poi inserisci un valore simile al seguente nel Input campo: 
    {
  "ListId": "1003",
  "LeadId": "13,25,21"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task ListMembersOfList avrà un valore simile al seguente:

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

Esempio: AssociateLead

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione AssociateLead e poi fai clic su Fine.
  3. Nella sezione Mappatura dei dati, Open Data Mapping Editor e poi inserisci un valore simile al seguente nel Input campo: 
    {
  "LeadId": 582.0,
  "Cookie": "id:703-VQQ-088%26token:_mch-marketo.com-_mch-mktoweb.com-1717156982039-98850"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task AssociateLead avrà un valore simile al seguente:

     
 [{
  "Status": "Success"
}]

Esempio: MergeLeads

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione MergeLeads e poi fai clic su Fine.
  3. Nella sezione Mappatura dei dati, Open Data Mapping Editor e poi inserisci un valore simile al seguente nel Input campo: 
     {
  "LoosingLeadId": "10",
  "WinningLeadId": "45"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task MergeLeads avrà un valore simile al seguente:

     
  [{
  "Status": "Success"
}]

Esempio: GetImportLeadsStatus

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione GetImportLeadsStatus e poi fai clic su Fine.
  3. Nella sezione Mappatura dei dati, Open Data Mapping Editor e poi inserisci un valore simile al seguente nel Input campo: 
    {
  "BatchId": "1022"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task GetImportLeadsStatus avrà un valore simile al seguente:

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

Esempio: annullare un job di esportazione

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione CancelExportJob e poi fai clic su Fine.
  3. Nella sezione Mappatura dei dati, Open Data Mapping Editor e poi inserisci un valore simile al seguente nel Input campo: 
    {
  "JobId": "ddf64e6f-0e9c-4254-91a9-32277349a22b",
  "Type": "Leads"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task CancelExportJob avrà un valore simile al seguente:

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

Esempio: EnqueueExportJob

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione EnqueueExportJob e poi fai clic su Fine.
  3. Nella sezione Mappatura dei dati, Open Data Mapping Editor e poi inserisci un valore simile al seguente nel Input campo: 
    {
  "JobId": "d04f60fb-5e68-40b5-9928-76fdb9034303",
  "Type": "Leads"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task EnqueueExportJob avrà un valore simile al seguente:

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

Esempio: GetExportJobStatus

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione GetExportJobStatus e poi fai clic su Fine.
  3. Nella sezione Mappatura dei dati, Open Data Mapping Editor e poi inserisci un valore simile al seguente nel Input campo: 
    {
  "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
  "Type": "Leads"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task GetExportJobStatus avrà un valore simile al seguente:

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

Esempio: CreateEmailTemplate

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione CreateEmailTemplate e poi fai clic su Fine.
  3. Nella sezione Mappatura dei dati, Open Data Mapping Editor e poi inserisci un valore simile al seguente nel Input campo: 
    {
  "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. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task CreateEmailTemplate avrà un valore simile al seguente:

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

Esempio: UpdateLeadProgramStatus

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione UpdateLeadProgramStatus e poi fai clic su Fine.
  3. Nella sezione Mappatura dei dati, Open Data Mapping Editor e poi inserisci un valore simile al seguente nel Input campo: 
    {
  "ProgramId": "1002",
  "Status": "Member",
  "LeadIds": "3"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task UpdateLeadProgramStatus avrà un valore simile al seguente:

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

Esempio: RemoveLeadsFromList

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione RemoveLeadsFromList e poi fai clic su Fine.
  3. Nella sezione Mappatura dei dati, Open Data Mapping Editor e poi inserisci un valore simile al seguente nel Input campo: 
     {
  "ListId": "1026",
  "LeadId": "57"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task RemoveLeadsFromList avrà un valore simile al seguente:

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

Esempio: ImportCustomObjectsFromFile

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione ImportCustomObjectsFromFile e poi fai clic su Fine.
  3. Nella sezione Mappatura dei dati, Open Data Mapping Editor e poi inserisci un valore simile al seguente nel Input campo: 
    {
  "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
  "Type": "Leads"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task ImportCustomObjectsFromFile avrà un valore simile al seguente:

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

Esempi di operazioni sulle entità

Questa sezione mostra come eseguire alcune delle operazioni sulle entità in questo connettore.

Quando utilizzi un'operazione di elenco e prevedi che il volume di dati sia elevato, ti consigliamo di specificare una clausola di filtro per le seguenti entità: LeadsLists, LeadPrograms, Activities, LandingPageContentSec, LeadChanges, LeadChangesFields, Emails, LandingPages, Forms, Programs, Leads, LandingPageTemplateCon, OpportunityRoles, SalesPersons, Tokens, ListStaticMemberShip, Opportunities, LeadChangesAttributes e Segments. Inoltre, per ordinare il set di risultati, devi prima applicare la clausola di filtro.

Esempio: elenca tutte le email

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Email dall'elenco Entity.
  3. Seleziona l'operazione List e poi fai clic su Fine.

Esempio: ottieni singole campagne intelligenti

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Campagne intelligenti dall'elenco Entity.
  3. Seleziona l'operazione Get e poi fai clic su Fine.
  4. Imposta l'ID entità su Ricevi singole campagne intelligenti. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dei dati, fai clic su Apri editor di mappatura dei dati e poi inserisci 1002 nel campo Valore di input e scegli EntityId come variabile locale.

Esempio: eliminare le email

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Email dall'elenco Entity.
  3. Seleziona l'operazione Delete e poi fai clic su Fine.
  4. Imposta l'ID entità su Elimina email. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dati, fai clic su Apri editor di mappatura dei dati e poi inserisci 1048.0 nel campo Valore di input e scegli EntityId come variabile locale.

Esempio: Crea email

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Email dall'elenco Entity.
  3. Seleziona l'operazione Create e fai clic su Fine.
  4. Nella sezione Data mapper dell'editor Attività, fai clic su OpenDataMapping e inserisci un valore simile al seguente nel campo 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"
}

Esempio: aggiorna EmailTemplates

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona EmailTemplates dall'elenco Entity.
  3. Seleziona l'operazione Update e fai clic su Fine.
  4. Imposta EntityID per aggiornare un EmailTemplates. Per impostare l'attributo EntityID, nella sezione Data mapper di Attività, fai clic su EntityID e poi inserisci 1034.0 nel campo apposito.
  5. Nella sezione Data mapper dell'editor Attività, fai clic su OpenDataMapping e inserisci un valore simile al seguente in field: 
     
{
"Name": "temp email updated",
"Description": "updation"
}

    6. L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload del compito del connettore:

    {
"Id": 1034.0
}

Ricevere assistenza dalla community Google Cloud

Puoi pubblicare le tue domande e discutere di questo connettore nella community di Google Cloud ai forum di Cloud.

Passaggi successivi