Uygulama: Sayfalara ayırma

Aşağıdaki örnekte, YouTube Data API (v3) sorguları için ek sonuç kümelerinin nasıl alınacağı gösterilmektedir.

API, bir API yanıtına kaç öğe ekleneceğini belirtmek için maxResults parametresini kullanır. API'nin list yöntemlerinin (videos.list, playlists.list vb.) neredeyse tamamı bu parametreyi destekler.

Bir sorgu için ek sonuçlar varsa API yanıtı bir nextPageToken mülkü, bir prevPageToken mülkü veya her ikisi de içerir. Bu özelliklerin değerleri daha sonra pageToken parametresini ek bir sonuç sayfası almak için ayarlamak üzere kullanılabilir.

Örneğin, aşağıdaki sorgu "skateboarding dog" (kaykay yapan köpek) sorgusuyla eşleşen en çok izlenen 10 videonun arama sonuçlarını getirir:

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ı, sorguyla ilgili ilk 10 eşleşmenin yanı sıra sonraki 10 sonucu almak için kullanılabilecek bir nextPageToken mülkünü 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 döndüren sorguyu yürütün.