Migrazione all’API REST

Ultimo aggiornamento: 19 dicembre 2024

Creato per:

  • Amministratore

L’API SOAP del Marketo Engage sarà ritirata dopo il 31 ottobre 2025. Tutte le integrazioni esistenti che utilizzano l'API SOAP devono essere ritirate o migrate all'API REST di Marketo Engage entro questa data per evitare interruzioni del servizio.

Migrazione

L'API SOAP supporta un intervallo limitato di casi d'uso rispetto al punto di accesso RESTI. Per determinare quali endpoint mappare i casi d'uso, segui Best practice di integrazione di Marketo

Architetture di riferimento disponibili per Sincronizzazione CRM e Esportazione Data Warehouse casi d'uso.

Autenticazione

Documentazione sull'autenticazione

L’API REST di Marketo utilizza l’autenticazione basata su OAuth 2.0 con il tipo di concessione Credenziali client. I token di accesso sono validi per un'ora dopo la creazione.

Lead

Documentazione API lead

L'API SOAP supporta la sincronizzazione dei dati dei lead, l'associazione dei cookie Munchkin e l'unione dei lead. Se l'applicazione chiama il metodo SOAP syncLead e imposta il parametro marketoCookie, è possibile eseguire la migrazione in uno dei modi seguenti:

  1. Utilizzo del metodo REST Lead di sincronizzazione, seguito da Lead associato
  2. È possibile chiamare Invia modulo, anche se questo richiede la configurazione di alcune Assets di marketing e l'interazione con l'API Forms

Le applicazioni che utilizzano il tipo di chiave foreignSysPersonId devono migrare a utilizzando un campo lead personalizzato per rappresentare questo identificatore esterno e utilizzare i metodi REST Lead di sincronizzazione o Importazione lead in blocco.

Metodo SOAPMetodo/i REST
getLeadOttieni lead per ID, Ottieni lead per tipo filtro
getMultipleLeadsOttieni lead per ID, Ottieni lead per tipo filtro, Ottieni lead per ID programma, Ottieni lead per ID elenco, Esportazione lead in blocco
mergeLeadsUnisci lead
syncLeadLead di sincronizzazione Invia modulo Associa lead
syncMultipleLeadsLead di sincronizzazione Importazione in blocco

Oggetti M

M Objects era un concetto onnicomprensivo per supportare l'esportazione dei dati di Attribution dell'opportunità per l'analisi esterna e utilizzava tre tipi di oggetto: Opportunità, Ruoli opportunità e Programmi.

Documentazione REST:

Metodo SOAPMetodo/i REST
deleteMObjectsElimina opportunità, Elimina ruoli opportunità
descriptionMObjectsDescrivi opportunità, Descrivi ruolo opportunità
getMObjectsOttieni opportunità, Ottieni ruoli opportunità
listMObjectsN/D
syncMObjectsOpportunità di sincronizzazione, Ruoli opportunità di sincronizzazione
getChannelsOttieni canali
getTagsOttieni tipi di tag, Ottieni tag per nome

Elenchi statici

I casi di utilizzo per elenchi statici nell'API SOAP sono limitati all'acquisizione dei dati di appartenenza e lead e alla rimozione dell'appartenenza che può essere eseguita con i metodi REST Aggiungi all'elenco, Importa in blocco lead o Rimuovi dall'elenco.

Metodo SOAPMetodo/i REST
getImportToListStatusLead importazione in blocco
importToListAggiungi All'Elenco Lead Di Importazione In Blocco
listOperationRimuovi dall'elenco

Attività

L’API SOAP supporta solo il recupero di attività.

Documentazione REST:

Metodo SOAPMetodo/i REST
getLeadActivityAttività di esportazione in blocco Attività lead
getLeadChangesAttività di esportazione in blocco Modifiche lead