Marketo

Il connettore Marketo consente di eseguire operazioni di inserimento, eliminazione, aggiornamento e lettura sui dati 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, vedi 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 di Google. Se non hai un account di servizio, devi crearne uno. Il connettore e il account di servizio devono appartenere allo stesso progetto. Per ulteriori informazioni, vedi Creare un service account.

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

      Per capire come abilitare i servizi, consulta Abilitazione dei servizi.

    Se questi servizi o autorizzazioni non sono stati attivati in precedenza per il tuo progetto, ti viene 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 separata per ciascuna. Per creare una connessione:

  1. Nella console Google Cloud, vai alla pagina Integration Connectors > Connessioni e poi 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 Posizione, scegli la posizione 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 superare i 49 caratteri.
    4. (Facoltativo) Inserisci una descrizione per l'istanza di connessione.
    5. Service Account: 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, viceversa, sono necessari meno nodi per elaborare meno transazioni. Per capire in che modo i nodi influiscono sui prezzi dei connettori, consulta Prezzi dei nodi di connessione. Se non inserisci alcun valore, per impostazione predefinita i nodi minimi sono impostati su 2 (per una migliore disponibilità) e i nodi massimi sono impostati su 50.

    7. (Facoltativo) 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 collegamento del servizio. Seleziona uno dei seguenti tipi di destinazione:
      • Indirizzo host: se vuoi specificare il nome host o l'indirizzo IP della destinazione.
      • Service Attachment: se vuoi specificare l'endpoint privato per i tuoi indirizzi IP interni. Il collegamento del servizio consente di nascondere gli indirizzi IP interni alla rete esterna. Puoi creare un collegamento di servizio in Google Cloud utilizzando la funzionalità Private Service Connect. Per informazioni sulla configurazione di Private Service Connect, consulta Pubblicare servizi gestiti.

      In base alla selezione del tipo di destinazione, 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: rivedi i dettagli di connessione e autenticazione.
  8. Fai clic su Crea.

Configura l'autenticazione

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

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

Limitazioni di sistema

