Channels

API artık kanalınızı veya videolarınızı "çocuklara özel" olarak işaretleme özelliğini destekliyor. Ayrıca, channel ve video kaynakları artık ilgili kanalın veya videonun "çocuklara özel" durumunu tanımlayan bir özelliğe de sahip. YouTube API Hizmetleri Hizmet Şartları ve Geliştirici Politikaları da 10 Ocak 2020'de güncellendi. Daha fazla bilgi için YouTube Data API Hizmeti ve YouTube API Hizmetleri Hizmet Şartları'nın düzeltme geçmişlerine bakın.

channel kaynakları, YouTube kanalı hakkında bilgi içerir.

Yöntemler

API, channels kaynakları için aşağıdaki yöntemleri destekler:

list
İstek ölçütleriyle eşleşen sıfır veya daha fazla channel kaynağından oluşan bir koleksiyon döndürür. Hemen deneyin.
güncelle
Bir kanalın meta verilerini günceller. Bu yöntemin şu anda yalnızca channel kaynağının brandingSettings ve invideoPromotion nesnelerindeki ve bunların alt mülklerindeki güncellemeleri desteklediğini unutmayın. Hemen deneyin.

Kaynak temsili

Aşağıdaki JSON yapısında, channels kaynağının biçimi gösterilmektedir:

