Implementasi: Permintaan penelusuran

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