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ınbrandingSettings
veinvideoPromotion
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:
|
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.
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.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:
|
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:
|
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ı. |