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ı 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 alanı için değer olarak gönderir:

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