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