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ıyla ilgili katı bir sınır vardır. Toplam etkinlik sayısı bu maksimum sayıyı aşarsa sunucu bir sayfa sonuç döndürür.
maxResults
değerinin, bir sayfadaki sonuç sayısını garanti etmediğini unutmayın.
Eksik sonuçlar, sonuçtaki boş olmayan bir nextPageToken
alanıyla tespit edilebilir. Sonraki sayfayı almak için daha önceyle aynı isteği gerçekleştirin ve önceki sayfadaki nextPageToken
değerini içeren bir pageToken
alanı ekleyin. Tüm sonuçlar alıncaya kadar aşağıdaki sayfalarda yeni bir nextPageToken
sağlanır.
Örneğin, sayfalara ayrılmış bir listedeki sonuçların bir sonraki sayfasını almak için kullanılan sorgunun ardından bir sorgu verilmiştir:
GET /calendars/primary/events?maxResults=10&singleEvents=true
//Result contains
"nextPageToken":"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA",
Sonraki sorgu, nextPageToken
alanındaki değeri alır ve pageToken
için değer olarak gönderir:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA