İnceleme Geçmişi

Bu sayfada, YouTube Data API (v3) değişiklikleri ve doküman güncellemeleri listelenmektedir. Bu değişiklik günlüğüne abone olun.

10 Temmuz 2025

21 Temmuz 2025'ten itibaren YouTube, video.list yönteminin mostPopular grafiği tarafından döndürülen içeriği ayarlayacak. Geçmişte mostPopular grafiğinde, Trendler listesinde öne çıkarılan videolar gösteriliyordu. Artık mostPopular listesinde Trendler Müzik, Trendler Filmler ve Trendler Oyun listelerindeki videolar yer alacak. Bu API değişikliği, YouTube'un Trendler sayfası desteğinin sonlandırılmasıyla birlikte yapılmıştır.

26 Mart 2025

YouTube, 31 Mart 2025'ten itibaren Shorts görüntülemelerinin sayılma şeklini değiştirecek. Geçmişte Shorts videolarında, videoların belirli bir süre oynatılması görüntüleme olarak sayılıyordu. Artık görüntüleme sayısı, Shorts videonuzun oynatılmaya veya tekrar oynatılmaya başlama sayısını ifade edecek. Minimum izlenme süresi şartı olmayacak. Daha fazla bilgi

31 Mart 2025'ten itibaren, Data API'deki aşağıdaki alanlar Shorts görüntüleme sayısını bu değişikliğe göre döndürecek:

• channels.statistics.viewCount
• videos.statistics.viewCount

30 Ekim 2024

API artık gerçekçi değiştirilmiş veya yapay (A/S) içerik barındıran videoları tanımlama özelliğini destekliyor. YouTube'un A/S içerikleriyle ilgili politikaları hakkında daha fazla bilgi edinin.

A/S içeriklerine örnek olarak şunlar verilebilir:

• Gerçek bir insanı, söylemediği veya yapmadığı bir şeyi söylemiş ya da yapmış gibi gösterme
• Gerçek bir olayın veya yerin kamera görüntülerini değiştirme
• Gerçekte meydana gelmese de gerçekçi görünen bir sahne oluşturma

Bir videonun A/S içeriği barındırıp barındırmadığını belirtmek için status.containsSyntheticMedia özelliğini ayarlayın. Bu özellik, videos.insert veya videos.update yöntemleri çağrılırken ayarlanabilir. Ayarlanırsa özellik, video kaynağında döndürülür.

30 Nisan 2024

Not: Bu, desteği sonlandırma duyurusudur.

Bu güncelleme aşağıdaki değişiklikleri içerir:

API artık kanal tartışmalarını ekleme veya alma özelliğini desteklemiyor. Bu değişiklik, YouTube web sitesinde desteklenen işlevle tutarlıdır. YouTube web sitesinde kanallara yorum gönderme özelliği desteklenmez.

13 Mart 2024

Not: Bu, desteği sonlandırma duyurusudur.

Bu güncelleme aşağıdaki değişiklikleri içerir:

captions.insert ve captions.update yöntemleri için sync parametresi kullanımdan kaldırıldı. YouTube, 12 Nisan 2024'ten itibaren parametresini desteklemeyi bırakacak.

Bu değişiklik sonucunda, geliştiricilerin altyazı parçalarını eklerken veya güncellerken zamanlama bilgilerini eklemesi gerekir. Aksi takdirde yükleme işlemi başarısız olur.

12 Mart 2024

Bu güncelleme aşağıdaki değişiklikleri içerir:

captions kaynağıyla ilgili dokümanlar, snippet.name alanı için izin verilen maksimum uzunluğun 150 karakter olduğunu belirtecek şekilde güncellendi. Parça adı bundan uzunsa API nameTooLong hatası döndürür.

7 Mart 2024

Not: Bu, desteği sonlandırma duyurusudur.

channel kaynak özelliği brandingSettings.channel.moderateComments kullanımdan kaldırıldı. YouTube, parametre desteğini 7 Mart 2024'ten itibaren sonlandıracak.

31 Ocak 2024

Bu güncelleme aşağıdaki değişiklikleri içerir:

channels.list yönteminin yeni forHandle parametresi, YouTube herkese açık kullanıcı adını belirterek bir kanal hakkında bilgi almanızı sağlar.

9 Kasım 2023

videoId kaynağı bir API çağrısıyla döndürülmediğinden Comments altındaki videoId kaynağına yapılan tüm referanslar kaldırıldı.

12 Eylül 2023

Not: Bu, desteği sonlandırma duyurusudur.

comments.markAsSpam yöntemi birkaç yıldır kullanımdan kaldırılmıştır. Bu yöntem YouTube'da zaten desteklenmiyor ve artık API üzerinden de desteklenmiyor.

comments.markAsSpam yöntemine referans veren tüm dokümanlara desteğin sonlandırılmasıyla ilgili bir uyarı eklendi.

22 Ağustos 2023

search.list yöntemi artık videoPaidProductPlacement parametresini destekliyor. Bu parametre, arama sonuçlarını yalnızca içerik üreticinin ücretli tanıtım içerdiğini belirttiği videoları içerecek şekilde filtrelemenizi sağlar.

18 Ağustos 2023

video kaynağının liveStreamingDetails.concurrentViewers tanımı, YouTube Data API'nin döndürdüğü eşzamanlı izleyici sayılarının, YouTube Analytics'te bulunan işlenmiş ve spam'den arındırılmış eşzamanlı izleyici sayılarından farklı olabileceğini belirtecek şekilde güncellendi. Canlı yayın metrikleri hakkında daha fazla bilgiyi YouTube Yardım Merkezi'nde bulabilirsiniz.

7 Ağustos 2023

12 Haziran 2023'te duyurulduğu gibi, search.list yönteminin relatedToVideoId parametresinin desteği sonlandırıldı. Bu parametre artık desteklenmiyor ve parametreye yapılan referanslar API belgelerinden kaldırıldı.

28 Haziran 2023

thumbnails.set yöntemi artık uploadRateLimitExceeded hatasını destekliyor. Bu hata, kanalın son 24 saat içinde çok fazla küçük resim yüklediğini ve daha sonra tekrar denemesi gerektiğini belirtir.

12 Haziran 2023

Not: Bu, desteği sonlandırma duyurusudur.

search.list yönteminin relatedToVideoId parametresi kullanımdan kaldırıldı. YouTube, 7 Ağustos 2023'ten itibaren parametresini desteklemeyi durduracak.

Şu anda search.list yönteminin dokümanlarına desteğin sonlandırılmasıyla ilgili bir uyarı eklendi. Bu parametre, 7 Ağustos 2023'te veya bu tarihten sonra search.list dokümanlarından tamamen kaldırılacaktır.

Ayrıca, ilgili videoların nasıl alınacağını gösteren bir örnek API uygulama kılavuzundan kaldırıldı.

22 Ağustos 2022

video.statistics alanları için düzeltilmiş tür açıklamaları, işaretsiz uzun tamsayıdan dizeye dönüştürüldü.

5 Ağustos 2022

YouTube, altyazı kimliklerinin oluşturulma şeklini değiştirdi ve bu değişikliğin bir parçası olarak tüm altyazı parçalarına yeni altyazı kimlikleri atıyor. Bu değişiklik, caption_id değerlerini depolayan uygulamalar için geriye dönük uyumsuz bir değişiklik olabilir ancak caption_id değerlerini depolamayan uygulamaları etkilemez.

Şu andan 1 Aralık 2022'ye kadar captions.list, captions.update, captions.download ve captions.delete yöntemleri hem eski hem de yeni altyazı parçası kimliklerini destekleyecek. Ancak 1 Aralık 2022'den itibaren YouTube, eski altyazı parçası kimliklerini desteklemeyi bırakacak. Bu tarihten itibaren, eski bir altyazı parçası kimliğiyle bu API yöntemlerinden herhangi birinin çağrılması captionNotFound hatasıyla sonuçlanacaktır.

Bu değişikliğe hazırlanmak için, şu andan 1 Aralık 2022'ye kadar saklanan tüm altyazı parçası verilerini tamamen değiştirmeyi planlamanız gerekir. Bu nedenle, altyazı parçası verilerini depoladığınız tüm videolar için şu anda depolanan verileri silmeniz, ardından videonun mevcut altyazı parçaları grubunu almak üzere captions.list yöntemini çağırmanız ve verileri normalde yaptığınız gibi API yanıtında depolamanız gerekir.

12 Temmuz 2022

YouTube API Hizmetleri Hizmet Şartları güncellendi. Daha fazla bilgi için lütfen YouTube API Hizmetleri Hizmet Şartları - Revizyon Geçmişi'ni inceleyin.

27 Nisan 2022

videos.insert yöntemi açıklamasında, yüklenen videoların maksimum dosya boyutunun 128 GB'tan 256 GB'a yükseldiği belirtildi.

8 Nisan 2022

subscriptions.list yönteminin myRecentSubscribers ve mySubscribers parametre tanımları, API tarafından döndürülen maksimum abone sayısının sınırlı olabileceğini belirtecek şekilde güncellendi. Bu değişiklik, API davranışında değil dokümanda yapılan bir düzeltmeyi ifade eder.

15 Aralık 2021

18 Kasım 2021'de duyurulduğu üzere, video beğenmeme sayılarının YouTube platformunun tamamında gizli hale getirilmesiyle ilgili değişiklikler kapsamında video kaynağının statistics.dislikeCount özelliği artık gizli.

Bu değişiklik hakkında daha fazla bilgiyi YouTube'un resmi blogunda bulabilirsiniz.

18 Kasım 2021

YouTube platformunun tamamında video beğenilmeme sayılarının gizli hale getirilmesiyle ilgili değişiklikler kapsamında, video kaynağının statistics.dislikeCount özelliği 13 Aralık 2021'den itibaren gizli hale getirilecek. Bu, özelliğin yalnızca API isteği video sahibi tarafından kimliği doğrulanmışsa videos.list uç noktasından gelen bir API yanıtına dahil edileceği anlamına gelir.

videos.rate uç noktası bu değişiklikten etkilenmez.

Beğenmeme sayılarını herkese açık olarak göstermeyen ve API istemcileri için beğenmeme sayısına ihtiyaç duyan geliştiriciler, muafiyet için izin verilenler listesine eklenmek üzere başvurabilir. Muafiyet için başvurmak istiyorsanız bu başvuru formunu doldurmanız gerekir.

Bu değişiklik hakkında daha fazla bilgiyi YouTube'un resmi blogunda bulabilirsiniz.

2 Temmuz 2021

Not: Bu, desteği sonlandırma duyurusudur.

commentThreads.update uç noktası kullanımdan kaldırıldı ve artık desteklenmiyor. Bu uç nokta, diğer API uç noktaları üzerinden kullanılabilen işlevleri kopyaladı. Bunun yerine comments.update

yöntemini kullanın ve kodunuz commentThreads kaynağı gerektiriyorsa commentThreads yöntemine ikincil bir çağrı yapın.commentThreads.list

1 Temmuz 2021

YouTube'un API Hizmetleri'ni kullanan tüm geliştiricilerin,10.000 birimlik varsayılan kota tahsisinden daha fazlasını alabilmek için API Uygunluk Denetimi'ni tamamlaması gerekir. Bugüne kadar hem uygunluk denetimi süreci hem de ek kota birimi tahsisi istekleri, geliştiricilerin YouTube API Hizmetleri - Denetim ve Kota Artırma Formu'nu doldurup göndermesiyle gerçekleştirildi.

Bu süreçleri netleştirmek ve API Hizmetlerimizi kullanan geliştiricilerin ihtiyaçlarını daha iyi karşılamak için üç yeni form ve bu formların nasıl doldurulacağına dair bir kılavuz ekliyoruz:

• Denetlenmiş Geliştirici İstekleri Formu: API Uygunluk Denetimi'ni başarıyla tamamlamış olan geliştiriciler, ayrılan kota artırımı isteğinde bulunmak için bu kısa formu doldurup gönderebilirler.
• İtiraz Formu: API projeleri uygunluk denetimini geçemeyen (veya kota birimi artışı reddedilen) geliştiriciler bu formu doldurup gönderebilir.
• Yönetim değişikliği formu: Bir API projesiyle ilişkili olarak yönetim değişikliği (ör. hisse alımı veya satışı, birleşme veya diğer kurumsal işlemler aracılığıyla) yaşayan geliştiriciler ya da bir geliştirici adına API istemcisi işleten taraflar bu formu doldurup göndermelidir. Bu sayede YouTube'un API ekibi kayıtlarımızı güncelleyebilir, yeni API projesinin kullanım alanı uygunluğunu denetleyebilir ve geliştiricinin mevcut kota tahsisini doğrulayabilir.

Her yeni form, YouTube'un API'sinin kullanım amacınız hakkında bizi bilgilendirir ve size daha iyi yardımcı olmamızı sağlar.

Daha fazla ayrıntıyı yeni API Uygunluk Denetimleri kılavuzumuzda bulabilirsiniz.

12 Mayıs 2021

Not: Bu, desteği sonlandırma duyurusudur.

Bu güncelleme aşağıdaki API değişikliklerini kapsar:

• channel kaynağının contentDetails.relatedPlaylists.favorites özelliği kullanımdan kaldırıldı. Favori videolar işlevinin, 28 Nisan 2016 tarihli revizyon geçmişi girişinde belirtildiği gibi birkaç yıl önce desteği sonlandırılmıştı.

  Bu güncellemeden önce, bir API istemcisi mevcut olmayan bir favori oynatma listesine video eklemeye çalıştığında API yine de yeni bir oynatma listesi oluşturuyordu. Bundan sonra, bu durumda oynatma listesi oluşturulmayacak ve API hata döndürecek. Öğeleri ekleyerek, değiştirerek veya silerek favori oynatma listelerini değiştirme girişimleri de daha önceki duyurular uyarınca kullanımdan kaldırıldı ve herhangi bir zamanda hata döndürmeye başlayabilir.

• Aşağıdaki channel kaynak özelliklerinin desteği sonlandırıldı. Bu özellikler, YouTube Studio kullanıcı arayüzünde ve YouTube'da zaten desteklenmiyor. Bu nedenle, API üzerinden de artık desteklenmiyorlar.

  • brandingSettings.channel.defaultTab
  • brandingSettings.channel.featuredChannelsTitle
  • brandingSettings.channel.featuredChannelsUrls[]
  • brandingSettings.channel.profileColor
  • brandingSettings.channel.showBrowseView
  • brandingSettings.channel.showRelatedChannels

  Tüm özellikler channel kaynak gösteriminden kaldırıldı ve tanımları kaynağın özellik listesinden kaldırıldı. Ayrıca, bu özelliklerle ilişkili hatalar yönteme özel dokümanlardan kaldırıldı.

• Aşağıdaki channelSection kaynak özelliklerinin desteği sonlandırıldı. Bu özellikler, YouTube Studio kullanıcı arayüzünde ve YouTube'da zaten desteklenmiyor. Bu nedenle, API üzerinden de artık desteklenmiyorlar.

  • snippet.style
  • snippet.defaultLanguage
  • snippet.localized.title
  • localizations
  • localizations.(key)
  • localizations.(key).title
  • targeting
  • targeting.languages[]
  • targeting.regions[]
  • targeting.countries[]

  Bu değişikliğin yanı sıra, desteklediği özellikler desteklenmediğinden channelSection.list yönteminin hl parametresinin de desteği sonlandırıldı.

  Tüm özellikler channelSection kaynak gösteriminden kaldırıldı ve tanımları kaynağın özellik listesinden kaldırıldı. Ayrıca, bu özelliklerle ilişkili hatalar yönteme özel dokümanlardan kaldırıldı.

• channelSection kaynağının snippet.type özelliği için aşağıdaki değerlerin desteği sonlandırıldı. Bu değerler YouTube kanal sayfalarında zaten desteklenmiyordu ve bu nedenle API üzerinden de artık desteklenmiyor.

  • likedPlaylists
  • likes
  • postedPlaylists
  • postedVideos
  • recentActivity
  • recentPosts

• playlist kaynağının snippet.tags[] özelliğinin desteği sonlandırıldı. Bu özellik YouTube'da zaten desteklenmiyor ve bu nedenle artık API üzerinden de desteklenmiyor.

9 Şubat 2021

playlistItem kaynağı iki yeni özelliği destekler:

• snippet.videoOwnerChannelId özelliği, oynatma listesi videosunu yükleyen kanalın kimliğini tanımlar.
• snippet.videoOwnerChannelTitle özelliği, oynatma listesi videosunu yükleyen kanalın adını tanımlar.

28 Ocak 2021

Bu güncelleme aşağıdaki değişiklikleri içerir:

• playlistItems.delete, playlistItems.insert, playlistItems.list, playlistItems.update, playlists.delete, playlists.list ve playlists.update yöntemlerinin tümü yeni bir playlistOperationUnsupported hatasını destekler. Bu hata, bir istek belirli bir oynatma listesi için izin verilmeyen bir işlemi gerçekleştirmeye çalıştığında oluşur. Örneğin, kullanıcılar yüklenen videolar oynatma listesinden video silemez veya oynatma listesini silemez.

  Bu hata her durumda 400 HTTP yanıt kodunu (Bad Request) döndürür.

• playlistItems.list yönteminin watchHistoryNotAccessible ve watchLaterNotAccessible hataları dokümanlardan kaldırıldı. Kullanıcıların izleme geçmişi ve daha sonra izle listelerine API üzerinden erişilemese de bu hatalar API tarafından döndürülmez.

15 Ekim 2020

Geliştirici Politikaları'na iki yeni bölüm eklendi:

• Yeni Bölüm III.E.4.i, YouTube yerleştirilmiş oynatıcısı aracılığıyla toplanan ve gönderilen veriler hakkında ek bilgiler sağlar. Kullanıcı, oynatma amacını belirtmek için oynatıcıyla etkileşime girmeden önce herhangi bir YouTube yerleştirilmiş oynatıcısı aracılığıyla bize gönderdiğiniz tüm kullanıcı verilerinden siz sorumlusunuz. Otomatik oynatma özelliğini devre dışı bırakarak, kullanıcı oynatıcıyla etkileşime girmeden önce YouTube ile paylaşılan verileri sınırlayabilirsiniz.
• Yeni Bölüm III.E.4.j, içerikleri sitelerinize ve uygulamalarınıza yerleştirmeden önce çocuklara özel (MFK) durumunu kontrol etmeyle ilgilidir. API istemcinize yerleştirdiğiniz videoların ne zaman çocuklara özel olduğunu bilmek ve yerleştirilmiş oynatıcıdan toplanan verileri buna göre işlemek sizin sorumluluğunuzdadır. Bu nedenle, YouTube Data API Hizmeti'ni kullanarak içeriğin durumunu kontrol etmeniz ve ardından YouTube yerleşik oynatıcıları aracılığıyla API istemcinize yerleştirmeniz gerekir.

Yeni Finding the MadeForKids status of a video (Bir videonun "Çocuklara Özel" durumunu bulma) rehberinde, YouTube Data API Hizmeti'ni kullanarak bir videonun "Çocuklara Özel" durumunu nasıl arayacağınız açıklanmaktadır.

Bu değişikliklerle birlikte, yerleştirilmiş oynatıcı parametreleri dokümanına bir hatırlatma eklendi. Bu hatırlatmada, otomatik oynatmayı etkinleştirirseniz oynatmanın, kullanıcı oynatıcıyla etkileşimde bulunmadan gerçekleşeceği; oynatma verilerinin toplanması ve paylaşılmasının bu nedenle sayfa yüklendiğinde gerçekleşeceği açıklanıyor.

8 Ekim 2020

Bu güncelleme, channel kaynağıyla ilgili üç küçük değişikliği kapsar:

• Bir kanalın küçük resimlerini tanımlayan snippet.thumbnails nesnesi, yeni oluşturulan kanallar için boş olabilir ve doldurulması bir günü bulabilir.
• statistics.videoCount özelliği, kanal sahipleri için bile yalnızca kanalın herkese açık videolarının sayısını gösterir. Bu davranış, YouTube web sitesinde gösterilen sayımlarla tutarlıdır.
• brandingSettings.channel.keywords özelliğinde tanımlanan kanal anahtar kelimeleri, izin verilen maksimum uzunluk olan 500 karakteri aşarsa veya kaçış karakteri kullanılmamış 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. Bu davranış, YouTube web sitesindeki davranışla tutarlıdır.

9 Eylül 2020

Not: Bu, desteği sonlandırma duyurusudur.

Bu güncelleme aşağıdaki API değişikliklerini kapsar. Tüm değişiklikler, bu duyurunun tarihi olan 9 Eylül 2020'de veya bu tarihten sonra yürürlüğe girecektir. Bu nedenle, geliştiriciler artık aşağıdaki API özelliklerini kullanmamalıdır.

• Aşağıdaki API kaynakları, yöntemleri, parametreleri ve kaynak özellikleri hemen kullanımdan kaldırılacak ve bu duyurunun tarihinden itibaren veya bu tarihten sonra çalışmayı durduracaktır:
  • Aşağıdaki channel kaynağı özellikleri:
    • statistics.commentCount özelliği
    • brandingSettings.image nesnesi ve tüm alt özellikleri
    • brandingSettings.hints listesi ve tüm alt mülkleri
  • channels.list yönteminin categoryId filtre parametresi
  • guideCategories kaynağı ve guideCategories.list yöntemi
• API isteğinde managedByMe parametresi true olarak ayarlanırsa channels.list yöntemi için API yanıtları artık prevPageToken özelliğini içermez. Bu değişiklik, diğer prevPageToken istekleri için channels.list özelliğini ve tüm istekler için nextPageToken özelliğini etkilemez.
• channel kaynağının contentDetails.relatedPlaylists.watchLater ve contentDetails.relatedPlaylists.watchHistory özellikleri, 11 Ağustos 2016'da desteği sonlandırılan özellikler olarak duyurulmuştu. Bu oynatma listeleri için playlistItems.insert ve playlistItems.delete yöntemlerinin desteği de tamamen kullanımdan kaldırıldı ve iki özellik dokümanlardan kaldırıldı.
• 30 Temmuz 2013'te kullanımdan kaldırıldığı duyurulan channels.list yönteminin mySubscribers parametresi dokümanlardan kaldırıldı. Kimliği doğrulanmış kullanıcının kanalına abone olanların listesini almak için subscriptions.list yöntemini ve mySubscribers parametresini kullanın.
• channel kaynağının invideoPromotion nesnesi ve 27 Kasım 2017'de desteği sonlandırıldığı duyurulan tüm alt özellikleri dokümanlardan kaldırıldı.

29 Temmuz 2020

part parametresiyle ilişkili ek maliyeti kaldırarak API istekleri için kota ücretlendirme sürecimizi basitleştirdik. Anında geçerli olmak üzere, yalnızca çağrılan yöntemin temel maliyetini alırız. Basitleştirilmiş kota hakkında daha fazla bilgiyi burada bulabilirsiniz.

Bu değişikliğin etkisi, çoğu API çağrısının kota maliyetinin biraz daha düşük olmasıdır. Bazı API çağrılarının maliyeti ise aynı kalır. Bu değişiklik, API çağrılarının maliyetini artırmaz. Genel olarak, Google Cloud Console'da görülebilen ayrılmış kotanızın biraz daha uzun süre kullanılabileceği tahmin edilmektedir.

YouTube API Hizmetleri'ne erişmeye devam etmek için tüm geliştiricilerin projeleriyle ilgili uygunluk denetimi yapmasını önemle tavsiye ederiz.

Bu revizyon geçmişi girişi ilk olarak 20 Temmuz 2020'de yayınlanmıştır.

28 Temmuz 2020

