Menelusuri daftar sumber daya

Anda bisa mengontrol jumlah maksimum resource yang dikembalikan server dalam respons permintaan daftar dengan menyetel kolom maxResults. Selain itu, untuk beberapa koleksi (seperti Peristiwa), ada batasan ketat terkait jumlah entri yang diambil tidak akan pernah terlampaui oleh server. Jika jumlah peristiwa melebihi batas maksimum ini, server akan menampilkan satu halaman hasil.

Perlu diingat bahwa maxResults tidak menjamin jumlah hasil di satu halaman. Hasil yang tidak lengkap dapat dideteksi oleh kolom nextPageToken yang tidak kosong di hasilnya. Untuk mengambil halaman berikutnya, lakukan permintaan yang sama persis. seperti sebelumnya dan tambahkan kolom pageToken dengan nilai nextPageToken dari halaman sebelumnya. nextPageToken baru diberikan di halaman berikutnya hingga semua hasil diambil.

Misalnya, berikut ini kueri yang diikuti dengan kueri untuk mengambil halaman hasil berikutnya dalam daftar yang diberi nomor halaman:

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

//Result contains

"nextPageToken":"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA",

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

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