Implementierung: Paginierung

Im folgenden Beispiel wird gezeigt, wie du zusätzliche Ergebnissätze für Abfragen der YouTube Data API (Version 3) abrufen kannst.

Mit dem Parameter maxResults wird in der API angegeben, wie viele Elemente in einer API-Antwort enthalten sein sollen. Dieser Parameter wird von fast allen list-Methoden der API (videos.list, playlists.list usw.) unterstützt.

Wenn für eine Suchanfrage zusätzliche Ergebnisse verfügbar sind, enthält die API-Antwort entweder eine nextPageToken-Property, eine prevPageToken-Property oder beides. Mit den Werten dieser Properties kann dann der Parameter pageToken so festgelegt werden, dass eine weitere Ergebnisseite abgerufen wird.

Mit der folgenden Suchanfrage werden beispielsweise die zehn meistgesehenen Videos zurückgegeben, die der Suchanfrage „Hund beim Skateboarden“ entsprechen:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &maxResults=10
        &order=viewCount
        &q=skateboarding+dog
        &type=video

Die API-Antwort enthält die ersten 10 Übereinstimmungen für die Suchanfrage sowie das Attribut nextPageToken, mit dem die nächsten 10 Ergebnisse abgerufen werden können:

Mit der folgenden Abfrage werden die nächsten 10 Ergebnisse für die Suchanfrage abgerufen:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &maxResults=10
        &order=viewCount
        &pageToken=CAoQAA
        &q=skateboarding+dog
        &type=video

Hinweis:Möglicherweise müssen Sie den Wert des Parameters pageToken aktualisieren, um diese Anfrage im APIs Explorer abzuschließen. Führen Sie die Abfrage aus, mit der die ersten 10 Ergebnisse abgerufen werden, um den richtigen Wert für den Parameter pageToken zu erhalten.