videos.insert uç noktası aracılığıyla yüklenen ve 28 Temmuz 2020'den sonra oluşturulan doğrulanmamış API projelerindeki tüm videolar, özel görüntüleme moduyla sınırlandırılacak. Bu kısıtlamayı kaldırmak için her projenin Hizmet Şartları'na uygunluğu doğrulamak üzere denetlenmesi gerekir.

Video yüklemek için doğrulanmamış bir API istemcisi kullanan içerik üreticiler, videolarının gizli olarak kilitlendiğini ve resmi veya denetlenmiş bir istemci kullanarak kısıtlamayı önleyebileceklerini açıklayan bir e-posta alır.

28 Temmuz 2020'den önce oluşturulan API projeleri şu anda bu değişiklikten etkilenmemektedir. Ancak YouTube API Hizmetleri'ne erişimin devamlılığı için tüm geliştiricilerin projeleriyle ilgili uygunluk denetimini tamamlamasını önemle tavsiye ederiz.

21 Temmuz 2020

[28 Temmuz 2020'de güncellendi.] Bu düzeltme geçmişi girişinde referans verilen doküman güncellemesi 28 Temmuz 2020'de yeniden yayınlandı.

Dün, kota ücretlendirme sürecimizle ilgili bir doküman güncellemesi yayınladık. Ancak öngörülemeyen koşullar nedeniyle kota değişikliği henüz geçerli değil. Bu nedenle, doğruluk adına dokümanlar geri alınmıştır. Kafa karışıklığını önlemek için değişikliği açıklayan düzeltme geçmişi girişi kaldırıldı ve yakın gelecekte yeniden yayınlanacak.

7 Temmuz 2020

Not: Bu, desteği sonlandırma duyurusudur.

videos.insert yönteminin autoLevels ve stabilize parametreleri artık kullanımdan kaldırıldı ve her iki parametre de dokümandan kaldırıldı. Bu değerler yoksayılır ve yeni yüklenen videoların işlenme şeklini etkilemez.

15 Haziran 2020

Yeni YouTube Geliştirici Politikaları'na Uyma kılavuzu, API istemcilerinizin YouTube API Hizmetleri Şartları ve Politikaları'nın (API Hizmet Şartları) belirli bölümlerine uymasını sağlamanıza yardımcı olacak rehberlik ve örnekler sunar.

Bu kılavuz, YouTube'un API Hizmet Şartları'nın belirli yönlerini nasıl uyguladığı hakkında bilgi verir ancak mevcut belgelerin yerini almaz. Bu kılavuzda, geliştiricilerin API uygunluk denetimleri sırasında en sık sorduğu sorulardan bazıları ele alınmaktadır. Bu değişikliğin, politikalarımızı nasıl yorumladığımızı ve uyguladığımızı anlamanıza yardımcı olarak özellik geliştirme sürecinizi basitleştireceğini umuyoruz.

4 Haziran 2020

Not: Bu, daha önce duyurulan desteğin sonlandırılmasıyla ilgili bir güncellemedir.

Kanal duyurusu özelliği tamamen kullanımdan kaldırıldı. Bu değişiklik ilk olarak 17 Nisan 2020'de duyurulmuştu ve yürürlüğe girdi. Bu nedenle, activities.insert yöntemi artık desteklenmiyor ve activities.list yöntemi artık kanal duyurularını döndürmüyor. Daha fazla bilgi için lütfen YouTube Yardım Merkezi'ne göz atın.

17 Nisan 2020

Not: Bu, desteği sonlandırma duyurusudur.

YouTube, kanal duyurusu özelliğini kullanımdan kaldırıyor. Bu nedenle, activities.insert yöntemi kullanımdan kaldırılacak ve activities.list yöntemi kanal duyurularını döndürmeyi durduracak. Bu değişiklikler, 18 Mayıs 2020'den itibaren API'de geçerli olacaktır. Daha fazla bilgi için lütfen YouTube Yardım Merkezi'ne göz atın.

31 Mart 2020

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni kaynaklar ve yöntemler

  • Yeni member kaynağı, bir YouTube kanalının kanal üyesini temsil eder. Üyeler, içerik üreticilere düzenli olarak maddi destek sağlar ve özel avantajlardan yararlanır. Örneğin, içerik üretici bir sohbet için üyelere özel modunu etkinleştirdiğinde üyeler sohbet edebilir.

    Bu kaynak, YouTube Live Streaming API'nin bir parçası olarak belgelenen sponsor kaynağının yerini alır. sponsor kaynağı artık kullanımdan kaldırıldı. API istemcileri, sponsors.list yöntemine yapılan çağrıları güncelleyerek bunun yerine members.list yöntemini kullanmalıdır.

  • Yeni membershipsLevel kaynağı, API isteğini yetkilendiren içerik üretici tarafından yönetilen bir fiyatlandırma düzeyini tanımlar. membershipsLevels.list yöntemi, içerik üreticinin tüm üyelik düzeylerinin listesini alır.

10 Ocak 2020

API artık çocuklara yönelik içerikleri tanımlama özelliğini destekliyor. YouTube bu içerikleri "çocuklara özel" olarak adlandırıyor. YouTube Yardım Merkezi'nde "çocuklara özel" içerikler hakkında daha fazla bilgi edinin.

channel ve video kaynakları, içerik üreticilerin ve izleyicilerin çocuklara özel içerikleri belirlemesini sağlamak için iki yeni özelliği destekler:

• selfDeclaredMadeForKids özelliği, içerik üreticilerin kanalın veya videonun çocuklara özel olup olmadığını belirtmesine olanak tanır.
  
  Kanallar için bu özellik, channels.update yöntemi çağrıldığında ayarlanabilir. Videolar için bu özellik, videos.insert veya videos.update yöntemleri çağrılırken ayarlanabilir.
  
  Bu özelliğin, yalnızca kanal sahibi API isteğine yetki verdiyse channel veya video kaynaklarını içeren API yanıtlarına dahil edildiğini unutmayın.
• madeForKids özelliği, herhangi bir kullanıcının kanalın veya videonun "çocuklara özel" durumunu almasına olanak tanır. Örneğin, durum selfDeclaredMadeForKids özelliğinin değerine göre belirlenebilir. Kanalınız, videolarınız veya yayınlarınızın kitlesini ayarlama hakkında daha fazla bilgi için YouTube Yardım Merkezi'ne göz atın.

Ayrıca YouTube API Hizmetleri Hizmet Şartları ve Geliştirici Politikaları'nı da güncelledik. Daha fazla bilgi için lütfen YouTube API Hizmetleri Hizmet Şartları - Revizyon Geçmişi'ni inceleyin. YouTube API Hizmetleri Hizmet Şartları ve Geliştirici Politikaları'nda yapılan değişiklikler, 10 Ocak 2020'de Pasifik Saati ile yürürlüğe girecektir.

10 Eylül 2019

API referans belgeleri, YouTube'da ve dolayısıyla API yanıtlarında abone sayılarının raporlanma şeklindeki değişikliği yansıtacak şekilde güncellendi. Bu değişiklik sonucunda, YouTube Data API Hizmeti tarafından döndürülen abone sayıları, 1.000'den fazla abonesi olan kanallar için üç anlamlı rakama yuvarlanarak döndürülür. Bu değişiklik, channel kaynağının statistics.subscriberCount özelliğini etkiler.

Not: Bu değişiklik, kullanıcı kendi kanalıyla ilgili veriler için yetkili bir istek gönderse bile bu özellik değerini etkiler. Kanal sahipleri, YouTube Studio'da tam abone sayılarını görmeye devam edebilir.

Örneğin, bir kanalın 123.456 abonesi varsa statistics.subscriberCount özelliği 123000 değerini içerir. Aşağıdaki tabloda, abone sayılarının API yanıtlarında nasıl yuvarlandığına ve herkese açık diğer YouTube kullanıcı arayüzlerinde nasıl kısaltıldığına dair örnekler verilmiştir:

Örnek abone sayısı	YouTube Data API	Herkese açık YouTube kullanıcı arayüzleri
1.234	1230	1,23 B
12.345	12300	12,3 B
123.456	123000	123 B
1.234.567	1230000	1,23 M
12.345.678	12300000	12,3 M
123.456.789	123000000	123 M

4 Nisan 2019

Bu güncelleme aşağıdaki değişiklikleri içerir:

• API referans dokümanları, her yöntemin yaygın kullanım alanlarını daha iyi açıklamak ve API Gezgini widget'ı aracılığıyla dinamik ve yüksek kaliteli kod örnekleri sağlamak için güncellendi. Örnek için channels.list yönteminin belgelerine bakın. API yöntemlerini açıklayan sayfalarda artık iki yeni öğe var:

  • API Gezgini widget'ı, yetkilendirme kapsamlarını seçmenize, örnek parametre ve özellik değerleri girmenize, ardından gerçek API istekleri göndermenize ve gerçek API yanıtlarını görmenize olanak tanır. Ayrıca, tam ekran görünümünde tam kod örnekleri gösterilir. Bu örnekler, girdiğiniz kapsamları ve değerleri kullanmak için dinamik olarak güncellenir.

  • Yaygın kullanım alanları bölümünde, sayfada açıklanan yöntemin bir veya daha fazla yaygın kullanım alanı açıklanmaktadır. Örneğin, belirli bir kanal hakkındaki verileri veya mevcut kullanıcının kanalı hakkındaki verileri almak için channels.list yöntemini çağırabilirsiniz.

    Bu bölümdeki bağlantıları kullanarak API Gezgini'ni kullanım alanınızla ilgili örnek değerlerle doldurabilir veya tam ekran API Gezgini'ni bu değerler zaten doldurulmuş şekilde açabilirsiniz. Bu değişiklikler, kendi uygulamanızda uygulamaya çalıştığınız kullanım alanıyla doğrudan alakalı kod örneklerini görmenizi kolaylaştırmayı amaçlamaktadır.

  Kod örnekleri şu anda Java, JavaScript, PHP, Python ve curl için desteklenmektedir.

• Kod örnekleri aracı da yukarıda açıklanan tüm özellikleri sunan yeni bir kullanıcı arayüzüyle güncellendi. Bu aracı kullanarak farklı yöntemlerin kullanım alanlarını keşfedebilir, API Gezgini'ne değer yükleyebilir ve Java, JavaScript, PHP ve Python'da kod örnekleri almak için API Gezgini'ni tam ekran olarak açabilirsiniz.

  Bu değişiklikle birlikte, daha önce Java, JavaScript, PHP ve Python için kullanılabilir kod örneklerinin listelendiği sayfalar kaldırıldı.

• Java, JavaScript, PHP ve Python için hızlı başlangıç kılavuzları güncellendi. Güncellenen kılavuzlarda, API Gezgini'ndeki kod örneklerini kullanarak bir örneğin API anahtarıyla, diğer örneğin ise OAuth 2.0 istemci kimliğiyle nasıl çalıştırılacağı açıklanmaktadır.

Yukarıda açıklanan değişikliklerin, 2017'de API belgelerine eklenen etkileşimli bir aracın yerini aldığını unutmayın.

9 Temmuz 2018

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channel kaynağının snippet.thumbnails özelliğinin tanımı, uygulamanızda küçük resimleri gösterirken kodunuzun resim URL'lerini API yanıtlarında döndürüldüğü şekilde kullanması gerektiğini belirtecek şekilde güncellendi. Örneğin, uygulamanız bir API yanıtında döndürülen URL'de https alanı yerine http alanını kullanmamalıdır.

  Temmuz 2018'den itibaren kanal küçük resmi URL'leri yalnızca https alanında kullanılabilir. Bu alan, URL'lerin API yanıtlarında görünme şeklidir. Bu sürenin ardından, uygulamanız YouTube resimlerini http alanından yüklemeye çalışırsa bozuk resimler görebilirsiniz.

• Not: Bu, desteği sonlandırma duyurusudur.

  video kaynağının recordingDetails.location.altitude özelliğinin desteği sonlandırıldı. Videoların bu özellik için değer döndüreceği garanti edilmez. Benzer şekilde, API istekleri bu özellik için bir değer ayarlamaya çalışsa bile gelen veriler depolanmayabilir.

22 Haziran 2018

Eskiden Uygulama ve Taşıma Kılavuzu olarak bilinen Uygulama kılavuzu, v2 API'den v3 API'ye geçişle ilgili talimatları kaldırmak için güncellendi. Ayrıca, v3 API'de kullanımdan kaldırılan özelliklerle (ör. favori videolar) ilgili talimatlar da kaldırıldı.

27 Kasım 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Not: Bu, desteği sonlandırma duyurusudur.

  YouTube, API'de channel kaynağının invideoPromotion nesnesi aracılığıyla desteklenen Öne Çıkan Video ve Öne Çıkan Web Sitesi özelliklerine yönelik desteği kaldırıyor. Bu nedenle, tüm alt mülkleri de dahil olmak üzere söz konusu nesnenin desteği sonlandırılıyor.

  14 Aralık 2017'ye kadar invideoPromotion verilerini almaya ve ayarlamaya devam edebilirsiniz. Bu tarihten sonra:

  • channels.list işlevi çağrıldığında invideoPromotion bölümünü almaya yönelik girişimler boş bir invideoPromotion döndürür veya hiç invideoPromotion verisi döndürmez.
  • channels.update çağrısı yapılırken invideoPromotion verilerini güncelleme girişimleri, en az 27 Mayıs 2018'e kadar başarılı bir yanıt döndürür ancak bunlar işlem yapılmamış olarak değerlendirilir. Yani aslında güncelleme gerçekleştirilmez.

  27 Mayıs 2018'den sonra bu istekler, örneğin invalidPromotion öğesinin geçersiz bir parça olduğunu belirten hata mesajları döndürebilir.

16 Kasım 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Etkileşimli kod snippet'i aracı artık Node.js kod örneklerini destekliyor. Örnekler, channels.list yöntemi gibi neredeyse tüm API yöntemlerinin belgelerinde de görülebilir.

  Özelleştirilebilir örnekler, Node.js uygulaması için kullanım alanına özgü bir başlangıç noktası sunmak üzere tasarlanmıştır. İşlev, Node.js hızlı başlangıç kılavuzundaki koda benzer. Ancak örneklerde, hızlı başlangıçta görünmeyen bazı yardımcı işlevler bulunur:

  • removeEmptyParameters işlevi, API isteği parametrelerine karşılık gelen bir anahtar/değer çiftleri listesi alır ve değer içermeyen parametreleri kaldırır.
  • createResource işlevi, bir API kaynağındaki özelliklere karşılık gelen anahtar/değer çiftlerinin listesini alır. Ardından özellikleri, insert ve update işlemlerinde kullanılabilecek bir JSON nesnesine dönüştürür. Aşağıdaki örnekte bir grup özellik adı ve değeri ile kodun bunlar için oluşturacağı JSON nesnesi gösterilmektedir:

    # Key-value pairs:
    {'id': 'ABC123',
     'snippet.title': 'Resource title',
     'snippet.description': 'Resource description',
     'status.privacyStatus': 'private'}
    
    # JSON object:
    {
     'id': 'ABC123',
     'snippet': {
       'title': 'Resource title',
       'description': 'Resource description',
     },
     'status': {
       'privacyStatus': 'private'
     }
    }

  Bu örneklerin tümü yerel olarak indirilip çalıştırılacak şekilde tasarlanmıştır. Daha fazla bilgi için kod snippet'i aracı talimatlarındaki tam kod örneklerini yerel olarak çalıştırma ön koşullarını inceleyin.

25 Ekim 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Etkileşimli kod snippet'i aracındaki Python kod örnekleri, artık kullanımdan kaldırılan oauth2client kitaplığı yerine google-auth ve google-auth-oauthlib kitaplıklarını kullanacak şekilde güncellendi.

  Bu değişikliğe ek olarak, araç artık yüklü Python uygulamaları ve Python web sunucusu uygulamaları için tam kod örnekleri sunuyor. Bu uygulamalar, biraz farklı yetkilendirme akışları kullanıyor. Tam örnekleri (ve bu değişikliği) görmek için:

  1. Etkileşimli kod snippet'i aracına veya channels.list yöntemi gibi herhangi bir API yönteminin dokümanlarına gidin.
  2. Kod örneklerinin üzerindeki Python sekmesini tıklayın.
  3. Bir snippet'ten tam örneğe geçmek için sekmelerin üzerindeki açma/kapatma düğmesini tıklayın.
     
  4. Sekmede artık InstalledAppFlow yetkilendirme akışını kullanan eksiksiz bir kod örneği gösterilmelidir. Örneğin üzerindeki açıklama bu durumu açıklar ve bir web sunucusu uygulaması örneğine bağlantı verir.
  5. Web sunucusu örneğine geçmek için bağlantıyı tıklayın. Bu örnekte Flask web uygulama çerçevesi ve farklı bir yetkilendirme akışı kullanılmaktadır.

  Bu örneklerin tümü yerel olarak indirilip çalıştırılacak şekilde tasarlanmıştır. Örnekleri çalıştırmak istiyorsanız kod snippet'i aracı talimatlarındaki tam kod örneklerini yerel olarak çalıştırma ile ilgili talimatları inceleyin.

29 Ağustos 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

• search.list yönteminin forContentOwner parametresinin tanımı, bu parametre true olarak ayarlanırsa type parametresinin video olarak ayarlanması gerektiğini belirtecek şekilde güncellendi.
• search.list yönteminin regionCode parametresinin tanımı, parametrenin arama sonuçlarını belirtilen bölgede görüntülenebilen videolarla sınırladığını netleştirmek için güncellendi.
• YouTube, marka logolarını ve simgelerini güncelledi. Yeni "YouTube ile geliştirildi" logolarını markalama kuralları sayfasından indirebilirsiniz. Diğer yeni YouTube logoları ve simgeleri de bu sayfada gösterilir ve YouTube marka sitesinden indirilebilir.

24 Temmuz 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

• iOS için yeni bir YouTube Data API hızlı başlangıç kılavuzu kullanıma sunuldu. Bu kılavuzda, Objective-C veya Swift ile yazılmış basit bir iOS uygulamasında YouTube Data API'nin nasıl kullanılacağı açıklanmaktadır.
• YouTube Data API'si için etkileşimli kod snippet'i aracı, artık aracın bazı özelliklerini açıklayan belgeler içeriyor:
  • API isteklerini yürütme
  • Kod snippet'leri ve tam kod örnekleri arasında geçiş yapma
  • Hazır işlevleri kullanma
  • Mevcut kaynakları yükleme (güncelleme yöntemleri için)

  Not: Araç, API yöntemleri için API referans belgelerine de yerleştirilmiştir (örnek).

1 Haziran 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Not: Bu, desteği sonlandırma duyurusudur.

  Aşağıdaki video kaynak özelliklerinin desteği sonlandırılıyor. Özellikler 1 Aralık 2017'ye kadar desteklenecek olsa da videoların bu tarihe kadar söz konusu özellikler için değer döndürmeye devam edeceğine dair bir garanti yoktur. Benzer şekilde, bu mülk değerlerini ayarlayan videos.insert ve videos.update istekleri bu tarihten önce hata oluşturmaz ancak gelen verilerin depolanmaması mümkündür.

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude

17 Mayıs 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

• API referans belgeleri, kod snippet'lerini daha yaygın ve etkileşimli hale getirmek için güncellendi. channels.list veya videos.rate gibi API yöntemlerini açıklayan sayfalarda artık Java, JavaScript, PHP, Python, Ruby, Apps Komut Dosyası ve Go'daki kod snippet'lerini görüntüleyip özelleştirmenize olanak tanıyan etkileşimli bir araç bulunuyor.

  Araç, herhangi bir yöntem için bir veya daha fazla kullanım alanına yönelik kod snippet'leri gösterir. Her kullanım alanı, söz konusu yöntemin yaygın olarak kullanılan bir çağrı şeklini açıklar. Örneğin, belirli bir kanal veya mevcut kullanıcının kanalıyla ilgili verileri almak için channels.list yöntemini çağırabilirsiniz.

  Kod örnekleriyle de etkileşimde bulunabilirsiniz:

  • Parametre ve özellik değerlerini değiştirdiğinizde kod snippet'leri, sağladığınız değerleri yansıtacak şekilde dinamik olarak güncellenir.

  • Kod snippet'leri ve tam örnekler arasında geçiş yapın. Kod snippet'i, API yöntemini çağıran kod bölümünü gösterir. Tam örnek, bu snippet'in yanı sıra istekleri yetkilendirmek ve göndermek için standart kodu da içerir. Tam örnekler, komut satırından veya yerel bir web sunucusundan kopyalanıp çalıştırılabilir.

  • Bir düğmeyi tıklayarak istekleri yürütün. (İstekleri yürütmek için aracı sizin adınıza API'yi çağırması konusunda yetkilendirmeniz gerekir.)

  Bu aracın, kullanılabildiği sayfalarda API Gezgini'nin yerini aldığını unutmayın. (Her sayfada, üzerinde çalıştığınız isteği API Gezgini'ne yükleme seçeneğiniz de olacak şekilde bir bağlantı gösterilir.)

• Data API Code Snippets (Veri API'si Kod Snippet'leri) aracı da yukarıda açıklanan tüm özellikleri sunan yeni bir kullanıcı arayüzüyle güncellendi. Bu sayfada sunulan başlıca yeni özellikler şunlardır:

  • Veri yazan API istekleri için destek.
  • Java örnekleri için destek.
  • Kullanıcıları yetkilendirmek ve API istekleri oluşturmak için daha esnek ve kapsamlı standart kod.

27 Nisan 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni hızlı başlangıç kılavuzlarında, YouTube Data API istekleri yapan basit bir uygulamanın nasıl ayarlanacağı açıklanmaktadır. Şu anda Android, Apps Komut Dosyası, Go, Java, JavaScript, Node.js, PHP, Python ve Ruby için rehberler mevcuttur.

30 Mart 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channel kaynağının yeni topicDetails.topicCategories[] özelliği, kanalın içeriğini açıklayan Wikipedia URL'lerinin listesini içerir. URL'ler, kaynağın topicDetails.topicIds[] özelliğinde döndürülen konu kimliklerine karşılık gelir.
• playlistItem kaynağının yeni contentDetails.videoPublishedAt özelliği, videonun YouTube'da yayınlandığı zamanı tanımlar. Kaynakta, öğenin çalma listesine eklendiği zamanı tanımlayan snippet.publishedAt özelliği zaten var.
• channel kaynağı gibi, video kaynağı da artık videonun içeriğini açıklayan Wikipedia URL'lerinin listesini içeren topicDetails.topicCategories[] özelliğini döndürüyor. video kaynakları için URL'ler, kaynağın topicDetails.relevantTopicIds[] özelliğinde döndürülen konu kimliklerine karşılık gelir.
• video kaynağının yeni contentDetails.contentRating.mpaatRating özelliği, Motion Picture Association of America'nın bir film fragmanına veya önizlemesine verdiği derecelendirmeyi tanımlar.

27 Şubat 2017

YouTube, 11 Ağustos 2016'da duyurulduğu gibi, desteklenen konu kimlikleri listesini seçilmiş bir listeyle değiştirdi. Desteklenen konu kimliklerinin tam listesi, topicDetails özelliklerinde channel ve video kaynaklarının yanı sıra search.list yönteminin topicId parametresinde yer alır.

Seçilmiş listede çeşitli değişiklikler yapıldığını unutmayın:

• Aşağıdaki konular, Society konusunun alt konuları olarak eklendi:

  Ad	konu kimliği
  İşletme	/m/09s1f
  Sağlık	/m/0kt51
  Askeriye	/m/01h6rj
  Politika	/m/05qt0
  Din	/m/06bvp

• Daha önce Entertainment öğesinin alt öğesi olan Animated cartoon konusu kaldırıldı.
• Daha önce Music öğesinin alt öğesi olan Children's music konusu kaldırıldı.

Bu değişiklik sonucunda, bir videoyla ilgili konular artık her zaman video kaynağının topicDetails.relevantTopicIds[] özellik değerinde döndürülüyor.

29 Kasım 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• 10 Şubat 2017'den itibaren desteklenecek konu kimlikleri listesinde üç küçük değişiklik yapıldı:

  • Daha önce Sports kategorisinin alt kategorisi olan Professional wrestling kategorisi artık Entertainment kategorisinin alt kategorisi.
  • TV shows kategorisi (Entertainment kategorisinin alt kategorisi) yenidir.
  • Daha önce Lifestyle kategorisinin alt öğesi olan Health kategorisi kaldırıldı.

  Ayrıca birkaç üst kategori (Entertainment, Gaming, Lifestyle, Music ve Sports) olduğunu da unutmayın. Tennis gibi bir alt kategoriyle ilişkilendirilen tüm videolar, üst kategoriyle (Sports) de ilişkilendirilir.

10 Kasım 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• 11 Ağustos 2016'da ilk kez duyurulduğu gibi, Freebase ve Freebase API'nin desteğinin sonlandırılması, konu kimlikleriyle ilgili çeşitli değişiklikler yapılmasını gerektiriyor. Konu kimlikleri, channel ve video kaynaklarıyla ilişkili konuları tanımlar. Ayrıca belirli bir konuyla ilgili kanalları veya videoları bulmak için topicId arama parametresini de kullanabilirsiniz.

  10 Şubat 2017'den itibaren YouTube, şu ana kadar döndürülen çok daha ayrıntılı kimlik kümesi yerine küçük bir konu kimliği kümesi döndürmeye başlayacak. Ayrıca, kanalların ve videoların herhangi bir konuyla ilişkilendirileceği garanti edilmez. Bu durum, mevcut API davranışıyla tutarlıdır.

  API istemcilerinizi bu değişikliklere hazırlayabilmeniz için aşağıdaki API parametrelerinin ve özelliklerinin tanımları, bu tarihten sonra desteklenecek konu kimliklerini listeleyecek şekilde güncellendi. Kategori listesinin tüm mülkler için aynı olduğunu unutmayın.

  • channel kaynağının topicDetails.topicIds[] özelliği.
  • video kaynağının topicDetails.relevantTopicIds[] özelliği.
  • search.list yönteminin topicId parametresi.

• Not: Bu, desteği sonlandırma duyurusudur.

  Aşağıdaki özelliklerin desteği sonlandırılacak:

  • channel kaynağının topicDetails.topicIds[] özelliği. Bu özellik 10 Kasım 2017'ye kadar desteklenecektir.
  • video kaynağının topicDetails.relevantTopicIds[] özelliği. Bu özellik 10 Kasım 2017'ye kadar desteklenecektir.
  • video kaynağının topicDetails.topicIds[] özelliği. Bu özellik, 10 Şubat 2017'den sonra değer içermeyecek. (Bu tarihten sonra, topicDetails.relevantTopicIds[] özelliği değeri bir videoyla ilişkili tüm konuları tanımlayacaktır.)

• Freebase kullanımdan kaldırıldığından Freebase Konularıyla Arama kılavuzu dokümanlardan kaldırıldı. Bu kılavuzda, bir uygulamanın Freebase API ile nasıl çalışacağını gösteren kod örnekleri yer alıyordu.

  Ayrıca, konu kimlikleriyle ilgili çeşitli kod örnekleri search.list yönteminin dokümanlarından kaldırıldı.

2 Kasım 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni özellikler ve parametreler

  • video kaynağı birkaç yeni özellik içerir:

    • player.embedHtml özelliği, videoyu oynatan bir oynatıcıyı yerleştirmek için kullanabileceğiniz bir <iframe> etiketi içerir. Yeni player.embedHeight ve player.embedWidth özellikleri, yerleştirilmiş oynatıcının boyutlarını tanımlar. Bu özellikler yalnızca API isteğinde maxHeight veya maxWidth parametrelerinden en az biri için bir değer belirtilmişse döndürülür. Bu iki yeni parametre, bu düzeltme geçmişi girişinin ilerleyen kısımlarında açıklanmaktadır.

    • Yeni hasCustomThumbnail özelliği, videoyu yükleyenin video için özel bir küçük resim sağlayıp sağlamadığını gösterir. Bu özelliğin yalnızca videoyu yükleyen kişi tarafından görülebildiğini unutmayın.

    • Yeni fpbRatingReasons[], videonun FPB (Güney Afrika) derecelendirmesini almasının nedenlerini tanımlar.

    • Yeni mcstRating, videonun Vietnam'da aldığı derecelendirmeyi tanımlar.

  • videos.list yöntemi, maxHeight ve maxWidth olmak üzere iki yeni parametreyi destekler. video kaynaklarındaki player bölümünü alırken parametrelerden birini veya her ikisini de kullanabilirsiniz.

    Varsayılan olarak, player.embedHtml özelliğinde döndürülen <iframe> öğesinin yüksekliği 360 pikseldir. Genişlik, videonun en boy oranıyla eşleşecek şekilde ayarlanır. Böylece, yerleştirilmiş oynatıcıda videoyu çerçeveleyen siyah çubuklar olmaz. Örneğin, bir videonun en boy oranı 16:9 ise oynatıcının genişliği 640 piksel olur.

    Yeni parametrelerle, yerleştirme kodunun varsayılan boyutlar yerine uygulama düzeninize uygun bir yükseklik ve/veya genişlik kullanmasını belirtebilirsiniz. API sunucusu, yerleştirilmiş oynatıcının videoyu çerçeveleyen siyah çubuklar içermemesini sağlamak için oynatıcı boyutlarını uygun şekilde ölçeklendirir. Her iki parametrenin de yerleştirilmiş oynatıcının maksimum boyutlarını belirttiğini unutmayın. Bu nedenle, her iki parametre de belirtilmişse bir boyut, söz konusu boyut için izin verilen maksimum miktardan daha küçük olabilir.

    Örneğin, bir videonun en boy oranının 16:9 olduğunu varsayalım. Bu nedenle, maxHeight veya maxWidth parametresi ayarlanmamışsa player.embedHtml etiketi 640x360 boyutlarında bir oynatıcı içerir.

    • maxHeight parametresi 720 olarak ayarlanırsa ve maxWidth parametresi ayarlanmazsa API, 1280x720 boyutlarında bir oynatıcı döndürür.
    • maxWidth parametresi 960 olarak ayarlanırsa ve maxHeight parametresi ayarlanmazsa API, 960x540 boyutlarında bir oynatıcı döndürür.
    • maxWidth parametresi 960 olarak, maxHeight parametresi ise 450 olarak ayarlanırsa API, 800x450 boyutlarında bir oynatıcı döndürür.

    Yukarıda açıklanan yeni player.embedHeight ve player.embedWidth özellikleri, oynatıcının boyutlarını tanımlar.

• Mevcut yöntemlerde, özelliklerde ve parametrelerde yapılan güncellemeler

  • channelSection kaynak açıklamasında, bir kanalın hedefleme verileri ayarlamadan en fazla 10 raf, hedefleme verileriyle ise en fazla 100 raf oluşturabileceği belirtildi.

    Ayrıca, channelSection kaynağının targeting özelliği, hedefleme seçeneklerinin yalnızca API kullanılarak ayarlanabileceğini yansıtacak şekilde güncellendi. Kanal bölümü, YouTube web sitesindeki kullanıcı arayüzü kullanılarak değiştirilirse hedefleme seçenekleri silinir.

  • i18nLanguage kaynağının snippet.name özelliği tanımı, değerin i18nLanguage.list yönteminin hl parametresiyle belirtilen dilde yazıldığı şekliyle bir dilin adını temsil ettiğini yansıtacak şekilde düzeltildi.

  • playlistItem kaynağının contentDetails.note özelliği, özellik değerinin maksimum uzunluğunun 280 karakter olduğunu belirtecek şekilde güncellendi.

  • playlistItem kaynağının contentDetails.startAt ve contentDetails.endAt özelliklerinin desteği sonlandırıldı. Bu alanlar, playlistItems.insert veya playlistItems.update isteklerinde ayarlanırsa yoksayılır.

  • playlistItems.delete ve playlistItems.update yöntemleri artık diğer birçok yöntemde zaten desteklenen onBehalfOfContentOwner parametresini destekliyor. Bu yöntemin kullanıldığı isteklerin de https://www.googleapis.com/auth/youtubepartner kapsamına erişim sağlayan bir jetonla yetkilendirilmesi gerekir.

  • search.list yönteminin publishedBefore ve publishedAfter parametreleri, parametre değerlerinin kapsayıcı olduğunu belirtecek şekilde güncellendi. Bu nedenle, örneğin publishedBefore parametresi ayarlanırsa API, belirtilen zamandan önce veya belirtilen zamanda oluşturulan kaynakları döndürür.

  • video kaynağının contentDetails.contentRating.grfilmRating özelliği üç ek değeri destekler: grfilmK12, grfilmK15 ve grfilmK18.

  • videos.insert yöntemi açıklamasında, yüklenen videoların maksimum dosya boyutunun 64 GB'tan 128 GB'a yükseldiği belirtildi.

• Yeni ve güncellenmiş hatalar

  • API, aşağıdaki yeni hataları destekler:

    Hata türü	Hata ayrıntısı	Açıklama
    forbidden (403)	homeParameterDeprecated	activities.list yöntemi, kullanıcının ana sayfa etkinlik verilerinin bu API aracılığıyla kullanılamadığını belirtmek için bu hatayı döndürür. Yetkisiz bir istekte home parametresini true olarak ayarlarsanız bu hata oluşabilir.
    invalidValue (400)	invalidContentDetails	playlistItems.insert yöntemi, istekteki contentDetails nesnesinin geçersiz olduğunu belirtmek için bu hatayı döndürür. Bu hatanın oluşmasının bir nedeni, contentDetails.note alanının 280 karakterden uzun olmasıdır.
    forbidden (403)	watchHistoryNotAccessible	playlistItems.list yöntemi, isteğin "izleme geçmişi" oynatma listesi öğelerini almaya çalıştığını ancak bu öğelerin API kullanılarak alınamayacağını belirtmek için bu hatayı döndürür.
    forbidden (403)	watchLaterNotAccessible	playlistItems.list yöntemi, isteğin "Daha sonra izle" oynatma listesi öğelerini almaya çalıştığını ancak bu öğelerin API kullanılarak alınamadığını belirtmek için bu hatayı döndürür.
    badRequest (400)	uploadLimitExceeded	videos.insert yöntemi, kanalın yükleyebileceği video sayısını aştığını belirtmek için bu hatayı döndürür.
    forbidden (403)	forbiddenEmbedSetting	videos.update yöntemi, API isteğinin video için geçersiz bir yerleştirme ayarı yapmaya çalıştığını belirtmek üzere bu hatayı döndürür. Bazı kanalların, canlı yayınlar için yerleştirilmiş oynatıcı sunma izni olmayabilir. Daha fazla bilgi için YouTube Yardım Merkezi'ne göz atın.

  • playlistItems.insert yöntemi, oynatma listesine yinelenen bir video eklediğinizde artık hata döndürmüyor. Bu hata daha önce, yinelenen öğelere izin vermeyen ancak artık desteklenmeyen favori videolar gibi bazı oynatma listelerinde meydana geliyordu. Genel olarak, oynatma listelerinde yinelenen videolara izin verilir.

• Diğer güncellemeler

  • 15 Eylül 2016 tarihli düzeltme geçmişi girişi, channel kaynağının contentDetails.relatedPlaylists.watchHistory ve contentDetails.relatedPlaylists.watchLater özellikleri bir yanıta dahil edildiğinde her zaman sırasıyla HL ve WL değerlerini içerdiğini netleştirmek için güncellendi. Ayrıca bu özellikler yalnızca yetkili bir kullanıcı, kullanıcının kendi kanalıyla ilgili verileri alıyorsa dahil edilir.

15 Eylül 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• 11 Ağustos 2016 tarihli revizyon geçmişi güncellemesinde, desteklenen konu kimlikleri kümesinin 10 Şubat 2017'den itibaren değişeceği de dahil olmak üzere konu kimlikleriyle ilgili çeşitli değişikliklerden bahsedilmişti. Desteklenecek konuların listesi 10 Kasım 2016'ya kadar yayınlanacaktır.

• Aşağıdaki değişiklikler artık geçerli. Bu değişikliklerle ilgili bildirim, 11 Ağustos 2016'daki düzeltme geçmişi güncellemesinde yapılmıştı:

  • activities.list yöntemi, home parametresi true olarak ayarlanmış şekilde çağrılırsa API yanıtı artık oturumu kapalı bir YouTube kullanıcısının ana sayfada göreceğine benzer öğeler içerir.

    Bu küçük değişiklik, 11 Ağustos 2016'daki düzeltme geçmişi güncellemesinde açıklanan davranıştan daha iyi bir kullanıcı deneyimi sağlamayı amaçlamaktadır. Bu güncellemede, home parametresinin kullanıldığı isteklerin boş bir liste döndüreceği belirtilmişti.

  • channel kaynağının contentDetails.relatedPlaylists.watchHistory ve contentDetails.relatedPlaylists.watchLater özellikleri artık tüm kanallar için sırasıyla HL ve WL değerlerini içeriyor.

    Bu özellikler yalnızca kullanıcının kendi kanalıyla ilgili verileri alan yetkili bir kullanıcı tarafından görülebilir. Özellikler, kullanıcının kendi kanalıyla ilgili verileri alan yetkili bir kullanıcı için bile her zaman HL ve WL değerlerini içerir. Bu nedenle, izleme geçmişi ve daha sonra izle oynatma listesi kimlikleri API aracılığıyla alınamaz.

    Ayrıca, bir kanalın izleme geçmişi veya daha sonra izle oynatma listesi için oynatma listesi ayrıntılarını (playlists.list) ya da oynatma listesi öğelerini (playlistItems.list) alma istekleri artık boş listeler döndürüyor. Bu davranış, yeni değerler olan HL ve WL ile API istemcinizin daha önce depolamış olabileceği tüm izleme geçmişi veya daha sonra izle oynatma listesi kimlikleri için geçerlidir.

• video kaynağının fileDetails.recordingLocation nesnesi ve alt özellikleri artık döndürülmüyor. Daha önce bu veriler (ör. üst fileDetails nesnesi) yalnızca videonun sahibi tarafından alınabiliyordu.

11 Ağustos 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• YouTube Mühendislik ve Geliştiriciler Blogu'nda ayrıntılı olarak ele alınan, yeni yayınlanan YouTube API Hizmetleri Hizmet Şartları ("Güncellenen Şartlar"), mevcut Hizmet Şartları'nda kapsamlı bir güncelleme seti sunuyor. 10 Şubat 2017'den itibaren geçerli olacak Güncellenen Şartlar'a ek olarak bu güncelleme, geliştiricilerin uyması gereken politikaları açıklamaya yardımcı olacak çeşitli destekleyici belgeler içerir.

  Yeni dokümanların tamamı Güncellenen Şartlar'ın düzeltme geçmişinde açıklanmaktadır. Ayrıca, Güncellenen Şartlar'da veya destekleyici belgelerde gelecekte yapılacak değişiklikler de bu revizyon geçmişinde açıklanacaktır. Bu dokümandaki bir bağlantıdan, düzeltme geçmişindeki değişiklikleri listeleyen bir RSS özet akışına abone olabilirsiniz.

• Freebase ve Freebase API'nin desteğinin sonlandırılması, konu kimlikleriyle ilgili çeşitli değişikliklere neden oluyor. Konu kimlikleri aşağıdaki API kaynaklarında ve yöntemlerinde kullanılır:

  • channel kaynağının topicDetails bölümü, kanalla ilişkili konuları tanımlar.
  • video kaynağının topicDetails bölümü, video ile ilişkili konuları tanımlar.
  • search.list yönteminin topicId parametresi, belirli bir konuyla ilgili videoları veya kanalları aramanıza olanak tanır.

  Bu özelliklerde yapılan değişiklikler şunlardır:

  • 10 Şubat 2017'den itibaren YouTube, şu ana kadar döndürülen çok daha ayrıntılı kimlik kümesi yerine küçük bir konu kimliği kümesi döndürmeye başlayacak. Desteklenen bu konu grubu, Spor veya Basketbol gibi üst düzey kategorileri tanımlar ancak örneğin belirli takımları veya oyuncuları tanımlamaz. Uygulamanızı bu değişikliğe hazırlamanız için desteklenen konuları duyuracağız.

  • Daha önce aldığınız tüm Freebase konu kimlikleri, 10 Şubat 2017'ye kadar içerik aramak için kullanılabilir. Ancak bu sürenin ardından, önceki öğede tanımlanan daha küçük konu grubunu kullanarak arama sonuçlarını yalnızca konuya göre alabilirsiniz.

  • 10 Şubat 2017'den sonra, desteklenen daha küçük konu kimlikleri kümesinde bulunmayan bir konu kimliği kullanarak sonuç arama girişiminde bulunursanız API boş bir sonuç kümesi döndürür.

• 12 Eylül 2016'dan itibaren geçerli olmak üzere çeşitli API alanları ve parametreleri kullanımdan kaldırılacak:

  • activities.list yönteminin home parametresi, yetkili bir kullanıcının YouTube ana sayfasında gösterilecek etkinlik feed'ini almasını sağlıyordu. 12 Eylül 2016'dan sonra bu parametreyi kullanan istekler boş bir liste döndürür.

  • channel kaynağının contentDetails.relatedPlaylists.watchHistory ve contentDetails.relatedPlaylists.watchLater özellikleri yalnızca kullanıcının kendi kanalıyla ilgili verileri alan yetkili bir kullanıcı tarafından görülebilir. 12 Eylül 2016'dan sonra contentDetails.relatedPlaylists.watchHistory, HL değerini, contentDetails.relatedPlaylists.watchLater özelliği ise tüm kanallar için WL değerini döndürecek.

    Bir kanalın izleme geçmişi veya daha sonra izle oynatma listesi için oynatma listesi ayrıntılarını (playlists.list) alma istekleri, 12 Eylül 2016'dan sonra boş bir liste döndürür. Bu oynatma listelerindeki oynatma listesi öğelerini (playlistItems.list) alma istekleri de bu süreden sonra boş bir liste döndürür. Bu durum, HL ve WL yeni değerlerinin yanı sıra API istemcinizin daha önce depolamış olabileceği tüm izleme geçmişi veya daha sonra izle oynatma listesi kimlikleri için de geçerlidir.

  • video kaynağının fileDetails.recordingLocation nesnesi veya alt özelliklerinden herhangi biri 12 Eylül 2016'dan sonra artık döndürülmeyecek. Üst fileDetails nesnesi yalnızca video sahibi tarafından alınabildiğinden bu veriler yalnızca video sahibi tarafından alınabilir.

13 Haziran 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channel kaynağının contentDetails.googlePlusUserId özelliğinin desteği sonlandırıldı. Daha önce, bu özellik yalnızca kanal bir Google+ profiliyle ilişkilendirilmişse kullanılabiliyordu. Desteğin sonlandırılmasının ardından mülk artık hiçbir channel kaynağına dahil edilmeyecek.

• comment kaynağının snippet.authorGoogleplusProfileUrl özelliğinin desteği sonlandırıldı. Daha önce, bu özellik yalnızca kanal bir Google+ profiliyle ilişkilendirilmişse kullanılabiliyordu. Desteğin sonlandırılmasının ardından mülk artık hiçbir comment kaynağına dahil edilmeyecek.

Bu özelliklerin hiçbiri desteğin sonlandırılmasının ardından döndürülmeyeceğinden her iki özellik de ilgili kaynak dokümanlarından kaldırıldı.

31 Mayıs 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• subscriptions.list yönteminin yeni myRecentSubscribers parametresi, kimliği doğrulanmış kullanıcının kanalına abone olanların listesini, kanala abone olma zamanlarına göre ters kronolojik sırada alır.

  Yeni parametrenin yalnızca kimliği doğrulanmış kullanıcının kanalına abone olan son 1.000 abonenin alınmasını desteklediğini unutmayın. Abonelerin tam listesini almak için mySubscribers parametresini kullanın. Aboneleri belirli bir sırada döndürmeyen bu parametre, alınabilecek abone sayısını sınırlamaz.

• snippet.thumbnails.(key) özelliğinin tanımı, bazı videolar için ek küçük resim boyutlarının kullanılabildiğini belirtmek üzere activity, playlistItem, playlist, search result, thumbnail ve video kaynakları için güncellendi.

  • standard resmi 640 piksel genişliğinde ve 480 piksel yüksekliğindedir.
  • maxres resmi 1.280 piksel genişliğinde ve 720 piksel yüksekliğindedir.

• channelSection.list yönteminin part parametresinin tanımı, targeting bölümünün 2 kota birimi maliyetle alınabileceğini belirtecek şekilde güncellendi.

• videos.list yöntemi artık uygun şekilde yetkilendirilmemiş bir istek, video kaynağının fileDetails, processingDetails veya suggestions bölümlerini almaya çalıştığında yasak (403) hatası döndürüyor. Bu bölümler yalnızca videonun sahibi tarafından kullanılabilir.

17 Mayıs 2016

Yeni Data API Kod Snippet'leri aracı, YouTube Data API'nin yaygın kullanım alanları için kısa kod snippet'leri sağlar. Kod snippet'leri şu anda Apps Komut Dosyası, Go, JavaScript, PHP, Python ve Ruby'deki tüm salt okunur API yöntemleri için kullanılabilir.

Araç, her yöntem için bir veya daha fazla kullanım alanına yönelik kod örnekleri gösterir. Örneğin, search.list yöntemi için beş kod snippet'i sağlar:

• Videoları anahtar kelimeye göre listeleme
• Videoları konuma göre listeleme
• Canlı etkinlikleri listeleme
• Kimliği doğrulanmış kullanıcının videolarını arama
• İlgili videoları listeleme

Araç, her kullanım alanı için API isteğinde kullanılan parametreleri gösterir. Parametre değerlerini değiştirebilirsiniz. Bu durumda araç, sağladığınız parametre değerlerini yansıtacak şekilde kod snippet'lerini günceller.

Son olarak araç, her isteğe verilen API yanıtını gösterir. İstek parametrelerini değiştirdiyseniz API yanıtı, sağladığınız parametre değerlerine göre belirlenir. API yanıtlarının gösterilmesi için aracın sizin adınıza istek göndermesine izin vermeniz gerektiğini unutmayın.

28 Nisan 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• video kaynağının yeni contentDetails.projection özelliği, videonun projeksiyon biçimini belirtir. Geçerli özellik değerleri 360 ve rectangular'dir.

• video kaynağının recordingDetails.location ve fileDetails.recordingLocation özellikleri, iki özellik arasındaki farkı açıklamak için güncellendi:

  • recordingDetails.location özelliği, video sahibinin videoyla ilişkilendirmek istediği konumu tanımlar. Bu konum düzenlenebilir, herkese açık videolarda aranabilir ve herkese açık videolarda kullanıcılara gösterilebilir.
  • fileDetails.recordingLocation özelliği değeri sabittir ve orijinal, yüklenen video dosyasıyla ilişkili konumu temsil eder. Değeri yalnızca video sahibi görebilir.

• channel kaynağının contentDetails.relatedPlaylists.favorites özelliğinin tanımı, özellik değerinin boş bir çalma listesine referans veren ve getirilemeyen bir çalma listesi kimliği içerebileceğini belirtecek şekilde güncellendi. Bunun nedeni, favori videolar işlevinin desteğinin sonlandırılmış olmasıdır. Bu özelliğin API desteğini sonlandırma politikasına tabi olmadığını unutmayın.

• ineligibleAccount, comments.update, commentThreads.insert veya commentThreads.update yöntemi tarafından döndürülebilen ineligibleAccount hatasının tanımı, API isteğini yetkilendirmek için kullanılan YouTube hesabının kullanıcının Google Hesabı ile birleştirilmediği durumlarda hatanın oluştuğunu yansıtacak şekilde güncellendi.comments.insert

20 Nisan 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channels.update yönteminin part parametresinin tanımı, localizations değerinin de bu parametre için geçerli bir değer olduğunu belirtecek şekilde güncellendi.

• Başlangıç kılavuzunun Kota Kullanımı bölümü, gerçek kotanızı ve kota kullanımınızı görebileceğiniz Google Developer Console'a bağlantı verecek şekilde güncellendi.

16 Mart 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Mevcut kaynaklar ve yöntemlerdeki güncellemeler

  • Yüklenen kanal banner'ı resminin önerilen boyutunun 2.560 piksel x 1.440 piksel olduğu belirtilmek üzere channelBanner kaynak dokümanı güncellendi. Minimum boyut (2048 piksel x 1152 piksel) değişmedi.

  • channel kaynağının yeni snippet.customUrl özelliği, kanalla ilişkili özel URL'yi tanımlar. (Tüm kanalların özel URL'si yoktur.) YouTube Yardım Merkezi'nde, özel URL alma ile ilgili uygunluk koşulları ve URL'nin nasıl ayarlanacağı açıklanmaktadır.

  • channel kaynağının brandingSettings.watch nesnesinin ve tüm alt özelliklerinin desteği sonlandırıldı.

  • search.list isteğine verilen API yanıtı artık bir regionCode özelliği içeriyor. Özellik, arama sorgusu için kullanılan bölge kodunu tanımlar. Bölge kodu, API'ye belirtilen ülke için arama sonuçları döndürmesi talimatını verir.

    Özellik değeri, bölgeyi tanımlayan iki harfli bir ISO ülke kodudur. i18nRegions.list yöntemi, desteklenen bölgelerin listesini döndürür. Varsayılan değer US'dır. Desteklenmeyen bir bölge belirtilirse YouTube, sorguyu işlemek için varsayılan değer yerine başka bir bölge seçebilir.

  • videoAbuseReportReason kaynağının snippet.label ve snippet.secondaryReasons[].label özelliklerinin tanımları, özelliklerin kötüye kullanım raporu nedenleriyle ilgili yerelleştirilmiş etiket metni içerdiğini belirtecek şekilde güncellendi.

    Ayrıca, videoAbuseReportReasons.list yöntemi artık API yanıtındaki etiket metni için kullanılması gereken dili belirten hl parametresini destekliyor. Varsayılan parametre değeri en_US'dır.

  • video kaynağının yeni contentDetails.contentRating.ecbmctRating özelliği, bir videonun Türkiye Cumhuriyeti Kültür ve Turizm Bakanlığı Değerlendirme ve Sınıflandırma Kurulu'ndaki derecelendirmesini tanımlar.

    Ayrıca, diğer derecelendirme sistemlerine ait API özellikleri aşağıdaki yeni özellik değerlerini destekler:

    • contentDetails.contentRating.fpbRating (Güney Afrika)
      Puan: 10; özellik değeri: fpb10
    • contentDetails.contentRating.moctwRating (Tayvan)
      Derecelendirme: R-12; özellik değeri: moctwR12
    • contentDetails.contentRating.moctwRating (Tayvan)
      Derecelendirme: R-15; özellik değeri: moctwR15

  • video Kaynağın liveStreamingDetails.activeLiveChatId özelliği, video ile ilişkili etkin canlı sohbetin kimliğini içerir. Özellik değeri yalnızca video, canlı sohbetin etkin olduğu mevcut bir canlı yayınsa bulunur. Yayın sona erip canlı sohbet kapatıldıktan sonra özellik, video için artık döndürülmez.

  • video kaynağının status.rejectionReason özelliği, yeni özellik değeri legal'yi destekliyor.

