Paging-Token

Marketo stellt Paging-Token bereit, mit denen Ergebnisse durchsucht oder Daten abgerufen werden können, die zu einem bestimmten Datum aktualisiert wurden.

Einige Antworten geben lange Paging-Token-Zeichenfolgen zurück, was zu einem HTTP 414-Fehler führen kann. Siehe Informationen zum Umgang mit diesen ​ ().

Weitere Informationen finden Sie in ​ Dokumentation zur PagingToken-API .

Tokentypen

Marketo bietet zwei miteinander verknüpfte, aber unterschiedliche Typen von Paging-Token:

datumsbasiert

Ein datumsbasiertes Paging-Token stellt eine Datums-/Uhrzeitangabe dar. Verwenden Sie sie, um Aktivitäten, Datenwertänderungen und gelöschte Leads abzurufen, die nach diesem Datum/dieser Uhrzeit auftreten.

Generieren Sie ein datumsbasiertes Token, indem Sie den Endpunkt Paging-Token abrufen mit einem Datum/Uhrzeit-Wert aufrufen:

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

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

Der sinceDateTime-Parameter muss die ISO 8601 Standarddatumsnotation verwenden. Um optimale Ergebnisse zu erzielen, sollten Sie ein vollständiges Datum und eine vollständige Zeitzone angeben.

Stellen Sie die Zeitzone als Versatz zur GMT im folgenden Format dar:

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

Verwenden Sie alternativ ein großes „Z“ zur Darstellung von UTC:

yyyy-mm-ddThh:mm:ssZ

Beispiel:

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

2016-09-15T10:53:00Z

Da sinceDateTime ein Abfrageparameter ist, kodieren Sie seinen Wert mit einer URL.

Übergeben Sie die zurückgegebene nextPageToken-Zeichenfolge an einen Aufruf Lead- abrufen, Lead- abrufen oder Gelöschte Leads abrufen. Der Aufruf ruft Datensätze ab, die nach dem Datum/der Uhrzeit liegen, das/die der Get Paging Token-API angegeben wurde.

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

positionsbasiert

Ein positionsbasiertes Paging-Token kann von jedem Batch-Abruf an eine Lead-Datenbank-API zurückgegeben werden. Das Token funktioniert wie ein Datenbank-Cursor und ermöglicht das Durchlaufen von Datensätzen.

Beispielsweise kann ein Aufruf Leads nach Filtertyp abrufen einen Ergebnissatz zurückgeben, der größer ist als die angeforderte Batch-Größe, die in der Regel einen maximalen und einen Standardwert von 300 hat. Wenn weitere Ergebnisse verfügbar sind, setzt die Antwort das Feld moreResult auf „true“ und gibt eine nextPageToken zurück.

Um die nächste Seite abzurufen, führen Sie einen weiteren Aufruf durch und übergeben Sie den nextPageToken aus der vorherigen Antwort. Die Antwort gibt die nächste Seite in der Ergebnismenge zurück.