maxResults alanını ayarlayarak sunucunun bir liste isteğine yanıtta döndürdüğü maksimum kaynak sayısını kontrol edebilirsiniz. Ayrıca, bazı koleksiyonlarda (etkinlikler gibi), alınan girişlerin sayısının hiçbir zaman aşmayacağı kesin bir sınır vardır. Toplam etkinlik 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ı tarafından algılanabilir. Sonraki sayfayı almak için öncekiyle tam olarak aynı isteği gerçekleştirin ve önceki sayfada nextPageToken değerine sahip bir pageToken alanı ekleyin. Tüm sonuçlar alınana kadar sonraki sayfalarda yeni bir nextPageToken değeri gösterilir.
Örneğin, sayfalara ayrılmış bir listedeki sonuçların sonraki sayfasını almaya yönelik sorguyu takip eden bir sorguyu burada görebilirsiniz:
GET /calendars/primary/events?maxResults=10&singleEvents=true
//Result contains
"nextPageToken":"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA",
Sonraki sorgu, nextPageToken alanındaki değeri alır ve pageToken değeri olarak gönderir:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA