Channels: list

Not: channel kaynağının statistics.subscriberCount özellik değeri abone sayılarının gösterilme şeklini etkileyen bir YouTube politika değişikliğini yansıtacak şekilde güncellendi. Daha fazla bilgi için Düzeltme Geçmişi veya YouTube Yardım Merkezi'ne göz atın.

İstek ölçütleriyle eşleşen sıfır veya daha fazla channel kaynağı içeren bir koleksiyon 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/channels

Yetkilendirme

Bir channel kaynağı için auditDetails bölümünü alan bir istek, https://www.googleapis.com/auth/youtubepartner-channel-audit kapsamını içeren bir yetkilendirme jetonu sağlamalıdır. Ayrıca, bu kapsamı kullanan tüm jetonlar, MCN'nin kanalı kabul etmeye veya reddetmeye karar verdiği anda ya da jetonun verildiği tarihten itibaren iki hafta içinde iptal edilmelidir.

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 channel 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 channel kaynağında contentDetails özelliği, uploads özellikleri gibi başka özellikler içerir. Bu nedenle, part=contentDetails değerini ayarlarsanız API yanıtı, iç içe yerleştirilmiş tüm bu özellikleri de içerir.

Aşağıdaki listede, parametre değerine ekleyebileceğiniz part adları yer almaktadır:
  • auditDetails
  • brandingSettings
  • contentDetails
  • contentOwnerDetails
  • id
  • localizations
  • snippet
  • statistics
  • status
  • topicDetails
Filtreler (Aşağıdaki parametrelerden tam olarak birini belirtin)
categoryId string
Bu parametrenin desteği sonlandırılmıştır. categoryId parametresi bir YouTube rehber kategorisi belirtir ve bu kategoriyle ilişkili YouTube kanallarını istemek için kullanılabilir.
forHandle string
forHandle parametresi, bir YouTube herkese açık kullanıcı adı belirtir ve bu herkese açık kullanıcı adıyla ilişkili kanalı ister. Parametre değerinin önüne @ sembolü eklenebilir. Örneğin, "Geliştiriciler İçin Google" kanalının kaynağını almak için forHandle parametre değerini GoogleDevelopers veya @GoogleDevelopers olarak ayarlayın.
forUsername string
forUsername parametresi bir YouTube kullanıcı adı belirtir ve bu kullanıcı adıyla ilişkili kanalı ister.
id string
id parametresi, alınan kaynakların YouTube kanal kimliklerinin virgülle ayrılmış bir listesini belirtir. channel kaynağında, id özelliği kanalın YouTube kanal kimliğini belirtir.
managedByMe boolean
Bu parametre yalnızca uygun şekilde yetkilendirilmiş bir istekte kullanılabilir.

Not: Bu parametre yalnızca YouTube içerik iş ortakları için tasarlanmıştır.

API'ye yalnızca onBehalfOfContentOwner parametresinin belirttiği içerik sahibinin yönettiği kanalları döndürmesi talimatını vermek için bu parametrenin değerini true olarak ayarlayın. Kullanıcının, belirtilen içerik sahibine bağlı bir içerik yönetim sistemi hesabı olarak kimliği doğrulanmalı ve onBehalfOfContentOwner sağlanmalıdır.
mine boolean
Bu parametre yalnızca uygun şekilde yetkilendirilmiş bir istekte kullanılabilir. API'ye yalnızca kimliği doğrulanmış kullanıcıya ait kanalları döndürmesi talimatını vermek için bu parametrenin değerini true olarak ayarlayın.
İ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öntemi tarafından döndürülen 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.
maxResults unsigned integer
maxResults parametresi, sonuç kümesinde döndürülmesi gereken maksimum öğe sayısını belirtir. Kabul edilen değerler 0 ile 50 arasındadır (bu değerler dahil). Varsayılan değer: 5.
onBehalfOfContentOwner string
Bu parametre yalnızca uygun şekilde yetkilendirilmiş bir istekte kullanılabilir.

Not: Bu parametre yalnızca YouTube İçerik İş Ortakları için tasarlanmıştır.

onBehalfOfContentOwner parametresi, isteğin yetkilendirme yeterlilik belgelerinin, parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube İYS 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 kimliğini doğruladığı içerik yönetim sistemi 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. API yanıtında nextPageToken ve prevPageToken özellikleri, alınabilecek diğer sayfaları tanımlar.

İ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#channelListResponse",
  "etag": etag,
  "nextPageToken": string,
  "prevPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    channel 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#channelListResponse 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ümesindeki önceki sayfayı almak için pageToken parametresinin değeri olarak kullanılabilecek jeton. İlgili API isteği managedByMe parametresini true olarak ayarladıysa bu özelliğin API yanıtına dahil edilmediğini unutmayın.
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ç sayısı.
items[] list
İstek ölçütleriyle eşleşen kanalları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ı tanımlanmaktadır. Daha fazla bilgi için YouTube Data API - Hatalar başlıklı makaleyi inceleyin.

Hata türü Hata ayrıntısı Açıklama
badRequest (400) invalidCriteria Aşağıdaki filtrelerden en fazla biri belirtilebilir:id, categoryId, mine, managedByMe, forHandle, forUsername. İçerik sahibinin onBehalfOfContentOwner parametresi aracılığıyla kimlik doğrulaması yapması durumunda yalnızca id veya managedByMe belirtilebilir.
forbidden (403) channelForbidden id parametresiyle belirtilen kanal, isteği desteklemiyor veya istek düzgün şekilde yetkilendirilmemiş.
notFound (404) categoryNotFound categoryId parametresiyle tanımlanan kategori bulunamıyor. Geçerli değerlerin listesini almak için guideCategories.list yöntemini kullanın.
notFound (404) channelNotFound id parametresinde belirtilen kanal bulunamıyor.

Deneyin.

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