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şmadığı, 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. Yanıtın nextPageToken alanının boş olmaması, sonuçların eksik olduğunu gösterir. Sonraki sayfayı almak için önceki isteği tekrarlayın ve önceki sayfadaki pageToken değerine sahip bir nextPageToken parametresi ekleyin. Yanıt tüm sonuçları içermeyene kadar sonraki her sayfada yeni bir nextPageToken sağlanır.

Örneğin, aşağıdaki sorgu ilk sayfayı ister:

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

Yanıtta nextPageToken var:

{
  "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