Menelusuri daftar sumber daya

Anda dapat mengontrol jumlah maksimum resource yang ditampilkan server dalam respons terhadap permintaan daftar dengan menetapkan kolom maxResults. Selain itu, untuk beberapa koleksi (seperti peristiwa), ada batas tetap pada jumlah entri yang diambil yang tidak pernah dilampaui server. Jika jumlah total peristiwa melebihi maksimum ini, server akan menampilkan satu halaman hasil.

Perlu diingat bahwa maxResults tidak menjamin jumlah hasil di satu halaman. Kolom nextPageToken yang tidak kosong dalam respons menunjukkan hasil yang tidak lengkap. Untuk mengambil halaman berikutnya, ulangi permintaan sebelumnya dan tambahkan parameter pageToken dengan nilai nextPageToken dari halaman sebelumnya. Setiap halaman berikutnya memberikan nextPageToken baru hingga respons berisi semua hasil.

Misalnya, kueri berikut meminta halaman pertama:

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

Respons berisi nextPageToken:

{
  "nextPageToken": "CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA"
}

Kueri berikutnya mengambil nilai dari nextPageToken dan mengirimkannya sebagai nilai untuk pageToken:

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