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