Contoh berikut menunjukkan cara menyelesaikan beberapa jenis permintaan penelusuran di API v3.
Video
Contoh ini memanggil metode search.list
untuk menemukan video definisi tinggi (HD) yang paling banyak ditonton, yang terkait dengan kueri " skateboarding". 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". Callback ini memanggil metode search.list
dan menetapkan parameter value type
ke playlist
sehingga 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 "wisata". Fungsi ini memanggil metode search.list
dan menetapkan parameter value type
ke channel
sehingga kumpulan hasil 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 bahwa 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 merujuk ke 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 situs atau aplikasi developer. Parameter ini dapat digunakan bersama dengan parameter penelusuran opsional, seperti parameter q
.
Catatan: Kueri ini tidak benar-benar menampilkan hasil di APIs Explorer karena API Explorer tidak mendukung upload video. Anda dapat menjalankan kueri ini untuk aplikasi Anda sendiri di luar API Explorer, tetapi Anda tidak bisa mendapatkan hasil untuk aplikasi Anda menggunakan APIs Explorer.
Setiap video yang diupload akan otomatis diberi tag dengan nomor project yang dikaitkan dengan aplikasi developer di Konsol API Google.
Jika permintaan penelusuran menetapkan parameter forDeveloper
ke benar (true), layanan API akan menggunakan kredensial otorisasi permintaan untuk mengidentifikasi developer. Dengan demikian, developer dapat membatasi hasil ke video yang diupload melalui situs atau aplikasi miliknya sendiri, tetapi tidak pada 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