Implementasi: Penomoran Halaman
Contoh berikut menunjukkan cara mengambil kumpulan hasil tambahan untuk kueri YouTube Data API (v3).
API menggunakan parameter maxResults untuk menunjukkan jumlah item yang harus disertakan dalam respons API. Hampir semua metode list API (videos.list, playlists.list, dll.) mendukung parameter tersebut.
Jika hasil tambahan tersedia untuk kueri, respons API akan berisi properti nextPageToken, properti prevPageToken, atau keduanya. Nilai properti tersebut kemudian dapat digunakan untuk menetapkan parameter pageToken guna mengambil halaman hasil tambahan.
Misalnya, kueri berikut mengambil hasil penelusuran untuk 10 video yang paling banyak ditonton yang cocok dengan kueri " skateboard":
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
part=snippet
&maxResults=10
&order=viewCount
&q=skateboarding+dog
&type=video
Respons API berisi 10 kecocokan pertama untuk kueri serta properti nextPageToken yang dapat digunakan untuk mengambil 10 hasil berikutnya:
Kueri di bawah mengambil 10 hasil berikutnya untuk kueri:
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
part=snippet
&maxResults=10
&order=viewCount
&pageToken=CAoQAA
&q=skateboarding+dog
&type=video
Catatan: Anda mungkin perlu memperbarui nilai parameter pageToken untuk menyelesaikan permintaan ini di API Explorer. Jalankan kueri yang mengambil 10 hasil pertama untuk mendapatkan nilai parameter pageToken yang benar.
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 2024-11-23 UTC.
[null,null,["Terakhir diperbarui pada 2024-11-23 UTC."],[[["The YouTube Data API (v3) uses the `maxResults` parameter to determine the number of items returned in a query response."],["API `list` methods, such as `videos.list` and `playlists.list`, support the `maxResults` parameter for pagination."],["If more results are available, the API response includes `nextPageToken` and/or `prevPageToken` properties."],["These token values can be used to set the `pageToken` parameter to retrieve additional result pages."],["The initial request fetches the first page of results, and subsequent requests use the `pageToken` from the previous response to get the next page of results."]]],["The YouTube Data API (v3) uses `maxResults` to specify the number of items in a response. `list` methods support this, and responses with additional results include `nextPageToken` or `prevPageToken`. These tokens, used with the `pageToken` parameter, retrieve further result sets. For instance, a query can get 10 most viewed videos, and a `nextPageToken` in the response allows fetching the next 10 by adding this value in the `pageToken` parameter.\n"]]
