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, 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.