• API, aşağıdaki yeni hataları destekler:

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest (400)	notEditable	channelSections.insert, channelSections.update ve channelSections.delete yöntemleri, belirtilen kanal bölümünün oluşturulamadığını, güncellenemediğini veya silinemediğini belirtmek için bu hatayı döndürür.
  badRequest (400)	styleRequired	channelSections.insert ve channelSections.update yöntemleri, API isteğinde gönderilen channelSection kaynağının snippet.style özelliği için bir değer belirtmesi gerektiğini belirtmek üzere bu hatayı döndürür.
  badRequest (400)	typeRequired	channelSections.insert ve channelSections.update yöntemleri, API isteğinde gönderilen channelSection kaynağının snippet.type özelliği için bir değer belirtmesi gerektiğini belirtmek üzere bu hatayı döndürür.
  badRequest (400)	processingFailure	commentThreads.list yöntemi, API sunucusunun isteği başarıyla işleyemediğini belirtmek için bu hatayı döndürür. Bu geçici bir hata olabilir ancak genellikle isteğin girişinin geçersiz olduğunu gösterir. Geçerli olduğundan emin olmak için istek gövdesindeki commentThread kaynağının yapısını kontrol edin.
  forbidden (403)	commentsDisabled	commentThreads.list yöntemi, videoId parametresiyle tanımlanan videoda yorumların devre dışı bırakıldığını belirtmek için bu hatayı döndürür.
  badRequest (400)	commentTextTooLong	commentThreads.insert yöntemi, eklenen comment kaynağının snippet.topLevelComment.snippet.textOriginal özelliğinde çok fazla karakter olduğunu belirtmek için bu hatayı döndürür.
  invalidValue (400)	videoAlreadyInAnotherSeriesPlaylist	playlistItems.insert yöntemi, oynatma listesine eklemeye çalıştığınız videonun zaten başka bir dizi oynatma listesinde olduğunu belirtmek için bu hatayı döndürür. Seri oynatma listeleri hakkında daha fazla bilgi için YouTube Yardım Merkezi'ne göz atın.
  badRequest (400)	subscriptionForbidden	subscriptions.insert yöntemi, maksimum abonelik sayısına ulaştığınızı veya çok fazla yeni abonelik oluşturduğunuzu belirtmek için bu hatayı döndürür. İkinci durumda, birkaç saat sonra isteği yeniden deneyebilirsiniz.
  badRequest (400)	invalidCategoryId	videos.update yöntemi, yüklenen video kaynağındaki snippet.categoryId özelliğinde geçersiz bir kategori kimliği belirtildiğini belirtmek için bu hatayı döndürür. Desteklenen kategorileri almak için videoCategories.list yöntemini kullanın.
  badRequest (400)	invalidDescription	videos.update yöntemi, yüklenen video kaynağındaki snippet.description özelliğinin geçersiz bir değer belirttiğini belirtmek için bu hatayı döndürür.
  badRequest (400)	invalidPublishAt	videos.update yöntemi, yüklenen video kaynağındaki status.publishAt özelliğinde geçersiz bir planlanmış yayınlanma zamanı belirtildiğini belirtmek için bu hatayı döndürür.
  badRequest (400)	invalidRecordingDetails	videos.update yöntemi, yüklenen video kaynağındaki recordingDetails nesnesinin geçersiz kayıt ayrıntıları belirttiğini belirtmek için bu hatayı döndürür.
  badRequest (400)	invalidTags	videos.update yöntemi, yüklenen video kaynağındaki snippet.tags özelliğinin geçersiz bir değer belirttiğini belirtmek için bu hatayı döndürür.
  badRequest (400)	invalidTitle	videos.update yöntemi, yüklenen video kaynağındaki snippet.title özelliğinin geçersiz veya boş bir video başlığı belirttiğini belirtmek için bu hatayı döndürür.
  badRequest (400)	invalidVideoMetadata	videos.update yöntemi, istek meta verilerinin geçersiz olduğunu belirtmek için bu hatayı döndürür. Bu hata, istek bir video kaynağının snippet bölümünü güncellediğinde ancak hem snippet.title hem de snippet.categoryId özellikleri için bir değer ayarlamadığında oluşur.

