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ı koleksiyonlar (ör. Etkinlikler) için sunucunun hiçbir zaman aşmayacağı, alınan girişlerin sayısı konusunda kesin bir sınır vardır. Toplam etkinlik sayısı bu maksimum değeri aşarsa sunucu bir sayfalık sonuç döndürür.
maxResults
işaretinin, bir sayfadaki sonuç sayısını garanti etmediğini unutmayın.
Eksik sonuçlar, sonuçtaki boş olmayan bir nextPageToken
alanı ile tespit edilebilir. Bir sonraki sayfayı almak için daha önce yaptığınız isteğin aynısını yapın ve önceki sayfadaki pageToken
alanına nextPageToken
değerini ekleyin. Tüm sonuçlar alınana kadar aşağıdaki sayfalarda yeni bir nextPageToken
sağlanır.
Örneğin, burada bir sorgu ve ardından sayfalandırılmış listedeki sonuçların bir sonraki sayfasını almak için kullanılan sorgu yer almaktadır:
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