Anda dapat mengontrol jumlah maksimum resource yang ditampilkan server sebagai
respons terhadap permintaan daftar dengan menyetel kolom maxResults
. Selain itu,
untuk beberapa koleksi (seperti Peristiwa) ada batas pasti pada jumlah
entri yang diambil yang tidak akan pernah terlampaui oleh server. Jika jumlah total peristiwa melebihi jumlah 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 pada
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