Videos: list

API isteği parametreleriyle eşleşen videoların listesini döndürür.

Kota etkisi: Bu yönteme yapılan bir çağrının kota maliyeti 1 birimdir.

Yaygın kullanım alanları

İstek

HTTP isteği

GET https://www.googleapis.com/youtube/v3/videos

Parametreler

Aşağıdaki tabloda, bu sorgunun desteklediği parametreler listelenmiştir. Listelenen tüm parametreler sorgu parametreleridir.

Parametreler
Gerekli parametreler
part string
part parametresi, API yanıtının içereceği bir veya daha fazla video kaynak özelliğinin virgülle ayrılmış listesini belirtir.

Parametre, alt özellikleri olan bir özelliği tanımlıyorsa alt özellikler yanıta dahil edilir. Örneğin, bir video kaynağında snippet özelliği; channelId, title, description, tags ve categoryId özelliklerini içerir. Bu nedenle, part=snippet değerini ayarlarsanız API yanıtı bu özelliklerin tümünü içerir.

Aşağıdaki listede, parametre değerine ekleyebileceğiniz part adları yer almaktadır:
  • brandPartner
  • contentDetails
  • fileDetails
  • id
  • liveStreamingDetails
  • localizations
  • paidProductPlacementDetails
  • player
  • processingDetails
  • recordingDetails
  • snippet
  • statistics
  • status
  • suggestions
  • topicDetails
Filtreler (Aşağıdaki parametrelerden tam olarak birini belirtin)
chart string
chart parametresi, almak istediğiniz listeyi tanımlar.

Kabul edilebilir değerler şunlardır:
id string
id parametresi, alınan kaynakların YouTube video kimliklerinin virgülle ayrılmış listesini belirtir. video kaynağında, id özelliği videonun kimliğini belirtir.
myRating string

Bu parametre yalnızca uygun şekilde yetkilendirilmiş bir istekte kullanılabilir. API'ye yalnızca kimliği doğrulanmış kullanıcının beğendiği veya beğenmediği videoları döndürmesini söylemek için bu parametrenin değerini like veya dislike olarak ayarlayın.



API, döndürülen sonuç kümesini en fazla 1.000 videoyla sınırlar. Yanıtın pageInfo.totalResults mülkü daha yüksek bir toplam gösterse bile pageToken parametresi kullanılarak yapılan sayfalama yalnızca en son 1.000 öğenin alınmasına izin verir.



Parametre aşağıdaki değerleri kabul eder:

  • dislike: Yalnızca kimliği doğrulanmış kullanıcının beğenmediği videoları döndürür.
  • like: Yalnızca kimliği doğrulanmış kullanıcının beğendiği videoları döndürür.
İsteğe bağlı parametreler
hl string
hl parametresi, API'ye YouTube web sitesinin desteklediği belirli bir uygulama dili için yerelleştirilmiş kaynak meta verilerini alma talimatı verir. Parametre değeri, i18nLanguages.list yönteminin döndürdüğü listede yer alan bir dil kodu olmalıdır.

Yerelleştirilmiş kaynak ayrıntıları bu dilde mevcutsa kaynağın snippet.localized nesnesi, yerelleştirilmiş değerleri içerir. Ancak yerelleştirilmiş ayrıntılar mevcut değilse snippet.localized nesnesi, kaynağın varsayılan dilindeki kaynak ayrıntılarını içerir.
maxHeight unsigned integer
maxHeight parametresi, player.embedHtml özelliğinde döndürülen yerleştirilmiş oynatıcının maksimum yüksekliğini belirtir. Bu parametreyi, yerleştirme kodunun varsayılan boyutlar yerine uygulama düzeninize uygun bir yükseklik kullanmasını belirtmek için kullanabilirsiniz. maxWidth parametresi de sağlanırsa maksimum genişliği ihlal etmemek için oynatıcı, maxHeight değerinden daha kısa olabilir. Kabul edilen değerler 72 ile 8192 arasındadır (bu değerler dahil).
maxResults unsigned integer
maxResults parametresi, sonuç kümesinde döndürülmesi gereken maksimum öğe sayısını belirtir.

Not: Bu parametre, myRating parametresiyle birlikte kullanılabilir ancak id parametresiyle birlikte kullanılamaz. Kabul edilen değerler, 1 ile 50 (bu değerler dahil) arasındadır. Varsayılan değer: 5.
maxWidth unsigned integer
maxWidth parametresi, player.embedHtml özelliğinde döndürülen yerleştirilmiş oynatıcının maksimum genişliğini belirtir. Bu parametreyi, varsayılan boyutlar yerine yerleştirme kodunun uygulama düzeninize uygun bir genişlik kullanmasını belirtmek için kullanabilirsiniz.

