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ı 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