18 Aralık 2015

Avrupa Birliği (AB) yasaları uyarınca, AB'deki son kullanıcılara belirli açıklamalar yapılmalı ve bu kullanıcılardan izin alınmalıdır. Bu nedenle, Avrupa Birliği'ndeki son kullanıcılar için AB Kullanıcı Rızası Politikası'na uymanız gerekir. Bu şartla ilgili bildirimi YouTube API Hizmet Şartları'na ekledik.

19 Kasım 2015

API artık playlist ve video kaynaklarının snippet.title ve snippet.description özelliklerinin, channelSection kaynağının snippet.title özelliğinin ve channel kaynağının snippet.description özelliğinin yerelleştirilmiş metnini ayarlama ve alma özelliğini destekliyor.

• Yerelleştirilmiş başlıklar ve açıklamalar ayarlama

  Bir kaynak için insert veya update yöntemini çağırırken bu kaynağın yerelleştirilmiş değerlerini ayarlayabilirsiniz. Bir kaynak için yerelleştirilmiş değerler ayarlamak üzere aşağıdakilerin ikisini de yapın:

  • Kaynağın snippet.defaultLanguage özelliği için bir değer ayarlandığından emin olun. Bu özellik, kaynağın snippet.title ve snippet.description özelliklerinin dilini tanımlar. Değeri, desteklenen herhangi bir uygulama dili veya diğer ISO 639-1:2002 dil kodlarının çoğu olabilir. Örneğin, İngilizce başlığı ve açıklaması olan bir video yüklerseniz snippet.defaultLanguage özelliğini en olarak ayarlarsınız.

    channel kaynaklarını güncelleme ile ilgili not: Bir channel kaynağı için snippet.defaultLanguage özelliğini ayarlamak üzere brandingSettings.channel.defaultLanguage özelliğini güncellemeniz gerekir.

  • Güncellediğiniz kaynağa localizations nesnesini ekleyin. Her nesne anahtarı, bir uygulama dilini veya ISO 639-1:2002 dil kodunu tanımlayan bir dizedir ve her anahtar, kaynağın yerelleştirilmiş başlığını (ve açıklamasını) içeren bir nesneyle eşlenir.

    Aşağıdaki örnek snippet, kaynağın varsayılan dilini İngilizce olarak ayarlar. Ayrıca, videoya yerelleştirilmiş Almanca ve İspanyolca başlıklar ve açıklamalar ekler:

    {
      "kind": "youtube#video",
      ...
      "snippet": {
        "title": "Playing soccer",
        "description": "We play soccer in the park on Sundays.",
        "defaultLanguage": "en",
        ...
      },
      "localizations":
        "de": {
          "title": "Fußball spielen",
          "description": "Wir spielen Fußball im Park am Sonntag"
        },
        "es": {
          "title": "Jugar al fútbol",
          "description": "Nosotros jugamos fútbol en el parque los domingos",
        }
      }
    }

  Önemli: Bir kaynağın yerelleştirilmiş verilerini güncellerken API isteğinizin, verilerin mevcut tüm yerelleştirilmiş sürümlerini içermesi gerektiğini unutmayın. Örneğin, yukarıdaki örnekteki videoya Portekizce veriler eklemek için sonraki bir isteği gönderdiyseniz isteğin Almanca, İspanyolca ve Portekizce için yerelleştirilmiş verileri içermesi gerekir.

• Yerelleştirilmiş değerleri alma

  API, bir kaynağın yerelleştirilmiş değerlerini almak için iki yöntemi destekler:

  • hl parametresini channels.list, channelSections.list, playlists.list veya videos.list isteğinize ekleyerek YouTube web sitesinin desteklediği belirli bir uygulama dili için yerelleştirilmiş verileri alın. Yerelleştirilmiş kaynak ayrıntıları bu dilde mevcutsa kaynağın snippet.localized nesnesi yerelleştirilmiş değerleri içerir. Ancak yerelleştirilmiş ayrıntılar mevcut değilse snippet.localized nesnesi, kaynağın varsayılan dilindeki kaynak ayrıntılarını içerir.

    Örneğin, yukarıda açıklanan video için yerelleştirilmiş Almanca ve İspanyolca verilerle birlikte veri alındığını varsayalım.videos.list hl parametresi de olarak ayarlanırsa kaynak aşağıdaki verileri içerir:

    {
      "kind": "youtube#video",
      ...
      "snippet": {
        "title": "Playing soccer",
        "description": "We play soccer in the park on Sundays.",
        "defaultLanguage": "en",
        "localized": {
          "title": "Fußball spielen",
          "description": "Wir spielen Fußball im Park am Sonntag"
        }
        ...
      }
    }

    Ancak hl parametresi fr olarak ayarlanırsa snippet.localized nesnesi İngilizce başlığı ve açıklamayı içerir. Bunun nedeni, İngilizcenin kaynak için varsayılan dil olması ve yerelleştirilmiş Fransızca ayrıntıların bulunmamasıdır.

    Önemli: hl parametresi yalnızca YouTube web sitesinin desteklediği uygulama dillerini tanımlayan değerleri destekler. Yerelleştirilmiş metnin diğer dillerde mevcut olup olmadığını belirlemek için kaynağın localizations bölümünü almanız ve yerelleştirilmiş metnin mevcut olup olmadığını belirlemek için filtrelemeniz gerekir.
    
    Örneğin, yerelleştirilmiş metnin Appalachian İngilizcesi'nde mevcut olup olmadığını belirlemek için yerelleştirmelerin tam listesini almanız gerekir.
    
    

  • Bir kaynak alınırken, bu kaynağın yerelleştirilmiş tüm ayrıntılarını almak için localizations değerini part parametre değerine ekleyin. Mevcut YouTube uygulama dili olmayan bir dil için yerelleştirilmiş verileri alıyorsanız tüm yerelleştirmeleri almak üzere bu yaklaşımı kullanmanız ve ardından istenen yerelleştirilmiş verilerin mevcut olup olmadığını belirlemek için filtre uygulamanız gerekir.

• Yerelleştirilmiş metin değerleriyle ilgili hatalar

  API, yerelleştirilmiş metin değerleri için aşağıdaki yeni hataları da destekler:

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest (400)	defaultLanguageNotSetError	Bu hata, bir kaynak için localizations nesnesini eklemeye veya güncellemeye çalışan bir isteğin, söz konusu kaynak için snippet.defaultLanguage özelliği ayarlanmadığından başarısız olduğunu gösterir. channels.update, channelSections.insert, channelSections.update, playlists.insert, playlists.update, videos.insert ve videos.update yöntemleri bu hatayı destekler.
  badRequest (400)	localizationValidationError	Bu hata, bir kaynağın localizations nesnesindeki değerlerden birinin doğrulanamadığını gösterir. Örneğin, nesne geçersiz bir dil kodu içeriyorsa bu hata oluşabilir. channels.update, channelSections.insert, channelSections.update, playlists.insert ve playlists.update yöntemleri bu hatayı destekler.

4 Kasım 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Mevcut kaynaklar ve yöntemlerdeki güncellemeler

  • search.list yönteminin order parametresi, canlı yayınları viewCount ile sıralarsanız API sonuçlarının, yayınlar devam ederken eşzamanlı izleyici sayısına göre sıralandığını belirtecek şekilde güncellendi.

  • search.list yönteminin relatedToVideoId parametresi, parametre ayarlanırsa desteklenen diğer tek parametrenin part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (video olarak ayarlanmalıdır) ve fields olduğu belirtilecek şekilde güncellendi. Bu güncelleme, API davranışında bir değişikliği yansıtmaz.

  • video Kaynağın snippet.publishedAt özelliğiyle ilgili tanım, videonun yayınlandığı tarih ve saati belirten özellik değerinin, videonun yüklendiği saatten farklı olabileceğini belirtecek şekilde güncellendi. Örneğin, bir video gizli olarak yüklenip daha sonra herkese açık hale getirilirse mülk değeri, videonun herkese açık hale getirildiği zamanı belirtir. Güncellenen tanımda, gizli ve liste dışı videolar için değerin nasıl doldurulduğu da açıklanmaktadır.

    Bu değişiklik, API davranışında bir değişikliği yansıtmaz.

  • video kaynağının status.publishAt özelliğinin tanımı, aşağıdakileri belirtecek şekilde güncellendi:

    • videos.update yöntemini çağırırken bu özelliğin değerini ayarlarsanız video zaten gizli olsa bile status.privacyStatus özelliğinin değerini de private olarak ayarlamanız gerekir.
    • İstek, bir videonun geçmişte bir zamanda yayınlanmasını planlıyorsa video hemen yayınlanır. Bu nedenle, status.publishAt özelliğini geçmiş bir tarih ve saate ayarlamanın etkisi, videonun privacyStatus özelliğini private'den public'e değiştirmekle aynıdır.

  • video kaynağının contentDetails.contentRating.cncRating özelliği, videonun Fransa'daki Commission de classification cinematographique'den aldığı derecelendirmeyi belirtir. Bu özellik, desteği sonlandırılan contentDetails.contentRating.fmocRating özelliğinin yerini almıştır.

  • channel kaynağının brandingSettings.channel.keywords tanımı, özellik değerinin daha önce belgelendiği gibi virgülle ayrılmış bir liste değil, boşlukla ayrılmış bir dizeler listesi içerdiğini doğru şekilde yansıtacak şekilde güncellendi. Bu güncelleme, API davranışında bir değişikliği yansıtmaz.

  • thumbnails.set yöntemiyle ilgili doküman, isteğin gövdesinin, yüklediğiniz ve bir videoyla ilişkilendirdiğiniz küçük resim görüntüsünü içerdiğini doğru şekilde yansıtacak şekilde güncellendi. İstek gövdesi thumbnail kaynağı içermiyor. Daha önce dokümanlarda bu yöntem çağrılırken istek gövdesi sağlanmaması gerektiği belirtiliyordu. Bu güncelleme, API davranışında bir değişikliği yansıtmaz.

  • activity kaynağının açıklaması, activities.list yönteminin şu anda yeni video yorumlarıyla ilgili kaynakları içermediğini yansıtacak şekilde güncellendi. Kaynağın snippet.type ve contentDetails.comment özellikleri de güncellendi.

• Yeni ve güncellenmiş hatalar

  • API artık aşağıdaki hataları desteklemektedir:

    Hata ayrıntıları
    activities.insert	HTTP Yanıt Kodu badRequest (400) Neden invalidMetadata Açıklama kind mülkü, sağlanan kimlik türüyle eşleşmiyor.
    commentThreads.update comments.insert comments.update	HTTP Yanıt Kodu badRequest (400) Neden commentTextTooLong Açıklama Eklenen veya güncellenen comment kaynağının snippet.topLevelComment.snippet.textOriginal özelliğinde çok fazla karakter var.
    playlistItems.insert playlistItems.update	HTTP Yanıt Kodu forbidden (403) Neden playlistItemsNotAccessible Açıklama İstek, belirtilen oynatma listesi öğesini eklemek, güncellemek veya silmek için uygun şekilde yetkilendirilmemiş.
    playlists.delete playlists.insert playlists.update	HTTP Yanıt Kodu badRequest (400) Neden playlistForbidden Açıklama Bu işlem yasaktır veya istek düzgün şekilde yetkilendirilmemiştir.
    search.list	HTTP Yanıt Kodu badRequest (400) Neden invalidLocation Açıklama location ve/veya locationRadius parametre değeri yanlış biçimlendirilmiş.
    search.list	HTTP Yanıt Kodu badRequest (400) Neden invalidRelevanceLanguage Açıklama relevanceLanguage parametre değeri yanlış biçimlendirilmiş.
    subscriptions.insert	HTTP Yanıt Kodu badRequest (400) Neden subscriptionForbidden Açıklama Bu hata, aşağıdaki durumlardan herhangi biri geçerli olduğunda ortaya çıkar: Oluşturmaya çalıştığınız abonelik zaten mevcut Maksimum abonelik sayısına ulaştınız Kendi kanalınıza abone olmaya çalışıyorsunuz. Bu işlem desteklenmez. Kısa süre önce çok fazla abonelik oluşturdunuz. İsteği yeniden denemeden önce birkaç saat beklemeniz gerekiyor.
    videos.update	HTTP Yanıt Kodu badRequest (400) Neden invalidDefaultBroadcastPrivacySetting Açıklama İstek, varsayılan yayın için geçersiz bir gizlilik ayarı belirlemeye çalışıyor.

28 Ağustos 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Mevcut kaynaklar ve yöntemlerdeki güncellemeler

  • video kaynağının statistics.favoriteCount özelliğinin desteği sonlandırıldı.

    Kullanımdan kaldırma politikamız uyarınca bu özellik, bu duyurudan sonra en az bir yıl boyunca video kaynaklarına dahil edilmeye devam edecektir. Ancak mülk değeri artık her zaman 0 olarak ayarlanır.

7 Ağustos 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Mevcut kaynaklar ve yöntemlerdeki güncellemeler

  • video Kaynağın snippet.tags[] özelliğiyle ilgili tanım, API sunucusunun özelliğin değerinin uzunluğunu nasıl hesapladığı hakkında daha fazla bilgi verecek şekilde güncellendi. Bu güncellemenin API'nin davranışında bir değişikliği yansıtmadığını unutmayın.

    Tanımda artık, bir etiket boşluk içeriyorsa API sunucusunun etiket değerini tırnak işaretleri içine alınmış gibi işlediği ve tırnak işaretlerinin karakter sınırına dahil edildiği açıklanıyor. Bu nedenle, karakter sınırları açısından Foo-Baz etiketi yedi karakter, Foo Baz etiketi ise dokuz karakter içerir.

  • commentThreads.insert yöntemi artık, daha önce bir yorumun ve bu yoruma verilen yanıtların yazarın Google+ profilinde de yayınlanıp yayınlanmayacağını belirten shareOnGooglePlus parametresini desteklemiyor. Bir istek parametreyi gönderirse API sunucusu parametreyi yok sayar ancak isteği başka şekilde işler.

18 Haziran 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Mevcut kaynaklar ve yöntemlerdeki güncellemeler

  • commentThreads.list yönteminin yeni order parametresi, API yanıtının yorum dizilerini hangi sırayla listeleyeceğini belirtir. İş parçacıkları zamana veya alaka düzeyine göre sıralanabilir. Varsayılan davranış, bunları zamana göre sıralamaktır.

  • video kaynağının yeni snippet.defaultAudioLanguage özelliği, videonun varsayılan ses parçasında konuşulan dili belirtir.

  • video Kaynağın contentDetails.licensedContent özelliğiyle ilgili tanım, içeriğin ilk olarak bir YouTube içerik iş ortağına bağlı bir kanala yüklenmesi ve ardından bu iş ortağı tarafından hak talebinde bulunulması gerektiğini netleştirmek için güncellendi. Bu durum, gerçek API davranışında bir değişikliği temsil etmez.

  • captions.delete, captions.download, captions.insert, captions.list ve captions.update yöntemleri artık onBehalfOfContentOwner parametresini destekliyor. Bu parametre, diğer birçok yöntemde zaten destekleniyordu. Bu yöntemin kullanıldığı isteklerin de https://www.googleapis.com/auth/youtubepartner kapsamına erişim sağlayan bir jetonla yetkilendirilmesi gerekir.

• Yeni ve güncellenmiş hatalar

  • API artık aşağıdaki hataları desteklemektedir:

    Hata ayrıntıları
    videos.rate	HTTP Yanıt Kodu badRequest (400) Neden emailNotVerified Açıklama Kullanıcı, videoyu derecelendirmeden önce e-posta adresini doğrulamalıdır.
    videos.rate	HTTP Yanıt Kodu badRequest (400) Neden videoPurchaseRequired Açıklama Kiralık videolar yalnızca kiralayan kullanıcılar tarafından derecelendirilebilir.

  • subscriptions.delete ve subscriptions.insert yöntemleri artık accountClosed ve accountSuspended hatalarını desteklemiyor.