{
  "kind": "youtube#channel",
  "etag": etag,
  "id": string,
  "snippet": {
    "title": string,
    "description": string,
    "customUrl": string,
    "publishedAt": datetime,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "country": string
  },
  "contentDetails": {
    "relatedPlaylists": {
      "likes": string,
      "favorites": string,
      "uploads": string
    }
  },
  "statistics": {
    "viewCount": unsigned long,
    "subscriberCount": unsigned long,  // this value is rounded to three significant figures
    "hiddenSubscriberCount": boolean,
    "videoCount": unsigned long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "status": {
    "privacyStatus": string,
    "isLinked": boolean,
    "longUploadsStatus": string,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean
  },
  "brandingSettings": {
    "channel": {
      "title": string,
      "description": string,
      "keywords": string,
      "trackingAnalyticsAccountId": string,
      "unsubscribedTrailer": string,
      "defaultLanguage": string,
      "country": string
    },
    "watch": {
      "textColor": string,
      "backgroundColor": string,
      "featuredPlaylistId": string
    }
  },
  "auditDetails": {
    "overallGoodStanding": boolean,
    "communityGuidelinesGoodStanding": boolean,
    "copyrightStrikesGoodStanding": boolean,
    "contentIdClaimsGoodStanding": boolean
  },
  "contentOwnerDetails": {
    "contentOwner": string,
    "timeLinked": datetime
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Ö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#channel olur.
etag etag
Bu kaynağın Etag değeri.
id string
YouTube'un kanalı benzersiz şekilde tanımlamak için kullandığı kimlik.
snippet object
snippet nesnesi, kanalla ilgili başlık, açıklama ve küçük resim gibi temel bilgileri içerir.
snippet.title string
Kanalın başlığı.
snippet.description string
Kanalın açıklaması. Özelliğin değeri en fazla 1.000 karakter uzunluğunda olabilir.
snippet.customUrl string
Kanalın özel URL'si. YouTube Yardım Merkezi'nde, özel URL almayla ilgili uygunluk koşulları ve URL'nin nasıl ayarlanacağı açıklanmaktadır.
snippet.publishedAt datetime
Kanalın oluşturulduğu tarih ve saat. Değer ISO 8601 biçiminde belirtilir.
snippet.thumbnails object
Kanalla ilişkili küçük resimlerin haritası. Haritadaki her nesne için anahtar, küçük resim adıdır ve değer, küçük resimle ilgili diğer bilgileri içeren bir nesnedir.

Uygulamanızda küçük resimleri görüntülerken, kodunuzun resim URL'lerini API yanıtlarında döndürüldüğü şekilde kullandığından emin olun. Örneğin, uygulamanız bir API yanıtında döndürülen URL'de https alanı yerine http alanını kullanmamalıdır.

Kanal küçük resmi URL'leri yalnızca https alanında kullanılabilir. URL'ler API yanıtlarında bu şekilde görünür. Uygulamanız http alanından YouTube resimleri yüklemeye çalışırsa uygulamanızda bozuk resimler görebilirsiniz. Yeni oluşturulan kanallarda küçük resimler boş olabilir ve doldurulması bir günü bulabilir.
snippet.thumbnails.(key) object
Geçerli anahtar değerleri:
  • default: Varsayılan küçük resim. Bir videonun veya videoya atıfta bulunan bir kaynağın (ör. oynatma listesi öğesi veya arama sonucu) varsayılan küçük resmi 120 piksel genişliğinde ve 90 piksel yüksekliğindedir. Kanalların varsayılan küçük resmi 88 piksel genişliğinde ve 88 piksel yüksekliğindedir.
  • medium: Küçük resmin daha yüksek çözünürlüklü bir sürümü. Videolar (veya videoya atıfta bulunan kaynaklar) için bu resim 320 piksel genişliğinde ve 180 piksel yüksekliğindedir. Kanallar için bu resim 240 piksel genişliğinde ve 240 piksel yüksekliğindedir.
  • high: Küçük resmin yüksek çözünürlüklü sürümü. Videolar (veya videoya atıfta bulunan kaynaklar) için bu resim 480 piksel genişliğinde ve 360 piksel yüksekliğindedir. Kanallar için bu resim 800 piksel genişliğinde ve 800 piksel yüksekliğindedir.
snippet.thumbnails.(key).url string
Resmin URL'si. Uygulamanızda küçük resim URL'lerini kullanmayla ilgili ek yönergeler için snippet.thumbnails mülk tanımına bakın.
snippet.thumbnails.(key).width unsigned integer
Resmin genişliği.
snippet.thumbnails.(key).height unsigned integer
Resmin yüksekliği.
snippet.defaultLanguage string
channel kaynağının snippet.title ve snippet.description özelliklerindeki metnin dili.
snippet.localized object
snippet.localized nesnesi, kanalın yerelleştirilmiş başlığını ve açıklamasını ya da kanalın meta verilerinin varsayılan dilinde kanalın başlığını ve açıklamasını içerir.
  • channels.list isteği, yerelleştirilmiş metnin döndürülmesi gereken bir dili belirtmek için hl parametresini kullandıysa, hl parametresi değeri bir YouTube uygulama dilini tanımladıysa ve yerelleştirilmiş metin bu dilde mevcutsa kaynak snippet'inde yerelleştirilmiş metin döndürülür.
  • hl parametresi değeri belirtilmezse veya bir değer belirtilirse ancak belirtilen dil için yerelleştirilmiş meta veri mevcut değilse varsayılan dilin meta verileri döndürülür.
Mülk salt okunur bir değer içeriyor. Yerelleştirilmiş meta veriler eklemek, güncellemek veya silmek için localizations nesnesini kullanın.
snippet.localized.title string
Yerelleştirilmiş kanal başlığı.
snippet.localized.description string
Yerelleştirilmiş kanal açıklaması.
snippet.country string
Kanalın ilişkilendirildiği ülke. Bu özelliğin değerini ayarlamak için brandingSettings.channel.country mülkünün değerini güncelleyin.
contentDetails object
contentDetails nesnesi, kanalın içeriğiyle ilgili bilgileri kapsar.
contentDetails.relatedPlaylists object
relatedPlaylists nesnesi, kanalla ilişkili oynatma listelerini (ör. kanalın yüklediği veya beğendiği videolar) tanımlayan bir haritadır. playlists.list yöntemini kullanarak bu oynatma listelerinden herhangi birini alabilirsiniz.
contentDetails.relatedPlaylists.likes string
Kanalın beğendiği videoları içeren oynatma listesinin kimliği. Bu listeye öğe eklemek veya listeden öğe kaldırmak için playlistItems.insert ve playlistItems.delete yöntemlerini kullanın.
contentDetails.relatedPlaylists.favorites string
Bu özelliğin desteği sonlandırıldı.

Kanalın favori videolarını içeren oynatma listesinin kimliği. playlistItems.insert ve playlistItems.delete yöntemlerini kullanarak bu listeye öğe ekleyebilir veya listeden öğe kaldırabilirsiniz.

YouTube'un favori video işlevini kullanımdan kaldırdığını unutmayın. Örneğin, video kaynağının statistics.favoriteCount özelliğinin desteği 28 Ağustos 2015'te sonlandırıldı. Sonuç olarak, geçmişe dönük nedenlerle bu mülk değeri, boş bir şarkı listesini belirten bir şarkı listesi kimliği içerebilir ve bu nedenle getirilemez.
contentDetails.relatedPlaylists.uploads string
Kanalın yüklediği videoları içeren oynatma listesinin kimliği. Yeni video yüklemek için videos.insert yöntemini, daha önce yüklenen videoları silmek için videos.delete yöntemini kullanın.
statistics object
statistics nesnesi, kanalın istatistiklerini kapsar.
statistics.viewCount unsigned long
Kanalın görüntülenme sayısı.
statistics.commentCount unsigned long
Bu özelliğin desteği sonlandırıldı.

Kanala gelen yorum sayısı.
statistics.subscriberCount unsigned long
Kanalın abone sayısı. Bu değer, üç anlamlı basamağa yuvarlanır. Abone sayılarının nasıl yuvarlandığı hakkında daha fazla bilgi için Düzeltme Geçmişi'ne veya YouTube Yardım Merkezi'ne göz atın.
statistics.hiddenSubscriberCount boolean
Kanalın abone sayısının herkese açık olup olmadığını gösterir.
statistics.videoCount unsigned long
Kanala yüklenen herkese açık videoların sayısı. Bu değerin, kanalın herkese açık videolarının sayısını yansıttığını unutmayın. Bu davranış, YouTube web sitesinde gösterilen sayılarla tutarlıdır.
topicDetails object
topicDetails nesnesi, kanalla ilişkili konularla ilgili bilgileri kapsar.

Önemli: Konu kimlikleriyle ilgili değişiklikler hakkında daha fazla bilgi için topicDetails.topicIds[] mülk tanımına ve düzeltme geçmişine bakın.
topicDetails.topicIds[] list
Kanalla ilişkili konu kimliklerinin listesi.

Bu özelliğin desteği 10 Kasım 2016'da sonlandırılmıştır. 10 Kasım 2017'ye kadar desteklenecektir.

Önemli: Freebase ve Freebase API'nin desteğinin sonlandırılması nedeniyle konu kimlikleri 27 Şubat 2017'den itibaren farklı şekilde çalışmaya başlamıştır. O dönemde YouTube, küçük bir grup seçili konu kimliği döndürmeye başladı.
topicDetails.topicCategories[] list
Kanalın içeriğini açıklayan Wikipedia URL'lerinin listesi.
status object
status nesnesi, kanalın gizlilik durumuyla ilgili bilgileri kapsar.
status.privacyStatus string
Kanalın gizlilik durumu.

Bu özellik için geçerli değerler şunlardır:
  • private
  • public
  • unlisted
status.isLinked boolean
Kanal verilerinin, halihazırda bir YouTube kullanıcı adına veya Google+ hesabına bağlı bir kullanıcıyı tanımlayıp tanımlamadığını belirtir. Bu bağlantılardan birine sahip olan kullanıcıların herkese açık bir YouTube kimliği vardır. Bu kimlik, video yükleme gibi çeşitli işlemler için ön koşuldur.
status.longUploadsStatus string
Kanalın 15 dakikadan uzun videolar yükleyip yükleyemeyeceğini belirtir. Bu özellik yalnızca kanal sahibi API isteğini yetkilendirdiyse döndürülür. Bu özellik hakkında daha fazla bilgi için YouTube Yardım Merkezi'ni ziyaret edin.

Bu mülk için geçerli değerler şunlardır:
  • allowed: Bu kanal 15 dakikadan uzun videolar yükleyebilir.
  • disallowed: Bu kanal 15 dakikadan uzun videolar yükleyemez veya yüklemeye uygun değildir. Bir kanalın uzun videolar yükleyebilmesi için YouTube Topluluk Kuralları'na uyması ve içeriklerinde dünya genelinde Content ID engellemesi bulunmaması gerekir.

    Kanal sahibi, kanalın uzun videolar yüklemesini engelleyen sorunları çözdükten sonra kanal allowed veya eligible durumuna geri döner.
  • eligible: Bu kanal, 15 dakikadan uzun videolar yüklemeye uygundur. Ancak kanal sahibinin, telefonla doğrulama işlemini tamamlayarak daha uzun videolar yükleme özelliğini etkinleştirmesi gerekir. Bu özellik hakkında daha fazla bilgi için YouTube Yardım Merkezi'ne göz atın.
status.madeForKids boolean
Bu değer, kanalın çocuklara yönelik olarak tanımlanıp tanımlanmadığını gösterir ve kanalın mevcut "çocuklara özel" durumunu içerir. Örneğin, durum selfDeclaredMadeForKids özelliğinin değerine göre belirlenebilir. Kanalınızın, videolarınızın veya yayınlarınızın kitlesini ayarlama hakkında daha fazla bilgi için YouTube Yardım Merkezi'ne göz atın .
status.selfDeclaredMadeForKids boolean
channels.update isteğinde bu özellik, kanal sahibinin kanalı çocuklara yönelik olarak tanımlamasına olanak tanır. Mülk değeri yalnızca kanal sahibi API isteğine yetki verdiyse döndürülür.
brandingSettings object
brandingSettings nesnesi, kanalın marka öğeleriyle ilgili bilgileri kapsar.
brandingSettings.channel object
channel nesnesi, kanal sayfasının marka özelliklerini kapsar.
brandingSettings.channel.title string
Kanalın başlığı. Başlık en fazla 30 karakter uzunluğunda olabilir.
brandingSettings.channel.description string
Kanal sayfanızın kanal bilgileri kutusunda gösterilen kanal açıklaması. Özelliğin değeri en fazla 1.000 karakter uzunluğunda olabilir.
brandingSettings.channel.keywords string
Kanalınızla ilişkili anahtar kelimeler. Değer, boşlukla ayrılmış bir dize listesidir. Kanal anahtar kelimeleri, izin verilen maksimum 500 karakter uzunluğunu aşarsa veya tırnak işareti (") içeriyorsa kısaltılabilir. 500 karakter sınırının anahtar kelime başına değil, tüm anahtar kelimelerin toplam uzunluğuyla ilgili bir sınır olduğunu unutmayın.
brandingSettings.channel.trackingAnalyticsAccountId string
Kanalınızın trafiğini izlemek ve ölçmek için kullanmak istediğiniz Google Analytics hesabının kimliği.
brandingSettings.channel.unsubscribedTrailer string
Kanal sayfasının göz atma görünümünde, abone olmayan izleyiciler için öne çıkan video modülünde oynatılacak video. Abone olan izleyiciler, kanaldaki daha güncel etkinliklerin öne çıkarıldığı farklı bir video görebilir.

Belirtilen özelliğin değeri, kanal sahibine ait herkese açık veya liste dışı bir videonun YouTube video kimliği olmalıdır.
brandingSettings.channel.defaultLanguage string
channel kaynağının snippet.title ve snippet.description özelliklerindeki metnin dili.
brandingSettings.channel.country string
Kanalın ilişkilendirildiği ülke. snippet.country mülkünün değerini ayarlamak için bu mülkü güncelleyin.
brandingSettings.watch object
Not: Bu nesnenin ve tüm alt mülklerinin desteği sonlandırılmıştır.

watch nesnesi, kanalın videolarının izleme sayfalarının marka özelliklerini kapsar.
brandingSettings.watch.textColor string
Not: Bu özelliğin desteği sonlandırıldı.

Video izleme sayfasının markalı alanının metin rengi.
brandingSettings.watch.backgroundColor string
Not: Bu özelliğin desteği sonlandırıldı.

Video izleme sayfasının markalı alanının arka plan rengi.
brandingSettings.watch.featuredPlaylistId string
Not: Bu özelliğin desteği sonlandırıldı. Değerini ayarlamaya çalışırsanız API bir hata döndürür.
brandingSettings.image object
Bu mülkün ve tüm alt mülklerinin desteği sonlandırıldı.

image nesnesi, kanalın kanal sayfasında veya video izleme sayfalarında gösterilen resimlerle ilgili bilgileri kapsar.
brandingSettings.image.bannerImageUrl string
Bu özelliğin desteği sonlandırıldı.

YouTube web sitesindeki kanal sayfasında gösterilen banner resminin URL'si. Resim 1060 piksel x 175 piksel boyutundadır.
brandingSettings.image.bannerMobileImageUrl string
Bu özelliğin desteği sonlandırıldı.

Mobil uygulamalarda kanal sayfasında gösterilen banner resminin URL'si. Resim 640 piksel x 175 piksel boyutundadır.
brandingSettings.image.watchIconImageUrl string
Bu özelliğin desteği sonlandırıldı.

Video oynatıcının üstünde görünen resmin URL'si. Bu, 25 piksel yüksekliğinde ve 170 pikseli geçmeyecek şekilde esnek genişliğe sahip bir resimdir. Bu resmi sağlamazsanız resim yerine kanal adınız gösterilir.
brandingSettings.image.trackingImageUrl string
Bu özelliğin desteği sonlandırıldı.

Kanalın veya video sayfalarının görüntülemeleriyle ilgili istatistikleri toplamak için kullanılabilecek 1 piksel x 1 piksel izleme pikselinin URL'si.
brandingSettings.image.bannerTabletLowImageUrl string
Bu özelliğin desteği sonlandırıldı.

Tablet uygulamalarında kanal sayfasında gösterilen düşük çözünürlüklü banner resminin URL'si. Resmin maksimum boyutu 1.138 piksel x 188 pikseldir.
brandingSettings.image.bannerTabletImageUrl string
Bu özelliğin desteği sonlandırıldı.

Tablet uygulamalarında kanal sayfasında gösterilen banner resminin URL'si. Resim 1.707 piksel x 283 piksel boyutundadır.
brandingSettings.image.bannerTabletHdImageUrl string
Bu özelliğin desteği sonlandırıldı.

Tablet uygulamalarında kanal sayfasında gösterilen yüksek çözünürlüklü banner resminin URL'si. Resmin maksimum boyutu 2.276 piksel x 377 pikseldir.
brandingSettings.image.bannerTabletExtraHdImageUrl string
Bu özelliğin desteği sonlandırıldı.

Tablet uygulamalarında kanal sayfasında gösterilen ekstra yüksek çözünürlüklü banner resminin URL'si. Resmin maksimum boyutu 2.560 piksel x 424 pikseldir.
brandingSettings.image.bannerMobileLowImageUrl string
Bu özelliğin desteği sonlandırıldı.

Mobil uygulamalardaki kanal sayfasında gösterilen düşük çözünürlüklü banner resminin URL'si. Resmin maksimum boyutu 320 piksel x 88 pikseldir.
brandingSettings.image.bannerMobileMediumHdImageUrl string
Bu özelliğin desteği sonlandırıldı.

Mobil uygulamalarda kanal sayfasında gösterilen orta çözünürlüklü banner resminin URL'si. Resmin maksimum boyutu 960 piksel x 263 pikseldir.
brandingSettings.image.bannerMobileHdImageUrl string
Bu özelliğin desteği sonlandırıldı.

Mobil uygulamalardaki kanal sayfasında gösterilen yüksek çözünürlüklü banner resminin URL'si. Resmin maksimum boyutu 1.280 piksel x 360 pikseldir.
brandingSettings.image.bannerMobileExtraHdImageUrl string
Bu özelliğin desteği sonlandırıldı.

Mobil uygulamalarda kanal sayfasında gösterilen çok yüksek çözünürlüklü bir banner resminin URL'si. Resmin maksimum boyutu 1.440 piksel x 395 pikseldir.
brandingSettings.image.bannerTvImageUrl string
Bu özelliğin desteği sonlandırıldı.

Televizyon uygulamalarındaki kanal sayfasında gösterilen ekstra yüksek çözünürlüklü banner resminin URL'si. Resmin maksimum boyutu 2.120 piksel x 1.192 pikseldir.
brandingSettings.image.bannerTvLowImageUrl string
Bu özelliğin desteği sonlandırıldı.

Televizyon uygulamalarındaki kanal sayfasında gösterilen düşük çözünürlüklü banner resminin URL'si. Resmin maksimum boyutu 854 piksel x 480 pikseldir.
brandingSettings.image.bannerTvMediumImageUrl string
Bu özelliğin desteği sonlandırıldı.

Televizyon uygulamalarındaki kanal sayfasında gösterilen orta çözünürlüklü banner resminin URL'si. Resmin maksimum boyutu 1.280 piksel x 720 pikseldir.
brandingSettings.image.bannerTvHighImageUrl string
Bu özelliğin desteği sonlandırıldı.

Televizyon uygulamalarındaki kanal sayfasında gösterilen yüksek çözünürlüklü banner resminin URL'si. Resmin maksimum boyutu 1.920 piksel x 1.080 pikseldir.
brandingSettings.image.bannerExternalUrl string
Bu özellik, YouTube'un bir kanal için çeşitli banner resim boyutlarını oluşturmak amacıyla kullandığı banner resminin konumunu belirtir.
brandingSettings.hints[] list
Bu mülkün ve tüm alt mülklerinin desteği sonlandırıldı.

hints nesnesi, ek marka öğelerini kapsar.
brandingSettings.hints[].property string
Bu özelliğin desteği sonlandırıldı.

Mülk.
brandingSettings.hints[].value string
Bu özelliğin desteği sonlandırıldı.

Özelliğin değeri.
auditDetails object
auditDetails nesnesi, çok kanallı bir ağın (MCN) belirli bir kanalı kabul edip etmeyeceği konusunda karar verirken değerlendireceği kanal verilerini kapsar. Bu kaynak bölümünü alan tüm API isteklerinin https://www.googleapis.com/auth/youtubepartner-channel-audit kapsamını içeren bir yetkilendirme jetonu sağlaması gerektiğini unutmayın. Ayrıca, bu kapsamı kullanan tüm jetonlar, MCN kanalı kabul etmeye veya reddetmeye karar verdiğinde ya da jetonun verildiği tarihten itibaren iki hafta içinde iptal edilmelidir.
auditDetails.overallGoodStanding boolean
Bu alan, kanalda sorun olup olmadığını gösterir. Şu anda bu alan, communityGuidelinesGoodStanding, copyrightStrikesGoodStanding ve contentIdClaimsGoodStanding mülkleri üzerinde mantıksal AND işleminin sonucunu temsil eder. Diğer tüm mülkler de true değerine sahipse bu mülkün değeri de true olur. Ancak bu özelliklerden herhangi birinin değeri false ise bu mülkün değeri false olur. Ancak bu mülkün değerini belirlemek için kullanılan metodolojinin değişebileceğini unutmayın.
auditDetails.communityGuidelinesGoodStanding boolean
Kanalın YouTube Topluluk Kuralları'na uyup uymadığını gösterir.
auditDetails.copyrightStrikesGoodStanding boolean
Kanalda telif hakkı ihtarı olup olmadığını gösterir.
auditDetails.contentIdClaimsGoodStanding boolean
Kanalda çözülmemiş hak talebi olup olmadığını gösterir.
contentOwnerDetails object
contentOwnerDetails nesnesi, yalnızca kanalı İçerik Yöneticisi'ne bağlayan YouTube iş ortağının görebildiği kanal verilerini kapsar.
contentOwnerDetails.contentOwner string
Kanala bağlı içerik sahibinin kimliği.
contentOwnerDetails.timeLinked datetime
Kanalın içerik sahibine bağlandığı tarih ve saat. Değer ISO 8601 biçiminde belirtilir.
localizations object
localizations nesnesi, kanalın meta verilerinin çevirilerini kapsar.
localizations.(key) object
Anahtar değerle ilişkili yerelleştirilmiş meta verilerin dili. Değer, BCP-47 dil kodu içeren bir dizedir.
localizations.(key).title string
Yerelleştirilmiş kanal başlığı.
localizations.(key).description string
Yerelleştirilmiş kanal açıklaması.