Aşağıdaki örneklerde, v3 API'de birkaç farklı türde arama isteğinin nasıl tamamlanacağı gösterilmektedir.
Videolar
Bu örnekte, "kaykay yapan köpek" sorgusuyla ilişkili en çok görüntülenen, yüksek çözünürlüklü (HD) videoları bulmak için search.list yöntemi çağrılır. Sorgu; order, part, q, type ve videoDefinition parametrelerini ayarlar.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &order=viewCount &q=skateboarding+dog &type=video &videoDefinition=high
Kod örnekleri için search.list yönteminin belgelerine bakın.
Oynatma listeleri
Bu örnekte, "GoogleDevelopers" sorgu terimiyle eşleşen oynatma listelerinin nasıl bulunacağı gösterilmektedir. Sonuç kümesinin yalnızca oynatma listelerini içermesi için search.list yöntemini çağırır ve type parametresinin değerini playlist olarak ayarlar.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=GoogleDevelopers &type=playlist
Kanallar
Bu örnekte, "travel" sorgu terimiyle eşleşen kanalların nasıl bulunacağı gösterilmektedir. Sonuç kümesinin yalnızca kanalları içermesi için search.list yöntemini çağırır ve type parametresinin değerini channel olarak ayarlar.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=travel &type=channel
Belirli bir dille alakalı sonuçlar
Bu örnekte, belirli bir dille en alakalı arama sonuçlarını bulmak için search.list yöntemi çağrılır. Örnekte, sorgu teriminin marine (q=marine) olduğu ve API yanıtının Fransızca ile en alakalı sonuçları (relevanceLanguage=fr) içermesi gerektiği gösterilmektedir.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=marine &relevanceLanguage=fr
İsteğin type parametresi için bir değer ayarlamadığını, yani her arama sonucunun bir videoya, oynatma listesine veya kanala referans verebileceğini unutmayın.
Geliştiricinin uygulaması veya web sitesi üzerinden yüklenen videolar
Bu örnekte, bir aramanın yalnızca geliştiricinin uygulaması veya web sitesi üzerinden yüklenen videoları alacak şekilde nasıl kısıtlanacağı forDeveloper gösterilmektedir. Bu parametre, q parametresi gibi isteğe bağlı arama parametreleriyle birlikte kullanılabilir.
Not: API Gezgini, video yüklemeyi desteklemediğinden bu sorgu API Gezgini'nde sonuç döndürmez. Bu sorguyu API Gezgini dışında kendi uygulamanız için çalıştırabilirsiniz ancak API Gezgini'ni kullanarak uygulamanız için sonuç alamazsınız.
Yüklenen her video, Google Cloud Console'da geliştiricinin uygulamasıyla ilişkili proje numarasıyla otomatik olarak etiketlenir.
Bir arama isteği daha sonra forDeveloper parametresini doğru olarak ayarladığında API hizmeti, geliştiriciyi tanımlamak için isteğin yetkilendirme kimlik bilgilerini kullanır. Bu nedenle, bir geliştirici sonuçları diğer uygulamalar veya siteler üzerinden yüklenen videolarla değil, geliştiricinin kendi uygulaması ya da web sitesi üzerinden yüklenen videolarla kısıtlayabilir.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=fun &forDeveloper=true