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ğı içeren bir koleksiyon döndürür. Hemen deneyin. - güncelleme
- Bir kanalın meta verilerini günceller. Bu yöntemin şu anda yalnızca
channelkaynağınınbrandingSettingsveinvideoPromotionnesneleri ile bunların 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 |
stringAPI kaynağının türünü tanımlar. Değer youtube#channel olacak. |
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 ayarlanacağı 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 resmin 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 resim 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ğendiği 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ılmıştır. 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ı. Bu nedenle, geçmişe dayalı nedenlerle bu özellik değeri, boş bir oynatma listesine referans veren ve bu nedenle getirilemeyen bir oynatma listesi kimliği içerebilir. |
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, daha önce yüklenen videoları silmek için videos.delete yöntemini kullanın. |
statistics |
objectstatistics nesnesi, kanalın istatistiklerini kapsar. |
statistics.viewCount |
unsigned longBir kanaldaki tüm biçimlerdeki tüm videoların görüntülenme sayısının toplamı. Bir kanaldaki tüm video formatlarında (uzun videolar, canlı yayınlar ve Shorts videoları) Bir kanaldaki tüm video formatları (uzun videolar, canlı yayınlar ve Shorts videoları) için |
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'ni veya YouTube Yardım Merkezi'ni inceleyin. |
statistics.videoCount |
unsigned longKanala yüklenen herkese açık video sayısı. Bu değerin, kanal sahipleri için bile yalnızca 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 |
objecttopicDetails nesnesi, kanalla ilişkili konular hakkındaki 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[] |
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 kullanımdan kaldırılması nedeniyle konu kimlikleri 27 Şubat 2017'den itibaren farklı şekilde çalışmaya başlamıştır. O dönemde YouTube, seçilmiş konu kimliklerinden oluşan küçük bir 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, bir YouTube kullanıcı adına veya Google+ hesabına zaten bağlı olan 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 |
stringKanalın 15 dakikadan uzun videolar yüklemeye uygun olup olmadığını gösterir. 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 özellik için geçerli değerler ş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'ne göz atın. |
status.selfDeclaredMadeForKids |
booleanchannels.update isteğinde,
bu özellik kanal sahibinin kanalı çocuklara yönelik olarak belirlemesine olanak tanır. Özellik değeri yalnızca kanal sahibi API isteğini yetkilendirdiyse döndürülür.
|
brandingSettings |
objectbrandingSettings nesnesi, kanalın marka öğeleriyle ilgili bilgileri kapsar. |
brandingSettings.channel |
objectchannel nesnesi, kanal sayfasının marka ö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 dize listesidir. Kanal anahtar kelimeleri, izin verilen maksimum 500 karakter sınırını aşarsa veya kaçış karakteri kullanılmamış tırnak işaretleri ( ") içeriyorsa kısaltılabilir. 500 karakterlik sınırı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ızın trafiğini 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 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ılmıştır. 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 bir 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 1060 piksel x 175 pikseldir. |
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, 25 piksel yüksekliğinde ve 170 pikseli aşamayacak esnek bir genişliğe sahip bir resimdir. Bu resmi sağlamazsanız resim yerine kanal adınız 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 1138 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 1707 piksel x 283 pikseldir. |
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ında 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 uygulamalardaki 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 1440 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 2120 x 1192 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 1280 x 720 pikseldir. |
brandingSettings.image.bannerTvHighImageUrl |
stringBu ö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 1920 x 1080 pikseldir. |
brandingSettings.image.bannerExternalUrl |
stringBu özellik, YouTube'un bir kanal için çeşitli banner resmi boyutları oluşturmak amacıyla kullandığı banner resminin konumunu belirtir. |
brandingSettings.hints[] |
listBu mülk ve tüm alt mülkleri kullanımdan kaldı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 edip etmeyeceğini belirlerken değerlendireceği kanal verilerini kapsar. Bu kaynak parçası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 |
booleanBu alan, kanalla ilgili herhangi bir sorun olup olmadığını gösterir. Şu anda bu alan, communityGuidelinesGoodStanding, copyrightStrikesGoodStanding ve contentIdClaimsGoodStanding özellikleri üzerinde mantıksal AND işleminin sonucunu temsil eder. Yani bu özellik, diğer tüm özelliklerin de true değerine sahip olması durumunda true değerine sahiptir. 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 İş 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ğerle 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ı. |