Token di paging

Marketo fornisce token di paging per scorrere i risultati o recuperare dati aggiornati in base a una data specifica.

Alcune risposte restituiscono stringhe di token di paging lunghe, che possono causare un errore HTTP 414. Vedi le informazioni sulla gestione di questi errori.

Consulta la documentazione Paging Token API.

Tipi di token

Marketo fornisce due tipi correlati ma distinti di token di paging:

Basato su data

Un token di paging basato su data rappresenta un datetime. Utilizzala per recuperare attività, modifiche al valore dei dati e lead eliminati che si verificano dopo tale data e ora.

Genera un token basato su data chiamando l’endpoint Get Paging Token con un datetime:

GET /rest/v1/activities/pagingtoken.json?sinceDatetime=2014-10-06T13:22:17-08:00

{
    "requestId": "1607c#14884f3e74e",
    "success": true,
    "nextPageToken": "GIYDAOBNGEYS2MBWKQYDAORQGA5DAMBOGAYDAKZQGAYDALBQ"
}

Il parametro sinceDateTime deve utilizzare la notazione di data standard ISO 8601. Per risultati ottimali, fornisci una data e un’ora complete con un fuso orario.

Rappresenta il fuso orario come scostamento da GMT nel seguente formato:

yyyy-mm-ddThh:mm:ss+|-hh:mm

In alternativa, utilizzare una “Z” maiuscola per rappresentare UTC:

yyyy-mm-ddThh:mm:ssZ

Ad esempio:

2016-09-15T15:53:00+05:00

2016-09-15T10:53:00Z

Poiché sinceDateTime è un parametro di query, il relativo valore viene codificato tramite URL.

Passa la stringa nextPageToken restituita a una chiamata Get Lead Activities, Get Lead Changes o Get Deleted Leads. La chiamata recupera i record che si verificano dopo il datetime fornito all’API Get Paging Token.

GET /rest/v1/activities.json?nextPageToken=GIYDAOBNGEYS2MBWKQYDAORQGA5DAMBOGAYDAKZQGAYDALBQ&activityTypeIds=1&activityTypeIds=12

Basato sulla posizione

Un token di paging basato sulla posizione può essere restituito da qualsiasi chiamata di recupero batch a un’API del database lead. Il token funziona come un cursore del database e consente l’attraversamento dei record.

Ad esempio, una chiamata Get Leads By Filter Type può restituire un set di risultati più grande della dimensione batch richiesta, che in genere ha un valore massimo e predefinito di 300. Quando sono disponibili più risultati, la risposta imposta il campo moreResult su true e restituisce nextPageToken.

Per recuperare la pagina successiva, effettua un’altra chiamata e passa il valore nextPageToken dalla risposta precedente. La risposta restituisce la pagina successiva nel set di risultati.