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