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 mutlak jumlah entri yang diambil yang tidak akan pernah terlampaui oleh server. Jika jumlah total peristiwa melebihi maksimum ini, server akan menampilkan satu halaman hasil.
Ingat bahwa maxResults
tidak menjamin jumlah hasil di satu halaman.
Hasil yang tidak lengkap dapat dideteksi oleh kolom nextPageToken
yang tidak kosong dalam
hasil. Untuk mengambil halaman berikutnya, lakukan permintaan yang sama persis
seperti sebelumnya dan tambahkan kolom pageToken
dengan nilai
nextPageToken
dari halaman sebelumnya. nextPageToken
baru disediakan
di halaman berikutnya hingga semua hasil diambil.
Misalnya, berikut adalah 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