Menelusuri daftar sumber daya

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

Ingatlah 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

Responsnya 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