Zum Hauptinhalt springen
Um eine größere maximale Anzahl von Kampagnen zu unterstützen und alle einem Konto zugeordneten Objekte effizient abzurufen, unterstützt die Advertiser API jetzt auf vielen GET-endpoints die Paginierung. Der Paging-Mechanismus ist einfach zu verwenden und ähnelt stark der cursorbasierten Paginierung der REST API, wie in Using cursors to navigate collections beschrieben.

​
Erste Schritte

Für bestimmte GET-Anfragen akzeptieren wir jetzt die Abfrageparameter cursor und count; beide sind optional. Wenn eine Antwort mehr als count Einträge enthält, geben diese endpoints nun die ersten count Einträge zurück und fügen dem Antwort-JSON den Schlüssel next_cursor hinzu. GET https://ads-api.x.com/5/accounts/abc1/campaigns?count=50 
{
  "data": \[...\],
  "next_cursor": "c-3yvu1pzhd3i7",
  "request": {...}
}
Um die nächste Reihe von Antworten abzurufen, fügen Sie cursor zu Ihren query-Parametern hinzu: GET https://ads-api.x.com/5/accounts/abc1/campaigns?cursor=c-3yvu1pzhd3i7&count=50 
{
  "data": \[...\],
  "next_cursor": "c-3w3zdyg8ywan",
  "request": {...}
}

​
Vertiefung

Für die meisten endpoints beträgt der maximale count-Wert 1.000, der minimale 1 und der Standardwert 200. Der von next_cursor gelieferte Wert ist immer eine Zeichenfolge und sollte als opaque betrachtet werden; die Implementierung kann sich ändern. Wenn auf der aktuellen Seite der Ergebnismenge weniger als count Entitäten zurückgegeben werden, ist der next_cursor-Wert null. Hinweis: Die Analytics-endpoints unterstützen diesen Paginierungsstil nicht. Paging bei den Stats-endpoints wird durch Angabe von Zeiträumen unterstützt. Weitere Informationen finden Sie in der Dokumentation der einzelnen endpoints.
⌘I