Menelusuri daftar sumber daya
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-29 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-29 UTC."],[],[],null,["# Page through lists of resources\n\nYou can control the maximum number of resources the server returns in the\nresponse to a list request by setting the `maxResults` field. Furthermore,\nfor some collections (such as Events) there is a hard limit on the number of\nretrieved entries that the server will never exceed. If the total number of\nevents exceeds this maximum, the server returns one page of results.\n\nRemember that `maxResults` does not guarantee the number of results on one page.\nIncomplete results can be detected by a non-empty `nextPageToken` field in\nthe result. In order to retrieve the next page, perform the exact same request\nas previously and append a `pageToken` field with the value of\n`nextPageToken` from the previous page. A new `nextPageToken` is provided\non the following pages until all the results are retrieved.\n\nFor example, here is a query followed by the query for retrieving the\nnext page of results in a paginated list: \n\n GET /calendars/primary/events?maxResults=10&singleEvents=true\n\n //Result contains\n\n \"nextPageToken\":\"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA\",\n\nThe subsequent query takes the value from `nextPageToken` and\nsubmits it as the value for `pageToken`: \n\n GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA"]]