Penerapan: Permintaan penelusuran

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