channel ve video kaynakları, artık ilgili kanalın veya videonun "çocuklara özel" durumunu tanımlayan bir özellik de içeriyor. 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 kaynağı, bir 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
channelkaynağın koleksiyonunu döndürür. Hemen deneyin. - update
- Bir kanalın meta verilerini günceller. Bu yöntemin şu anda yalnızca
channelkaynağınınbrandingSettingsveinvideoPromotionnesnelerinde ve bunların alt özelliklerinde yapılan 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 |
stringAPI kaynağının türünü tanımlar. Değer youtube#channel olur. |
etag |
etagBu kaynağın Etag'i. |
id |
stringYouTube'un kanalı benzersiz şekilde tanımlamak için kullandığı kimlik. |
snippet |
objectsnippet nesnesi, kanalla ilgili başlık, açıklama ve küçük resimler gibi temel bilgileri içerir. |
snippet.title |
stringKanalın başlığı. |
snippet.description |
stringKanalın açıklaması. Özelliğin değeri en fazla 1.000 karakter uzunluğunda olabilir. |
snippet.customUrl |
stringKanalın özel URL'si. YouTube Yardım Merkezi'nde, özel URL alma uygunluk koşulları ve URL'nin nasıl oluşturulacağı açıklanmaktadır. |
snippet.publishedAt |
datetimeKanalın oluşturulduğu tarih ve saat. Değer, ISO 8601 biçiminde belirtilir. |
snippet.thumbnails |
objectKanalla ilişkili küçük resimlerin haritası. Haritadaki her nesne için anahtar, küçük resim görüntüsünün adıdır ve değer, küçük resimle ilgili diğer bilgileri içeren bir nesnedir. Uygulamanızda küçük resimleri gösterirken 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, YouTube resimlerini http alanından 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) |
objectGeçerli anahtar değerleri:
|
snippet.thumbnails.(key).url |
stringResmin 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 integerResmin genişliği. |
snippet.thumbnails.(key).height |
unsigned integerResmin yüksekliği. |
snippet.defaultLanguage |
stringchannel kaynağının snippet.title ve snippet.description özelliklerindeki metnin dili. |
snippet.localized |
objectsnippet.localized nesnesi, kanal için yerelleştirilmiş bir başlık ve açıklama içerir veya kanalın meta verileri için varsayılan dilde kanalın başlığını ve açıklamasını içerir.
localizations nesnesini kullanın. |
snippet.localized.title |
stringYerelleştirilmiş kanal başlığı. |
snippet.localized.description |
stringYerelleştirilmiş kanal açıklaması. |
snippet.country |
stringKanalın ilişkili olduğu ülke. Bu özelliğin değerini ayarlamak için brandingSettings.channel.country özelliğinin değerini güncelleyin. |
contentDetails |
objectcontentDetails nesnesi, kanalın içeriğiyle ilgili bilgileri kapsar. |
contentDetails.relatedPlaylists |
objectrelatedPlaylists nesnesi, kanalla ilişkili oynatma listelerini (ör. kanalın yüklenen videoları veya beğenilen videoları) tanımlayan bir haritadır. playlists.list yöntemini kullanarak bu oynatma listelerinden herhangi birini alabilirsiniz. |
contentDetails.relatedPlaylists.likes |
stringKanalı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 |
stringBu özellik kullanımdan kaldırıldı. Kanalın favori videolarını 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.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şteki nedenlerden dolayı bu özellik değeri boş bir oynatma listesine atıfta bulunan bir oynatma listesi kimliği içerebilir ve bu nedenle getirilemez. |
contentDetails.relatedPlaylists.uploads |
stringKanalın yüklenen videolarını içeren oynatma listesinin kimliği. Yeni videoları yüklemek için videos.insert yöntemini, önceden yüklenmiş videoları silmek için ise videos.delete yöntemini kullanın. |
statistics |
objectstatistics nesnesi, kanalın istatistiklerini kapsar. |
statistics.viewCount |
unsigned longBir kanalda tüm biçimlerdeki tüm videoların görüntülenme sayılarının toplamı. 24 Ağustos 2026'dan itibaren, bir kanaldaki tüm video formatlarında (uzun videolar, canlı yayınlar ve Shorts videoları) |
statistics.commentCount |
unsigned longBu özelliğin desteği sonlandırıldı. Kanalın yorum sayısı. |
statistics.subscriberCount |
unsigned longKanalı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.videoCount |
unsigned longKanala yüklenen herkese açık video sayısı. Bu değerin, kanal sahipleri için bile yalnızca kanaldaki herkese açık videoların sayısını yansıttığını unutmayın. Bu davranış, YouTube web sitesinde gösterilen sayılarla tutarlıdır. |
topicDetails |
objecttopicDetails nesnesi, kanalla ilişkili konular hakkında bilgi içerir.Önemli: Konu kimlikleriyle ilgili değişiklikler hakkında daha fazla bilgi için topicDetails.topicIds[] mülk tanımını ve düzeltme geçmişini inceleyin. |
topicDetails.topicIds[] |
listKanalla ilişkili konu kimliklerinin listesi. Bu özellik, 10 Kasım 2016 itibarıyla kullanımdan kaldırılmıştır. 10 Kasım 2017'ye kadar desteklenecektir. Önemli: Freebase ve Freebase API'nin desteği sonlandırıldığından konu kimlikleri 27 Şubat 2017'den itibaren farklı şekilde çalışmaya başlamıştır. O dönemde YouTube, seçilmiş küçük bir konu kimliği grubu döndürmeye başladı. |
topicDetails.topicCategories[] |
listKanalın içeriğini açıklayan Wikipedia URL'lerinin listesi. |
status |
objectstatus nesnesi, kanalın gizlilik durumuyla ilgili bilgileri kapsar. |
status.privacyStatus |
stringKanalın gizlilik durumu. Bu özellik için geçerli değerler şunlardır:
|
status.isLinked |
booleanKanal verilerinin, YouTube kullanıcı adına veya Google+ hesabına zaten bağlı olan bir kullanıcıyı tanımlayıp tanımlamadığını gösterir. 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 |
stringKanalın 15 dakikadan uzun videolar yüklemeye uygun olup olmadığını gösterir. Bu özellik yalnızca kanal sahibi API isteğine yetki verdiyse döndürülür. Bu özellik hakkında daha fazla bilgi için YouTube Yardım Merkezi'ne bakın. Bu özelliğin geçerli değerleri şunlardır:
|
status.madeForKids |
booleanBu 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, videolarınız veya yayınlarınız için kitleyi ayarlama hakkında daha fazla bilgi edinmek istiyorsanız YouTube Yardım Merkezi'ni ziyaret edin . |
status.selfDeclaredMadeForKids |
booleanBu özellik, channels.update isteğinde kanal sahibinin kanalı çocuklara yönelik olarak belirlemesine olanak tanır. Özellik değeri yalnızca kanal sahibi API isteğine yetki verdiyse döndürülür.
|
brandingSettings |
objectbrandingSettings nesnesi, kanalın markasıyla ilgili bilgileri kapsar. |
brandingSettings.channel |
objectchannel nesnesi, kanal sayfasının markalama özelliklerini kapsar. |
brandingSettings.channel.title |
stringKanalın başlığı. Başlık en fazla 30 karakter uzunluğunda olabilir. |
brandingSettings.channel.description |
stringKanal sayfanızdaki kanal bilgileri kutusunda görünen kanal açıklaması. Özelliğin değeri en fazla 1.000 karakter uzunluğunda olabilir. |
brandingSettings.channel.keywords |
stringKanalınızla ilişkili anahtar kelimeler. Değer, boşlukla ayrılmış bir dizeler listesidir. Kanal anahtar kelimeleri, izin verilen maksimum uzunluk olan 500 karakteri aşarsa veya kaçış karakteri uygulanmamış tırnak işaretleri ( ") içeriyorsa kısaltılabilir. 500 karakter sınırının, anahtar kelime başına değil, tüm anahtar kelimelerin toplam uzunluğu için geçerli olduğunu unutmayın. |
brandingSettings.channel.trackingAnalyticsAccountId |
stringKanalınıza gelen trafiği izlemek ve ölçmek için kullanmak istediğiniz Google Analytics hesabının kimliği. |
brandingSettings.channel.unsubscribedTrailer |
stringAbone 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, daha yeni kanal etkinliklerini öne çıkaran farklı bir video görebilir. Belirtilmişse özelliğin değeri, kanal sahibine ait olan herkese açık veya liste dışı bir videonun YouTube video kimliği olmalıdır. |
brandingSettings.channel.defaultLanguage |
stringchannel kaynağının snippet.title ve snippet.description özelliklerindeki metnin dili. |
brandingSettings.channel.country |
stringKanalın ilişkili olduğu ülke. snippet.country özelliğinin değerini ayarlamak için bu özelliği güncelleyin. |
brandingSettings.watch |
objectNot: Bu nesnenin ve tüm alt mülklerinin desteği sonlandırıldı. watch nesnesi, kanal videolarının izleme sayfalarının marka özelliklerini kapsar. |
brandingSettings.watch.textColor |
stringNot: Bu özelliğin desteği sonlandırıldı. Video izleme sayfasının markalı alanının metin rengi. |
brandingSettings.watch.backgroundColor |
stringNot: Bu özelliğin desteği sonlandırıldı. Video izleme sayfasının markalı alanının arka plan rengi. |
brandingSettings.watch.featuredPlaylistId |
stringNot: Bu özelliğin desteği sonlandırıldı. Değerini ayarlamaya çalışırsanız API hata döndürür. |
brandingSettings.image |
objectBu mülk ve tüm alt mülkleri kullanımdan kaldırıldı. image nesnesi, kanalın kanal sayfasında veya video izleme sayfalarında gösterilen resimlerle ilgili bilgileri kapsar. |
brandingSettings.image.bannerImageUrl |
stringBu özelliğin desteği sonlandırıldı. YouTube web sitesindeki kanal sayfasında gösterilen banner resminin URL'si. Resim 1.060 piksel x 175 piksel boyutundadır. |
brandingSettings.image.bannerMobileImageUrl |
stringBu özelliğin desteği sonlandırıldı. Mobil uygulamalarda kanal sayfasında gösterilen banner resminin URL'si. Resim 640 x 175 pikseldir. |
brandingSettings.image.watchIconImageUrl |
stringBu özelliğin desteği sonlandırıldı. Video oynatıcının üzerinde görünen resmin URL'si. Bu, 170 pikseli geçemeyen esnek genişliğe sahip 25 piksellik bir resimdir. Bu resmi sağlamazsanız resim yerine kanalınızın adı gösterilir. |
brandingSettings.image.trackingImageUrl |
stringBu özelliğin desteği sonlandırıldı. Kanal veya video sayfalarının görüntüleme istatistiklerini toplamak için kullanılabilecek 1 piksele 1 piksellik izleme pikselinin URL'si. |
brandingSettings.image.bannerTabletLowImageUrl |
stringBu ö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 |
stringBu ö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 |
stringBu ö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 2276 x 377 pikseldir. |
brandingSettings.image.bannerTabletExtraHdImageUrl |
stringBu özelliğin desteği sonlandırıldı. Tablet uygulamalarındaki kanal sayfasında gösterilen ekstra yüksek çözünürlüklü banner resminin URL'si. Resmin maksimum boyutu 2560 x 424 pikseldir. |
brandingSettings.image.bannerMobileLowImageUrl |
stringBu ö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 |
stringBu özelliğin desteği sonlandırıldı. Mobil uygulamalardaki kanal sayfasında gösterilen orta çözünürlüklü banner resminin URL'si. Resmin maksimum boyutu 960 x 263 pikseldir. |
brandingSettings.image.bannerMobileHdImageUrl |
stringBu ö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 1280 x 360 pikseldir. |
brandingSettings.image.bannerMobileExtraHdImageUrl |
stringBu özelliğin desteği sonlandırıldı. Mobil uygulamalardaki kanal sayfasında gösterilen çok yüksek çözünürlüklü banner resminin URL'si. Resmin maksimum boyutu 1.440 piksel x 395 pikseldir. |
brandingSettings.image.bannerTvImageUrl |
stringBu ö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 x 1.192 pikseldir. |
brandingSettings.image.bannerTvLowImageUrl |
stringBu ö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 x 480 pikseldir. |
brandingSettings.image.bannerTvMediumImageUrl |
stringBu ö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 x 720 pikseldir. |
brandingSettings.image.bannerTvHighImageUrl |
stringBu özelliğin desteği sonlandırıldı. Televizyon uygulamalarında kanal sayfasında gösterilen yüksek çözünürlüklü banner resminin URL'si. Resmin maksimum boyutu 1.920 x 1.080 pikseldir. |
brandingSettings.image.bannerExternalUrl |
stringBu özellik, YouTube'un bir kanal için çeşitli banner resmi boyutlarını oluşturmak üzere kullandığı banner resminin konumunu belirtir. |
brandingSettings.hints[] |
listBu mülkün ve tüm alt mülklerinin desteği sonlandırıldı. hints nesnesi, ek marka özelliklerini kapsar. |
brandingSettings.hints[].property |
stringBu özelliğin desteği sonlandırıldı. Bir mülk. |
brandingSettings.hints[].value |
stringBu özelliğin desteği sonlandırıldı. Özelliğin değeri. |
auditDetails |
objectauditDetails nesnesi, çok kanallı ağın (MCN) belirli bir kanalı kabul veya reddetme 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'nin kanalı kabul etmeye veya reddetmeye karar verdiği anda ya da jetonun verildiği tarihten itibaren iki hafta içinde iptal edilmelidir. |
auditDetails.overallGoodStanding |
booleanBu alan, kanalla ilgili herhangi bir sorun olup olmadığını gösterir. Şu anda bu alan, communityGuidelinesGoodStanding, copyrightStrikesGoodStanding ve contentIdClaimsGoodStanding özellikleri üzerindeki mantıksal AND işleminin sonucunu temsil eder. Yani diğer tüm özelliklerin değeri true ise bu özelliğin değeri de true olur. Ancak bu özelliklerden herhangi birinin değeri false ise bu özelliğin değeri false olur. Ancak bu özelliğin değerini ayarlamak için kullanılan metodolojinin değişebileceğini unutmayın. |
auditDetails.communityGuidelinesGoodStanding |
booleanKanalın YouTube Topluluk Kuralları'na uyup uymadığını gösterir. |
auditDetails.copyrightStrikesGoodStanding |
booleanKanalın telif hakkı ihtarı alıp almadığını gösterir. |
auditDetails.contentIdClaimsGoodStanding |
booleanKanalda çözümlenmemiş hak talebi olup olmadığını gösterir. |
contentOwnerDetails |
objectcontentOwnerDetails nesnesi, yalnızca kanalı İçerik Yöneticisi'ne bağlayan YouTube iş ortağı tarafından görülebilen kanal verilerini kapsar. |
contentOwnerDetails.contentOwner |
stringKanala bağlı içerik sahibinin kimliği. |
contentOwnerDetails.timeLinked |
datetimeKanalın içerik sahibine bağlandığı tarih ve saat. Değer, ISO 8601 biçiminde belirtilir. |
localizations |
objectlocalizations nesnesi, kanalın meta verilerinin çevirilerini kapsar. |
localizations.(key) |
objectAnahtar değeriyle ilişkili yerelleştirilmiş meta verilerin dili. Değer, BCP-47 dil kodu içeren bir dizedir. |
localizations.(key).title |
stringYerelleştirilmiş kanal başlığı. |
localizations.(key).description |
stringYerelleştirilmiş kanal açıklaması. |