Channels

API artık kanalınızı veya kanallarınızı videoların "çocuklara özel" olarak değerlendirilmesi. Ayrıca, channel ve video kaynaklarında artık "çocuklara özel" kanal veya videonun durumu hakkında bilgi edinebilirsiniz. YouTube API Hizmetleri Hizmet Şartları ve Geliştirici Politikaları 10 Ocak 2020 tarihinde de güncellenmiştir. Daha fazla bilgi için lütfen YouTube Data API Hizmeti ve YouTube API Hizmetleri Hizmet Şartları.

channel kaynağı, bir YouTube kanalıyla ilgili bilgiler 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
Kanalın meta verilerini günceller. Bu yöntemin şu anda yalnızca channel kaynağının brandingSettings ve invideoPromotion nesneleri ile alt özelliklerinde yapılan güncellemeleri desteklediğini unutmayın. Hemen deneyin.

Kaynak temsili

Aşağıdaki JSON yapısı, bir channels kaynağının biçimini gösterir:

{
  "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'i.
id string
YouTube'un kanalı benzersiz şekilde tanımlamak için kullandığı kimliktir.
snippet object
snippet nesnesi, kanalla ilgili temel ayrıntıları (ör. başlığı, açıklaması ve küçük resmi) içerir.
snippet.title string
Kanalın başlığı.
snippet.description string
Kanalın açıklaması. Tesisin değeri en fazla 1000 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 önemli olan küçük resmin adı, değer ise küçük resim hakkında diğer bilgileri içeren bir nesnedir.

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

Kanal küçük resim URL'leri yalnızca https alanında kullanılabilir. URL'ler API yanıtlarında bu şekilde görünür. http alanından YouTube resimleri yüklemeye çalışırsa uygulamanızda bozuk resimler görebilirsiniz. Küçük resim resimleri yeni oluşturulan kanallar için boş olabilir ve küçük resimlerin doldurulması bir günü bulabilir.
snippet.thumbnails.(key) object
Geçerli anahtar değerleri şunlardır:
  • default: Varsayılan küçük resimdir. Bir videonun (veya oynatma listesi öğesi ya da arama sonucu gibi bir videoya atıfta bulunan bir kaynak) varsayılan küçük resmi 120 piksel genişliğinde ve 90 piksel uzunluğundadır. Bir kanalı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ü sürümü. Bir video (veya videoya atıfta bulunan bir kaynak) için bu görüntü 320 piksel genişliğinde ve 180 piksel yüksekliğindedir. Bir kanal 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ü. Bir video (veya videoya atıfta bulunan bir kaynak) için bu görüntü 480 piksel genişliğinde ve 360 piksel yüksekliğindedir. Bir kanal 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'lerinin kullanımıyla ilgili ek yönergeler için snippet.thumbnails özelliğinin 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 dili belirtmek için hl parametresini kullanıyorsa, hl parametre değeri bir YouTube uygulama dilini tanımlıyorsa ve yerelleştirilmiş metin bu dilde mevcutsa kaynak snippet'inde yerelleştirilmiş metin döndürülür.
  • Bir hl parametre değeri belirtilmemiş veya bir değer belirtilmişse ancak belirtilen dil için yerelleştirilmiş meta veriler mevcut değilse varsayılan dilin meta verileri döndürülür.
Özellik, salt okunur bir değer içerir. Yerelleştirilmiş meta verileri 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 ülkedir. Bu özelliğin değerini ayarlamak için brandingSettings.channel.country özelliğinin değerini güncelleyin.
contentDetails object
contentDetails nesnesi, kanal içeriğiyle ilgili bilgileri içerir.
contentDetails.relatedPlaylists object
relatedPlaylists nesnesi, kanalın yüklediği videolar veya beğenilen videolar gibi kanalla ilişkili oynatma listelerini tanımlayan bir haritadır. Bu oynatma listelerinden herhangi birini playlists.list yöntemini kullanarak alabilirsiniz.
contentDetails.relatedPlaylists.likes string
Kanalda beğenilen videoları içeren oynatma listesinin kimliği. Listeye öğe eklemek veya listeden öğe kaldırmak için playlistItems.insert ve playlistItems.delete yöntemlerini kullanın.
contentDetails.relatedPlaylists.favorites string
Bu mülk kullanımdan kaldırıldı.

Kanalın favori videolarını içeren oynatma listesinin kimliği. Listeye öğe eklemek veya listeden öğe kaldırmak için playlistItems.insert ve playlistItems.delete yöntemlerini kullanın.

YouTube'un favori video işlevini kullanımdan kaldırdığını unutmayın. Örneğin, video kaynağının statistics.favoriteCount özelliği 28 Ağustos 2015'te kullanımdan kaldırıldı. Sonuç olarak, bu özellik değeri, geçmişe yönelik nedenlerle, boş bir oynatma listesine işaret eden bir oynatma listesi kimliği içerebilir ve bu nedenle getirilemez.
contentDetails.relatedPlaylists.uploads string
Kanalın yüklenen videolarını içeren oynatma listesinin kimliği. Yeni videolar yüklemek için videos.insert yöntemini, önceden yüklenen videoları silmek için ise videos.delete yöntemini kullanın.
statistics object
statistics nesnesi, kanala ilişkin istatistikleri içerir.
statistics.viewCount unsigned long
Kanalın görüntülenme sayısı.
statistics.commentCount unsigned long
Bu özelliğin desteği sonlandırıldı.

Kanaldaki yorum sayısı.
statistics.subscriberCount unsigned long
Kanalın abone sayısı. Bu değer üçe yuvarlanır önemli rakamlara ulaşabilirsiniz. Daha fazla bilgi için lütfen Düzeltme Geçmişi veya Daha fazla bilgi için YouTube Yardım Merkezi abone sayılarının nasıl yuvarlandığına ilişkin ayrıntılar.
statistics.hiddenSubscriberCount boolean
Kanalın abone sayısının herkese açık olup olmadığını belirtir.
statistics.videoCount unsigned long
Kanala yüklenen herkese açık videoların sayısı. Bu değerin, Search Ads 360'taki kanal sahipleri de dahil olmak üzere herkese açık videolarını izleyebilir. Bu davranış, sayılarla tutarlıdır YouTube web sitesinde gösterilebilir.
topicDetails object
topicDetails nesnesi, kanalla ilişkili konularla ilgili bilgileri içerir.

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

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

Önemli: Freebase ve Freebase API'nin kullanımdan kaldırılması nedeniyle, konu kimlikleri 27 Şubat 2017 itibarıyla farklı şekilde çalışmaya başladı. Bu dönemde YouTube, az sayıda seçilmiş konu kimliği yayınlamaya 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 içerir.
status.privacyStatus string
Kanalın gizlilik durumu.

Bu tesis için geçerli değerler:
  • private
  • public
  • unlisted
status.isLinked boolean
Kanal verilerinin, bir YouTube kullanıcı adına veya Google+ hesabına zaten bağlı bir kullanıcıyı tanımlayıp tanımlamadığını belirtir. Bu bağlantılardan birine sahip bir kullanıcının zaten herkese açık bir YouTube kimliği vardır. Bu, video yükleme gibi çeşitli işlemler için bir ön koşuldur.
status.longUploadsStatus string
Kanalın 15 dakikadan uzun videolar yüklemeye uygun olup olmadığını 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 tesis 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, yalnızca YouTube Topluluk Kuralları'na göre iyi durumdaysa ve dünya genelinde Content ID engellemesi bulunmuyorsa uzun video yükleyebilir.

    Kanal sahibi, kanalın daha uzun videolar yüklemesini engelleyen sorunları giderdikten sonra kanal allowed veya eligible durumuna geri döner.
  • eligible – Bu kanal 15 dakikadan uzun videolar yükleyebilir. Ancak önce kanal sahibinin daha uzun videolar yükleme özelliğini https://www.youtube.com/verify adresinde etkinleştirmesi gerekir. Bu özellik hakkında daha ayrıntılı 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 mevcut "çocuklara özel" kanal durumu. Örneğin, selfDeclaredMadeForKids özelliğinin değerine göre belirlenir. Bkz. Daha fazla bilgi için YouTube Yardım Merkezi kanalınız, videolarınız veya yayınlarınızın kitlesini ayarlamayla ilgili bilgiler.
status.selfDeclaredMadeForKids boolean
Bir channels.update isteğinde, Bu özellik, kanal sahibinin kanalı çocuklara yönelik olarak tanımlamasına olanak tanır. İlgili içeriği oluşturmak için kullanılan özellik değeri yalnızca kanal sahibi API isteğini yetkilendirdiyse döndürülür.
brandingSettings object
brandingSettings nesnesi, kanalın marka bilinci oluşturma işlemleriyle ilgili bilgileri içerir.
brandingSettings.channel object
channel nesnesi, kanal sayfasının marka bilinci oluşturma özelliklerini içerir.
brandingSettings.channel.title string
Kanalın başlığı. Başlık en fazla 30 karakter uzunluğunda olabilir.
brandingSettings.channel.description string
Kanal sayfanızdaki kanal bilgileri kutusunda görünen kanal açıklaması Tesisin değeri en fazla 1000 karakter uzunluğunda olabilir.
brandingSettings.channel.keywords string
Kanalınızla ilişkilendirilen anahtar kelimeler. Değer, boşlukla ayrılmış dize listesidir. Kanal anahtar kelimeler, izin verilen maksimum 500 karakterlik uzunluğu aşarsa kesilebilir veya ." 500 karakterlik limiti, anahtar kelime başına bir sınır değildir, bunun yerine tüm anahtar kelimelerin toplam uzunluğuna yönelik bir sınırdır.
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
Abone olmayan izleyiciler için kanal sayfasının göz atma görünümündeki öne çıkan video modülünde oynatılması gereken video. Abone olan izleyiciler, son kanal etkinliklerini öne çıkaran farklı bir video görebilir.

Belirtilirse mülkün değeri, kanal sahibine ait olan 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 ülkedir. snippet.country özelliğinin değerini ayarlamak için bu özelliği güncelleyin.
brandingSettings.watch object
Not: Bu nesne ve tüm alt özellikleri kullanımdan kaldırılmıştır.

watch nesnesi, kanalın videolarına ait izleme sayfalarının marka bilinci oluşturma özelliklerini içerir.
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ı. API, değerini ayarlamaya çalışırsanız bir hata döndürür.
brandingSettings.image object
Bu mülkün ve tüm alt mülklerinin desteği sonlandırılmıştır.

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

YouTube web sitesindeki kanal sayfasında gösterilen banner resminin URL'si. Resmin boyutu 1.060 x 175 pikseldir.
brandingSettings.image.bannerMobileImageUrl string
Bu özelliğin desteği sonlandırıldı.

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

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

Kanalın veya video sayfalarının görüntülemelerine ilişkin istatistikleri toplamak için kullanılabilen 1 x 1 piksel takip pikselinin URL'si.
brandingSettings.image.bannerTabletLowImageUrl string
Bu özelliğin desteği sonlandırıldı.

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

Tablet uygulamalarında kanal sayfasında görüntülenen banner resminin URL'si. Resmin boyutu 1.707 x 283 pikseldir.
brandingSettings.image.bannerTabletHdImageUrl string
Bu özelliğin desteği sonlandırıldı.

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

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

Mobil uygulamalarda kanal sayfasında gösterilen düşük çözünürlüklü banner resminin URL'si. Resmin maksimum boyutu 320 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 x 263 pikseldir.
brandingSettings.image.bannerMobileHdImageUrl string
Bu özelliğin desteği sonlandırıldı.

Mobil uygulamalarda kanal sayfasında gösterilen yüksek çözünürlüklü banner resminin URL'si. Resmin maksimum boyutu 1.280 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ü banner resminin URL'si. Resmin maksimum boyutu 1.440 x 395 pikseldir.
brandingSettings.image.bannerTvImageUrl string
Bu özelliğin desteği sonlandırıldı.

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

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

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

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

hints nesnesi, ek markalama özelliklerini içerir.
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 etmeye veya reddetmeye karar verirken değerlendireceği kanal verilerini içerir. Bu kaynak bölümünü alan 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, MCN kanalı kabul etmeye veya reddetmeye karar verdiğinde ya da jetonun verildiği tarihten itibaren iki hafta içinde bu kapsamı kullanan tüm jetonlar iptal edilmelidir.
auditDetails.overallGoodStanding boolean
Bu alan, kanalla ilgili herhangi bir sorun olup olmadığını gösterir. Şu anda bu alan communityGuidelinesGoodStanding, copyrightStrikesGoodStanding ve contentIdClaimsGoodStanding özellikleri genelinde mantıksal AND işleminin sonucunu temsil eder. Diğer bir deyişle, bu diğer tüm özellikler true değerine sahipse bu özellik, true değerine sahiptir. Ancak bu özelliklerden herhangi birinin false değerine sahip olması halinde bu özelliğin değeri false olur. Ancak, bu mülkün değerini belirlemek için kullanılan yöntemin değişebileceğini unutmayın.
auditDetails.communityGuidelinesGoodStanding boolean
Kanalın YouTube'un topluluk kurallarına uyup uymadığını belirtir.
auditDetails.copyrightStrikesGoodStanding boolean
Kanalın telif hakkı ihtarı olup olmadığını gösterir.
auditDetails.contentIdClaimsGoodStanding boolean
Kanalda çözüme ulaştırılmamış hak talebi olup olmadığını gösterir.
contentOwnerDetails object
contentOwnerDetails nesnesi, yalnızca kanalı İçerik Yöneticisi'ne bağlayan YouTube İş Ortağı'nın görebildiği kanal verilerini içerir.
contentOwnerDetails.contentOwner string
Kanala bağlı içerik sahibinin kimliğidir.
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 içerir.
localizations.(key) object
Anahtar değeriyle ilişkili yerelleştirilmiş meta verilerin dilidir. Değer, BCP-47 dil kodunu içeren bir dizedir.
localizations.(key).title string
Yerelleştirilmiş kanal başlığı.
localizations.(key).description string
Yerelleştirilmiş kanal açıklaması.