27 Nisan 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni kaynaklar ve yöntemler

  • Yeni videoAbuseReportReason kaynağında, bir videonun kötüye kullanım amaçlı içerik barındırdığı için işaretlenmesinin nedenleri hakkında bilgi yer alıyor. videoAbuseReportReasons.list yöntemi, videoların işaretlenmesinin olası tüm nedenlerinin listesini almanızı sağlar.

  • Yeni videos.reportAbuse yöntemi, taciz edici içerik barındıran videoları işaretlemenin bir yolunu sunar. İsteğin gövdesinde, işaretlenen videoyu ve videonun kötüye kullanım amaçlı içerik barındırdığına dair gerekçeyi belirten bir JSON nesnesi bulunur. Geçerli nedenler, yukarıda açıklanan videoAbuseReportReason.list yönteminden elde edilebilir.

    Taşıma kılavuzu da taciz edici videoları bildirme örneğiyle güncellendi. Bu değişiklikle birlikte v3 API, desteklemesi planlanan tüm v2 API özelliklerini desteklemektedir. Bu özelliklerin tümü taşıma kılavuzunda da açıklanmaktadır.

• Mevcut kaynaklar ve yöntemlerdeki güncellemeler

  • search.list yönteminin yeni forDeveloper filtre parametresi, bir aramanın yalnızca geliştiricinin uygulaması veya web sitesi üzerinden yüklenen videoları almasını sağlar. forDeveloper parametresi, q parametresi gibi isteğe bağlı arama parametreleriyle birlikte kullanılabilir.

    Bu özellik için yüklenen her video, Google Developers Console'da geliştiricinin uygulamasıyla ilişkili proje numarasıyla otomatik olarak etiketlenir.

    Bir arama isteği daha sonra forDeveloper parametresini true olarak ayarladığında API sunucusu, geliştiriciyi tanımlamak için isteğin yetkilendirme kimlik bilgilerini kullanır. Bu nedenle, bir geliştirici sonuçları yalnızca kendi uygulaması veya web sitesi üzerinden yüklenen videolarla kısıtlayabilir ancak diğer uygulamalar veya siteler üzerinden yüklenen videolarla kısıtlayamaz.

    Yeni özellik, v2 API'nin desteklediği geliştirici etiketleri işlevine benzer ancak aynı olmayan bir işlev sunar.

  • channel kaynağının yeni snippet.country özelliği, kanal sahiplerinin kanallarını belirli bir ülkeyle ilişkilendirmesine olanak tanır.

    Not: Bir channel kaynağı için snippet.country özelliğini ayarlamak üzere brandingSettings.channel.country özelliğini güncellemeniz gerekir.

  • API artık channelSection kaynakları için hedeflemeyi destekliyor. Kanal bölümü hedefleme, bir içerik bölümünün görünürlüğünü belirli ölçütlere uyan kullanıcılarla sınırlamanın bir yolunu sunar.

    API üç hedefleme seçeneği sunar. Bir kullanıcının görünür olması için kanal bölümünün tüm hedefleme ayarlarını karşılaması gerekir.

    • targeting.languages[]: YouTube uygulama dillerinin listesi. Bu dillerden birini seçen kullanıcılar, ilgili kanal bölümünü görebilir.

    • targeting.regions[]: YouTube'da tercih edilen içerik bölgelerinin listesi. Kanal bölümü, bu bölgelerden birini seçen kullanıcıların yanı sıra bu bölgelerden biri otomatik olarak seçilen kullanıcılara da gösterilir.

    • targeting.countries[]: Kanal bölümünün göründüğü ülkelerin listesi. Listedeki her değer bir ISO 3166-1 alfa-2 ülke kodudur.

  • video kaynağının contentDetails.duration özelliğinin tanımı, değerin saatleri, günleri vb. yansıtabileceğini belirtecek şekilde düzeltildi.

  • channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete ve videos.delete yöntemleriyle ilgili dokümanlar, başarılı olduklarında bu yöntemlerin tümünün bir HTTP 204 yanıt kodu (No Content) döndürdüğünü yansıtacak şekilde düzeltildi.

• Yeni ve güncellenmiş hatalar

  • API artık aşağıdaki hataları desteklemektedir:

    Hata türü	Hata ayrıntısı	Açıklama
    badRequest (400)	targetInvalidCountry	channelSections.insert ve channelSections.update yöntemleri, eklenen channelSection kaynağı targeting.countries[] özelliği için geçersiz bir değer içeriyorsa bu hatayı döndürür.
    badRequest (400)	targetInvalidLanguage	channelSections.insert ve channelSections.update yöntemleri, eklenen channelSection kaynağı targeting.languages[] özelliği için geçersiz bir değer içeriyorsa bu hatayı döndürür.
    badRequest (400)	targetInvalidRegion	channelSections.insert ve channelSections.update yöntemleri, eklenen channelSection kaynağı targeting.regions[] özelliği için geçersiz bir değer içeriyorsa bu hatayı döndürür.
    badRequest (400)	operationNotSupported	API kullanıcısı, snippet.parentId özelliğiyle tanımlanan üst düzey yoruma yanıt olarak yorum ekleyemiyorsa comments.insert yöntemi bu hatayı döndürür. commentThread kaynağında, snippet.canReply özelliği, mevcut izleyicinin ileti dizisine yanıt verip veremeyeceğini belirtir.
    badRequest (400)	invalidChannelId	İstekteki channelId parametresi geçersiz bir kanal kimliği belirtiyorsa search.list yöntemi bu hatayı döndürür.
    badRequest (400)	subscriptionForbidden	API kullanıcısı kendi kanalına abone olmaya çalışırsa subscriptions.insert yöntemi bu hatayı döndürür.

  • captions.update yöntemi artık invalidMetadata ve videoNotFound hatalarını desteklemiyor.

16 Nisan 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Taşıma rehberi, yorum işlevini kullanmaya devam eden uygulamaların v2 API'den nasıl taşınacağını açıklayacak şekilde güncellendi.

  Kılavuzda, v2 API'nin desteklemediği ancak v3 API'de desteklenen çeşitli yorum özellikleri de belirtilmektedir. Bunlardan bazıları:

  • Bir kanalla ilgili yorumları alma
  • Bir kanalla ilgili tüm yorum dizilerini alma. Bu, API yanıtının kanal veya videolarından herhangi biriyle ilgili yorumlar içerebileceği anlamına gelir.
  • Yorum metnini güncelleme
  • Yorumları spam olarak işaretleme
  • Yorumun denetleme durumunu ayarlama

• Push bildirimlerine abone olma kılavuzu, bildirimlerin yalnızca Google PubSubHubBub hub'ına gönderildiği ve daha önce belirtildiği gibi Superfeedr hub'ına da gönderilmediği gerçeğini yansıtacak şekilde güncellendi.

9 Nisan 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• API'nin yeni commentThread ve comment kaynakları, yorumları almanıza, eklemenize, güncellemenize, silmenize ve denetlemenize olanak tanır.

  • commentThread kaynağı, üst düzey bir yorum ve varsa bu yoruma verilen yanıtlardan oluşan bir YouTube yorum dizisi hakkında bilgi içerir. commentThread kaynağı, bir video veya kanal hakkındaki yorumları temsil edebilir.

    En üst düzeydeki yorum ve yanıtlar aslında comment kaynağının içine yerleştirilmiş commentThread kaynaklarıdır. commentThread kaynağının bir yoruma verilen tüm yanıtları içermeyebileceğini ve belirli bir yoruma verilen tüm yanıtları almak istiyorsanız comments.list yöntemini kullanmanız gerektiğini unutmayın. Ayrıca bazı yorumlara yanıt verilmemiştir.

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

    • commentThreads.list – Yorum ileti dizilerinin listesini alma Belirli bir video veya kanalla ilişkili yorumları almak için bu yöntemi kullanın.
    • commentThreads.insert: Yeni bir üst düzey yorum oluşturun. (Mevcut bir yorumu yanıtlamak için comments.insert yöntemini kullanın.)
    • commentThreads.update – Üst düzey yorumu değiştirme

  • comment kaynağı, tek bir YouTube yorumuyla ilgili bilgiler içerir. comment kaynağı, bir video veya kanal hakkındaki yorumu temsil edebilir. Ayrıca yorum, üst düzey bir yorum veya üst düzey bir yoruma verilen yanıt olabilir.

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

    • comments.list: Yorum listesini alma Belirli bir yoruma verilen tüm yanıtları almak için bu yöntemi kullanın.
    • comments.insert – Mevcut bir yoruma yanıt oluşturma
    • comments.update: Yorumu değiştirme
    • comments.markAsSpam: Bir veya daha fazla yorumu spam olarak işaretleyin.
    • comments.setModerationStatus: Bir veya daha fazla yorumun denetleme durumunu ayarlayın. Örneğin, bir yorumu herkese açık olarak görüntülenmek üzere onaylayabilir veya görüntülenmeye uygun olmadığı için reddedebilirsiniz. API isteği, yorumlarla ilişkili kanalın veya videonun sahibi tarafından yetkilendirilmelidir.
    • comments.delete – Yorum silme

  2 Nisan 2015 tarihli revizyon geçmişinde açıklanan API'nin yeni https://www.googleapis.com/auth/youtube.force-ssl kapsamının, comments.insert, comments.update, comments.markAsSpam, comments.setModerationStatus, comments.delete, commentThreads.insert ve commentThreads.update yöntemlerine yapılan çağrılar için gerekli olduğunu unutmayın.

• Yeni Anlık bildirimlere abone olma kılavuzunda, API'nin web'de erişilebilen kaynaklar için sunucudan sunucuya yayınlama/abone olma protokolü olan PubSubHubBub üzerinden anlık bildirimlere yönelik yeni desteği açıklanmaktadır. PubSubHubBub geri çağırma sunucunuz, bir kanal aşağıdaki etkinliklerden herhangi birini gerçekleştirdiğinde Atom feed bildirimleri alabilir:

  • video yükleme
  • Videonun başlığını günceller
  • Videonun açıklamasını günceller.

• Taşıma kılavuzu da push bildirimleri için yeni destekle ilgili bilgileri içerecek şekilde güncellendi. Ancak v2 API, v3 API'de desteklenmeyen çok sayıda başka push bildirimi türünü desteklediğinden PubSubHubBub desteğinden bahsedilmesi, bu kılavuzun Desteği Sonlandırılanlar bölümünde yer almaya devam etmektedir.

• API'nin yeni https://www.googleapis.com/auth/youtube.force-ssl kapsamı artık daha önce https://www.googleapis.com/auth/youtube kapsamını destekleyen tüm API yöntemleri için geçerli bir kapsamdır.

• API artık aşağıdaki hataları desteklemektedir:

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest (400)	invalidRating	İstek, rating parametresi için beklenmeyen bir değer içeriyorsa videos.rate yöntemi bu hatayı döndürür.

• subscriptions.insert yöntemi artık, daha önce istekte tanımlanan abonenin abonelik oranı sınırını aştığını belirten subscriptionLimitExceeded hatasını desteklemiyor.

2 Nisan 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni captions kaynağı, YouTube altyazı parçasını temsil eder. Altyazı parçası tam olarak bir YouTube videosuyla ilişkilendirilir.

  API, altyazı parçalarını listelemek, eklemek, güncellemek, indirmek ve silmek için yöntemleri destekler.

• Taşıma rehberi, v2 API'de altyazı işlevini kullanmaya devam eden uygulamaların nasıl taşınacağını açıklayacak şekilde güncellendi.

• API'nin yeni https://www.googleapis.com/auth/youtube.force-ssl kapsamı, API sunucusuyla iletişimin SSL bağlantısı üzerinden yapılmasını gerektirir.

  Bu yeni kapsam, https://www.googleapis.com/auth/youtube kapsamıyla aynı erişimi sağlar. Aslında, YouTube API sunucusu yalnızca bir HTTPS uç noktası üzerinden kullanılabildiğinden bu iki kapsam işlevsel olarak aynıdır. Bu nedenle, https://www.googleapis.com/auth/youtube kapsamı SSL bağlantısı gerektirmese de aslında API isteği göndermenin başka bir yolu yoktur.

  Yeni kapsam, caption kaynağının tüm yöntemlerine yapılan çağrılar için gereklidir.

11 Mart 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• YouTube Data API (v3) taşıma rehberinde, v3 API'nin desteklediği ve v2 API'nin desteklemediği özellikleri listeleyen v3 API'deki yenilikler adlı yeni bir sekme bulunur. Aynı özellikler daha önce ve hâlâ kılavuzdaki diğer sekmelerde listelenmektedir. Örneğin, bir kanalın video içi tanıtım kampanyası verilerinin nasıl güncelleneceğini açıklayan yeni özellik de Kanallar (profiller) sekmesinde listelenir.

• YouTube Data API (v3) taşıma kılavuzu, v3 API'nin aşağıdaki v2 API özelliğini destekleyeceğini belirtecek şekilde güncellendi:

  • Video işaretleme

• YouTube Data API (v3) taşıma rehberi, aşağıdaki v2 API özelliklerinin v3 API'de desteklenmeyeceğini belirtecek şekilde güncellendi:

  • Video önerilerini alma: v3 API, yalnızca mevcut API kullanıcısına önerilen videoları içeren bir liste almaz. Ancak, activities.list yöntemini çağırıp home parametre değerini true olarak ayarlayarak önerilen videoları bulmak için v3 API'yi kullanabilirsiniz.

    API yanıtında, snippet.type özelliğinin değeri recommendation ise bir kaynak, önerilen videoya karşılık gelir. Bu durumda, contentDetails.recommendation.reason ve contentDetails.recommendation.seedResourceId özellikleri, videonun neden önerildiğiyle ilgili bilgileri içerir. Yanıtın belirli sayıda önerilen video içereceğinin garanti edilmediğini unutmayın.

  • Kanal önerilerini alma

  • Yeni abonelik videolarını alma: v3 API, yalnızca API kullanıcısının abone olduğu kanallara yakın zamanda yüklenen videoları içeren bir liste almaz. Ancak, activities.list yöntemini çağırıp home parametre değerini true olarak ayarlayarak yeni abonelik videolarını bulmak için v3 API'yi kullanabilirsiniz.

    API yanıtında, snippet.type özelliğinin değeri upload ise kaynak yeni bir abonelik videosuna karşılık gelir. Yanıtın belirli sayıda yeni abonelik videosu içereceğinin garanti edilmediğini unutmayın.

  • RSS özet akışı desteği

  • Feed güncellemeleri için push bildirimleri: v2 API, YouTube kullanıcılarının kullanıcı etkinliği feed'lerini izlemek için Basit Güncelleme Protokolü (SUP) veya PubSubHubbub'ı kullanarak push bildirimlerini destekliyordu. Yeni kanal abonelikleri ve videolar değerlendirildiğinde, paylaşıldığında, favorilere eklendiğinde, yorum yapıldığında veya yüklendiğinde bildirimler gönderiliyordu.

    v3 API'si, PubSubHubbub protokolünü kullanarak push bildirimlerini destekleyecek ancak bildirimler yalnızca video yüklemelerini ve video başlıklarında ya da video açıklamalarında yapılan güncellemeleri kapsayacak.

  • Kanal konumu: v2 API, kullanıcının konumunu kanalın YouTube herkese açık profilinde girildiği şekilde tanımlamak için <yt:location> etiketini kullanıyordu. Bazı geliştiriciler bu alanı bir kanalı belirli bir ülkeyle ilişkilendirmek için kullanmış olsa da alanın verileri bu amaçla tutarlı bir şekilde kullanılamıyordu.

  • Geliştirici etiketlerini ayarlama veya alma: v2 API, video yüklendiği sırada anahtar kelimelerin veya geliştirici etiketlerinin bir videoyla ilişkilendirilmesini destekliyordu. Geliştirici etiketleri YouTube kullanıcılarına gösterilmez ancak video sahipleri, belirli bir geliştirici etiketiyle eşleşen videoları alabilir.

    v3 API, benzer ancak aynı olmayan bir özellik sunacaktır. Özellikle, geliştiriciler kendi uygulamaları tarafından yüklenen videoları arayabilir. Bu özellik için yüklenen her video, Google Developers Console'da geliştiricinin uygulamasıyla ilişkili proje numarasıyla otomatik olarak etiketlenir. Geliştirici daha sonra videoları aramak için aynı proje numarasını kullanır.

  • Videoları yayınlanma tarihine, görüntüleme sayısına veya derecelendirmeye göre listeleme: 2. sürüm API'sinde orderby parametresi, oynatma listesindeki videoları konuma, süreye, yayınlanma tarihine, başlığa ve diğer çeşitli değerlere göre sıralamanıza olanak tanıyordu. v3 API'sinde oynatma listesi öğeleri genellikle konumlarına göre artan sırada sıralanır ve başka sıralama seçenekleri kullanılamaz.

    Bu kuralın birkaç istisnası vardır. Yeni yüklenen, favori, beğenilen veya son izlenen videolar, aşağıdaki oynatma listesi türlerinde otomatik olarak ilk öğe (snippet.position=0) olarak eklenir. Bu nedenle, bu listelerin her biri, öğelerin listeye eklendiği zamanlara göre en yeni öğeden en eski öğeye doğru sıralanır.

    • kullanıcı yüklemeleri
    • favori videolar
    • beğendiği videolar
    • izleme geçmişi

    Ancak "Daha sonra izle" oynatma listesine eklenen yeni öğeler, listenin sonuna eklenir. Bu nedenle, liste en eski öğeden en yeni öğeye doğru sıralanır.

  • Toplu işleme: v3 API, v2 API'nin desteklediği toplu işleme kullanım alanlarından birini destekler. v3 API'sindeki channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list ve videos.list yöntemlerinin tümü, virgülle ayrılmış bir kimlik listesi (video kimlikleri, kanal kimlikleri vb.) belirtmek için kullanılabilecek bir id parametresini destekler. Bu yöntemleri kullanarak tek bir istekle birden fazla kaynağın listesini alabilirsiniz.

  Bu değişikliklerle birlikte kılavuz artık eski (v2) API'de desteklenen ve mevcut API sürümünde (v3) desteği sonlandırılacak tüm işlevleri tanımlıyor.

4 Mart 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channelSections.delete ve channelSections.update yöntemleri artık diğer birçok yöntemde zaten desteklenen onBehalfOfContentOwner parametresini destekliyor.

• Aşağıdaki özelliklerin ve alt özelliklerinin desteği sonlandırıldı:

  • brandingSettings.image.backgroundImageUrl
  • brandingSettings.image.largeBrandedBannerImageImapScript
  • brandingSettings.image.largeBrandedBannerImageUrl
  • brandingSettings.image.smallBrandedBannerImageImapScript
  • brandingSettings.image.smallBrandedBannerImageUrl

  Not: Bu özelliklerin hiçbiri API desteğinin sonlandırılması politikasına tabi olmamıştır.

• video kaynağının yeni contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons özelliği, videonun DJCQT (Brezilya) derecelendirmesini neden aldığını açıklayan nedenleri tanımlar.

• API artık aşağıdaki hataları desteklemektedir:

  Hata türü	Hata ayrıntısı	Açıklama
  notFound (404)	channelNotFound	İsteğin id parametresi bulunamayan bir kanal belirtiyorsa channels.update yöntemi bu hatayı döndürür.
  badRequest (400)	manualSortRequiredinvalidValue	İstek, oynatma listesi öğesinin konumunu ayarlamaya çalışırsa ancak oynatma listesinde manuel sıralama kullanılmıyorsa playlistItems.insert ve playlistItems.update yöntemleri bu hatayı döndürür. Örneğin, oynatma listesi öğeleri tarihe veya popülerliğe göre sıralanabilir. İstek gövdesinde gönderilen kaynaktan snippet.position öğesini kaldırarak bu hatayı düzeltebilirsiniz. Oynatma listesi öğesinin listede belirli bir konumda olmasını istiyorsanız önce oynatma listesinin sıralama ayarını Manuel olarak güncellemeniz gerekir. Bu ayar, YouTube Video Yöneticisi'nde düzenlenebilir.
  forbidden (403)	channelClosed	İsteğin channelId parametresi kapatılmış bir kanalı belirtiyorsa playlists.list yöntemi bu hatayı döndürür.
  forbidden (403)	channelSuspended	İsteğin channelId parametresi, askıya alınmış bir kanalı belirtiyorsa playlists.list yöntemi bu hatayı döndürür.
  forbidden (403)	playlistForbidden	İsteğin playlists.list parametresi isteği desteklemiyorsa veya istek düzgün şekilde yetkilendirilmemişse id yöntemi bu hatayı döndürür.
  notFound (404)	channelNotFound	İsteğin channelId parametresi bulunamayan bir kanal belirtiyorsa playlists.list yöntemi bu hatayı döndürür.
  notFound (404)	playlistNotFound	İsteğin id parametresi bulunamayan bir oynatma listesini belirtiyorsa playlists.list yöntemi bu hatayı döndürür.
  notFound (404)	videoNotFound	İstekle ilgili videos.list parametresi bulunamayan bir videoyu belirtirse id yöntemi bu hatayı döndürür.
  badRequest (400)	invalidRating	İstek, rating parametresi için beklenmeyen bir değer içeriyorsa videos.rate yöntemi bu hatayı döndürür.

2 Mart 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• search.list yöntemi artık relevanceLanguage parametresini destekliyor. Bu parametre, belirli bir dille en alakalı sonuçları istemenize olanak tanır.

  Bu yeni parametrenin nasıl kullanılacağını açıklamak için YouTube Data API (v3) taşıma rehberi de güncellendi. Bu parametre, mevcut API sürümü (v3) ile daha önce kullanımdan kaldırılmış olan önceki sürüm (v2) arasında daha önce var olan bir özellik açığını giderir.

• YouTube Data API (v3) taşıma kılavuzu da güncellenerek v2 API'nin filmleri, fragmanları, televizyon programlarını, televizyon sezonlarını ve televizyon bölümlerini açıklamak için sağladığı özel feed'lerin ve meta veri alanlarının desteğinin sonlandırıldığı belirtildi.

14 Ocak 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• YouTube Data API (v3) taşıma kılavuzu, JavaScript kullanarak video yüklemek için v3 API'nin nasıl kullanılacağını açıklayacak şekilde güncellendi. (Ayrıntılar için Video yükleme bölümüne bakın.) Bu işlev, v2 API'nin desteklediği tarayıcı tabanlı yükleme işleviyle karşılaştırılabilir. Taşıma rehberindeki bu değişikliğin gerçek bir API değişikliğini değil, istemci tarafı JavaScript ile video yüklemeye yönelik yeni örnek kodun kullanıma sunulmasını yansıttığını unutmayın.

  JavaScript istemci kitaplığı ve CORS ile video yükleme desteği sunulduğundan, taşıma kılavuzunda artık tarayıcı tabanlı yükleme, v3 API'de desteği sonlandırılacak bir özellik olarak listelenmiyor.

• videos.insert yöntemiyle ilgili doküman, yukarıda açıklanan yeni JavaScript kodu örneğini içerecek şekilde güncellendi. YouTube Data API (v3) için JavaScript kod örnekleri listesi de güncellendi.

11 Kasım 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• search.list yöntemine yapılan bir çağrının kota maliyeti 100 birim olarak değiştirildi.

  Önemli: Çoğu durumda, bilgileri daha düşük kota maliyetiyle almak için diğer API yöntemlerini kullanabilirsiniz. Örneğin, GoogleDevelopers kanalına yüklenen videoları bulmak için aşağıdaki iki yöntemi kullanabilirsiniz.

  • Kota maliyeti: 100 birim

    search.list yöntemini çağırın ve GoogleDevelopers için arama yapın.

  • Kota maliyeti: 6 birim

    Doğru kanal kimliğini bulmak için channels.list yöntemini çağırın. forUsername parametresini GoogleDevelopers, part parametresini ise contentDetails olarak ayarlayın. API yanıtında, contentDetails.relatedPlaylists.uploads özelliği kanalın yüklenen videolarının oynatma listesi kimliğini belirtir.

    Ardından playlistItems.list yöntemini çağırın ve playlistId parametresini yakalanan kimliğe, part parametresini ise snippet olarak ayarlayın.

