Kaynak listeleri arasında sayfa geçişi

maxResults alanını ayarlayarak, sunucunun bir liste isteğine yanıt olarak döndürdüğü maksimum kaynak sayısını kontrol edebilirsiniz. Ayrıca, bazı koleksiyonlarda (Etkinlikler gibi) alınan girişlerin sayısında sunucunun hiçbir zaman aşmayacağı sabit bir sınır vardır. Etkinliklerin toplam sayısı bu maksimum değeri aşarsa sunucu bir sayfa sonuç döndürür.

maxResults işlevinin bir sayfadaki sonuç sayısını garanti etmediğini unutmayın. Eksik sonuçlar, sonuçtaki boş olmayan bir nextPageToken alanı ile tespit edilebilir. Sonraki sayfayı almak için öncekiyle tam olarak aynı isteği gerçekleştirin ve önceki sayfadan nextPageToken değerine sahip bir pageToken alanı ekleyin. Tüm sonuçlar alınana kadar aşağıdaki sayfalarda yeni bir nextPageToken sağlanır.

Örneğin, aşağıda, sayfalara ayrılmış bir listedeki sonuçların sonraki sayfasını almak için bir sorgu ve ardından gelen sorgu verilmiştir:

GET /calendars/primary/events?maxResults=10&singleEvents=true

//Result contains

"nextPageToken":"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA",

Sonraki sorgu, nextPageToken değerini alır ve pageToken değeri olarak gönderir:

GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA