Anda dapat mengontrol jumlah maksimum resource yang ditampilkan server dalam respons terhadap permintaan daftar dengan menyetel kolom maxResults
. Selain itu, untuk beberapa kumpulan (seperti Peristiwa), ada batas ketat pada jumlah entri yang diambil yang tidak akan pernah dilampaui server. Jika jumlah total
peristiwa melebihi jumlah maksimum ini, server akan menampilkan satu halaman hasil.
Ingatlah bahwa maxResults
tidak menjamin jumlah hasil di satu halaman.
Hasil yang tidak lengkap dapat dideteksi dengan 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 diberikan
di halaman berikutnya hingga semua hasil diambil.
Misalnya, berikut adalah kueri yang diikuti dengan kueri untuk mengambil halaman hasil berikutnya dalam daftar yang memiliki penomoran 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