8 Ekim 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channel kaynağı iki yeni özellik içerir:

  • status.longUploadsStatus özelliği, kanalı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. Geçerli özellik değerleri şunlardır:

    • allowed – Kanal, 15 dakikadan uzun videolar yükleyebilir.
    • eligible – Kanal, 15 dakikadan uzun videolar yüklemeye uygundur ancak bu özelliği etkinleştirmesi gerekir.
    • disallowed – Kanal, 15 dakikadan uzun videolar yükleyemiyor veya yüklemeye uygun değil.

    Bu değerler hakkında daha fazla bilgi için mülk tanımına bakın. Bu özellik hakkında daha ayrıntılı bilgiyi YouTube Yardım Merkezi'nde bulabilirsiniz.

  • invideoPromotion.useSmartTiming özelliği, kanalın tanıtım kampanyasında "akıllı zamanlama" kullanılıp kullanılmadığını gösterir. Bu özellik, promosyonları videonun tıklanma olasılığının daha yüksek olduğu ve izleme deneyimini kesintiye uğratma olasılığının daha düşük olduğu bir noktada göstermeye çalışır. Bu özellik, her videoda gösterilecek tek bir tanıtım da seçer.

• video kaynağının snippet.title ve snippet.categoryId özelliklerinin tanımları, API'nin videos.update yöntemine yapılan çağrıları nasıl işlediğini netleştirmek için güncellendi. Bir video kaynağının snippet bölümünü güncellemek için bu yöntemi çağırırsanız bu özelliklerin her ikisi için de bir değer ayarlamanız gerekir.

  Bir video kaynağının snippet bölümünü güncellemeye çalışır ve bu özelliklerin her ikisi için de değer ayarlamazsanız API, invalidRequest hatası döndürür. Bu hatanın açıklaması da güncellendi.

• Yeni Zelanda'daki Film ve Edebiyat Sınıflandırma Kurumu'nun bir videoya verdiği derecelendirmeyi tanımlayan video kaynağının contentDetails.contentRating.oflcRating özelliği artık iki yeni derecelendirmeyi (oflcRp13 ve oflcRp16) destekliyor. Bunlar sırasıyla RP13 ve RP16 derecelendirmelerine karşılık gelir.

• channelBanners.insert yöntemi artık aşağıdaki hatayı desteklemektedir:

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest	bannerAlbumFull	Kanal sahibinin YouTube kanal resmi albümünde çok fazla resim var. Kanal sahibi http://photos.google.com adresine gidip albümler sayfasına yönlendirilmeli ve bu albümdeki bazı resimleri kaldırmalıdır.

12 Eylül 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• search.list yöntemine yapılan bir çağrının kota maliyeti, belirtilen kaynak bölümlerinin maliyetine ek olarak 1 birimden 2 birime yükseldi.

13 Ağustos 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• subscriptions.insert yöntemi artık aşağıdaki hatayı desteklemektedir:

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest	subscriptionLimitExceeded	İstekle tanımlanan abone, abonelik oranı sınırını aşmıştır. Birkaç saat sonra daha fazla abonelik denenebilir.

12 Ağustos 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Uygulamanızı YouTube Data API'ye (v3) Taşıma başlıklı yeni kılavuzda, YouTube Data API'de (v2) bulunan işlevleri gerçekleştirmek için YouTube Data API'nin (v3) nasıl kullanılacağı açıklanmaktadır. Eski API, 4 Mart 2014 itibarıyla resmi olarak kullanımdan kaldırıldı. Bu kılavuz, v2 API'yi kullanan uygulamaları en yeni API sürümüne taşımanıza yardımcı olmayı amaçlamaktadır.

8 Temmuz 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• playlists.insert yöntemi artık aşağıdaki hatayı desteklemektedir:

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest	maxPlaylistExceeded	Bu hata, kanalda izin verilen maksimum oynatma listesi sayısına ulaşıldığı için oynatma listesi oluşturulamadığında gösterilir.

18 Haziran 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Her API yönteminin açıklaması, bu yönteme yapılan bir çağrının neden olduğu kota maliyetini içerecek şekilde güncellendi. Benzer şekilde, part parametrelerinin tanımları, bir API çağrısında alınabilecek her bölümün kota maliyetini belirtecek şekilde güncellendi. Örneğin, subscriptions.insert yöntemine yapılan bir çağrının kota maliyeti yaklaşık 50 birimdir. subscription kaynağı da üç bölümden (snippet, contentDetails ve subscriberSnippet) oluşur ve her birinin maliyeti iki birimdir.

  Kota maliyetlerinin uyarıda bulunulmaksızın değişebileceğini lütfen unutmayın.

• video kaynağı artık videoların çeşitli ulusal derecelendirme kuruluşlarından aldığı derecelendirmeleri belirleyen 43 yeni içerik derecelendirme sistemini destekliyor. Yeni desteklenen derecelendirme sistemleri Arjantin, Avusturya, Belçika, Bulgaristan, Şili (televizyon), Şili (film), Çekya, Kolombiya, Danimarka, Mısır, Estonya, Finlandiya, Fransa, Yunanistan, Hong Kong, İzlanda, Endonezya, İrlanda, İsrail, İtalya, Kenya, Letonya, Lüksemburg, Malezya, Maldivler, Malta, Hollanda, Nijerya, Norveç, Peru, Filipinler, Portekiz, Romanya, Singapur, Slovakya, Güney Afrika, İsveç, İsviçre, Tayvan, Tayland ve Venezuela'ya aittir.

28 Mayıs 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• search.list yöntemi artık location ve locationRadius parametrelerini destekliyor. Bu parametreler, coğrafi konumla ilişkili videoları aramanıza olanak tanır. Konuma dayalı sonuçlar almak için bir istekte her iki parametre için de değer belirtilmelidir. İstek yalnızca iki parametreden birini içeriyorsa API hata döndürür.

  • location parametresi, dairesel coğrafi alanın merkezindeki enlem/boylam koordinatlarını belirtir.

  • locationRadius parametresi, bir videoyla ilişkili konumun, videonun arama sonuçlarına dahil edilmeye devam etmesi için alanın merkezinden olabileceği maksimum mesafeyi belirtir.

13 Mayıs 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channel kaynağının invideoPromotion.items[] özelliği, kanalınız için genellikle yalnızca bir tanıtılan öğe ayarlayabileceğinizi belirtecek şekilde güncellendi. Çok fazla tanıtılan öğe eklemeye çalışırsanız API, HTTP 400 durum koduna sahip bir tooManyPromotedItems hatası döndürür.

• channelSection kaynağı artık öne çıkan içeriklerin birkaç yeni türü hakkında bilgi içerebilir. channelSection kaynağının snippet.type özelliği artık aşağıdaki değerleri destekliyor:

  • postedPlaylists - Kanal sahibinin kanalın etkinlik özet akışında yayınladığı oynatma listeleri
  • postedVideos - Kanal sahibinin kanalın etkinlik akışına gönderdiği videolar
  • subscriptions - Kanal sahibinin abone olduğu kanallar

• video kaynağının yeni contentDetails.contentRating.ifcoRating özelliği, bir videonun Irish Film Classification Office'ten (İrlanda Film Sınıflandırma Kurumu) aldığı derecelendirmeyi tanımlar.

• watermark Kaynağın position.cornerPosition özelliğinin tanımı, filigranın her zaman oynatıcının sağ üst köşesinde görüneceğini belirtecek şekilde güncellendi.

• search.list yöntemi için q parametresinin tanımı, sorgu teriminin belirli bir arama terimiyle ilişkili videoları hariç tutmak için Boole NOT (-) operatörünü kullanabileceğini belirtecek şekilde güncellendi. Değer, birkaç arama teriminden biriyle ilişkili videoları bulmak için Boole VEYA (|) operatörünü de kullanabilir.

• search.list çağrısına verilen API yanıtında döndürülen pageInfo.totalResults özelliğinin tanımı, değerin yaklaşık bir değer olduğunu ve tam değeri temsil etmeyebileceğini belirtecek şekilde güncellendi. Ayrıca, maksimum değer 1.000.000'dur. Bu değeri, sayfalara ayırma bağlantıları oluşturmak için kullanmamalısınız. Bunun yerine, sayfalara ayırma bağlantılarının gösterilip gösterilmeyeceğini belirlemek için nextPageToken ve prevPageToken özellik değerlerini kullanın.

• watermarks.set ve watermarks.unset yöntemleri, API'nin bu yöntemlere yapılan başarılı istekler için HTTP 204 yanıt kodu döndürdüğünü yansıtacak şekilde güncellendi.

2 Mayıs 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni i18nLanguage kaynağı, YouTube web sitesinin desteklediği bir uygulama dilini tanımlar. Uygulama dili, kullanıcı arayüzü dili olarak da adlandırılabilir. YouTube web sitesinde, Google Hesabı ayarlarına, tarayıcı diline veya IP konumuna göre otomatik olarak bir uygulama dili seçilebilir. Ayrıca kullanıcılar, YouTube sitesinin altbilgisinden istedikleri kullanıcı arayüzü dilini manuel olarak da seçebilir.

  API, desteklenen uygulama dillerini listeleme yöntemini destekler. Desteklenen diller, videoCategories.list ve guideCategories.list gibi API yöntemleri çağrılırken hl parametresinin değeri olarak kullanılabilir.

• Yeni i18nRegion kaynağı, bir YouTube kullanıcısının tercih edilen içerik bölgesi olarak seçebileceği coğrafi alanı tanımlar. İçerik bölgesi, içerik yerel ayarı olarak da adlandırılabilir. YouTube web sitesinde, YouTube alanı veya kullanıcının IP konumu gibi sezgisel yöntemlere göre içerik bölgesi otomatik olarak seçilebilir. Kullanıcılar da YouTube sitesinin altbilgisinden istedikleri içerik bölgesini manuel olarak seçebilir.

  API, desteklenen içerik bölgelerini listelemek için bir yöntemi destekler. Desteklenen bölge kodları, search.list, videos.list, activities.list ve videoCategories.list gibi API yöntemleri çağrılırken regionCode parametresinin değeri olarak kullanılabilir.

7 Nisan 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni channelSection kaynağı, bir kanalın öne çıkarmayı seçtiği bir grup videoyla ilgili bilgiler içerir. Örneğin, bir bölümde kanalın en son yüklemeleri, en popüler yüklemeleri veya bir ya da daha fazla oynatma listesindeki videolar yer alabilir.

  API, kanal bölümlerini listelemek, eklemek, güncellemek veya silmek için yöntemleri destekler. Belirli bir kanal kimliği veya benzersiz kanal bölümü kimliklerinin listesini belirterek kimliği doğrulanmış kullanıcının kanalına ait kanal bölümlerinin listesini alabilirsiniz.

  Hata dokümanları da API'nin özellikle bu yeni yöntemler için desteklediği hata mesajlarını açıklayacak şekilde güncellendi.

• video kaynağının fileDetails nesnesinin tanımı, bu nesnenin yalnızca videonun processingDetails.fileDetailsAvailability özelliği available değerine sahipse döndürüleceğini açıklayacak şekilde güncellendi.

  Benzer şekilde, video kaynağının suggestions nesnesinin tanımı, bu nesnenin yalnızca videonun processingDetails.tagSuggestionsAvailability özelliği veya processingDetails.editorSuggestionsAvailability özelliği available değerine sahipse döndürüleceğini açıklayacak şekilde güncellendi.

• videos.insert ve videos.update yöntemleriyle ilgili dokümanlar, bu yöntemler çağrıldığında status.publishAt özelliğinin ayarlanabileceğini yansıtacak şekilde güncellendi.

• channel Kaynağın invideoPromotion nesnesinin tanımı, nesnenin yalnızca kanalın sahibi tarafından alınabileceğini açıklayacak şekilde güncellendi.

• videos.rate yönteminin parametre listesi, bu yöntemin aslında onBehalfOfContentOwner parametresini desteklemediğini yansıtacak şekilde güncellendi. Bu, dokümantasyon hatasıydı. Çünkü bu parametreyi ayarlayan videos.rate istekleri 500 hatası döndürüyordu.

31 Mart 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• video kaynağının yeni status.publishAt özelliği, gizli bir videonun yayınlanmasının planlandığı tarih ve saati belirtmenize olanak tanır. Bu özellik yalnızca videonun gizlilik durumu private ise ve video daha önce hiç yayınlanmamışsa ayarlanabilir. Bu yeni mülk, kullanımdan kaldırma politikasına tabi değildir.

13 Mart 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• API artık channel kaynakları için contentOwnerDetails bölümünü destekliyor. Yeni bölümde, kanala bağlı YouTube iş ortakları için alakalı olan kanal verileri (ör. kanala bağlı içerik sahibinin kimliği, içerik sahibi ile kanalın bağlandığı tarih ve saat) yer alır. Bu yeni bölümün kullanımdan kaldırma politikasına tabi olmadığını unutmayın.

• Dokümanlarda artık aşağıdaki özellikler için desteklenen maksimum karakter uzunluğu listeleniyor:

  Kaynak	Mülk	Maksimum uzunluk
  channel	invideoPromotion.items[].customMessage	40 karakter
  video	snippet.title	100 karakter
  video	snippet.description	5.000 bayt
  video	snippet.tags	500 karakter. Özellik değerinin bir liste olduğunu ve listedeki öğeler arasındaki virgüllerin sınıra dahil edildiğini unutmayın.

• channel kaynağının brandingSettings.watch.featuredPlaylistId özelliğinin desteği sonlandırıldı. Değerini ayarlamaya çalışırsanız API hata döndürür.

• Aşağıdaki video kaynak özellikleri, bir video eklenirken veya güncellenirken ayarlanabilen değerler listesine eklendi:

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude
  • recordingDetails.recordingDate

• Hata dokümanlarında artık her hata türü için HTTP yanıt kodu belirtiliyor.

