Token di paging

Ultimo aggiornamento: 5 novembre 2024
  • Argomenti:

Creato per:

  • Amministratore

Per esaminare i risultati o recuperare i dati aggiornati rispetto a un dato dato, Marketo fornisce token di paging.

In alcuni casi è possibile che vengano restituite stringhe di token di paging lunghe. Questo potrebbe causare l’errore HTTP 414. Ulteriori informazioni su come gestire questi errori.

Consulta la documentazione Paging Token API.

Tipi di token

Esistono due tipi correlati, ma distinti, di token di paging forniti da Marketo:

  • Basato su data
  • Basato sulla posizione

Basato su data

Il primo è un token di paging che rappresenta una data. Vengono utilizzati per recuperare attività, modifiche al valore dei dati e lead eliminati che si sono verificati dopo la data rappresentata dal token di paging. Questo tipo di token di paging viene generato chiamando l'endpoint Get Paging Token e includendo un datetime.

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

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

Il formato del parametro sinceDateTime deve essere conforme alla notazione di data standard ISO 8601. Per ottenere risultati ottimali, utilizza un datetime completo che includa il fuso orario. Il fuso orario può essere rappresentato come uno scostamento da GMT utilizzando il seguente formato:

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

Oppure puoi usare una "Z" maiuscola come scorciatoia per rappresentare un UTC come questo:

yyyy-mm-ddThh:mm:ssZ

Esempi

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

2016-09-15T10:53:00Z

Poiché sinceDateTime è un parametro di query, deve essere codificato nell'URL.

La stringa nextPageToken viene quindi fornita a una chiamata Get Lead Activities, Get Lead Changes o Get Deleted Leads e le attività vengono recuperate da dopo il datetime fornito all'API Get Paging Token.

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