Aşağıdaki örneklerde, v3 API'de çeşitli arama isteklerinin nasıl tamamlanacağı gösterilmektedir.
Videolar
Bu örnekte, "skateboarding dog" (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ıyor. 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. search.list yöntemini çağırır ve sonuç kümesinin yalnızca oynatma listelerini içermesi için 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. search.list yöntemini çağırır ve sonuç kümesinin yalnızca kanalları içermesi için 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 dil ile 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 terimiyle marine (q=marine) ve API yanıtının Fransızca (relevanceLanguage=fr) ile en alakalı sonuçları içermesi gerektiği gösterilmektedir.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=marine &relevanceLanguage=fr
İstekte type parametresi için bir değer ayarlanmadığını unutmayın. Bu, her arama sonucunun bir videoyu, oynatma listesini veya kanalı referans alabileceği anlamına gelir.
Geliştiricinin uygulaması veya web sitesi üzerinden yüklenen videolar
Bu örnekte, bir aramayı yalnızca geliştiricinin uygulaması veya web sitesi üzerinden yüklenen videoları alacak şekilde 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üklemelerini desteklemediği için 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 kendi uygulamanızla ilgili sonuçlar alamazsınız.
Yüklenen her video, geliştiricinin Google API Konsolu'ndaki uygulamasıyla ilişkili proje numarasıyla otomatik olarak etiketlenir.
Bir arama isteği daha sonra forDeveloper parametresini true olarak ayarlarsa API hizmeti, geliştiriciyi tanımlamak için isteğin yetkilendirme kimlik bilgilerini kullanır. Bu nedenle, geliştiriciler sonuçları kendi uygulamaları veya web siteleri üzerinden 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