Aşağıdaki örneklerde, v3 API'sinde birkaç farklı arama isteği türünün nasıl yapılacağı gösterilmektedir.
Videolar
Bu örnekte "kaykay köpek" sorgusuyla ilişkili en çok izlenen yüksek çözünürlüklü (HD) videoları bulmak için search.list yöntemi kullanılmaktadı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 dokümanlarına bakın.
Oynatma listeleri
Bu örnekte, "GoogleDevelopers" sorgu terimiyle eşleşen oynatma listelerinin nasıl bulunacağı gösterilmektedir. Sonuç grubunun 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, "seyahat" sorgu terimiyle eşleşen kanalların nasıl bulunacağı gösterilmektedir. Sonuç grubunun 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 deniz (q=marine) olduğu ve API yanıtının Fransızca (relevanceLanguage=fr) ile en alakalı sonuçları içermesi gerektiği gösterilir.
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 belirlemediğini unutmayın. Bu, her arama sonucunun bir videoya, oynatma listesine veya kanala başvuruda bulunabileceği anlamına gelir.
Geliştiricinin uygulaması veya web sitesi aracılığıyla yüklenen videolar
Bu örnekte, yalnızca geliştiricinin uygulaması veya web sitesi üzerinden yüklenen videoları almak amacıyla aramayı kısıtlamak için forDeveloper parametresinin nasıl kullanılacağı gösterilmektedir. Bu parametre, q parametresi gibi isteğe bağlı arama parametreleriyle birlikte kullanılabilir.
Not: API Gezgini, video yükleme işlemlerini desteklemediğinden bu sorgu gerçekte API Gezgini'nde sonuç döndürmez. Bu sorguyu API Gezgini dışında kendi uygulamanız için de çalıştırabilirsiniz ancak kendi uygulamanız için API Gezgini'ni kullanarak sonuç alamazsınız.
Yüklenen her video, Google API Konsolu'nda 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, geliştiriciler sonuçları geliştiricinin kendi uygulaması veya web sitesi aracılığıyla yüklenen videolarla kısıtlayabilir ancak diğer uygulamalar veya siteler üzerinden yüklenen videolarla kısıtlayamaz.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=fun &forDeveloper=true