maxHeight parametresi de sağlanırsa maksimum yüksekliği ihlal etmemek için oynatıcı maxWidth değerinden daha dar olabilir. Kabul edilen değerler 72 ile 8192 arasındadır (bu değerler dahil).
onBehalfOfContentOwner string
Bu parametre yalnızca doğru şekilde yetkilendirilmiş bir istekte kullanılabilir. Not: Bu parametre yalnızca YouTube içerik iş ortakları için tasarlanmıştır.

onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin, parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube İçerik Yönetim Sistemi kullanıcısını tanımladığını gösterir. Bu parametre, birçok farklı YouTube kanalının sahibi olan ve bunları yöneten YouTube içerik iş ortakları için tasarlanmıştır. İçerik sahipleri, bu özellik sayesinde bir kez kimlik doğrulama yaparak tüm video ve kanal verilerine erişebilir. Her kanal için ayrı ayrı kimlik doğrulama bilgileri sağlamaları gerekmez. Kullanıcının kimlik doğrulaması için kullandığı CMS hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.
pageToken string
pageToken parametresi, sonuç kümesinde döndürülmesi gereken belirli bir sayfayı tanımlar. Bir API yanıtında, nextPageToken ve prevPageToken özellikleri, alınabilecek diğer sayfaları tanımlar.

Not: Bu parametre, myRating parametresiyle birlikte kullanılabilir ancak id parametresiyle birlikte kullanılamaz.
regionCode string
regionCode parametresi, API'ye belirtilen bölgede kullanılabilen bir video listesi seçmesi talimatını verir. Bu parametre yalnızca chart parametresiyle birlikte kullanılabilir. Parametre değeri, ISO 3166-1 alfa-2 ülke kodudur.
videoCategoryId string
videoCategoryId parametresi, listenin alınması gereken video kategorisini tanımlar. Bu parametre yalnızca chart parametresiyle birlikte kullanılabilir. Varsayılan olarak listeler belirli bir kategoriyle kısıtlanmaz. Varsayılan değer 0'dır.

İstek metni

Bu yöntemi çağırırken istek gövdesi sağlamayın.

Yanıt

Başarılı olursa bu yöntem, aşağıdaki yapıya sahip bir yanıt gövdesi döndürür:

{
  "kind": "youtube#videoListResponse",
  "etag": etag,
  "nextPageToken": string,
  "prevPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    video Resource
  ]
}

Özellikler

Aşağıdaki tabloda, bu kaynakta görünen özellikler tanımlanmaktadır:

Özellikler
kind string
API kaynağının türünü tanımlar. Değer youtube#videoListResponse olur.
etag etag
Bu kaynağın Etag'i.
nextPageToken string
Sonuç kümesindeki sonraki sayfayı almak için pageToken parametresinin değeri olarak kullanılabilecek jeton.
prevPageToken string
Sonuç kümesinde önceki sayfayı almak için pageToken parametresinin değeri olarak kullanılabilen jeton.
pageInfo object
pageInfo nesnesi, sonuç kümesi için sayfalama bilgilerini kapsar.
pageInfo.totalResults integer
Sonuç kümesindeki toplam sonuç sayısı.
pageInfo.resultsPerPage integer
API yanıtına dahil edilen sonuçların sayısı.
items[] list
İstek ölçütleriyle eşleşen videoların listesi.

Hatalar

Aşağıdaki tabloda, API'nin bu yönteme yapılan bir çağrıya yanıt olarak döndürebileceği hata mesajları belirtilmektedir. Daha fazla bilgi için hata mesajı belgelerini inceleyin.

Hata türü Hata ayrıntısı Açıklama
badRequest (400) videoChartNotFound İstenen video listesi desteklenmiyor veya kullanılamıyor.
forbidden (403) forbidden İsteğin, video dosyasına veya işleme bilgilerine erişmek için uygun yetkisi yok. fileDetails, processingDetails ve suggestions bölümlerinin yalnızca videonun sahibi tarafından kullanılabildiğini unutmayın.
forbidden (403) forbidden İstek, kullanıcı puanı bilgilerine erişemiyor. Bu hata, isteğin myRating parametresini kullanmak için düzgün şekilde yetkilendirilmemesinden kaynaklanabilir.
notFound (404) videoNotFound Almaya çalıştığınız video bulunamıyor. İsteğin id parametresinin değerini kontrol ederek doğru olduğundan emin olun.

Deneyin.

Bu API'yi çağırmak ve API isteği ile yanıtını görmek için APIs Explorer kullanın.