Aşağıdaki örnekte YouTube Data API (v3) sorguları için ek sonuç kümelerinin nasıl alınacağı gösterilmektedir.
API, API yanıtına kaç öğenin eklenmesi gerektiğini belirtmek için maxResults
parametresini kullanır. API'nin list
yöntemlerinin neredeyse tamamı (videos.list
, playlists.list
vb.) bu parametreyi destekler.
Bir sorgu için ek sonuçlar mevcutsa API yanıtı bir nextPageToken
özelliği, bir prevPageToken
özelliği veya her ikisini birden içerir. Ardından bu özelliklerin değerleri, ek bir sonuç sayfası almak üzere pageToken
parametresini ayarlamak için kullanılabilir.
Örneğin, aşağıdaki sorgu en çok görüntülenen 10 videonun "kaykay köpeği" sorgusuyla eşleşen arama sonuçlarını alır:
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &maxResults=10 &order=viewCount &q=skateboarding+dog &type=video
API yanıtı, sorgu için ilk 10 eşleşmenin yanı sıra sonraki 10 sonucu almak üzere kullanılabilecek bir nextPageToken
özelliği içerir:
Aşağıdaki sorgu, sorgu için sonraki 10 sonucu alır:
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
Not: Bu isteği API Gezgini'nde tamamlamak için pageToken
parametresinin değerini güncellemeniz gerekebilir. Doğru pageToken
parametre değerini almak için ilk 10 sonucu alan sorguyu yürütün.