Il connettore Marketo può elaborare 1 transazione al secondo, per nodo, e limita le transazioni oltre questo limite. Per impostazione predefinita, Integration Connectors alloca due nodi (per una migliore 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, questa diventa disponibile sia in Apigee Integration che in Application Integration. Puoi utilizzare la connessione in un'integrazione tramite l'attività Connettori.

  • Per capire come creare e utilizzare l'attività Connettori in Apigee Integration, consulta Attività Connettori.
  • Per capire come creare e utilizzare l'attività Connettori in Application Integration, vedi 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 di destinazione.

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 dei contenuti. Anche l'ID HTML della sezione.
Tipo Stringa Vero Tipo di sezione dei contenuti. I valori consentiti sono Image, Form, Rectangle, Snippet, RichText, HTML.

Per un esempio di come configurare l'azione AddLandingPageContentSection, consulta Esempi di azioni.

Azione DeleteLandingPageContentSection

Elimina 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 dei contenuti. Anche l'ID HTML della sezione.

Per un esempio di come configurare l'azione DeleteLandingPageContentSection, consulta Esempi di azioni.

Azione UpdateEmailContent

Aggiorna i contenuti di un'email.

Parametri di input dell'azione UpdateEmailContent

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 Rispondi a dell'email
Oggetto Stringa Vero Oggetto dell'email

Per un esempio di 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 Image, Form, Rectangle, Snippet, RichText, HTML.
Valore Stringa Vero Tipo di sezione dei contenuti.
LandingPageId Stringa Vero ID della pagina di destinazione.
ContentId Stringa Vero ID della sezione dei contenuti. Anche l'ID HTML della sezione.

Per un esempio di come configurare l'azione UpdateLandingPageContentSection, consulta Esempi di azioni.

Azione GetImportProgramMembersStatus

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

Parametri di input dell'azione GetImportProgramMembersStatus

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

Per un esempio di come configurare l'azione GetImportProgramMembersStatus, consulta Esempi di azioni.

Azione ScheduleCampaign

Pianifica in remoto l'esecuzione di una campagna batch a una determinata ora.

Parametri di input dell'azione ScheduleCampaign

Nome parametro Tipo di dati Obbligatorio Descrizione
CampaignId Stringa Vero L'ID della campagna batch da pianificare.
RunAt Stringa Vero Data e ora in cui pubblicare la campagna. Se non viene impostato, la campagna verrà eseguita cinque minuti dopo la chiamata.

Per un esempio di come configurare l'azione ScheduleCampaign, consulta Esempi di azioni.

Azione ListMembersOfList

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 da controllare per i lead.
LeadId Stringa Vero Un elenco separato da virgole di ID lead da controllare per verificare se sono presenti nell'elenco specificato da ListId.

Per un esempio di come configurare l'azione ListMembersOfList, consulta Esempi di azioni.

Azione AssociateLead

Associa un record lead Marketo noto a un cookie munchkin e alla relativa cronologia dell'attività web

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

Per un esempio di 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 Unisci lead

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

Per un esempio di come configurare l'azione MergeLeads, consulta Esempi di azioni.

Azione GetImportLeadsStatus

Recupera lo stato di un'operazione di importazione di 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 importazione dei lead.

Per un esempio di come configurare l'azione GetImportLeadsStatus, consulta Esempi di azioni.

Azione CancelExportJob

Annulla 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 : Activities, Leads, ProgramMembers I valori consentiti sono Activities, Leads, ProgramMembers.

Per un esempio di 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 : Activities, Leads, ProgramMembers. I valori consentiti sono Activities, Leads, ProgramMembers.

Per un esempio di 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 : Activities, Leads, ProgramMembers. I valori consentiti sono Activities, Leads, ProgramMembers.

Per un esempio di come configurare l'azione GetExportJobStatus, consulta Esempi di azioni.

Azione CreateEmailTemplate

Crea un nuovo modello di 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 di email. Deve essere univoco nella cartella principale.
File Stringa Vero File multiparte. Contenuti HTML per il modello.

Per un esempio di 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 i membri esistenti del programma possono modificare il proprio stato con questa API.

Parametri di input dell'azione UpdateLeadProgramStatus

Nome parametro Tipo di dati Obbligatorio Descrizione
ProgramId Stringa Vero L'ID della campagna batch da pianificare.
LeadIds Stringa Vero Un elenco separato da virgole di ID lead per l'input.
Stato Stringa Vero Stato del programma del record.

Per un esempio di 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.

Per un esempio di 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 dell'oggetto personalizzato. 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 il file non è specificato.

Per un esempio di 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 , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input: 
    {
  "LandingPageId": "1005",
  "ContentId": "1120",
  "Type": "HTML"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro CampaignTest della risposta connectorOutputPayload dell'attività 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, quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input: 
    {
  "LandingPageId": "1005",
  "ContentId": "1009"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro DeleteLandingPageContentSection della risposta connectorOutputPayload dell'attività 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 , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input: 
     {
  "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 UpdateEmailContent della risposta connectorOutputPayload dell'attività 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 , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input: 
    {
  "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 UpdateLandingPageContentSection della risposta connectorOutputPayload dell'attività 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 , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input: 
    {
  "BatchId": "1029"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro GetImportProgramMembersStatus della risposta connectorOutputPayload dell'attività 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: ScheduleCampaign

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione ScheduleCampaign , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input: 
    {
  "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 ScheduleCampaign della risposta connectorOutputPayload dell'attività 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 , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input: 
    {
  "ListId": "1003",
  "LeadId": "13,25,21"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro ListMembersOfList della risposta connectorOutputPayload dell'attività 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 , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input: 
    {
  "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 AssociateLead della risposta connectorOutputPayload dell'attività 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 , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input: 
     {
  "LoosingLeadId": "10",
  "WinningLeadId": "45"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro MergeLeads della risposta connectorOutputPayload dell'attività 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 , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input: 
    {
  "BatchId": "1022"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro GetImportLeadsStatus della risposta connectorOutputPayload dell'attività 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 , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input: 
    {
  "JobId": "ddf64e6f-0e9c-4254-91a9-32277349a22b",
  "Type": "Leads"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro CancelExportJob della risposta connectorOutputPayload dell'attività 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 , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input: 
    {
  "JobId": "d04f60fb-5e68-40b5-9928-76fdb9034303",
  "Type": "Leads"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro EnqueueExportJob della risposta connectorOutputPayload dell'attività 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 , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input: 
    {
  "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
  "Type": "Leads"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro GetExportJobStatus della risposta connectorOutputPayload dell'attività 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 , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel 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. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro CreateEmailTemplate della risposta connectorOutputPayload dell'attività 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 , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input: 
    {
  "ProgramId": "1002",
  "Status": "Member",
  "LeadIds": "3"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro UpdateLeadProgramStatus della risposta connectorOutputPayload dell'attività 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 , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input: 
     {
  "ListId": "1026",
  "LeadId": "57"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro RemoveLeadsFromList della risposta connectorOutputPayload dell'attività 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 , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input: 
    {
  "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
  "Type": "Leads"
}

    4. Questo esempio mostra i record Object specifici. Se l'azione ha esito positivo, il parametro ImportCustomObjectsFromFile della risposta connectorOutputPayload dell'attività 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 un volume di dati 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, quindi fai clic su Fine.

Esempio: recuperare singole campagne intelligenti

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona SmartCampaigns dall'elenco Entity.
  3. Seleziona l'operazione Get, quindi fai clic su Fine.
  4. Imposta l'ID entità su Get single SmartCampaigns. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dati, fai clic su Apri editor mappatura dati, 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, quindi 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 mappatura dati, 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, quindi fai clic su Fine.
  4. Nella sezione Data Mapper dell'editor Task, fai clic su OpenDataMapping e poi inserisci un valore simile al seguente in 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: aggiornamento di EmailTemplates

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona EmailTemplates dall'elenco Entity.
  3. Seleziona l'operazione Update, quindi fai clic su Fine.
  4. Imposta EntityID su Aggiorna un EmailTemplates. Per impostare l'EntityID, nella sezione Data Mapper di Attività, fai clic su EntityID e poi inserisci 1034.0 nel campo specificato.
  5. Nella sezione Data Mapper dell'attività, fai clic sull'editor OpenDataMapping e poi 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 dell'attività 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 nei forum di Cloud.

Passaggi successivi