• API artık aşağıdaki hataları desteklemektedir:

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest (400)	invalidCriteria	İstek, birlikte kullanılamayan filtre parametreleri belirtiyorsa channels.list yöntemi bu hatayı döndürür.
  badRequest (400)	channelTitleUpdateForbidden	Bir kanalın channels.update bölümünü güncellemeye ve brandingSettings özelliğinin değerini değiştirmeye çalışırsanız brandingSettings.channel.title yöntemi bu hatayı döndürür. (Özelliği atlarsanız API'nin hatayı döndürmeyeceğini unutmayın.)
  badRequest (400)	invalidRecentlyUploadedBy	channels.update yöntemi, invideoPromotion.items[].id.recentlyUploadedBy özelliği geçersiz bir kanal kimliği belirtiyorsa bu hatayı döndürür.
  badRequest (400)	invalidTimingOffset	channels.update yöntemi, invideoPromotion bölümünde geçersiz bir zamanlama farkı belirtilirse bu hatayı döndürür.
  badRequest (400)	tooManyPromotedItems	channels.update yöntemi, invideoPromotion bölümünde izin verilen tanıtılan öğe sayısından fazla öğe belirtilirse bu hatayı döndürür.
  forbidden (403)	promotedVideoNotAllowed	channels.update yöntemi, invideoPromotion.items[].id.videoId özelliği bulunamayan veya tanıtılan öğe olarak kullanılamayan bir video kimliği belirtiyorsa bu hatayı döndürür.
  forbidden (403)	websiteLinkNotAllowed	channels.update yöntemi, invideoPromotion.items[].id.websiteUrl özelliği izin verilmeyen bir URL belirtirse bu hatayı döndürür.
  required (400)	requiredTimingType	Bir istekte, YouTube'un tanıtılan bir öğeyi ne zaman göstereceğine ilişkin varsayılan zamanlama ayarları belirtilmemişse channels.update yöntemi bu hatayı döndürür.
  required (400)	requiredTiming	channels.update yöntemi, tanıtılan her öğe için bir invideoPromotion.items[].timing nesnesi belirtmelidir.
  required (400)	requiredWebsiteUrl	channels.update yöntemi, tanıtılan her öğe için bir invideoPromotion.items[].id.websiteUrl özelliği belirtmelidir.
  badRequest (400)	invalidPublishAt	İstek meta verileri geçersiz bir planlanmış yayınlama zamanı belirtiyorsa videos.insert yöntemi bu hatayı döndürür.

4 Mart 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• YouTube Data API v3, artık YouTube API'leri Hizmet Şartları'nda açıklanan Destek Sonlandırma Politikası'na tabidir. Kullanımdan kaldırma politikasına tabi olan API'lerin listelendiği sayfada, v3 API işlevlerinin bir kısmının bu politikaya tabi olmadığı belirtilmektedir.

5 Aralık 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• search.list yönteminin dokümanları, arama isteği gönderirken tam olarak bir filtre parametresi için değer belirtmeniz gerekmediğini doğru şekilde yansıtacak şekilde güncellendi. Bunun yerine, sıfır filtre parametresi veya bir filtre parametresi için değer ayarlayabilirsiniz.

• search.list yönteminin parametrelerinin tanımları, aşağıdaki parametrelerden herhangi biri için de bir değer belirtirseniz type parametresinin değerini video olarak ayarlamanız gerektiğini belirtecek şekilde güncellendi:

  • eventType
  • videoCaption
  • videoCategoryId
  • videoDefinition
  • videoDimension
  • videoDuration
  • videoEmbeddable
  • videoLicense
  • videoSyndicated
  • videoType

• Yüklenen kanal banner'ı resimlerinin minimum boyutu 2048 x 1152 piksele düşürüldü. (Daha önce minimum boyut 2.120 x 1.192 pikseldi.) Ayrıca, channelkaynak dokümanlarında API'den sunulan tüm banner resimlerinin maksimum boyutlarının belirtildiğini unutmayın. Örneğin, televizyon uygulamaları için brandingSettings.image.bannerTvImageUrl resminin maksimum boyutu 2120x1192 pikseldir ancak gerçek resim 2048x1152 piksel olabilir. YouTube Yardım Merkezi, kanal resmini farklı cihaz türlerinde gösterilecek şekilde optimize etme konusunda ek bilgiler sunar.

• Aşağıdaki bilgileri yansıtmak için çeşitli channel kaynak özelliği tanımları güncellendi:

  • brandingSettings.channel.description özelliğinin değeri en fazla 1.000 karakter uzunluğunda olabilir.
  • brandingSettings.channel.featuredChannelsTitle özelliği en fazla 30 karakter uzunluğunda olabilir.
  • brandingSettings.channel.featuredChannelsUrls[] özelliği artık 100 kanala kadar listeleyebilir.
  • Ayarlanmışsa brandingSettings.channel.unsubscribedTrailer özellik değeri, kanal sahibine ait herkese açık veya liste dışı bir videonun YouTube video kimliğini belirtmelidir.

• channels.update yöntemi artık invideoPromotion.items[].promotedByContentOwner özelliğinde güncellemeleri destekliyor. Bu özellik, promosyon gösterilirken içerik sahibinin adının gösterilip gösterilmeyeceğini belirtir. Yalnızca özellik değerini ayarlayan API isteği, onBehalfOfContentOwner parametresi kullanılarak içerik sahibinin adına yapılıyorsa ayarlanabilir.

• playlistItems.list ve playlistItems.insert yöntemleri artık diğer birçok yöntemde zaten desteklenen onBehalfOfContentOwner parametresini destekliyor.

• contentDetails.contentRating.acbRating özelliği artık filmler için Australian Classification Board (ACB) veya çocuklara yönelik televizyon programları için Australian Communications and Media Authority (ACMA) tarafından verilen bir derecelendirmeyi belirtebilir.

• Yeni contentDetails.contentRating.catvRating ve contentDetails.contentRating.catvfrRating özellikleri, bir videonun sırasıyla Kanada TV Sınıflandırma Sistemi ve Québec'te kullanılan Fransızca Régie du cinéma derecelendirme sistemi kapsamında aldığı derecelendirmeleri tanımlar.

• videoCategory kaynağının yeni snippet.assignable özelliği, güncellenen videoların veya yeni yüklenen videoların bu video kategorisiyle ilişkilendirilip ilişkilendirilemeyeceğini gösterir.

• Aşağıdaki yöntemler için kod örnekleri eklendi:

  • activities.insert (Git)
  • channelBanners.insert (Python)
  • channels.update (Python)
  • playlistItems.list (Git)
  • search.list (Git)
  • thumbnails.set (Java)
  • videos.insert (Git)

24 Ekim 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• API, canlı yayın içeriklerini bulup öne çıkarmanıza yardımcı olmak için tasarlanmış iki ek özellik içerir:

  Arama sonuçlarındaki yeni snippet.liveBroadcastContent özelliği, bir video veya kanal kaynağında canlı yayın içeriği olup olmadığını gösterir. Geçerli özellik değerleri upcoming, active ve none'dir.

  • video kaynağının yeni snippet.liveBroadcastContent özelliği, videonun yaklaşan veya etkin bir canlı yayın olup olmadığını gösterir. Aşağıdaki listede, özelliğin olası değerleri açıklanmaktadır:

    • upcoming: Video, henüz başlamamış bir canlı yayındır.
    • active: Video, devam eden bir canlı yayındır.
    • none: Video, yaklaşan veya etkin bir canlı yayın değildir. Bu, YouTube'da hâlâ görüntülenebilen tamamlanmış yayınların mülk değeri olacaktır.

  • video kaynağının yeni liveStreamingDetails özelliği, canlı video yayınıyla ilgili meta verileri içeren bir nesnedir. Bu meta verileri almak için liveStreamingDetails değerini, part parametre değerinin kaynak bölümleri listesine ekleyin. Meta veriler aşağıdaki yeni özellikleri içerir:

    • liveStreamingDetails.actualStartTime: Yayının gerçekte başladığı zaman. (Bu değer, yayın durumu active olduğunda gösterilir.)
    • liveStreamingDetails.actualEndTime – Yayının gerçekte sona erdiği zaman. (Bu değer, yayın sona erdiğinde gösterilir.)
    • liveStreamingDetails.scheduledStartTime: Yayının başlamasının planlandığı zaman.
    • liveStreamingDetails.scheduledEndTime – Yayının sona ermesinin planlandığı zaman. Özellik değeri boşsa veya özellik mevcut değilse yayın süresiz olarak planlanır.
    • liveStreamingDetails.concurrentViewers: Canlı yayını izleyen kullanıcı sayısı.

    Bu meta verileri almak için videos.list, videos.insert veya videos.update yöntemi çağrılırken part parametre değerine liveStreamingDetails ekleyin.

  Canlı yayın içeriğini tanımlamaya yönelik diğer iki özelliğin 1 Ekim 2013'te kullanıma sunulduğunu hatırlatırız: search.list yönteminin eventType parametresi ve arama sonucunun snippet.liveBroadcastContent özelliği.

• videos.insert yöntemi artık, YouTube'un yeni video hakkında videonun kanalına abone olan kullanıcılara bildirim gönderip göndermeyeceğini belirten notifySubscribers parametresini destekliyor. Parametrenin varsayılan değeri True'dır. Bu değer, abonelerin yeni yüklenen videolardan haberdar edileceğini gösterir. Ancak çok sayıda video yükleyen bir kanal sahibi, kanalın abonelerine her yeni video hakkında bildirim göndermemek için değeri False olarak ayarlamayı tercih edebilir.

• channels.update yöntemi çağrıldığında değiştirilebilen özellikler listesi, invideoPromotion.items[].customMessage ve invideoPromotion.items[].websiteUrl özelliklerini içerecek şekilde güncellendi. Ayrıca, değiştirilebilir brandingSettings özelliklerini belirlemek için liste değiştirildi. Bu brandingSettings özellikleri zaten değiştirilebiliyordu. Bu nedenle, dokümanda yapılan değişiklik, API'nin mevcut işlevinde bir değişikliği yansıtmaz.

• playlists.insert, playlists.update ve playlists.delete yöntemleri artık onBehalfOfContentOwner parametresini destekliyor. Bu parametre, diğer birçok yöntemde zaten destekleniyordu.

• playlists.insert yöntemi artık diğer birçok yöntemde zaten desteklenen onBehalfOfContentOwnerChannel parametresini destekliyor.

• video kaynağının contentDetails.contentRating.tvpgRating özelliği artık TV-14 derecelendirmesine karşılık gelen pg14 değerini destekliyor.

• Arama sonuçlarının bir parçası olan snippet.liveBroadcastContent özelliğinin tanımı, live geçerli bir özellik değeri, active ise geçerli bir özellik değeri olmadığını yansıtacak şekilde düzeltildi.

• video kaynağının contentDetails.contentRating.mibacRating özelliği artık iki ek derecelendirmeyi destekliyor:

  • mibacVap (VAP) – Çocuklara bir yetişkin eşlik etmelidir.
  • mibacVm6 (V.M.6) – 6 yaş ve üstü ile sınırlıdır.
  • mibacVm12 (V.M.12) – 12 yaş ve üstü ile sınırlıdır.

• channel kaynağının yeni invideoPromotion.items[].promotedByContentOwner özelliği, promosyon gösterilirken içerik sahibinin adının gösterilip gösterilmeyeceğini belirtir. Bu alan yalnızca değeri ayarlayan API isteği içerik sahibinin adına yapılıyorsa ayarlanabilir. Daha fazla bilgi için onBehalfOfContentOwner parametresine bakın.

1 Ekim 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channel kaynağının yeni auditDetails nesnesi, çok kanallı bir ağın (MCN) belirli bir kanalı kabul edip etmeyeceğini belirlerken değerlendireceği kanal verilerini içerir. 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, MCN'nin kanalı kabul etmeye veya reddetmeye karar verdiği anda ya da jetonun verildiği tarihten itibaren iki hafta içinde bu kapsamı kullanan tüm jetonların iptal edilmesi gerekir.

• channel kaynağının invideoPromotion.items[].id.type özelliği artık recentUpload değerini destekliyor. Bu değer, tanıtılan öğenin belirtilen kanala en son yüklenen video olduğunu gösterir.

  Varsayılan olarak kanal, video içi tanıtım verilerinin ayarlandığı kanalla aynıdır. Ancak yeni invideoPromotion.items[].id.recentlyUploadedBy özelliğinin değerini ilgili kanalın kanal kimliği olarak ayarlayarak başka bir kanaldan en son yüklenen videoyu tanıtabilirsiniz.

• channel kaynağı, televizyon uygulamalarındaki kanal sayfalarında gösterilen banner resimlerinin URL'lerini belirten üç yeni özellik (brandingSettings.image.bannerTvLowImageUrl, brandingSettings.image.bannerTvMediumImageUrl, brandingSettings.image.bannerTvHighImageUrl) içerir.

• Arama sonuçlarındaki yeni snippet.liveBroadcastContent özelliği, bir video veya kanal kaynağında canlı yayın içeriği olup olmadığını gösterir. Geçerli özellik değerleri upcoming, active ve none'dir.

  • video kaynağı için upcoming değeri, videonun henüz başlamamış bir canlı yayın olduğunu, active değeri ise videonun devam eden bir canlı yayın olduğunu gösterir.
  • channel kaynağı için upcoming değeri, kanalın henüz başlamamış planlanmış bir yayını olduğunu, acive değeri ise kanalın devam eden bir canlı yayını olduğunu gösterir.

• watermark kaynağında, targetChannelId özelliği nesneden dizeye değiştirildi. Filigran resminin bağlantı verdiği kanalın YouTube kanal kimliğini belirten bir alt özellik içermek yerine, targetChannelId özelliği artık bu değeri kendisi belirtiyor. Bu nedenle, kaynağın targetChannelId.value özelliği kaldırıldı.

• thumbnails.set yöntemi artık diğer birçok yöntemde zaten desteklenen onBehalfOfContentOwner parametresini destekliyor.

• search.list yöntemi artık eventType parametresini destekliyor. Bu parametre, aramanın yalnızca etkin, yaklaşan veya tamamlanmış yayın etkinliklerini döndürmesini sağlar.

• Yeni contentDetails.contentRating.mibacRating özelliği, bir videonun İtalya'daki Ministero dei Beni e delle Attivita Culturali e del Turismo'dan aldığı derecelendirmeyi tanımlar.

• API artık aşağıdaki hataları desteklemektedir:

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest	invalidImage	thumbnails.set yöntemi, sağlanan resim içeriği geçersizse bu hatayı döndürür.
  forbidden	videoRatingDisabled	Puan verilen videonun sahibi, videonun puanlarını devre dışı bıraktıysa videos.rate yöntemi bu hatayı döndürür.

27 Ağustos 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni watermark kaynağı, belirli bir kanalın videolarının oynatılması sırasında gösterilen resmi tanımlar. Ayrıca, resmin bağlanacağı hedef kanalı ve filigranın video oynatma sırasında ne zaman görüneceğini ve ne kadar süreyle görünür kalacağını belirleyen zamanlama ayrıntılarını da belirtebilirsiniz.

  watermarks.set yöntemi, kanalın filigran resmini yükler ve ayarlar. watermarks.unset yöntemi, kanalın filigran resmini siler.

  Hata dokümanında, API'nin özellikle watermarks.set ve watermarks.unset yöntemleri için desteklediği hata mesajları açıklanmaktadır.

• channel kaynağının yeni statistics.hiddenSubscriberCount özelliği, kanalın abone sayısının gizlenip gizlenmediğini belirten bir boole değeri içerir. Bu nedenle, kanalın abone sayısı herkese açıksa özelliğin değeri false olur.

• playlists.list yöntemi artık onBehalfOfContentOwner ve onBehalfOfContentOwnerChannel parametrelerini destekliyor. Her iki parametre de diğer birçok yöntem için zaten desteklenmektedir.

• videos.list yöntemi artık bir grafiğin alınması gereken içerik bölgesini tanımlayan regionCode parametresini destekliyor. Bu parametre yalnızca chart parametresiyle birlikte kullanılabilir. Parametre değeri, ISO 3166-1 alfa-2 ülke kodudur.

• error documentation, birden fazla API yönteminde oluşabilecek aşağıdaki yeni genel istek hatasını açıklar:

  Hata türü	Hata ayrıntısı	Açıklama
  forbidden	insufficientPermissions	İstek için sağlanan OAuth 2.0 jetonuyla ilişkili kapsamlar, istenen verilere erişmek için yeterli değil.

15 Ağustos 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channel kaynağının invideoPromotion nesnesi aşağıdaki yeni ve güncellenmiş özelliklere sahiptir:

  • API artık bir web sitesini tanıtılan öğe olarak belirtme özelliğini destekliyor. Bunu yapmak için invideoPromotion.items[].id.type özellik değerini website olarak ayarlayın ve URL'yi belirtmek için yeni invideoPromotion.items[].id.websiteUrl özelliğini kullanın. Ayrıca, promosyon için gösterilecek özel bir mesaj tanımlamak üzere yeni invideoPromotion.items[].customMessage özelliğini kullanın.

    Bağlantılar, ilişkili web sitelerine, satıcı sitelerine veya sosyal ağ sitelerine yönlendirebilir. İçeriğiniz için bağlantıları etkinleştirme hakkında daha fazla bilgi edinmek istiyorsanız ilişkili web siteleri ve satıcı siteleri ile ilgili YouTube Yardım Merkezi talimatlarına göz atın.

    Tanıtım bağlantıları ekleyerek bu bağlantıların trafiği yetkisiz sitelere yönlendirmek için kullanılmayacağını ve YouTube'un AdWords politikalarına, YouTube reklam politikalarına, YouTube Topluluk Kuralları'na ve YouTube Hizmet Şartları'na uygun olacağını kabul edersiniz.

  • Video oynatma sırasında tanıtılan öğelerin gösterilmesiyle ilgili zamanlama ayarları yeniden yapılandırıldı:

    • invideoPromotion.timing nesnesi invideoPromotion.items[].timing konumuna taşındı. Bu nesne artık invideoPromotion.items[] listesindeki her tanıtılan öğenin zamanlama verilerini özelleştirmenize olanak tanıyor.

    • Yeni invideoPromotion.defaultTiming nesnesi, promosyonunuz için varsayılan zamanlama ayarlarını belirtir. Bu ayarlar, tanıtılan bir öğenin kanalınızdaki bir videonun oynatılması sırasında ne zaman gösterileceğini tanımlar. invideoPromotion.items[].timing nesnesini kullanarak belirli bir tanıtılan öğenin varsayılan zamanlamasını geçersiz kılabilirsiniz.

    • Yeni invideoPromotion.items[].timing.durationMs özelliği, promosyonun milisaniye cinsinden ne kadar süreyle gösterileceğini belirtir. invideoPromotion.defaultTiming nesnesi, tanıtılan öğenin görüntüleneceği varsayılan süreyi belirten bir durationMs alanı da içerir.

  • Hem invideoPromotion.items[].type hem de invideoPromotion.items[].videoId özellikleri invideoPromotion.items[].id nesnesine taşındı.

• subscriptions.list yöntemi artık onBehalfOfContentOwner ve onBehalfOfContentOwnerChannel parametrelerini destekliyor. Her iki parametre de diğer birçok yöntem için zaten desteklenmektedir.

• thumbnails.set isteğine verilen API yanıtında, kind özellik değeri youtube#thumbnailListResponse yerine youtube#thumbnailSetResponse olarak değiştirildi.

• Aşağıdaki yöntemler için kod örnekleri eklendi:

  • channels.update (Java, Python)
  • playlists.insert (.NET, PHP)
  • subscriptions.insert (PHP, Python)
  • thumbnails.set (PHP, Python)
  • videos.insert (Filipin pesosu)
  • videos.list (Filipin pesosu)
  • videos.rate (Python)
  • videos.update (Java, PHP, Python)

  playlistItems.insert yöntemiyle ilgili Python örneğinin de kaldırıldığını belirtmek isteriz. Bunun nedeni, bu yöntemin gösterdiği işlevin artık videos.rate yöntemiyle ele alınmasıdır.

• error documentation, mine istek parametresini destekleyen tüm API yöntemlerinde oluşabilecek aşağıdaki yeni istek bağlamı hatasını açıklar:

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest	invalidMine	Kimliği doğrulanmış kullanıcının YouTube iş ortağı olduğu isteklerde mine parametresi kullanılamaz. mine parametresini kaldırmanız, onBehalfOfContentOwner parametresini kaldırarak YouTube kullanıcısı olarak kimliğinizi doğrulamanız veya çağrılan yöntem için kullanılabilirse onBehalfOfContentOwnerChannel parametresini sağlayarak iş ortağının kanallarından biri olarak hareket etmeniz gerekir.

8 Ağustos 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• YouTube Data API'yi Kullanmaya Başlama kılavuzunun Kota Kullanımı bölümü, video yüklemenin kota maliyetinde yapılan değişikliği yansıtacak şekilde güncellendi. Bu değişiklikle birlikte, video yüklemenin kota maliyeti yaklaşık 16.000 birimden yaklaşık 1.600 birime düşürüldü.

30 Temmuz 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channelBanner kaynağında, kind özelliğinin değeri youtube#channelBannerInsertResponse iken youtube#channelBannerResource olarak değiştirildi. Bu kaynak, channelBanners.insert isteğine yanıt olarak döndürülür.

• channel kaynağının yeni brandingSettings.channel.profileColor özelliği, kanalın içeriğini tamamlayan belirgin bir renk belirtir. Özellik değeri, altı karakterli bir onaltılık dizeyi (ör. #2793e6) takip eden bir pound işareti (#) olur.

• API artık aboneliğin bir kanalın tüm etkinlikleri için mi yoksa yalnızca yeni yüklemeler için mi geçerli olacağını belirtme özelliğini destekliyor. subscription kaynağının yeni contentDetails.activityType özelliği, abonenin hangi etkinlik türleri hakkında bilgilendirileceğini tanımlar. Geçerli özellik değerleri all ve uploads'dir.

• videos.list yöntemi, YouTube'daki en popüler videoların listesini almak için yeni parametreleri destekler:

  • chart parametresi, almak istediğiniz grafiği tanımlar. Şu anda yalnızca mostPopular değeri desteklenmektedir. chart parametresinin bir filtre parametresi olduğunu ve bu nedenle diğer filtre parametreleriyle (id ve myRating) aynı istekte kullanılamayacağını unutmayın.
  • videoCategoryId parametresi, grafiğin alınması gereken video kategorisini tanımlar. Bu parametre yalnızca chart parametresiyle birlikte kullanılabilir. Varsayılan olarak, grafikler belirli bir kategoriyle kısıtlanmaz.

• video kaynağının yeni topicDetails.relevantTopicIds[] özelliği, video veya içeriğiyle alakalı Freebase konu kimliklerinin bir listesini sağlar. Bu konuların öznesi olan kişiler videoda bahsedilebilir veya videoda görünebilir.

• video kaynağının recordingDetails.location.elevation özelliği recordingDetails.location.altitude olarak, fileDetails.recordingLocation.location.elevation özelliği ise fileDetails.recordingLocation.location.altitude olarak yeniden adlandırıldı.

• video kaynağının contentDetails.contentRating nesnesi, bir videonun MPAA derecelendirmeleri, TVPG derecelendirmeleri vb. dahil olmak üzere çeşitli derecelendirme şemaları kapsamında aldığı derecelendirmeleri belirtir. API, artık her derecelendirme sistemi için videonun derecelendirilmediğini belirten bir derecelendirme değerini destekliyor. MPAA derecelendirmelerinde, filmin kesilmiş versiyonu resmi bir derecelendirme almış olsa da kesilmemiş versiyonlarını tanımlamak için sıklıkla "derecelendirilmemiş" derecelendirmesinin kullanıldığını unutmayın.

• video kaynağının yeni contentDetails.contentRating.ytRating özelliği, yaş kısıtlamalı içeriği tanımlar. YouTube, videonun 18 yaşından küçük kullanıcılar için uygun olmayan içerik barındırdığını belirlediyse özellik değeri ytAgeRestricted olur. Özellik yoksa veya özellik değeri boşsa içerik, yaş kısıtlamalı olarak tanımlanmamıştır.

• channels.list yönteminin mySubscribers parametresinin desteği sonlandırıldı. Kimliği doğrulanmış kullanıcının kanalına abone olanların listesini almak için subscriptions.list yöntemini ve mySubscribers parametresini kullanın.

• channelBanners.insert, channels.update, videos.getRating ve videos.rate yöntemleri artık onBehalfOfContentOwner parametresini destekliyor. Bu parametre, kimliği doğrulanmış kullanıcının parametre değerinde belirtilen içerik sahibi adına hareket ettiğini gösterir.

• channels.update yönteminin dokümanları, bu yöntemin channel kaynağının brandingSettings nesnesini ve alt özelliklerini güncellemek için kullanılabileceğini yansıtacak şekilde güncellendi. Dokümanlarda artık channel kaynağının invideoPromotion nesnesi için ayarlayabileceğiniz güncellenmiş özellikler listesi de yer alıyor.

• error documentation, aşağıdaki yeni hataları açıklıyor:

  Hata türü	Hata ayrıntısı	Açıklama
  forbidden	accountDelegationForbidden	Bu hata, belirli bir API yöntemine özgü değildir. Kimliği doğrulanmış kullanıcının, belirtilen Google Hesabı adına işlem yapma yetkisi olmadığını gösterir.
  forbidden	authenticatedUserAccountClosed	Bu hata, belirli bir API yöntemine özgü değildir. Kimliği doğrulanmış kullanıcının YouTube hesabının kapatıldığını gösterir. Kullanıcı başka bir Google Hesabı adına işlem yapıyorsa bu hata, söz konusu hesabın kapatıldığını gösterir.
  forbidden	authenticatedUserAccountSuspended	Bu hata, belirli bir API yöntemine özgü değildir. Kimliği doğrulanmış kullanıcının YouTube hesabının askıya alındığını gösterir. Kullanıcı başka bir Google Hesabı adına işlem yapıyorsa bu hata, söz konusu hesabın askıya alındığını gösterir.
  forbidden	authenticatedUserNotChannel	Bu hata, belirli bir API yöntemine özgü değildir. Bu hata, API sunucusunun API isteğiyle ilişkili kanalı tanımlayamadığını gösterir. İstek yetkilendirilmişse ve onBehalfOfContentOwner parametresini kullanıyorsa onBehalfOfContentOwnerChannel parametresini de ayarlamanız gerekir.
  forbidden	cmsUserAccountNotFound	Bu hata, belirli bir API yöntemine özgü değildir. İçerik yönetim sistemi kullanıcısının, belirtilen içerik sahibi adına işlem yapmasına izin verilmiyor.
  notFound	contentOwnerAccountNotFound	Bu hata, belirli bir API yöntemine özgü değildir. Belirtilen içerik sahibi hesabı bulunamadı.
  badRequest	invalidPart	Bu hata, belirli bir API yöntemine özgü değildir. İsteğin part parametresi, aynı anda yazılamayan bölümleri belirtiyor.
  badRequest	videoChartNotFound	İstek, desteklenmeyen veya kullanılamayan bir video grafiği belirttiğinde videos.list yöntemi bu hatayı döndürür.
  notFound	videoNotFound	videos.update yöntemi, güncellemeye çalıştığınız videonun bulunamadığını belirtmek için bu hatayı döndürür. Doğruluğundan emin olmak için istek gövdesindeki id özelliğinin değerini kontrol edin.

10 Haziran 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channels.list yönteminin yeni forUsername parametresi, YouTube kullanıcı adını belirterek bir kanal hakkında bilgi almanızı sağlar.

• activities.list yöntemi artık API'ye belirtilen ülkeyle alakalı sonuçlar döndürmesini bildiren regionCode parametresini destekliyor. YouTube, yetkili kullanıcının YouTube'daki önceki etkinliği, etkinlik feed'ini oluşturmak için yeterli bilgi sağlamadığında bu değeri kullanır.

• Oynatma listesi kaynakları artık snippet.tags özelliğini içeriyor. Mülk yalnızca kendi oynatma listeleriyle ilgili verileri alan yetkili kullanıcılara döndürülür. Yetkili kullanıcılar, playlists.insert veya playlists.update yöntemlerinden birini çağırırken oynatma listesi etiketleri de ayarlayabilir.

• Daha önce channels.list ve search.list yöntemleri için desteklenen onBehalfOfContentOwner parametresi artık videos.insert, videos.update ve videos.delete yöntemleri için de destekleniyor. Bu parametre videos.insert yöntemine yapılan bir çağrıda kullanıldığında, isteğin videonun ekleneceği kanalı tanımlayan yeni onBehalfOfContentOwnerChannel parametresi için de bir değer belirtmesi gerektiğini unutmayın. Kanal, onBehalfOfContentOwner parametresinin belirttiği içerik sahibine bağlı olmalıdır.

  Parametre, isteğin yetkilendirme kimlik bilgilerinin, parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube CMS kullanıcısını tanımladığını gösterir. Kullanıcının kimliğini doğruladığı CMS hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.

  Bu parametre, birçok farklı YouTube kanalına sahip olan ve bunları yöneten içerik iş ortakları için tasarlanmıştır. Bu parametre, söz konusu iş ortaklarının tek bir kimlik doğrulama işlemiyle tüm video ve kanal verilerine erişmesini sağlar. Böylece, her kanal için ayrı ayrı kimlik doğrulama bilgileri sağlamaları gerekmez.

  Bu sürümle birlikte, parametre artık içerik iş ortağının sahip olduğu YouTube kanallarında video eklemesine, güncellemesine veya silmesine olanak tanıyor.

• error documentation, aşağıdaki yeni hataları açıklıyor:

  Hata türü	Hata ayrıntısı	Açıklama
  forbidden	insufficientCapabilities	Bu hata, belirli bir API yöntemine özgü değildir. Bu hata, API'yi çağıran içerik yönetim sistemi kullanıcısının istenen işlemi gerçekleştirmek için yeterli izne sahip olmadığını gösterir. Bu hata, çeşitli API yöntemleri için desteklenen onBehalfOfContentOwner parametresinin kullanımıyla ilişkilidir.
  unauthorized	authorizationRequired	İstek activities.list parametresini kullandığında ancak doğru şekilde yetkilendirilmediğinde home yöntemi bu hatayı döndürür.

• channels kaynağında, kanal kimliği kaynağın id özelliği kullanılarak zaten belirtildiği için invideoPromotion.channelId özelliği kaldırıldı.

• Yeni Kanal Kimlikleriyle Çalışma kılavuzunda, API'nin kanal kimliklerini nasıl kullandığı açıklanmaktadır. Bu kılavuz, özellikle API'nin önceki sürümünden geçiş yapan ve default kullanıcısı için içerik isteyen ya da her YouTube kanalının benzersiz bir kullanıcı adı olduğu (artık geçerli olmayan) fikrine dayanan uygulamaları olan geliştiriciler için faydalı olabilir.

22 Mayıs 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni channelBanners.insert yöntemi, channel kaynağının yeni brandingSettings.image.bannerExternalUrl özelliği kullanılarak daha sonra bir kanalın banner resmi olarak ayarlanabilecek bir banner resmi yüklemenize olanak tanır.

• channels.update yöntemiyle ilgili dokümanlar, yöntem çağrıldığında değiştirilebilecek özellikleri listeleyecek şekilde güncellendi.

• video kaynak dokümanlarında artık unspecified, suggestions.processingErrors[], suggestions.processingHints[], suggestions.processingWarnings[] ve suggestions.editorSuggestions[] özellikleri için geçerli bir özellik değeri olarak listelenmiyor.

• videos.list yönteminin maxResults parametresinin varsayılan değeri artık 5.

• error documentation artık channelBanners.insert ve subscriptions.list yöntemleriyle ilgili hataları listeliyor. Ayrıca channels.update yöntemiyle ilgili birkaç yeni hata da listelenir.

14 Mayıs 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Bağımsız sayfalar artık Java, .NET, PHP ve Ruby için kod örnekleri listeliyor.

• Python kodu örneklerinin listelendiği sayfaya artık abonelik ekleme, oynatma listesi oluşturma ve video güncelleme örnekleri de dahil edildi.

10 Mayıs 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• YouTube artık deneysel API özelliklerini ve hizmetlerini tanımlamıyor. Bunun yerine, artık kullanımdan kaldırma politikasına tabi olan YouTube API'lerinin listesini sunuyoruz.

8 Mayıs 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Kanal kaynakları artık kanalla ilişkili bir tanıtım kampanyası hakkındaki bilgileri kapsayan inVideoPromotion nesnesini destekliyor. Bir kanal, kanalın videolarının oynatılması sırasında video oynatıcıda tanıtılan videonun küçük resimlerini göstermek için video içi tanıtım kampanyası kullanabilir.

  Bu verileri, channels.list isteğindeki part parametre değerine invideoPromotion ekleyerek alabilirsiniz.

• Yeni channels.update yöntemi, bir kanalın video içi tanıtım kampanyası verilerini güncellemek için kullanılabilir. Bu yöntemin yalnızca channel kaynağının invideoPromotion bölümündeki güncellemeleri desteklediğini ve henüz bu kaynağın diğer bölümlerindeki güncellemeleri desteklemediğini unutmayın.

2 Mayıs 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Kanal kaynakları artık status.isLinked özelliğini destekliyor. Bu özellik, kanal 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, video yükleme gibi çeşitli işlemler için ön koşul olan herkese açık bir YouTube kimliğine sahiptir.

• Abonelik kaynakları artık subscriberSnippet bölümünü destekliyor. Bu nesne, abonenin kanalına ait snippet verilerini kapsar.

• API artık, kimliği doğrulanmış kullanıcının bir veya daha fazla videoya verdiği puanları alan videos.getRating yöntemini destekliyor.

• videos.list yönteminin yeni myRating parametresi, kimliği doğrulanmış kullanıcının like veya dislike derecesi verdiği videoların listesini almanızı sağlar.

  myRating parametresi ve id parametresi artık filtre parametreleri olarak kabul ediliyor. Bu nedenle, bir API isteğinde parametrelerden yalnızca biri belirtilmelidir. (Daha önce, id parametresi bu yöntem için zorunlu bir parametreydi.)

  Bu yöntem, video derecelendirme bilgilerini almaya çalışan ancak bunun için uygun şekilde yetkilendirilmemiş istekler için forbidden hatası döndürür.

• myRating parametresinin kullanıma sunulmasıyla birlikte, videos.list yöntemi de sayfalara ayırmayı destekleyecek şekilde güncellendi. Ancak sayfalama parametrelerinin yalnızca myRating parametresinin kullanıldığı isteklerde desteklendiğini unutmayın. (Sayfalama parametreleri ve bilgileri, id parametresini kullanan isteklerde desteklenmez.)

  • maxResults parametresi, API'nin sonuç kümesinde döndürebileceği maksimum video sayısını belirtir. pageToken parametresi ise sonuç kümesinde almak istediğiniz belirli bir sayfayı tanımlar.

  • videos.list isteğine yanıt olarak döndürülen youtube#videoListResponse kaynağı artık pageInfo nesnesini içeriyor. Bu nesne, toplam sonuç sayısı ve mevcut sonuç kümesine dahil edilen sonuç sayısı gibi ayrıntıları içerir. youtube#videoListResponse kaynağı, sonuç kümesinde belirli bir sayfanın alınmasında kullanılabilecek bir jeton sağlayan nextPageToken ve prevPageToken özelliklerini de içerebilir.

• videos.insert yöntemi aşağıdaki yeni parametreleri destekler:

  • autoLevels: YouTube'a videonun ışığını ve rengini otomatik olarak iyileştirmesi talimatını vermek için bu parametre değerini true olarak ayarlayın.
  • stabilize: YouTube'a, kamera hareketlerinden kaynaklanan titremeyi kaldırarak videoyu ayarlaması talimatını vermek için bu parametre değerini true olarak ayarlayın.

• channelTitle özelliği, aşağıdaki kaynaklar için snippet'ye eklendi:

  • playlistItem: Özellik, oynatma listesi öğesini ekleyen kanalın adını belirtir.
  • playlist: Özellik, oynatma listesini oluşturan kanalın adını belirtir.
  • subscription: Özellik, abone olunan kanalın adını belirtir.

• Aşağıdaki yöntemler için kod örnekleri eklendi:

  • activities.insert (Ruby)
  • playlistItems.list (.NET)
  • search.list (.NET)
  • subscriptions.insert (Java, Ruby)
  • videos.insert (.NET, Ruby)

• subscriptions.list yönteminin yeni mySubscribers parametresi, şu anda kimliği doğrulanmış kullanıcının abonelerinin listesini almanızı sağlar. Bu parametre yalnızca uygun şekilde yetkilendirilmiş bir istekte kullanılabilir.

  Not: Bu işlev, şu anda channels.list yöntemi için desteklenen mySubscribers parametresinin yerini alması amacıyla tasarlanmıştır. Bu parametrenin desteği sonlandırılacak.

• video kaynağında, unspecified özellik değeri artık aşağıdaki özelliklerden herhangi biri için olası bir değer değildir:

  • fileDetails.fileType
  • fileDetails.videoStreams[].rotation
  • processingDetails.processingStatus
  • processingDetails.processingFailureReason
  • fileDetails.fileType

• Beklenmeyen bir parametre içeren API istekleri artık badRequest hatası döndürüyor ve hatanın bildirilen nedeni unexpectedParameter oluyor.

• Oynatma listesi zaten izin verilen maksimum sayıda öğe içerdiğinde playlistItems.insert yönteminin döndürdüğü hata güncellendi. Hata artık forbidden hatası olarak bildiriliyor ve hata nedeni playlistContainsMaximumNumberOfVideos.

19 Nisan 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni videos.rate yöntemi, kullanıcının bir videoya like veya dislike derecelendirmesi vermesine ya da videodan derecelendirmeyi kaldırmasına olanak tanır.

  Hata dokümanları da API'nin videos.rate yöntem çağrısına yanıt olarak döndürebileceği hataları listeleyecek şekilde güncellendi.

• Küçük resimler artık API dokümanlarında ayrı bir kaynak olarak tanımlanıyor. Yeni thumbnails.set yöntemi sayesinde YouTube'a özel bir video küçük resmi yükleyebilir ve bunu bir video için ayarlayabilirsiniz.

  Hata dokümanları da API'nin thumbnails.set yöntem çağrısına yanıt olarak döndürebileceği hataları listeleyecek şekilde güncellendi.

  Bu değişikliğin, küçük resim döndüren mevcut kaynakları pek etkilemediğini unutmayın. Küçük resimler, API'nin döndürebileceği farklı küçük resim boyutlarının adları artık dokümanda listeleniyor olsa da bu kaynaklarda daha önce olduğu gibi döndürülür.

• channel kaynağının yeni brandingSettings bölümü, kanalın kanal sayfası ve video izleme sayfalarıyla ilgili ayarları, metinleri ve resimleri tanımlar.

• playlistItem kaynağı aşağıdaki yeni özellikleri içerir:

  • Yeni status nesnesi, oynatma listesi öğesiyle ilgili durum bilgilerini kapsar. status.privacyStatus özelliği ise oynatma listesi öğesinin gizlilik durumunu tanımlar.

• video kaynağı aşağıdaki yeni özellikleri içerir:

  • status.publicStatsViewable özelliği, izleme sayfasındaki genişletilmiş video istatistiklerinin herkese açık olarak görüntülenebilir olup olmadığını gösterir. Bu istatistikler varsayılan olarak görüntülenebilir. Bu özelliğin değeri false olarak ayarlanmış olsa bile videonun görüntüleme sayısı ve derecelendirmeleri gibi istatistikler herkese açık olarak görünmeye devam eder. Bu özelliğin değerini videos.insert veya videos.update yöntemini çağırırken ayarlayabilirsiniz.

  • contentDetails.contentRating nesnesi, videonun çeşitli derecelendirme şemaları kapsamında aldığı derecelendirmeleri kapsar. Aşağıdaki listede, desteklenen derecelendirme sistemleri ve her derecelendirme sistemiyle ilişkili tesisin bağlantısı yer almaktadır. Özellik tanımları, her sistem için desteklenen derecelendirme değerlerini tanımlar.

    Ülke	Derecelendirme sistemi	Mülk
    United States	Motion Picture Association of America (Amerikan Sinema Filmleri Derneği - MPAA)	contentDetails.contentRating.mpaaRating
    United States	TV Ebeveyn Yönergeleri	contentDetails.contentRating.tvpgRating
    Australia	Australian Classification Board (ACB)	contentDetails.contentRating.acbRating
    Brazil	Departamento de Justiça, Classificação, Qualificação e Títulos	contentDetails.contentRating.djctqRating
    Canada	Canadian Home Video Rating System (CHVRS) [Kanada Ev Video Derecelendirme Sistemi]	contentDetails.contentRating.chvrsRating
    France	Centre national du cinéma et de l'image animée (Fransız Kültür Bakanlığı)	contentDetails.contentRating.fmocRating
    Germany	Freiwillige Selbstkontrolle der Filmwirtschaft (FSK)	contentDetails.contentRating.fskRating
    Great Britain	British Board of Film Classification (BBFC)	contentDetails.contentRating.bbfcRating
    India	Central Board of Film Certification (CBFC)	contentDetails.contentRating.cbfcRating
    Japan	映倫管理委員会 (EIRIN)	contentDetails.contentRating.eirinRating
    Korea	영상물등급위원회 (KMRB)	contentDetails.contentRating.kmrbRating
    Mexico	Radyo, Televizyon ve Sinema Genel Müdürlüğü (RTC)	contentDetails.contentRating.rtcRating
    New Zealand	Office of Film and Literature Classification	contentDetails.contentRating.oflcRating
    Russia	Rusya Federasyonu Ulusal Film Kayıtları	contentDetails.contentRating.russiaRating
    Spain	Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA)	contentDetails.contentRating.icaaRating

• playlistItems.update yönteminin dokümanları, snippet.resourceId özelliğinin istek gövdesi olarak gönderilen kaynakta belirtilmesi gerektiğini yansıtacak şekilde güncellendi.

• search.list yöntemi artık aşağıdaki işlevleri desteklemektedir:

  • Yeni forMine parametresi, aramayı yalnızca kimliği doğrulanmış kullanıcının videolarını alacak şekilde kısıtlar.

  • order parametresi artık sonuçları başlığa göre alfabetik olarak (order=title) veya video sayısına göre azalan sırada (order=videoCount) sıralama özelliğini destekliyor.

  • Yeni safeSearch parametresi, arama sonuçlarının kısıtlanmış içerik barındırıp barındırmaması gerektiğini belirtir.

• videos.insert yöntemi, aşağıdaki tabloda listelenen çeşitli yeni hataları destekler:

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest	invalidCategoryId	snippet.categoryId özelliği geçersiz bir kategori kimliği belirtiyor. Desteklenen kategorileri almak için videoCategories.list yöntemini kullanın.
  badRequest	invalidRecordingDetails	metadata geçersiz kayıt ayrıntılarını belirtiyor.
  badRequest	invalidVideoGameRating	İstek meta verilerinde geçersiz bir video oyunu derecelendirmesi belirtiliyor.
  badRequest	invalidVideoMetadata	İstek meta verileri geçersiz.

• onBehalfOfContentOwner parametresi, videos.update ve videos.delete yöntemleri için desteklenen parametreler listesinden kaldırıldı.

12 Mart 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channelTitle özelliği, aşağıdaki kaynaklar için snippet'ye eklendi:

  • activity: Özellik, etkinlikten sorumlu kanalın adını belirtir.
  • search: Özellik, arama sonucunun tanımladığı kaynakla ilişkili kanalın adını belirtir.
  • video: Özellik, videoyu yükleyen kanalın adını belirtir.

• search.list yöntemi aşağıdaki yeni parametreleri destekler:

  • channelType parametresi, kanalları ararken tüm kanalları veya yalnızca programları alacak şekilde aramayı kısıtlamanıza olanak tanır.

  • videoType parametresi, videoları arama işlemini tüm videoları veya yalnızca filmleri ya da yalnızca dizilerin bölümlerini alacak şekilde kısıtlamanıza olanak tanır.

• video Kaynağın recordingDetails bölümünün tanımı, nesnenin yalnızca videonun coğrafi konum verileri veya kayıt zamanı ayarlanmışsa döndürüleceğini belirtecek şekilde güncellendi.

• playlistItems.update yöntemi artık invalidSnippet hatasını döndürüyor. Bu hata, API isteğinde geçerli bir snippet belirtilmediğinde döndürülür.

• Çeşitli API yöntemleri, yalnızca YouTube içerik iş ortaklarına yönelik yeni parametreleri destekler. YouTube içerik iş ortakları arasında film ve televizyon stüdyoları, plak şirketleri ve içeriklerini YouTube'da yayınlayan diğer içerik üreticiler yer alır.

  • onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin, parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube İYS kullanıcısını tanımladığını gösterir. Kullanıcının kimliğini doğruladığı CMS hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.

    Bu parametre, birçok farklı YouTube kanalına sahip olan ve bunları yöneten içerik iş ortakları için tasarlanmıştır. Bu parametre, söz konusu iş ortaklarının tek bir kimlik doğrulama işlemiyle tüm video ve kanal verilerine erişmesini sağlar. Böylece, her kanal için ayrı ayrı kimlik doğrulama bilgileri sağlamaları gerekmez.

    channels.list, search.list, videos.delete, videos.list ve videos.update yöntemlerinin tümü bu parametreyi destekler.

  • channels.list yöntemi tarafından desteklenen managedByMe parametresi, API'ye onBehalfOfContentOwner parametresinin belirttiği içerik sahibine ait tüm kanalları döndürmesini bildirir.

  • search.list yöntemi tarafından desteklenen forContentOwner parametresi, API'ye arama sonuçlarını yalnızca onBehalfOfContentOwner parametresinin belirttiği içerik sahibine ait kaynakları içerecek şekilde kısıtlaması talimatını verir.

25 Şubat 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• API, video kaynakları için çeşitli yeni bölümleri ve özellikleri destekler:

  • Yeni fileDetails, processingDetails ve suggestions bölümleri, video sahiplerine yükledikleri videolar hakkında bilgi verir. Bu veriler, video yüklemeyi sağlayan uygulamalarda çok faydalıdır ve aşağıdakileri içerir:

    • işleme durumu ve ilerleme durumu
    • Video işlenirken karşılaşılan hatalar veya diğer sorunlar
    • küçük resimlerin kullanılabilirliği
    • Video veya meta veri kalitesini artırmaya yönelik öneriler
    • YouTube'a yüklenen orijinal dosya hakkında ayrıntılar

    Bu bölümlerin tümü yalnızca video sahibi tarafından alınabilir. Aşağıdaki listede yeni bölümler kısaca açıklanmakta, video kaynak dokümanında ise her bölümün içerdiği tüm özellikler tanımlanmaktadır.

    • fileDetails nesnesi, dosyanın çözünürlüğü, süresi, ses ve video codec'leri, akış bit hızları gibi YouTube'a yüklenen video dosyasıyla ilgili bilgileri içerir.

    • processingProgress nesnesi, YouTube'un yüklenen video dosyasını işleme sürecindeki ilerlemesiyle ilgili bilgileri içerir. Nesnenin özellikleri, mevcut işleme durumunu tanımlar ve YouTube'un videoyu işlemeyi tamamlamasına kadar kalan süreyi tahmin eder. Bu bölüm, dosya ayrıntıları veya küçük resimler gibi farklı türlerdeki verilerin ya da içeriklerin video için kullanılabilir olup olmadığını da gösterir.

      Bu nesne, video yükleyenin YouTube'un yüklenen video dosyasını işleme sürecindeki ilerlemeyi takip edebilmesi için yoklama yapacak şekilde tasarlanmıştır.

    • suggestions nesnesi, yüklenen videonun kalitesini veya meta verilerini iyileştirme fırsatlarını belirleyen öneriler içerir.

  • contentDetails bölümü dört yeni özellik içerir. Bu özellikler, kimliği doğrulanmamış isteklerle alınabilir.

    • dimension: Videonun 2D veya 3D olarak kullanılabilir olup olmadığını gösterir.
    • definition: Videonun standart veya yüksek çözünürlükte olup olmadığını gösterir.
    • caption: Videoda altyazı olup olmadığını gösterir.
    • licensedContent: Videoda, YouTube içerik iş ortağı tarafından hak talebinde bulunulan içerik olup olmadığını gösterir.

  • status bölümü iki yeni özellik içerir. Video sahipleri, video eklerken veya güncellerken her iki özelliğin de değerlerini ayarlayabilir. Bu özellikler, kimliği doğrulanmamış isteklerle de alınabilir.

    • embeddable: Videonun başka bir web sitesine yerleştirilip yerleştirilemeyeceğini gösterir.
    • license: Videonun lisansını belirtir. Geçerli değerler creativeCommon ve youtube'dir.

• part parametresinin tanımı, yukarıda açıklanan yeni eklenen parçaların yanı sıra yanlışlıkla atlanan recordingDetails parçasını da listelemek için videos.list, videos.insert ve videos.update yöntemleri için güncellendi.

• channel kaynağının yeni contentDetails.googlePlusUserId özelliği, kanalla ilişkili Google+ profil kimliğini belirtir. Bu değer, Google+ profiline bağlantı oluşturmak için kullanılabilir.

• Artık her küçük resim nesnesinde resmin genişliği ve yüksekliği belirtiliyor. Küçük resimler şu anda activity, channel, playlist, playlistItem, search result, subscription ve video kaynaklarında döndürülmektedir.

• playlistItems.list artık videoId parametresini destekliyor. Bu parametre, yalnızca belirtilen videoyu temsil eden oynatma listesi öğesini almak için playlistId parametresiyle birlikte kullanılabilir.

  Parametrenin tanımladığı video oynatma listesinde bulunamazsa API notFound hatası döndürür.

• Hata dokümanlarında, isteğin istenen işlem için düzgün şekilde yetkilendirilmediğini belirten yeni bir forbidden hatası açıklanmaktadır.

• channel kaynağının snippet.channelId özelliği kaldırıldı. Kaynağın id özelliği aynı değeri sağlıyor.

30 Ocak 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni hata sayfasında, API'nin döndürebileceği hatalar listelenir. Sayfada, birden fazla farklı API yönteminde oluşabilecek genel hataların yanı sıra yönteme özgü hatalar da yer alır.

16 Ocak 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Aşağıdaki listede gösterilen yöntemler ve diller için artık kod örnekleri kullanılabilir:

  • activities.insert – Java
  • playlistItems.insert – Python
  • playlistItems.list – Java, JavaScript, PHP, Python, Ruby
  • playlists.insert – Java, JavaScript, Python
  • search.list – Java, JavaScript, Python, Ruby
  • videos.insert – Java

• Bir activitykaynakchannelItem artık YouTube'un bir videoyu otomatik olarak oluşturulan YouTube kanalına eklediği zaman gerçekleşen bir channelItemişlemi bildirebilir. (YouTube, YouTube web sitesinde önemli bir yere sahip olan konuları algoritmik olarak tanımlar ve bu konular için otomatik olarak kanallar oluşturur.)

• Aşağıdaki search.list parametreleri güncellendi:

  • q parametresi artık filtre olarak belirlenmiyor. Bu nedenle ....
  • relatedToVideo parametresinin adı relatedToVideoId olarak değiştirildi.
  • published parametresi, aşağıda açıklanan publishedAfter ve publishedBefore olmak üzere iki yeni parametreyle değiştirildi.

• search.list yöntemi aşağıdaki yeni parametreleri destekler:

  Parametre adı	Değer	Açıklama
  channelId	string	Belirtilen kanal tarafından oluşturulan kaynakları döndürür.
  publishedAfter	datetime	Belirtilen zamandan sonra oluşturulan kaynakları döndürür.
  publishedBefore	datetime	Belirtilen zamandan önce oluşturulan kaynakları döndürür.
  regionCode	string	Belirtilen ülke için kaynakları döndürür.
  videoCategoryId	string	Video arama sonuçlarını, yalnızca belirtilen video kategorisiyle ilişkili videoları içerecek şekilde filtreleyin.
  videoEmbeddable	string	Video arama sonuçlarını, yalnızca bir web sayfasındaki yerleştirilmiş oynatıcıda oynatılabilen videoları içerecek şekilde filtreleyin. Yalnızca yerleştirilebilir videoları almak için parametre değerini true olarak ayarlayın.
  videoSyndicated	string	Video arama sonuçlarını yalnızca YouTube.com dışında oynatılabilen videoları içerecek şekilde filtreleyin. Yalnızca feed'e eklenmiş videoları almak için parametre değerini true olarak ayarlayın.

• Çeşitli API kaynakları yeni özellikleri destekler. Aşağıdaki tabloda kaynaklar ve yeni özellikleri tanımlanmaktadır:

  Kaynak	Mülk adı	Değer	Açıklama
  activity	contentDetails.playlistItem.playlistItemId	string	YouTube'un, oynatma listesindeki öğeyi benzersiz şekilde tanımlamak için atadığı oynatma listesi öğesi kimliği.
  activity	contentDetails.channelItem	object	Bir kanala eklenen kaynakla ilgili bilgileri içeren nesne. Bu özellik yalnızca snippet.type değeri channelItem ise bulunur.
  activity	contentDetails.channelItem.resourceId	object	Kanala eklenen kaynağı tanımlayan bir nesne. Diğer resourceId özellikleri gibi, kaynak türünü (ör. video veya oynatma listesi) belirten bir kind özelliği içerir. Ayrıca, bu kaynağı benzersiz şekilde tanımlayan kimliği belirten videoId, playlistId gibi özelliklerden tam olarak birini içerir.
  channel	status	object	Bu nesne, kanalın gizlilik durumuyla ilgili bilgileri kapsar.
  channel	status.privacyStatus	string	Kanalın gizlilik durumu. Geçerli değerler private ve public'dir.
  playlist	contentDetails	object	Bu nesne, oynatma listesinin içeriğiyle ilgili meta veriler içerir.
  playlist	contentDetails.itemCount	unsigned integer	Oynatma listesindeki video sayısı.
  playlist	player	object	Bu nesne, oynatma listesini yerleşik bir oynatıcıda oynatmak için kullanacağınız bilgileri içerir.
  playlist	player.embedHtml	string	Oynatma listesini oynatan bir video oynatıcıyı yerleştiren <iframe> etiketi.
  video	recordingDetails	object	Bu nesne, videonun kaydedildiği yeri ve zamanı tanımlayan veya açıklayan bilgileri kapsar.
  video	recordingDetails.location	object	Bu nesne, videoyla ilişkili coğrafi konum bilgileri içerir.
  video	recordingDetails.location.latitude	double	Enlem (derece cinsinden).
  video	recordingDetails.location.longitude	double	Derece cinsinden boylam.
  video	recordingDetails.location.elevation	double	Dünyanın üzerinde, metre cinsinden yükseklik.
  video	recordingDetails.locationDescription	string	Videonun kaydedildiği yerin metin açıklaması.
  video	recordingDetails.recordingDate	datetime	Videonun kaydedildiği tarih ve saat. Değer, ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) biçiminde belirtilir.

