Contoh berikut menunjukkan cara menyelesaikan beberapa jenis permintaan penelusuran di v3 API.
Video
Contoh ini memanggil metode search.list
untuk menemukan video definisi tinggi (HD) yang paling banyak ditonton dan terkait dengan kueri " bermain skateboard". Kueri menetapkan parameter order
, part
, q
, type
, dan videoDefinition
.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &order=viewCount &q=skateboarding+dog &type=video &videoDefinition=high
Lihat dokumentasi metode search.list
untuk contoh kode.
Playlist
Contoh ini menunjukkan cara menemukan playlist yang cocok dengan istilah kueri "GoogleDevelopers". Metode ini memanggil metode search.list
dan menetapkan nilai parameter type
ke playlist
sehingga kumpulan hasil hanya menyertakan playlist.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=GoogleDevelopers &type=playlist
Channel
Contoh ini menunjukkan cara menemukan saluran yang cocok dengan istilah kueri "travel". Metode ini memanggil metode search.list
dan menetapkan nilai parameter type
ke channel
sehingga kumpulan hasilnya hanya menyertakan saluran.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=travel &type=channel
Hasil yang relevan dengan bahasa tertentu
Contoh ini memanggil metode search.list
untuk menemukan hasil penelusuran yang paling relevan dengan bahasa tertentu. Contoh ini menunjukkan bahwa istilah kueri adalah marine (q=marine
) dan respons API harus berisi hasil yang paling relevan dengan bahasa Prancis (relevanceLanguage=fr
).
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=marine &relevanceLanguage=fr
Perhatikan bahwa permintaan tidak menetapkan nilai untuk parameter type
, yang berarti setiap hasil penelusuran dapat mereferensikan video, playlist, atau channel.
Video yang diupload melalui aplikasi atau situs developer
Contoh ini menunjukkan cara menggunakan parameter forDeveloper
untuk membatasi penelusuran agar hanya mengambil video yang diupload melalui aplikasi atau situs developer. Parameter ini dapat digunakan bersama dengan parameter penelusuran opsional, seperti parameter q
.
Catatan: Kueri ini sebenarnya tidak menampilkan hasil di API Explorer karena API Explorer tidak mendukung upload video. Anda dapat menjalankan kueri ini untuk aplikasi Anda sendiri di luar API Explorer, tetapi Anda tidak dapat mendapatkan hasil untuk aplikasi Anda menggunakan API Explorer.
Setiap video yang diupload akan otomatis diberi tag dengan nomor project yang terkait dengan aplikasi developer di Konsol API Google.
Jika permintaan penelusuran kemudian menetapkan parameter forDeveloper
ke benar (true), layanan API akan menggunakan kredensial otorisasi permintaan untuk mengidentifikasi developer. Dengan demikian, developer dapat membatasi hasil untuk video yang diupload melalui aplikasi atau situsnya sendiri, tetapi tidak untuk video yang diupload melalui aplikasi atau situs lain.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=fun &forDeveloper=true