• Çeşitli API yöntemlerinin dokümanlarında artık istek gövdesinde belirtilmesi gereken veya istek gövdesindeki değerlere göre güncellenen özellikler tanımlanıyor. Aşağıdaki tabloda bu yöntemlerin yanı sıra zorunlu veya değiştirilebilir özellikler listelenmektedir.

  Not: Diğer yöntemlerle ilgili dokümanlarda zorunlu ve değiştirilebilir özellikler listelenmiş olabilir.

  Yöntem	Özellikler
  activities.insert	Zorunlu özellikler: snippet.description Değiştirilebilir özellikler: snippet.description contentDetails.bulletin.resourceId
  playlists.update	Zorunlu özellikler: id
  playlistItems.update	Zorunlu özellikler: id
  videos.update	Zorunlu özellikler: id

• Aynı kanalda zaten mevcut olan bir çalma listesiyle aynı başlığa sahip bir çalma listesi oluşturmaya veya güncellemeye çalışırsanız API artık playlistAlreadyExists hatası bildirmez.

• Çeşitli API yöntemleri yeni hata türlerini destekler. Aşağıdaki tabloda yöntem ve yeni desteklenen hatalar tanımlanmıştır:

  Yöntem	Hata türü	Hata ayrıntısı	Açıklama
  guideCategories.list	notFound	notFound	id parametresiyle tanımlanan rehber kategorisi bulunamıyor. Geçerli değerlerin listesini almak için guideCategories.list yöntemini kullanın.
  playlistItems.delete	forbidden	playlistItemsNotAccessible	İstek, belirtilen oynatma listesi öğesini silmek için uygun şekilde yetkilendirilmedi.
  videoCategories.list	notFound	videoCategoryNotFound	id parametresiyle tanımlanan video kategorisi bulunamıyor. Geçerli değerlerin listesini almak için videoCategories.list yöntemini kullanın.