İnceleme Geçmişi

Bu sayfada, YouTube Data API (v3) değişiklikleri ve doküman güncellemeleri listelenir.

2 Kasım 2026

Doğrulanmamış API projelerinden videos.insert yöntemiyle yüklenen videolar artık gizli görüntüleme moduyla kısıtlanmıyor. Bu değişiklik, 28 Temmuz 2020'de duyurulan ve bu tarihten sonra oluşturulan doğrulanmamış API projelerinden yüklenen videoları, proje denetimi tamamlanana kadar gizli görüntüleme moduyla kısıtlayan politikayı geçersiz kılar.

Bir videos.insert isteğinde status.privacyStatus özelliği için değer belirtmezseniz yüklenen videonun gizlilik durumu varsayılan olarak public olur. YouTube Yardım Merkezi'nde açıklandığı üzere, içerik üretici hesap ayarlarına bağlı olarak belirli yüklemeler varsayılan olarak private şeklinde ayarlanabilir.

15 Ekim 2026

videos.list yönteminde, status.selfDeclaredMadeForKids ve status.madeForKids özelliklerinin yalnızca istekte belirtilmeleri durumunda güncelleneceği ve atlanmaları durumunda geçersiz kılınmayacağı açıklığa kavuşturuldu.

30 Eylül 2026

comments kaynak tanımı, bir yoruma eklenen resmin veya hareketli GIF'in URL'sini sağlayan yeni snippet.imageUrl özelliğini içerecek şekilde güncellendi.

Bu özellik, Kasım 2026'da tüm kullanıcıların erişimine açılacak.

14 Eylül 2026

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

  • thumbnails.set yönteminin açıklaması, yüklenen küçük resimlerin maksimum dosya boyutunun 2 MB'tan 50 MB'a yükseltildiğini belirtecek şekilde güncellendi.
  • playlistImages.insert yöntem açıklaması, yüklenen resimler için maksimum dosya boyutunun 2 MB'tan 50 MB'a yükseltildiğini belirtecek şekilde güncellendi.

11 Eylül 2026

activities, liveBroadcasts, playlistItems, playlists, search ve videos kaynaklarının referans belgelerinde snippet.thumbnails.(key) mülkünün tanımı güncellendi. Bu güncelleme, bazı videolar için daha yüksek çözünürlüklü küçük resim boyutlarının (fhd (1080p), qhd (1440p) ve uhd (4K)) kullanılabildiğini belirtiyor.

1 Eylül 2026

videos.getRating yöntemi artık https://www.googleapis.com/auth/youtube.readonly yetkilendirme kapsamını kabul ediyor.

27 Ağustos 2026

YouTube, herkese açık görüntüleme sayısını tüm video formatlarında (uzun videolar, canlı yayınlar ve Shorts videoları) aynı şekilde ölçecek. YouTube, video oynatılmaya başladığı andan itibaren herkese açık görüntülemeleri sayar.

Para kazanma uygunluğu ve temel performans metriklerinin çoğu, etkileşim metriklerine bağlı kaldığı için etkilenmez. İçerik üreticilerin kazançları,"Aktif Shorts görüntülemeleri" ve "Aktif izlenme saati"ne göre belirlenmeye devam edecek. Bu metrikleri YouTube Analytics > Gelişmiş Mod'da görebilirsiniz.

YouTube İş Ortağı Programı'na uygunluk koşullarında herhangi bir değişiklik yapılmadı. YouTube İş Ortağı Programı'na katılım koşulları da artık "geçerli Shorts görüntülemeleri" ve "geçerli izlenme saati" (önceki adıyla "herkese açık geçerli Shorts görüntülemeleri" ve "herkese açık içeriklerin izlenme süresi") olarak adlandırılacak.

Daha fazla bilgi için YouTube içeriklerinizin performansına dair fikir edinme başlıklı makaleyi inceleyin.

Metrik Durum Tetikleyici Kullanım Alanı
Görünüm Güncellendi Video, ilk kareden itibaren oynatılır (otomatik oynatma, fareyle üzerine gelme ve oynatmak için tıklama/dokunma dahildir). Standart herkese açık görüntüleme sayısı.
Etkileşimli Görüntüleme Değiştirilmemiş Oynatma ilk kareden sonra devam eder veya kullanıcı oynatmak için tıklar/dokunur. YouTube İş Ortağı Programı üzerinden para kazanma, temel analizlerin (tıklama oranı, ortalama görüntüleme süresi) büyük bir kısmı ve etkileşim raporları.
Küçük resim gösterimi Değiştirilmemiş Küçük resim, etkileşim veya otomatik oynatma olmadan gösterilir. Feed düzeyinde görünürlüğü ve paketlemeyi ölçer.

API belgeleriyle ilgili güncellemeler: Kanallar ve videolar referans belgelerindeki viewCount alanının açıklaması güncellendi.

6 Ağustos 2026

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

  • activities.contentDetails altındaki contentDetails.like ve contentDetails.favorite alanlarına yapılan tüm referanslar, bu alanlar API tarafından döndürülmediği için herkese açık dokümanlardan kaldırıldı.

7 Temmuz 2026

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

API artık videos kaynağındaki brandPartner bölümünü destekliyor. Bu bölümde, içerik üretici tarafından başlatılan marka iş ortağı erişimi için videoya bağlı marka iş ortağıyla ilgili ayrıntılar yer alır.

brandPartner bölümü, aşağıdaki yöntemler çağrılırken belirtilebilir:

brandPartner nesnesi aşağıdaki alanları içerir:

  • channelId: Marka iş ortağının harici kanal kimliği.
  • channelHandle: Marka iş ortağının kanal herkese açık kullanıcı adı.
Bağlantı oluşturulurken channelId veya channelHandle ayarlanmalıdır ancak yanıtta yalnızca channelId döndürülür.

23 Haziran 2026

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

  • liveChatMessages altındaki messageDeletedEvent ve messageRetractedEvent kaynak türlerine (ve bunlara karşılık gelen messageDeletedDetails ve messageRetractedDetails nesnelerine) yapılan tüm referanslar, bu etkinlikler API tarafından döndürülmediği için kaldırıldı.

3 Haziran 2026

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

API artık API isteği parametreleriyle eşleşen video istatistiklerinin listesini alan yeni bir yöntemi (videos.batchGetStats) destekliyor.

Bu yönteme yapılan bir çağrının kendi ayrıntılı kota grubunda 1 birimlik kota maliyeti vardır. Yöntemin varsayılan kotası günde 10.000 birimdir.

1 Haziran 2026

YouTube Data API, videos.insert ve search.list ile başlayarak daha küçük yöntem gruplarını kapsayan ayrıntılı bir kota sistemine geçiyor.

Bu güncelleme, YouTube'un belirli yöntem kullanımına dayalı istekleri daha kolay doğrulayıp onaylamasına olanak tanıyarak kota artışlarına giden yolu basitleştirir. Bu geçiş, platformun kararlılığı ve güvenliği konusundaki taahhüdümüzün de önemli bir parçasıdır. Bu sayede her geliştirici, onaylanmış kullanım alanları için gerekli erişim düzeylerini korurken korumalı bir ekosistemde çalışabilir.

videos.insert ve search.list yöntemlerine yapılan API çağrıları, kendi kota gruplarına göre ücretlendirilir. Diğer tüm yöntemlere yapılan API çağrıları, mevcut kota grubundan ücretlendirilir. Geliştiriciler, kota sınırlarını Google Cloud Console'da görüntüleyebilir ve Kota Uzatma Formu aracılığıyla ek kota isteğinde bulunabilir.

4 Aralık 2025

YouTube Data API belgeleri ve Kota Hesaplayıcı, video yükleme işleminin kota maliyetinde yaklaşık 1.600 birimden yaklaşık 100 birime düşüşü yansıtacak şekilde güncellendi.

10 Temmuz 2025

21 Temmuz 2025'ten itibaren YouTube, video.list yönteminin mostPopular grafiği tarafından döndürülen içerikte düzenleme yapacak. Geçmişte mostPopular listesi, Trendler listesinde yer alan videoları yansıtıyordu. mostPopular listesinde artık Trend Müzik, Film ve Oyun listelerindeki videolar yer alacak. Bu API değişikliği, YouTube'un Trendler sayfasının kullanımdan kaldırılmasıyla birlikte yapılıyor.

26 Mart 2025

YouTube, 31 Mart 2025'ten itibaren Shorts videolarındaki görüntülemelerin sayılma şeklini değiştirecek. YouTube Shorts'ta daha önce, videoların saniye cinsinden belirli bir süre oynatılması görüntüleme olarak sayılıyordu. Artık Shorts görüntülemeleri hesaplanırken minimum izlenme süresine bakılmayacak. Oynatma veya tekrar oynatma işlemlerinin her biri, başladığı andan itibaren görüntüleme olarak sayılacak. Daha fazla bilgi

31 Mart 2025'ten itibaren, Data API'deki aşağıdaki alanlar bu değişiklik uyarınca Shorts görüntüleme sayısını 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. Alkol ve tütün içerikleriyle ilgili YouTube politikaları hakkında daha fazla bilgi edinin.

A/S içeriklere örnek olarak aşağıdaki videolar 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 alkol/tütün 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ğin sonlandırılmasıyla ilgili bir duyurudur.

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

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

13 Mart 2024

Not: Bu, desteğin sonlandırılmasıyla ilgili bir duyurudur.

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

captions.insert ve captions.update yöntemleri için sync parametresinin desteği sonlandırıldı. YouTube, 12 Nisan 2024'ten itibaren parametreyi desteklemeyi bırakacak.

Bu değişiklik nedeniyle, geliştiricilerin altyazı dosyası 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ının izin verilen maksimum uzunluğunun 150 karakter olduğunu belirtecek şekilde güncellendi. Parça adı bu değerden uzunsa API, nameTooLong hatası döndürür.

7 Mart 2024

Not: Bu, desteğin sonlandırılmasıyla ilgili bir duyurudur.

channel kaynak mülkü brandingSettings.channel.moderateComments kullanımdan kaldırıldı. YouTube, 7 Mart 2024'ten itibaren bu parametreyi desteklemeyecek.

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ıza olanak tanır.

9 Kasım 2023

videoId kaynağı bir API çağrısı kullanılarak 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ğin sonlandırılmasıyla ilgili bir duyurudur.

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

comments.markAsSpam yöntemine referans veren tüm belgelere 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 filtrelemenize olanak tanır.

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. YouTube Yardım Merkezi'nde canlı yayın metrikleri hakkında daha fazla bilgi bulabilirsiniz.

7 Ağustos 2023

12 Haziran 2023'te duyurulduğu üzere, search.list yönteminin relatedToVideoId parametresinin desteği sonlandırıldı. Bu parametre artık desteklenmiyor ve parametreye yapılan referanslar API dokümanlarından 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ğin sonlandırılmasıyla ilgili bir duyurudur.

search.list yönteminin relatedToVideoId parametresinin desteği sonlandırıldı. YouTube, 7 Ağustos 2023'ten itibaren parametreyi desteklemeyi durduracak.

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

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

22 Ağustos 2022

video.statistics alanları için tür ek açıklamaları, işaretsiz uzun yerine dize olarak düzeltildi.

5 Ağustos 2022

YouTube, altyazı kimliklerinin oluşturulma şeklini değiştirdi ve bu değişiklik kapsamında tüm altyazı dosyalarına yeni altyazı kimlikleri atıyor. Bu değişiklik, caption_id değerlerini depolayan uygulamalar için geriye dönük uyumsuzluk sorunu oluşturabilir ancak caption_id değerlerini depolamayan uygulamaları etkilemez.

Şu andan itibaren 1 Aralık 2022'ye kadar captions.list, captions.update, captions.download ve captions.delete yöntemleri hem eski hem de yeni altyazı dosyası kimliklerini destekleyecek. Ancak 1 Aralık 2022'den itibaren YouTube, eski altyazı dosyası kimliklerini desteklemeyi bırakacak. Bu tarihten sonra, eski bir altyazı dosyası kimliğiyle bu API yöntemlerinden herhangi birini çağırmak captionNotFound hatasına neden olur.

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

12 Temmuz 2022

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

27 Nisan 2022

videos.insert yöntem açıklaması, yüklenen videolar için maksimum dosya boyutunun 128 GB'tan 256 GB'a yükseltildiğini belirtecek şekilde güncellendi.

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 bir değişiklik değil, dokümantasyon düzeltmesidir.

15 Aralık 2021

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

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

18 Kasım 2021

YouTube platformunun tamamında video beğenmeme 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. Yani bu özellik, yalnızca API isteğinin kimliği video sahibi tarafından doğrulanmışsa videos.list uç noktasından gelen bir API yanıtına dahil edilir.

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 başvurusunda bulunmak için 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ğin sonlandırılmasıyla ilgili bir duyurudur.

commentThreads.update uç noktası kullanımdan kaldırıldı ve artık desteklenmiyor. Bu uç nokta, diğer API uç noktaları aracılığıyla kullanılabilen işlevleri kopyalıyordu. Bunun yerine comments.update yöntemini çağırabilirsiniz.

yöntemini çağırın ve kodunuz için commentThreads kaynağı gerekiyorsa commentThreads.list yöntemine ikincil bir çağrı yapın.

1 Temmuz 2021

YouTube'un API hizmetlerini kullanan tüm geliştiricilerin,varsayılan kota tahsisi olan 10.000 birimden daha fazlasını alabilmek için API Uygunluk Denetimi'ni tamamlaması gerekir. Şimdiye 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ştiriliyordu.

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ğını açıklayan bir kılavuz ekliyoruz:

  • Denetim ve Kota Artırma Formu: API Uygunluk Denetimi'ni daha önce geçmiş olan geliştiriciler, tahsis edilen kotanın artırılmasını talep etmek için bu formu doldurup gönderebilirler (ilk soruda "Mevcut kotayı korumak için uygunluk denetimini tamamlama (Yeniden denetim istendi.)" seçeneğini belirleyerek).
  • İtiraz Formu: API projeleri uygunluk denetiminden geçemeyen (veya kota birimi artırma isteği reddedilen) geliştiriciler bu formu doldurup gönderebilir.
  • Yönetim Değişikliği Formu: Bir API projesiyle ilişkili 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 geliştirici adına API istemcisi yöneten taraflar bu formu doldurup göndermelidir. Bu sayede YouTube'un API ekibi kayıtlarımızı güncelleyebilir, yeni API projesinin kullanım alanına uygunluğunu denetleyebilir ve geliştiricinin mevcut kota tahsisini doğrulayabilir.

Her yeni form, YouTube API'sini kullanım amacınız hakkında bilgi edinmemizi ve size daha iyi yardımcı olmamızı sağlar.

Daha fazla bilgiyi yeni API Uygunluk Denetimleri kılavuzumuzda bulabilirsiniz.

12 Mayıs 2021

Not: Bu, desteğin sonlandırılmasıyla ilgili bir duyurudur.

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

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

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

  • Aşağıdaki channel kaynak özellikleri kullanımdan kaldırıldı. Bu özellikler YouTube Studio kullanıcı arayüzünde ve YouTube'da zaten desteklenmiyor. Bu nedenle, API üzerinden de desteklenmeyecekler.

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

    Tüm özellikler channel kaynak temsilinden 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 özellikleri kullanımdan kaldırıldı. Bu özellikler YouTube Studio kullanıcı arayüzünde ve YouTube'da zaten desteklenmiyor. Bu nedenle, API üzerinden de desteklenmeyecekler.

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

    Bu değişiklikle birlikte, channelSection.list yönteminin hl parametresi de desteklediği özellikler artık desteklenmediği için kullanımdan kaldırıldı.

    Tüm özellikler channelSection kaynak temsilinden 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. Bu nedenle, artık API üzerinden de desteklenmeyecek.

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

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

9 Şubat 2021

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

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şlem gerçekleştirmeye çalıştığında ortaya çıkar. Örneğin, kullanıcılar yüklenen videolar oynatma listesinden video silemez veya oynatma listesinin kendisini silemez.

    Tüm durumlarda bu hata, 400 HTTP yanıt kodu (Hatalı İstek) döndürür.

  • playlistItems.list yönteminin watchHistoryNotAccessible ve watchLaterNotAccessible hataları belgelerden 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 niyetini belirtmek için oynatıcıyla etkileşime girmeden önce YouTube'un yerleştirilmiş oynatıcıları aracılığıyla bize gönderdiğiniz tüm kullanıcı verilerinden siz sorumlusunuz. Otomatik oynatmayı devre dışı bırakarak, kullanıcı oynatıcıyla etkileşime geçmeden önce YouTube ile paylaşılan verileri sınırlayabilirsiniz.
  • Yeni Bölüm III.E.4.j, sitelerinize ve uygulamalarınıza yerleştirmeden önce içeriğin Çocuklara Özel (MFK) durumunun kontrol edilmesiyle ilgilidir. API istemcinize yerleştirdiğiniz videoların ne zaman çocuklara özel olarak ayarlandığını bilmek ve yerleştirilmiş oynatıcıdan toplanan verileri buna göre işlemek sizin sorumluluğunuzdadır. Bu nedenle, herhangi bir YouTube yerleştirilmiş oynatıcısı aracılığıyla API istemcinize yerleştirmeden önce YouTube Data API hizmetini kullanarak içeriğin durumunu kontrol etmeniz gerekir.

Yeni Videonun MadeForKids durumunu bulma kılavuzunda, YouTube Data API hizmetini kullanarak bir videonun MFK durumunu nasıl bulacağınız açıklanmaktadır.

Bu değişikliklerle birlikte, Yerleştirilmiş Oynatıcı Parametresi dokümanlarına bir hatırlatma eklendi. Bu hatırlatmada, otomatik oynatmayı etkinleştirirseniz oynatıcının kullanıcı etkileşimi olmadan oynatılacağı ve bu nedenle oynatma verilerinin toplanması ve paylaşılmasının sayfa yüklendiğinde gerçekleşeceği açıklanmaktadır.

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 sürebilir.
  • statistics.videoCount özelliği, kanal sahipleri için bile yalnızca kanalın herkese açık videolarının sayısını yansıtır. Bu davranış, YouTube web sitesinde gösterilen sayılarla tutarlıdır.
  • brandingSettings.channel.keywords özelliğinde tanımlanan kanal anahtar kelimeleri, izin verilen maksimum 500 karakter sınırını aşarsa veya kaçış karakteri kullanılmamış tırnak işaretleri (") içeriyorsa kısaltılabilir. 500 karakterlik sınırın anahtar kelime başına değil, tüm anahtar kelimelerin toplam uzunluğu için geçerli olduğunu unutmayın. Bu davranış, YouTube web sitesindeki davranışla tutarlıdır.

9 Eylül 2020

Not: Bu, desteğin sonlandırılmasıyla ilgili bir duyurudur.

Bu güncelleme, aşağıdaki API değişikliklerini kapsar. Tüm değişiklikler, bu duyurunun yapıldığı tarih olan 9 Eylül 2020'de veya bu tarihten sonra yürürlüğe girecektir. Bu nedenle, geliştiriciler artık aşağıda listelenen API özelliklerinden hiçbirini kullanmamalıdır.

  • Aşağıdaki API kaynakları, yöntemleri, parametreleri ve kaynak özellikleri hemen kullanımdan kaldırılacak ve bu duyurunun yapıldığı tarihten itibaren çalışmayacak:
    • Aşağıdaki channel kaynak özellikleri:
      • statistics.commentCount mülkü
      • 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ği managedByMe parametresini true olarak ayarlarsa channels.list yönteminin API yanıtları artık prevPageToken özelliğini içermez. Bu değişiklik, diğer channels.list istekleri için prevPageToken özelliğini ve hiçbir istek için nextPageToken özelliğini etkilemez.
  • channel kaynağının contentDetails.relatedPlaylists.watchLater ve contentDetails.relatedPlaylists.watchHistory özelliklerinin desteğinin sonlandırılacağı 11 Ağustos 2016'da duyurulmuştu. playlistItems.insert yönteminin ve playlistItems.delete yönteminin bu oynatma listeleri için desteği de tamamen kullanımdan kaldırıldı ve iki özellik dokümanlardan kaldırıldı.
  • channels.list yönteminin 30 Temmuz 2013'te desteğinin sonlandırıldığı duyurulan 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 tüm alt özellikleri, 27 Kasım 2017'de desteğinin sonlandırılacağı duyurulduktan sonra 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. Bu değişiklik hemen geçerli olacak ve yalnızca çağrılan yöntemin temel maliyeti için ücret alınacak. Basitleştirilmiş kota hakkında daha fazla bilgiyi burada bulabilirsiniz.

Bu değişiklik, çoğu API çağrısının kota maliyetini biraz düşürürken bazı API çağrılarının maliyetini aynı tutar. Bu değişiklik, API çağrılarının maliyetini artırmaz. Genel olarak, Google Cloud Console'da görülebilen tahsis edilmiş kotanızın biraz daha artması muhtemeldir.

YouTube API Hizmetleri'ne erişimin devam etmesi için tüm geliştiricilerin projeleriyle ilgili uygunluk denetimini tamamlamasını önemle tavsiye ederiz.

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

28 Temmuz 2020

28 Temmuz 2020'den sonra oluşturulan doğrulanmamış API projelerinden videos.insert uç noktası aracılığıyla yüklenen tüm videolar, gizli görüntüleme moduyla kısıtlanacak. Bu kısıtlamanın kaldırılması için her projenin Hizmet Şartları'na uygunluğunu doğrulamak üzere denetimden geçmesi 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 bu kısıtlamadan kaçınabileceklerini 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 devam etmesi için tüm geliştiricilerin projeleriyle ilgili uygunluk denetimini tamamlamalarını önemle tavsiye ederiz.

21 Temmuz 2020

[28 Temmuz 2020'de güncellendi.] Bu düzeltme geçmişi girişinde belirtilen 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ğildir. Bu nedenle, doğruluk açısından belgeler geri alındı. Karışıklığı ö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ğin sonlandırılmasıyla ilgili bir duyurudur.

videos.insert yönteminin autoLevels ve stabilize parametrelerinin desteği sonlandırıldı ve her iki parametre de dokümanlardan kaldırıldı. Bu değerler yok sayılır ve yeni yüklenen videoların işlenme şeklini etkilemez.

15 Haziran 2020

Yeni YouTube Geliştirici Politikaları'na Uygunluk 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 yönergeler ve örnekler sunar.

Bu kılavuz, YouTube'un API Hizmet Şartları'nın belirli yönlerini nasıl uyguladığına dair bilgi verir ancak mevcut belgelerin yerine geçmez. Kılavuzda, geliştiricilerin API uygunluk denetimleri sırasında en sık sorduğu sorulardan bazıları ele alınmaktadır. Bu kılavuzun, politikalarımızı nasıl yorumlayıp uyguladığımızı anlamanıza yardımcı olarak özellik geliştirme sürecinizi kolaylaştıracağını umuyoruz.

4 Haziran 2020

Not: Bu, daha önce yapılan bir desteği sonlandırma duyurusunun güncellemesidir.

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

17 Nisan 2020

Not: Bu, desteğin sonlandırılmasıyla ilgili bir duyurudur.

YouTube, kanal bülteni özelliğini kullanımdan kaldırıyor. Bu nedenle, activities.insert yöntemi kullanımdan kaldırılacak ve activities.list yöntemi kanal bültenlerini döndürmeyi durduracak. Bu değişiklikler, 18 Mayıs 2020'de veya bu tarihten sonra API'de geçerli olacaktır. Daha fazla bilgi için 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 ü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 modu 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ğının desteği sonlandırıldı. API istemcileri, sponsors.list yöntemine yapılan çağrıları members.list yöntemini kullanacak şekilde güncellemelidir.

    • 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 seviyelerinin listesini alır.

10 Ocak 2020

API artık YouTube'un "çocuklara özel" olarak adlandırdığı çocuklara yönelik içerikleri tanımlama özelliğini destekliyor. "Çocuklara özel" içerikler hakkında daha fazla bilgiyi YouTube Yardım Merkezi'nde bulabilirsiniz.

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

  • selfDeclaredMadeForKids özelliği, içerik üreticilerin bir kanalın veya videonun çocuklara özel olup olmadığını belirtmesine olanak tanır.

    Kanallar için bu özellik, channels.update yöntemi çağrılırken ayarlanabilir. Videolar için bu özellik, videos.insert veya videos.update yöntemleri çağrılırken ayarlanabilir.

    Bu özelliğin yalnızca kanal sahibinin API isteğini yetkilendirmesi durumunda channel veya video kaynaklarını içeren API yanıtlarına dahil edildiğini unutmayın.
  • madeForKids özelliği, tüm kullanıcıların bir 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 için kitle ayarlama hakkında daha fazla bilgi edinmek istiyorsanız YouTube Yardım Merkezi'ni ziyaret edin.

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ı - Sürüm Geçmişi'ni inceleyin. YouTube API Hizmetleri Hizmet Şartları ve Geliştirici Politikaları'nda yapılan değişiklikler, Pasifik Saati'ne göre 10 Ocak 2020'de yürürlüğe girecek.

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ı basamağa yuvarlanır. Bu değişiklik, channel kaynağının statistics.subscriberCount özelliğini etkiler.

Not: Bu değişiklik, kullanıcının kendi kanalıyla ilgili veriler için yetkili bir istek gönderdiği durumlarda 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ığı 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çıklayacak ve API Gezgini widget'ı aracılığıyla dinamik, yüksek kaliteli kod örnekleri sunacak şekilde 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ğerlerini girmenize, ardından gerçek API istekleri gönderip gerçek API yanıtlarını görmenize olanak tanır. Widget'ta, girdiğiniz kapsamları ve değerleri kullanacak şekilde dinamik olarak güncellenen tam kod örneklerini gösteren bir tam ekran görünümü de bulunur.

    • Yaygın kullanım alanları bölümünde, sayfada açıklanan yöntemin bir veya daha fazla yaygın kullanım alanı açıklanır. Örneğin, belirli bir kanalla veya mevcut kullanıcının kanalıyla ilgili 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 doldurulmuş olarak açabilirsiniz. Bu değişiklikler, kendi uygulamanızda uygulamaya çalıştığınız kullanım alanına doğrudan uygulanabilen kod örneklerini görmenizi kolaylaştırmayı amaçlar.

    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, değerleri API Gezgini'ne yükleyebilir ve Java, JavaScript, PHP ve Python dillerinde kod örnekleri almak için tam ekran API Gezgini'ni açabilirsiniz.

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

  • Java, JavaScript, PHP ve Python için hızlı başlangıç kılavuzları güncellendi. Yenilenen kılavuzlarda, API Gezgini'ndeki kod örnekleri kullanılarak bir örneğin API anahtarıyla, başka bir ö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 mülküyle ilgili tanım, uygulamanızda küçük resimler gösterilirken 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 resim URL'leri yalnızca https alanında kullanılabilir. URL'ler API yanıtlarında bu şekilde görünür. Bu tarihten sonra, uygulamanız http alanından YouTube resimlerini yüklemeye çalışırsa bozuk resimler görebilirsiniz.

  • Not: Bu, desteğin sonlandırılmasıyla ilgili bir duyurudur.

    video kaynağının recordingDetails.location.altitude özelliği kullanımdan kaldı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

Eski adı Uygulama ve Geçiş Rehberi olan Uygulama kılavuzu, v2 API'den v3 API'ye geçiş talimatlarını kaldıracak şekilde 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ğin sonlandırılmasıyla ilgili bir duyurudur.

    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 bu 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 çağrılırken invideoPromotion bölümünü alma girişimleri boş bir invideoPromotion döndürür veya hiç invideoPromotion verisi döndürmez.
    • channels.update çağrı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ılmayan girişimler olarak değerlendirilir. Yani, aslında bir güncelleme gerçekleştirmezler.

    27 Mayıs 2018'den sonra bu istekler, örneğin invalidPromotion değerinin 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ünür.

    Özelleştirilebilir örnekler, Node.js uygulaması için kullanım alanına özel 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ıç kılavuzunda yer almayan bazı hizmet işlevleri bulunur:

    • removeEmptyParameters işlevi, API isteği parametrelerine karşılık gelen anahtar/değer çiftlerinin listesini alır ve değeri olmayan 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 dizi ö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ü, indirilip yerel olarak çalıştırılacak şekilde tasarlanmıştır. Daha fazla bilgi için kod snippet'i aracı talimatlarında tam kod örneklerini yerel olarak çalıştırmayla ilgili ön koşulları 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. Örneklerin tamamını (ve bu değişikliği) görmek için:

    1. Etkileşimli kod snippet'i aracına veya herhangi bir API yönteminin (ör. channels.list yöntemi) belgelerine gidin.
    2. Kod örneklerinin üstündeki Python sekmesini tıklayın.
    3. Sekmelerin üst kısmındaki açma/kapatma düğmesini tıklayarak snippet'ten tam örneğe geçebilirsiniz.
    4. Sekmede artık InstalledAppFlow yetkilendirme akışını kullanan eksiksiz bir kod örneği gösterilir. Örneğin üstündeki açıklamada bu durum açıklanmakta ve bir web sunucusu uygulaması örneğine bağlantı verilmektedir.
    5. Web sunucusu örneğine geçmek için bağlantıyı tıklayın. Bu örnekte Flask web uygulaması çerçevesi ve farklı bir yetkilendirme akışı kullanılır.

    Bu örneklerin tümü, indirilip yerel olarak ç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 talimatlarını 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 kısıtladığı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 için etkileşimli kod snippet'i aracı, artık aracın bazı özelliklerini açıklayan dokümanlar içeriyor:
    • API isteklerini yürütme
    • Kod snippet'leri ile tam kod örnekleri arasında geçiş yapma
    • Standart işlevleri kullanma
    • Mevcut kaynaklar yükleniyor (güncelleme yöntemleri için)

    Not: Bu 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:

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 dillerindeki kod snippet'lerini görüntüleyip özelleştirmenize olanak tanıyan etkileşimli bir araç bulunuyor.

    Araç, belirli bir yöntem için bir veya daha fazla kullanım alanına ait kod snippet'lerini gösterir. Her kullanım alanı, ilgili yöntemi çağırmanın yaygın bir yolunu 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şim kurabilirsiniz:

    • 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 ile tam örnekler arasında geçiş yapın. Kod snippet'i, API yöntemini çağıran kodun bölümünü gösterir. Tam örnekte bu snippet'in yanı sıra istekleri yetkilendirmek ve göndermek için ortak metin kodu bulunur. Tam örnekler kopyalanabilir ve komut satırından veya yerel bir web sunucusundan çalıştırılabilir.

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

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

  • Data API 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ı ortak metin kodu.

27 Nisan 2017

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

30 Mart 2017

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

  • channel kaynağının yeni topicDetails.topicCategories[] mülkü, kanalın içeriğini açıklayan Wikipedia URL'lerinin listesini içerir. URL'ler, kaynağın topicDetails.topicIds[] mülkünde 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. Kaynak, öğenin oynatma listesine eklendiği zamanı tanımlayan snippet.publishedAt özelliğini zaten içeriyor.
  • 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ür. video kaynakları için URL'ler, kaynağın topicDetails.relevantTopicIds[] mülkünde 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

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

Seçilmiş listede birkaç değişiklik yapıldığını unutmayın:

  • Aşağıdaki konular Society konusunun alt konuları olarak eklendi:
    Adkonu kimliği
    İşletme/m/09s1f
    Sağlık/m/0kt51
    Askeriye/m/01h6rj
    Politika/m/05qt0
    Din/m/06bvp
  • Daha önce Entertainment konusunun alt konusu olan Animated cartoon konusu kaldırıldı.
  • Daha önce Music konusunun alt konusu olan Children's music konusu kaldırıldı.

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

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ılmıştır:

    • Daha önce Sports kategorisinin alt kategorisi olan Professional wrestling kategorisi, artık Entertainment kategorisinin alt kategorisidir.
    • Entertainment kategorisinin alt kategorisi olan TV shows kategorisi yeni.
    • Daha önce Lifestyle kategorisinin alt kategorisi olan Health kategorisi kaldırıldı.

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

10 Kasım 2016

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

  • İlk olarak 11 Ağustos 2016'da duyurulduğu üzere, Freebase ve Freebase API'nin kullanımdan kaldı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, şimdiye kadar döndürülen çok daha ayrıntılı kimlik grubu yerine küçük bir konu kimliği grubu döndürmeye başlayacak. Ayrıca, kanalların ve videoların herhangi bir konuyla ilişkilendirileceğinin garanti edilmediğini unutmayın. 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.

  • Not: Bu, desteğin sonlandırılmasıyla ilgili bir duyurudur.

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

    • 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çermeyecektir. (Bu tarihten sonra, topicDetails.relevantTopicIds[] özellik değeri bir videoyla ilişkili tüm konuları tanımlayacaktır.)

  • Freebase kullanımdan kaldırıldığı için Freebase Konularıyla Arama kılavuzu belgelerden kaldırıldı. Bu kılavuzda, bir uygulamanın Freebase API ile nasıl çalışacağını gösteren kod örnekleri verilmiştir.

    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ği, maxHeight veya maxWidth parametrelerinden en az biri için bir değer belirtiyorsa döndürülür. Bu iki yeni parametre, bu düzeltme geçmişi girişinin ilerleyen kısımlarında açıklanmıştır.

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

      • Yeni fpbRatingReasons[], videonun FPB (Güney Afrika) derecelendirmesini alma 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ında player bölümünü alırken parametrelerden birini veya her ikisini birden kullanabilirsiniz.

      Varsayılan olarak, player.embedHtml özelliğinde döndürülen <iframe> yüksekliği 360 pikseldir. Genişlik, videonun en-boy oranına uyacak şekilde ayarlanır. Böylece yerleştirilmiş oynatıcıda videoyu çevreleyen 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ı gerektiğini belirtebilirsiniz. API sunucusu, yerleştirilmiş oynatıcının videoyu çerçeveleyen siyah çubuklara sahip olmamasını 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 belirtilirse bir boyut, o boyut için izin verilen maksimum miktardan daha küçük olabilir.

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

      • maxHeight parametresi 720 olarak ayarlanırsa ve maxWidth parametresi ayarlanmazsa API, 1280x720 boyutunda bir oynatıcı döndürür.
      • maxWidth parametresi 960 olarak ayarlanırsa ve maxHeight parametresi ayarlanmazsa API, 960x540 boyutunda bir oynatıcı döndürür.
      • maxWidth parametresi 960, maxHeight parametresi ise 450 olarak ayarlanırsa API, 800x450 boyutunda 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öntemler, özellikler ve parametrelerde yapılan güncellemeler

    • channelSection kaynak açıklaması, bir kanalın hedefleme verilerini ayarlamadan en fazla 10 raf, hedefleme verileriyle ise en fazla 100 raf oluşturabileceğini belirtecek şekilde güncellendi.

      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 mülküne ait tanım, değerin bir dilin adını i18nLanguage.list yönteminin hl parametresiyle belirtilen dilde yazıldığı şekilde 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 özellikleri kullanımdan kaldırıldı. playlistItems.insert veya playlistItems.update isteklerinde ayarlanmışsa bu alanlar yoksayılır.

    • playlistItems.delete ve playlistItems.update yöntemleri artık diğer birçok yöntem için desteklenen onBehalfOfContentOwner parametresini destekliyor. Bu yöntemi kullanan 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 dahil olduğunu gösterecek şekilde güncellendi. Örneğin, publishedBefore parametresi ayarlanırsa API, belirtilen zamanda veya daha önce 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önteminin açıklaması, yüklenen videolar için maksimum dosya boyutunun 64 GB'tan 128 GB'a yükseltildiğini belirtecek şekilde güncellendi.

  • 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 üzerinden kullanılamadığını belirtmek için bu hatayı döndürür. Bu hata, yetkisiz bir istekte home parametresini true olarak ayarlarsanız 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 nedenlerinden biri, 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 bunların 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ınamayacağı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ı belirlemeye ç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 atabilirsiniz.

    • Bir oynatma listesine yinelenen video eklediğinizde playlistItems.insert yöntemi artık hata döndürmez. Bu hata daha önce, yinelenenlere izin vermeyen ancak artık desteklenmeyen bazı oynatma listelerinde (ör. beğenilen videolar) ortaya çıkıyordu. 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 özelliklerinin bir yanıta dahil edildiğinde her zaman sırasıyla HL ve WL değerlerini içerdiğini açıklayacak şekilde 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 düzeltme geçmişi güncellemesinde, desteklenen konu kimlikleri grubunun 10 Şubat 2017'den itibaren değişeceği de dahil olmak üzere konu kimlikleriyle ilgili çeşitli değişiklikler ele alınmıştır. Desteklenecek konuların listesi 10 Kasım 2016'ya kadar yayınlanacaktır.

  • Aşağıdaki değişiklikler artık geçerlidir. Bu değişiklikler, 11 Ağustos 2016 tarihli düzeltme geçmişi güncellemesinde bildirilmiştir:

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

      Bu, 11 Ağustos 2016 tarihli düzeltme geçmişi güncellemesinde açıklanan davranıştan daha iyi bir kullanıcı deneyimi sunmayı amaçlayan küçük bir değişikliktir. Bu güncellemede, home parametresini kullanan 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.

      Açıklamak gerekirse 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) veya oynatma listesi öğelerini (playlistItems.list) alma istekleri artık boş listeler döndürüyor. Bu davranış, yeni değerler (HL ve WL) için olduğu kadar API istemcinizin önceden depolamış olabileceği izleme geçmişi veya daha sonra izle oynatma listesi kimlikleri için de geçerlidir.

  • video kaynağının fileDetails.recordingLocation nesnesi ve alt mülkleri artık döndürülmez. 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ştirici Blogu'nda ayrıntılı olarak ele alınan ve yeni yayınlanan YouTube API Hizmetleri Hizmet Şartları ("Güncellenen Şartlar"), mevcut Hizmet Şartları'nda yapılan birçok güncellemeyi içerir. 10 Şubat 2017'den itibaren geçerli olacak Güncellenmiş Şartlar'a ek olarak bu güncelleme, geliştiricilerin uyması gereken politikaları açıklamaya yardımcı olacak çeşitli destekleyici belgeler içerir.

    Yeni belgelerin tamamı, Güncellenen Şartlar'ın düzeltme geçmişinde açıklanmıştır. Ayrıca, Güncellenen Şartlar'da veya bu destekleyici belgelerde gelecekte yapılacak değişiklikler de bu düzeltme geçmişinde açıklanacaktır.

  • Freebase ve Freebase API'nin kullanımdan kaldı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ü, videoyla 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, şimdiye kadar döndürülen çok daha ayrıntılı kimlik grubu yerine küçük bir konu kimliği grubu döndürmeye başlayacak. Desteklenen bu konular, Spor veya Basketbol gibi üst düzey kategorileri tanımlar ancak belirli takımları veya oyuncuları tanımlamaz. Uygulamanızı bu değişikliğe hazırlamanız için desteklenen konuları önceden duyuracağız.

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

    • 10 Şubat 2017'den sonra, desteklenen konu kimliklerinin daha küçük kümesinde yer almayan bir konu kimliği kullanarak sonuçları aramaya çalışırsanız API boş bir sonuç kümesi döndürür.

  • 12 Eylül 2016'dan itibaren çeşitli API alanları ve parametreleri kullanımdan kaldırılacaktır:

    • activities.list yönteminin home parametresi, yetkili bir kullanıcının YouTube ana sayfasında gösterilecek etkinlik feed'ini almasına olanak tanı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, tüm kanallar için contentDetails.relatedPlaylists.watchHistory HL değerini ve contentDetails.relatedPlaylists.watchLater özelliği 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ürecektir. Bu tarihten sonra, söz konusu oynatma listelerindeki öğeleri (playlistItems.list) alma istekleri de boş bir liste döndürür. Bu durum, yeni değerler (HL ve WL) ve API istemcinizin önceden depolamış olabileceği izleme geçmişi veya daha sonra izle oynatma listesi kimlikleri için geçerlidir.

    • video kaynağının fileDetails.recordingLocation nesnesi veya alt özelliklerinden herhangi biri 12 Eylül 2016'dan sonra döndürülmeyecek. Üst fileDetails nesnesi yalnızca video sahibi tarafından alınabildiğinden bu veriler de 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ği kullanımdan kaldırıldı. Önceden bu özellik, yalnızca kanal bir Google+ profiliyle ilişkilendirilmişse kullanılabiliyordu. Desteğin sonlandırılmasının ardından bu özellik artık hiçbir channel kaynağına dahil edilmeyecek.

  • comment kaynağının snippet.authorGoogleplusProfileUrl özelliği kullanımdan kaldırıldı. Önceden bu özellik, yalnızca kanal bir Google+ profiliyle ilişkilendirilmişse kullanılabiliyordu. Desteğin sonlandırılmasının ardından bu özellik artık hiçbir comment kaynağına dahil edilmeyecek.

Kullanımdan kaldırıldıktan sonra bu özelliklerin ikisi de döndürülmeyeceğinden, her iki özellik de ilgili kaynak belgelerinden 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 oldukları zamana 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 kullanıcının alınmasını desteklediğini unutmayın. Abonelerin tam listesini almak için mySubscribers parametresini kullanın. Aboneleri belirli bir sırayla döndürmeyen bu parametre, alınabilecek abone sayısını sınırlamaz.

  • snippet.thumbnails.(key) özelliğinin tanımı; activity, playlistItem, playlist, arama sonucu, thumbnail ve video kaynakları için güncellenerek bazı videolar için ek küçük resim boyutlarının kullanılabildiği belirtildi.

    • standard resmi 640 piksel genişliğinde ve 480 piksel yüksekliğindedir.
    • maxres resmi 1280 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, uygun şekilde yetkilendirilmemiş bir istek bir video kaynağının fileDetails, processingDetails veya suggestions bölümlerini almaya çalıştığında artık yasak (403) hatası döndürüyor. Bu bölümleri yalnızca videonun sahibi görebilir.

17 Mayıs 2016

Yeni Data API Code Snippets aracı, yaygın YouTube Data API 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ç, kod snippet'lerini sağladığınız parametre değerlerini yansıtacak şekilde 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ğerlerini temel alır. 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çıklayacak şekilde 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 özellik değeri sabittir ve yüklenen orijinal video dosyasıyla ilişkili konumu temsil eder. Bu değer yalnızca videonun sahibi tarafından görülebilir.

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

  • comments.insert, 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.

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 Developers 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öntemlerde yapılan güncellemeler

    • channelBanner kaynak dokümanı, yüklenen kanal banner'ı resmi için önerilen boyutun 2560 piksel x 1440 piksel olduğunu belirtecek şekilde güncellendi. Minimum boyut (2048 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 uygunluk koşulları ve URL'nin nasıl oluşturulacağı açıklanmaktadır.

    • channel kaynağının brandingSettings.watch nesnesi ve tüm alt özellikleri kullanımdan kaldırıldı.

    • search.list isteğine verilen API yanıtı artık bir regionCode özelliği içeriyor. Bu özellik, arama sorgusu için kullanılan bölge kodunu tanımlar. Bölge kodu, API'ye belirtilen ülke için arama sonuçlarını döndürme talimatı 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. 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ı, kötüye kullanım raporu nedenleri için yerelleştirilmiş etiket metni içerecek ş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'dir.

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

      Ayrıca, diğer derecelendirme sistemleri için API özellikleri aşağıdaki yeni özellik değerlerini destekler:

      • contentDetails.contentRating.fpbRating (Güney Afrika)
        Derecelendirme: 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ın liveStreamingDetails.activeLiveChatId özelliği, videoyla 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 gösterilir. Yayın sona erdikten ve canlı sohbet bittikten sonra özellik artık video için döndürülmez.

    • video kaynağının status.rejectionReason özelliği, yeni özellik değeri olan legal değerini destekler.

  • 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 bildirmek ü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 bildirmek ü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. İstek gövdesindeki commentThread kaynağının yapısını kontrol ederek geçerli olduğundan emin olun.
    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 başka bir dizi oynatma listesinde bulunduğunu belirtmek için bu hatayı döndürür. Dizi listeler hakkında daha fazla bilgi için YouTube Yardım Merkezi'ni ziyaret edin.
    badRequest (400) subscriptionForbidden subscriptions.insert yöntemi, maksimum abonelik sayınıza ulaştığınızı veya son zamanlarda çok fazla abonelik oluşturduğunuzu belirtmek için bu hatayı döndürür. İkinci durumda, isteği birkaç saat sonra tekrar deneyebilirsiniz.
    badRequest (400) invalidCategoryId videos.update yöntemi, yüklenen video kaynağındaki snippet.categoryId özelliğinin geçersiz bir kategori kimliği belirttiğini göstermek 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 göstermek için bu hatayı döndürür.
    badRequest (400) invalidPublishAt videos.update yöntemi, yüklenen video kaynağındaki status.publishAt özelliğinin geçersiz bir planlanmış yayınlama zamanı belirttiğini göstermek 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 bildirmek 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 göstermek 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 bildirmek 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üncelliyor ancak hem snippet.title hem de snippet.categoryId özellikleri için bir değer ayarlamıyorsa ortaya çıkar.

18 Aralık 2015

Avrupa Birliği (AB) yasaları uyarınca, AB'deki son kullanıcılara belirli açıklamaların yapılması ve bu kullanıcılardan izin alınması zorunludur. 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 bir 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 özellikleri, channelSection kaynağının snippet.title özelliği ve channel kaynağının snippet.description özelliği için yerelleştirilmiş metin ayarlama ve alma özelliğini destekliyor.

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

    Bir kaynağın insert veya update yöntemini çağırırken o kaynak için yerelleştirilmiş değerler ayarlayabilirsiniz. Bir kaynağın yerelleştirilmiş değerlerini ayarlamak için 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 istiyorsanız 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 Almanca ve İspanyolca dillerinde yerelleştirilmiş 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 yerel verilerini güncellediğinizde API isteğinizin, verilerin mevcut tüm yerelleştirilmiş sürümlerini içermesi gerektiğini unutmayın. Örneğin, yukarıdaki örnekte yer alan videoya Portekizce verileri eklemek için daha sonra bir istek gönderirseniz bu 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:

    • YouTube web sitesinin desteklediği belirli bir uygulama diline ait yerelleştirilmiş verileri almak için channels.list, channelSections.list, playlists.list veya videos.list isteğinize hl parametresini ekleyin. 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 dilinde kaynak ayrıntılarını içerir.

      Örneğin, bir videos.list isteğinin, yukarıda açıklanan video için yerelleştirilmiş Almanca ve İspanyolca verileri aldığını varsayalım. 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 ayarlanmışsa snippet.localized nesnesi İngilizce başlık ve açıklamayı içerir. Bunun nedeni, İngilizcenin kaynak için varsayılan dil olması ve yerelleştirilmiş Fransızca ayrıntıların mevcut olmaması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 İngilizcesinde mevcut olup olmadığını belirlemek için yerelleştirmelerin tam listesini almanız gerekir.

    • Bir kaynağı alırken, o kaynağın tüm yerelleştirilmiş ayrıntılarını almak için part parametre değerine localizations ekleyin. Mevcut YouTube uygulama dillerinden biri olmayan bir dil için yerelleştirilmiş verileri alıyorsanız tüm yerelleştirmeleri almak için bu yaklaşımı kullanmanız ve ardından istenen yerelleştirilmiş verilerin mevcut olup olmadığını belirlemek için filtrelemeniz 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, ilgili 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öntemlerde yapılan güncellemeler

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

    • search.list yönteminin relatedToVideoId parametresi, parametre ayarlanırsa desteklenen diğer parametrelerin yalnızca part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (video olarak ayarlanmalıdır) ve fields olduğunu belirtecek şekilde güncellendi. Bu güncelleme, API davranışında bir değişiklik olduğu anlamına gelmez.

    • video kaynağının snippet.publishedAt özelliğinin tanımı, videonun yayınlandığı tarih ve saati belirten özellik değerinin, videonun yüklendiği zamandan farklı olabileceğini belirtecek şekilde güncellendi. Örneğin, bir video gizli olarak yüklenip daha sonra herkese açık hale getirilirse özellik 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ı şu şekilde güncellendi:

      • videos.update yöntemini çağırırken bu özelliğin değerini ayarlarsanız video zaten gizli olsa bile status.privacyStatus özellik değerini 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 değerini private yerine public olarak değiştirmekle aynıdır.

    • video kaynağının contentDetails.contentRating.cncRating özelliği, videonun Fransa'daki Commission de classification cinematographique tarafından belirlenen derecelendirmesini belirtir. Bu özellik, artık kullanımdan kaldırılmış olan contentDetails.contentRating.fmocRating özelliğinin yerini alır.

    • channel kaynağının brandingSettings.channel.keywords tanımı, özellik değerinin daha önce belirtildiği gibi virgülle ayrılmış bir dize listesi değil, boşlukla ayrılmış bir dize listesi içerdiğini doğru şekilde yansıtacak şekilde güncellendi. Bu güncelleme, API davranışında bir değişiklik olduğu anlamına gelmez.

    • thumbnails.set yönteminin dokümanları, isteğin gövdesinde yüklediğiniz ve bir videoyla ilişkilendirdiğiniz küçük resmin yer aldığını doğru şekilde yansıtacak şekilde güncellendi. İstek gövdesi bir thumbnail kaynağı içermiyor. Daha önce, bu yöntemi çağırırken istek gövdesi sağlamamanız gerektiği belirtiliyordu. Bu güncelleme, API davranışında bir değişiklik olduğu anlamına gelmez.

    • 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 değerleri 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 kodubadRequest (400)
      NedeninvalidMetadata
      Açıklamakind özelliği, sağlanan kimlik türüyle eşleşmiyor.
      commentThreads.update
      comments.insert
      comments.update
      HTTP yanıt kodubadRequest (400)
      NedencommentTextTooLong
      AçıklamaEklenen veya güncellenen comment kaynağının snippet.topLevelComment.snippet.textOriginal özelliğinde çok fazla karakter var.
      playlistItems.insert
      playlistItems.update
      HTTP yanıt koduforbidden (403)
      NedenplaylistItemsNotAccessible
      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 kodubadRequest (400)
      NedenplaylistForbidden
      AçıklamaBu işlem yasaklanmış veya istek düzgün şekilde yetkilendirilmemiş.
      search.list
      HTTP yanıt kodubadRequest (400)
      NedeninvalidLocation
      Açıklamalocation ve/veya locationRadius parametre değeri yanlış biçimlendirilmiş.
      search.list
      HTTP yanıt kodubadRequest (400)
      NedeninvalidRelevanceLanguage
      AçıklamarelevanceLanguage parametre değeri yanlış biçimlendirilmiş.
      subscriptions.insert
      HTTP yanıt kodubadRequest (400)
      NedensubscriptionForbidden
      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.
      • Son zamanlarda çok fazla abonelik oluşturduğunuz için isteği yeniden denemeden önce birkaç saat beklemeniz gerekiyor.
      videos.update
      HTTP yanıt kodubadRequest (400)
      NedeninvalidDefaultBroadcastPrivacySetting
      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öntemlerde yapılan güncellemeler

    • video kaynağının statistics.favoriteCount özelliği kullanımdan kaldı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 edecek. Ancak özellik 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öntemlerde yapılan güncellemeler

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

      Daha açık belirtmek gerekirse tanımda artık bir etiketin boşluk içermesi durumunda 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ırlamasına dahil edildiği açıklanıyor. Dolayısıyla, karakter sınırlaması açısından Foo-Baz etiketi yedi karakter, Foo Baz etiketi ise dokuz karakter içerir.

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

18 Haziran 2015

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

  • Mevcut kaynaklar ve yöntemlerde yapılan güncellemeler

    • commentThreads.list yönteminin yeni order parametresi, API yanıtının yorum dizilerini listelemesi gereken sırayı belirtir. Mesaj dizileri 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ın contentDetails.licensedContent mülküyle 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şiklik olduğu anlamına gelmez.

    • captions.delete, captions.download, captions.insert, captions.list ve captions.update yöntemleri artık onBehalfOfContentOwner parametresini destekliyor. Bu parametre, diğer bazı yöntemler için zaten destekleniyordu. Bu yöntemi kullanan 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 kodubadRequest (400)
      NedenemailNotVerified
      AçıklamaKullanıcı, videoyu değerlendirmeden önce e-posta adresini doğrulamalıdır.
      videos.rate
      HTTP yanıt kodubadRequest (400)
      NedenvideoPurchaseRequired
      AçıklamaKiralık videolar yalnızca kiralayan kullanıcılar tarafından değerlendirilebilir.

    • 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ğı, bir videonun kötüye kullanım amaçlı içerik barındırdığı için işaretlenmesine neden olan bir gerekçe hakkında bilgi içerir. videoAbuseReportReasons.list yöntemi, videoların işaretlenme nedenlerinin tümünü içeren bir liste almanızı sağlar.

    • Yeni videos.reportAbuse yöntemi, kötüye kullanım amaçlı içerik barındıran videoları işaretlemenize olanak tanır. İsteğin gövde bölümünde, işaretlenen videoyu ve videonun kötüye kullanım amaçlı içerik barındırdığına karar verilmesinin nedenini belirten bir JSON nesnesi bulunur. Geçerli nedenler, yukarıda açıklanan videoAbuseReportReason.list yönteminden alınabilir.

      Geçiş rehberi de kötüye kullanım amaçlı bir videonun bildirilmesiyle ilgili bir örnekle güncellendi. Bu değişiklikle birlikte v3 API, desteklemesi planlanan tüm v2 API özelliklerini destekler. Bu özelliklerin tümü geçiş rehberinde de açıklanmıştır.

  • Mevcut kaynaklar ve yöntemlerde yapılan güncellemeler

    • search.list yönteminin yeni forDeveloper filtre parametresi, aramayı yalnızca geliştiricinin uygulaması veya web sitesi aracılığıyla yüklenen videoları alacak şekilde kısıtlar. 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, geliştiriciler sonuçları kendi uygulamaları veya web siteleri ü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ğının snippet.country özelliğini ayarlamak için 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çütleri karşılayan kullanıcılarla kısıtlamanın bir yolunu sunar.

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

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

    • channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete ve videos.delete yönteminin belgeleri, başarılı olduğunda 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 Eklenen channelSection kaynağı, targeting.countries[] özelliği için geçersiz bir değer içeriyorsa channelSections.insert ve channelSections.update yöntemleri bu hatayı döndürür.
      badRequest (400) targetInvalidLanguage Eklenen channelSection kaynağı, targeting.languages[] özelliği için geçersiz bir değer içeriyorsa channelSections.insert ve channelSections.update yöntemleri bu hatayı döndürür.
      badRequest (400) targetInvalidRegion Eklenen channelSection kaynağı, targeting.regions[] özelliği için geçersiz bir değer içeriyorsa channelSections.insert ve channelSections.update yöntemleri bu hatayı döndürür.
      badRequest (400) operationNotSupported API kullanıcısı, snippet.parentId mülkü tarafından 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 görüntüleyenin 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:

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

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

    • Kanal hakkındaki yorumları alma
    • Bir kanalla ilgili tüm yorum dizilerini alma. Bu durumda API yanıtı, kanalla veya kanaldaki videolarla ilgili yorumlar içerebilir.
    • Yorum metnini güncelleme
    • Yorumları spam olarak işaretleme
    • Yorumun moderasyon durumunu ayarlama

  • Push bildirimlerine abone olma kılavuzu, bildirimlerin yalnızca Google PubSubHubBub merkezine gönderildiğini ve daha önce belirtildiği gibi Superfeedr merkezine gönderilmediğ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ğı, bir YouTube yorum dizisi hakkında bilgi içerir. Bu dizi, üst düzey bir yorum ve varsa bu yoruma verilen yanıtlardan oluşur. commentThread kaynağı, bir video veya kanalla ilgili yorumları temsil edebilir.

      Üst düzey yorum ve yanıtlar, aslında commentThread kaynağının içine yerleştirilmiş comment kaynaklarıdır. commentThread kaynağının bir yorumun tüm yanıtlarını içermeyebileceğini ve belirli bir yorumun tüm yanıtlarını almak istiyorsanız comments.list yöntemini kullanmanız gerektiğini unutmayın. Ayrıca bazı yorumların yanıtı yoktur.

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

      • commentThreads.list: Yorum 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şturur. (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 yorumu hakkında bilgi içerir. comment kaynağı, bir video veya kanalla ilgili 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şturun.
      • comments.update: Yorumu değiştirme
      • comments.markAsSpam: Bir veya daha fazla yorumu spam olarak işaretleyin.
      • comments.setModerationStatus: Bir veya daha fazla yorumun moderasyon durumunu ayarlayın. Örneğin, bir yorumu herkese açık olarak gösterilmek üzere onaylayabilir veya gösterilmeye uygun olmadığı için reddedebilirsiniz. API isteği, yorumlarla ilişkili kanalın veya videonun sahibi tarafından yetkilendirilmelidir.
      • comments.delete: Yorum silme

    API'nin 2 Nisan 2015 tarihli düzeltme geçmişinde açıklanan 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 yönelik çağrılar için gerekli olduğunu unutmayın.

  • Yeni Push bildirimlerine abone olma kılavuzunda, API'nin web'den erişilebilen kaynaklar için sunucudan sunucuya yayınlama/abone olma protokolü olan PubSubHubBub aracılığıyla push bildirimleri için 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üklediğinde
    • Bir videonun başlığını günceller
    • Bir videonun açıklamasını günceller.

  • Geçiş rehberi de push bildirimleri için yeni desteği belirtecek ş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 söz edilmesi, ilgili kılavuzun Desteği sonlandırıldı bölümünde hâlâ yer almaktadır.

  • API'nin yeni https://www.googleapis.com/auth/youtube.force-ssl kapsamı, daha önce https://www.googleapis.com/auth/youtube kapsamını destekleyen tüm API yöntemleri için artık 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 subscriptionLimitExceeded hatasını desteklemiyor. Bu hata, daha önce istekle tanımlanan abonenin abonelik sıklık sınırlamasını aştığını gösteriyordu.

2 Nisan 2015

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

  • Yeni captions kaynağı, bir YouTube altyazı dosyasını temsil eder. Bir altyazı dosyası tam olarak bir YouTube videosuyla ilişkilendirilir.

    API; altyazı dosyalarını listeleme, ekleme, güncelleme, indirme ve silme yöntemlerini destekler.

  • Geçiş rehberi de v2 API'deki 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. 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 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) geçiş rehberi, v3 API'nin desteklediği ve v2 API'nin desteklemediği özellikleri listeleyen v3 API'deki yenilikler adlı yeni bir sekme içerir. Aynı özellikler daha önce de kılavuzun diğer sekmelerinde listeleniyordu ve hâlâ listeleniyor. Ö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) geçiş rehberi, v3 API'nin aşağıdaki v2 API özelliğini destekleyeceğini belirtecek şekilde güncellendi:

  • YouTube Data API (v3) geçiş 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ı için ö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 kaynak, önerilen bir videoya karşılık gelir. Bu durumda, contentDetails.recommendation.reason ve contentDetails.recommendation.seedResourceId özellikleri videonun neden önerildiğine dair bilgiler 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 etkinlik feed'lerini izlemek için Basit Güncelleme Protokolü (SUP) veya PubSubHubbub'ı kullanarak push bildirimlerini destekliyordu. Yeni kanal abonelikleri ve videoların derecelendirilmesi, paylaşılması, favorilere eklenmesi, yorumlanması veya yüklenmesiyle ilgili bildirimler gönderiliyordu.

      v3 API, PubSubHubbub protokolünü kullanarak push bildirimlerini destekler ancak bildirimler yalnızca video yüklemelerini ve video başlıkları ya da video açıklamalarındaki güncellemeleri kapsar.

    • Kanal konumu: v2 API, kullanıcının kanalın YouTube herkese açık profilinde girilen konumunu tanımlamak için <yt:location> etiketini kullanıyordu. Bazı geliştiriciler bu alanı bir kanalı belirli bir ülkeyle ilişkilendirmek için kullansa 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 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 sunacak. Ö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: v2 API'de 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'de oynatma listesi öğeleri genellikle konuma göre artan düzende sıralanır ve diğer sıralama seçenekleri kullanılamaz.

      Ancak birkaç istisna 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 zamana 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 bir öğenin, bu listenin son öğesi olarak eklendiğini ve bu listenin en eski öğeden en yeni öğeye doğru sıralandığını unutmayın.

    • Toplu işleme: v3 API, v2 API'nin desteklediği toplu işleme kullanım alanlarından birini destekler. v3 API'nin 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ış kimlik listesini (video kimlikleri, kanal kimlikleri vb.) belirtmek için kullanılabilen 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) kullanımdan kaldırılacak tüm işlevleri tanımlamaktadır.

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öntem için desteklenen onBehalfOfContentOwner parametresini destekliyor.

  • Aşağıdaki mülklerin ve alt mülklerinin 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 kullanımdan kaldırma politikasına tabi değildir.

  • video kaynağının yeni contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons özelliği, videonun DJCQT (Brezilya) derecelendirmesini alma nedenlerini 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 listesi manuel sıralama kullanmı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ı giderebilirsiniz. Oynatma listesi öğesinin listede belirli bir konuma sahip olmasını istiyorsanız öncelikle 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 id parametresi isteği desteklemiyorsa veya istek düzgün şekilde yetkilendirilmemişse playlists.list 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 listesi belirtiyorsa playlists.list yöntemi bu hatayı döndürür.
    notFound (404) videoNotFound İsteğin id parametresi bulunamayan bir video belirtiyorsa videos.list 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 belirli bir dille en alakalı sonuçları istemenize olanak tanıyan relevanceLanguage parametresini destekliyor.

    YouTube Data API (v3) geçiş rehberi de bu yeni parametrenin nasıl kullanılacağını açıklayacak şekilde güncellendi. Bu parametre, mevcut API sürümü (v3) ile daha önce desteği sonlandırılmış olan önceki sürüm (v2) arasında daha önce mevcut olan bir özellik boşluğunu giderir.

  • YouTube Data API (v3) geçiş rehberi de 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 kullanımdan kaldırıldığını gösterecek şekilde güncellendi.

14 Ocak 2015

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

  • YouTube Data API (v3) geçiş rehberi, 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 benzerdir. Geçiş rehberindeki bu değişikliğin gerçek bir API değişikliğini yansıtmadığını, bunun yerine istemci tarafı JavaScript ile video yüklemek için yeni örnek kodun kullanılabilirliğini yansıttığını unutmayın.

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

  • videos.insert yönteminin dokümanları, yukarıda açıklanan yeni JavaScript kod ö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, daha düşük kota maliyetiyle bilgi almak için diğer API yöntemlerini kullanabilirsiniz. Örneğin, GoogleDevelopers kanalına yüklenen videoları bulmanın iki yolu vardır.

    • 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 değerine 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ğini yetkilendirdiyse 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 önce bu özelliği etkinleştirmesi gerekir.
      • disallowed: Kanal, 15 dakikadan uzun videolar yükleyemez veya bu işlem için uygun değildir.

      Bu değerler hakkında daha fazla bilgi için özellik tanımına bakın. Bu özellik hakkında daha ayrıntılı bilgiyi YouTube Yardım Merkezi'nde de 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, tanıtımları videonun tıklanma olasılığının daha yüksek ve izleme deneyimini kesintiye uğratma olasılığının daha düşük olduğu bir noktasında 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ı işleme şeklini 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.

  • video kaynağının, bir videonun Yeni Zelanda Film ve Edebiyat Sınıflandırma Ofisi'nden aldığı derecelendirmeyi tanımlayan contentDetails.contentRating.oflcRating özelliği artık iki yeni derecelendirmeyi destekliyor: oflcRp13 ve oflcRp16. Bunlar sırasıyla RP13 ve RP16 derecelendirmelerine karşılık gelir.

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

    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ını açmalı ve ilgili albümden bazı resimleri kaldırmalıdır.

12 Eylül 2014

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

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ı destekliyor:

    Hata türü Hata ayrıntısı Açıklama
    badRequest subscriptionLimitExceeded İstekle tanımlanan abone, abonelik sıklık sınırlamasını aştı. Birkaç saat sonra daha fazla abonelik için tekrar deneyebilirsiniz.

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 bir 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ılmıştır. Bu kılavuz, hâlâ v2 API'yi kullanan uygulamaları en son 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ı destekliyor:

    Hata türü Hata ayrıntısı Açıklama
    badRequest maxPlaylistExceeded Bu hata, kanalda izin verilen maksimum sayıda oynatma listesi olduğu için yeni bir oynatma listesi oluşturulamadığında ortaya çıkar.

18 Haziran 2014

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

28 Mayıs 2014

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

  • search.list yöntemi artık coğrafi konumla ilişkili videoları aramanıza olanak tanıyan location ve locationRadius parametrelerini destekliyor. Konuma dayalı sonuçları almak için istekte her iki parametre için de bir değer belirtilmelidir. İstek, iki parametreden yalnızca 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 videonun arama sonuçlarına dahil edilmesi için videoyla ilişkili konumun, 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 birkaç yeni öne çıkan içerik 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 feed'inde yayınladığı oynatma listeleri
    • postedVideos: Kanal sahibinin kanalın etkinlik feed'inde yayınladığı videolar
    • subscriptions: Kanal sahibinin abone olduğu kanallar

  • video kaynağının yeni contentDetails.contentRating.ifcoRating özelliği, bir videonun İrlanda Film Sınıflandırma Ofisi'nden aldığı derecelendirmeyi tanımlar.

  • watermark kaynağının position.cornerPosition özelliğinin tanımı, filigranın her zaman oynatıcının sağ üst köşesinde göründüğünü 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, birden fazla arama teriminden biriyle ilişkili videoları bulmak için Boole OR (|) operatörünü de kullanabilir.

  • search.list çağrısına verilen API yanıtında döndürülen pageInfo.totalResults mülkünün tanımı, değerin yaklaşık bir değer olduğunu ve tam bir değeri temsil etmeyebileceğini belirtecek şekilde güncellendi. Ayrıca, maksimum değer 1.000.000'dur. Sayfalama bağlantıları oluşturmak için bu değeri 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 yönelik 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ı, YouTube sitesinin altbilgisinden istediği kullanıcı arayüzü dilini manuel olarak da seçebilir.

    API, desteklenen uygulama dillerini listelemek için bir yöntem 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ğı, YouTube kullanıcıları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 adı veya kullanıcının IP konumu gibi sezgisel yöntemlere göre bir içerik bölgesi otomatik olarak seçilebilir. Kullanıcılar, YouTube sitesinin altbilgisinden istedikleri içerik bölgesini manuel olarak da seçebilir.

    API, desteklenen içerik bölgelerini listelemek için bir yöntem 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 videolarla 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 listeleme, ekleme, güncelleme veya silme yöntemlerini destekler. Kimliği doğrulanmış kullanıcının kanalına ait kanal bölümlerinin listesini almak için belirli bir kanal kimliği veya benzersiz kanal bölümü kimliklerinin listesini belirtebilirsiniz.

    Hata belgeleri de 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ı, yalnızca videonun processingDetails.fileDetailsAvailability özelliğinin değeri available olduğunda 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ılırken status.publishAt özelliğinin ayarlanabileceğini gösterecek şekilde güncellendi.

  • channel kaynağını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 onBehalfOfContentOwner parametresini desteklemediğini yansıtacak şekilde güncellendi. Bu, bir doküman hatasıydı. Bu parametreyi ayarlayan videos.rate istekleri 500 hatası döndürür.

31 Mart 2014

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

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üm, kanala bağlı YouTube iş ortaklarıyla alakalı kanal verilerini içerir. Bu veriler arasında, kanala bağlı içerik sahibinin kimliği ve 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.

  • Belgelerde artık aşağıdaki özellikler için desteklenen maksimum karakter uzunluğu listelenmektedir:

    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ği kullanımdan kaldırıldı. Değerini ayarlamaya çalışırsanız API bir hata döndürür.

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

  • Hata belgeleri artık her hata türü için HTTP yanıt kodunu belirtiyor.

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

    Hata türü Hata ayrıntısı Açıklama
    badRequest (400) invalidCriteria İstekte birbiriyle birlikte kullanılamayan filtre parametreleri belirtilirse channels.list yöntemi bu hatayı döndürür.
    badRequest (400) channelTitleUpdateForbidden Bir kanalın brandingSettings bölümünü güncellemeye ve brandingSettings.channel.title özelliğinin değerini değiştirmeye çalışırsanız channels.update yöntemi bu hatayı döndürür. (Özelliği atlarsanız API'nin hatayı döndürmeyeceğini unutmayın.)
    badRequest (400) invalidRecentlyUploadedBy invideoPromotion.items[].id.recentlyUploadedBy özelliği geçersiz bir kanal kimliği belirtiyorsa channels.update yöntemi bu hatayı döndürür.
    badRequest (400) invalidTimingOffset invideoPromotion bölümü geçersiz bir zamanlama ofseti belirtirse channels.update yöntemi bu hatayı döndürür.
    badRequest (400) tooManyPromotedItems invideoPromotion bölümü, izin verilen sayıda tanıtılan öğeden fazlasını belirtiyorsa channels.update yöntemi bu hatayı döndürür.
    forbidden (403) promotedVideoNotAllowed invideoPromotion.items[].id.videoId özelliği, bulunamayan veya tanıtılan öğe olarak kullanılamayan bir video kimliği belirtiyorsa channels.update yöntemi bu hatayı döndürür.
    forbidden (403) websiteLinkNotAllowed invideoPromotion.items[].id.websiteUrl özelliği, izin verilmeyen bir URL belirtiyorsa channels.update yöntemi bu hatayı döndürür.
    required (400) requiredTimingType channels.update yöntemi, bir istekte YouTube'un tanıtılan bir öğeyi ne zaman göstermesi gerektiğiyle ilgili varsayılan zamanlama ayarları belirtilmediğinde 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:

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 parametrelerine ait tanımlar, aşağıdaki parametrelerden herhangi biri için 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ü. (Önceden minimum boyut 2120 x 1192 pikseldi.) Ayrıca, channel kaynak belgelerinde 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 2120 piksel x 1192 pikseldir ancak gerçek resim 2048 piksel x 1152 piksel olabilir. YouTube Yardım Merkezi, kanal resmini farklı cihaz türlerinde görüntülenmek üzere optimize etme konusunda ek bilgiler sağlar.

  • Birkaç channel kaynak mülkü tanımı, aşağıdaki bilgileri yansıtacak şekilde güncellendi:

    • brandingSettings.channel.description özelliğinin değeri en fazla 1.000 karakter uzunluğunda olabilir.
    • brandingSettings.channel.featuredChannelsTitle özelliğinin maksimum uzunluğu 30 karakterdir.
    • brandingSettings.channel.featuredChannelsUrls[] mülkü artık 100'e kadar kanal listeleyebilir.
    • brandingSettings.channel.unsubscribedTrailer özellik değeri ayarlanmışsa 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 yapılan 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 sahibi adına yapılıyorsa ayarlanabilir.

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

  • contentDetails.contentRating.acbRating özelliği artık filmler için Australian Classification Board'dan (ACB) veya çocuk televizyon programları için Australian Communications and Media Authority'den (ACMA) bir derecelendirme belirtebilir.

  • Yeni contentDetails.contentRating.catvRating ve contentDetails.contentRating.catvfrRating mülkleri, bir videonun 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 belirtir.

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

24 Ekim 2013

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

  • API, canlı yayın içeriğini bulmaya ve öne çıkarmaya 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.

    • 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 özellik değeri olur.

    • 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 part parametre değerinin kaynak parçaları listesine liveStreamingDetails değerini ekleyin. Meta veriler aşağıdaki yeni özellikleri içerir:

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

    Canlı yayın içeriğini tanımlamak için kullanılan diğer iki özelliğin (search.list yönteminin eventType parametresi ve arama sonucunun snippet.liveBroadcastContent özelliği) 1 Ekim 2013'te kullanıma sunulduğunu unutmayın.

  • videos.insert yöntemi artık notifySubscribers parametresini destekliyor. Bu parametre, YouTube'un videonun kanalına abone olan kullanıcılara yeni video hakkında bildirim gönderip göndermeyeceğini belirtir. Parametrenin varsayılan değeri True şeklindedir. Bu değer, abonelerin yeni yüklenen videolar hakkında bilgilendirileceğ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ılırken değiştirilebilecek özelliklerin listesi, invideoPromotion.items[].customMessage ve invideoPromotion.items[].websiteUrl özelliklerini içerecek şekilde güncellendi. Ayrıca liste, değiştirilebilir brandingSettings özelliklerini tanımlayacak şekilde değiştirildi. Bu brandingSettings özellikleri zaten değiştirilebiliyordu. Bu nedenle, dokümandaki değişiklik API'nin mevcut işlevinde bir değişiklik olduğu anlamına gelmez.

  • playlists.insert, playlists.update ve playlists.delete yöntemleri artık diğer birçok yöntem için desteklenen onBehalfOfContentOwner parametresini destekliyor.

  • playlists.insert yöntemi artık diğer birkaç yöntem için de 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 değerinin geçerli bir özellik değeri olduğunu ancak active değerinin 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 sahibi 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ı ağın (MCN) belirli bir kanalı kabul edip etmeyeceğini belirlerken değerlendireceği kanal verilerini içerir. Bu kaynak parçasını alan tüm API isteklerinin https://www.googleapis.com/auth/youtubepartner-channel-audit kapsamını içeren bir yetkilendirme jetonu sağlaması gerektiğini unutmayın. Ayrıca, bu kapsamı kullanan tüm jetonlar, MCN kanalı kabul etmeye veya reddetmeye karar verdiğinde ya da jetonun verildiği tarihten itibaren iki hafta içinde iptal edilmelidir.

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

    Varsayılan olarak kanal, video içi promosyon verilerinin ayarlandığı kanalla aynıdır. Ancak yeni invideoPromotion.items[].id.recentlyUploadedBy özelliğinin değerini başka bir kanalın kanal kimliğine ayarlayarak o 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.

    • 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ış planlı 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 bir nesneden dizeye değiştirildi. targetChannelId özelliği, filigran resminin bağlantı verdiği kanalın YouTube kanal kimliğini belirten bir alt özellik içermek yerine 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 birkaç yöntem için de desteklenen onBehalfOfContentOwner parametresini destekliyor.

  • search.list yöntemi artık eventType parametresini destekliyor. Bu parametre, aramayı yalnızca etkin, yaklaşan veya tamamlanmış yayın etkinliklerini döndürecek şekilde kısıtlar.

  • Yeni contentDetails.contentRating.mibacRating özelliği, bir videonun İtalya Kültürel Miras, Etkinlikler ve Turizm Bakanlığı'ndan aldığı derecelendirmeyi tanımlar.

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

    Hata türü Hata ayrıntısı Açıklama
    badRequest invalidImage Sağlanan resim içeriği geçersizse thumbnails.set yöntemi bu hatayı döndürür.
    forbidden videoRatingDisabled Puanlanan videonun sahibi, videonun puanlanması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ğı, belirtilen bir kanalın videoları oynatılırken gösterilen bir resmi tanımlar. Ayrıca, resmin bağlantı vereceği hedef kanalı ve filigranın video oynatılırken 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, bir kanalın filigran resmini siler.

    Hata belgelerinde, 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 gizli olup olmadığını belirten bir boole değeri içerir. Kanalın abone sayısı herkese açık olarak görünüyorsa özelliğin değeri false olur.

  • playlists.list yöntemi artık onBehalfOfContentOwner ve onBehalfOfContentOwnerChannel parametrelerini destekliyor. Her iki parametre de diğer birkaç 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öntemi için oluşabilecek aşağıdaki yeni yaygın 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 nesnesinde aşağıdaki yeni ve güncellenmiş özellikler bulunur:

    • API artık bir web sitesini tanıtılan öğe olarak belirtme özelliğini destekliyor. Bunun 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. Promosyon için gösterilecek özel bir mesaj tanımlamak üzere yeni invideoPromotion.items[].customMessage özelliğini de 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 YouTube Yardım Merkezi'ndeki ilişkilendirilmiş web siteleri ve satıcı siteleri ile ilgili talimatları inceleyin.

      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 uyacağını kabul etmiş olursunuz.

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

      • invideoPromotion.timing nesnesi invideoPromotion.items[].timing konumuna taşındı. Bu nesne artık invideoPromotion.items[] listesindeki her bir tanıtılan öğe için zamanlama verilerini özelleştirmenize olanak tanır.

      • Yeni invideoPromotion.defaultTiming nesnesi, promosyonunuz için varsayılan zamanlama ayarlarını belirtir. Bu ayarlar, tanıtılan bir öğenin kanalınızdaki videoların oynatılması sırasında ne zaman gösterileceğini belirler. invideoPromotion.items[].timing nesnesini kullanarak tanıtılan herhangi bir öğ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österileceği varsayılan süreyi belirten bir durationMs alanı da içerir.

    • invideoPromotion.items[].type ve 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 birkaç yöntem için zaten desteklenmektedir.

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

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

    playlistItems.insert yönteminin Python örneği de kaldırıldı. Bu örnekte gösterilen işlev artık videos.rate yöntemi tarafından gerçekleştiriliyor.

  • 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 mine parametresi, kimliği doğrulanmış kullanıcının YouTube iş ortağı olduğu isteklerde kullanılamaz. mine parametresini kaldırmanız, onBehalfOfContentOwner parametresini kaldırarak YouTube kullanıcısı olarak kimlik doğrulaması yapmanız veya çağrılan yöntem için mevcutsa 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:

30 Temmuz 2013

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

  • Bir channelBanner kaynağında, kind özelliğinin değeri youtube#channelBannerInsertResponse iken youtube#channelBannerResource olarak değiştirildi. Bu kaynak, bir 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, diyez işareti (#) ve ardından gelen altı karakterli onaltılık dizedir (ör. #2793e6).

  • API artık bir aboneliğin kanalın tüm etkinlikleri için mi yoksa yalnızca yeni yüklemeler için mi olduğunu 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 desteklenen tek değer mostPopular. chart parametresinin bir filtre parametresi olduğunu, dolayısıyla diğer filtre parametreleriyle (id ve myRating) aynı istekte kullanılamayacağını unutmayın.
    • videoCategoryId parametresi, listenin alınması gereken video kategorisini tanımlar. Bu parametre yalnızca chart parametresiyle birlikte kullanılabilir. Varsayılan olarak listeler belirli bir kategoriyle kısıtlanmaz.

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

  • video kaynağının recordingDetails.location.elevation özelliği recordingDetails.location.altitude, 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, "derecelendirilmemiş" derecelendirmesinin, filmin kesilmiş versiyonunun resmi bir derecelendirme aldığı filmlerin kesilmemiş versiyonlarını tanımlamak için sıklıkla kullanıldığını unutmayın.

  • video kaynağının yeni contentDetails.contentRating.ytRating özelliği, yaş kısıtlaması olan 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ı tespit ederse ö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 işlem yaptığını 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 özelliklerin güncellenmiş listesi de yer alıyor.

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

    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 kapalı olduğunu gösterir. Kullanıcı başka bir Google Hesabı adına işlem yapıyorsa bu hata, diğer hesabın kapalı olduğunu 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, diğer hesabın askıya alındığını gösterir.
    forbidden authenticatedUserNotChannel Bu hata, belirli bir API yöntemine özgü değildir. 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 İstekte desteklenmeyen veya kullanılamayan bir video listesi belirtildiğ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. İstek gövdesindeki id özelliğinin değerini kontrol ederek doğru olduğundan emin olun.

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ıza olanak tanır.

  • activities.list yöntemi artık regionCode parametresini destekliyor. Bu parametre, API'ye belirtilen ülkeyle alakalı sonuçları döndürmesini bildirir. 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 mülkünü içeriyor. Özellik 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öntemlerini ç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, istekteki yetkilendirme kimlik bilgilerinin, parametre değerinde belirtilen içerik sahibi adına işlem yapan bir YouTube İYS kullanıcısını tanımladığını gösterir. Kullanıcının kimlik doğrulaması için kullandığı İçerik Yönetim Sistemi hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.

    Bu parametre, birçok farklı YouTube kanalının sahibi olan ve bunları yöneten içerik iş ortakları için tasarlanmıştır. Bu parametre, söz konusu iş ortaklarının bir kez kimlik doğrulaması yapmasına ve her bir kanal için kimlik doğrulama bilgileri sağlamak zorunda kalmadan tüm video ve kanal verilerine erişmesine olanak tanır.

    Bu sürümle ilgili olarak, parametre artık bir içerik iş ortağının, sahip olduğu YouTube kanallarından herhangi birine video eklemesine, güncellemesine veya silmesine olanak tanır.

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

    Hata türü Hata ayrıntısı Açıklama
    forbidden insufficientCapabilities Bu hata, belirli bir API yöntemine özgü değildir. API'yi çağıran İYS 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 ilgilidir.
    unauthorized authorizationRequired activities.list yöntemi, istek home parametresini kullandığında ancak düzgün şekilde yetkilendirilmediğinde bu hatayı döndürür.

  • channels kaynağında, kanal kimliği zaten kaynağın id özelliği kullanılarak belirtildiğinden 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 yararlı olabilir.

22 Mayıs 2013

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

14 Mayıs 2013

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

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

  • Python kod örneklerinin listelendiği sayfaya abonelik ekleme, oynatma listesi oluşturma ve video güncelleme örnekleri eklendi.

10 Mayıs 2013

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

8 Mayıs 2013

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

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

    Bu verileri, bir 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 kanal verilerinin, bir YouTube kullanıcı adına veya Google+ hesabına bağlı bir kullanıcıyı tanımlayıp tanımlamadığını belirten status.isLinked özelliğini destekliyor. Bu bağlantılardan birine sahip olan kullanıcıların herkese açık bir YouTube kimliği vardır. Bu kimlik, video yükleme gibi çeşitli işlemler için ön koşuldur.

  • Abonelik kaynakları artık subscriberSnippet bölümünü destekliyor. Bu nesne, abonenin kanalı için snippet verilerini içerir.

  • API artık kimliği doğrulanmış kullanıcının bir veya daha fazla videodan oluşan bir listeye 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 kullanıcı puanı verdiği videoların listesini almanıza olanak tanır.

    myRating parametresi ve id parametresi artık filtre parametreleri olarak kabul edilir. Bu, bir API isteğinin parametrelerden tam olarak birini belirtmesi gerektiği anlamına gelir. (Daha önce id parametresi bu yöntem için zorunlu bir parametreydi.)

    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 sayfalama desteği sunacak şekilde güncellendi. Ancak sayfalama parametrelerinin yalnızca myRating parametresini kullanan istekler için desteklendiğini unutmayın. (id parametresini kullanan istekler için sayfalama parametreleri ve bilgileri 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 toplam sonuç sayısı ve mevcut sonuç kümesine dahil edilen sonuç sayısı gibi ayrıntıları içeren pageInfo nesnesini içerir. youtube#videoListResponse kaynağı, her biri sonuç kümesindeki belirli bir sayfayı almak için 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'un videonun ışığını ve rengini otomatik olarak iyileştirmesi için bu parametre değerini true olarak ayarlayın.
    • stabilize: YouTube'un, kamera hareketlerinden kaynaklanan sarsıntıları kaldırarak videoyu ayarlamasını sağlamak için bu parametre değerini true olarak ayarlayın.

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

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

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

  • subscriptions.list yönteminin yeni mySubscribers parametresi, kimliği doğrulanmış mevcut kullanıcının abonelerinin listesini almanıza olanak tanır. 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 alacak şekilde 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:

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

  • Oynatma listesi 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ıların bir videoya like veya dislike puanı vermesine ya da videodan puanı kaldırmasına olanak tanır.

    Hata belgeleri de API'nin bir 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 belgelerinde ayrı bir kaynak olarak tanımlanıyor ve yeni thumbnails.set yöntemi, YouTube'a özel bir video küçük resmi yüklemenize ve bunu bir video için ayarlamanıza olanak tanıyor.

    Hata belgeleri de API'nin bir 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ı etkilemediğini unutmayın. Küçük resimler, bu kaynaklarda daha önce olduğu gibi döndürülür ancak belgelerde artık API'nin döndürebileceği farklı küçük resim boyutlarının adları listelenir.

  • channel kaynağının yeni brandingSettings bölümü, kanalın kanal sayfası ve video izleme sayfaları için ayarları, metni ve resimleri tanımlar.

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

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

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

  • 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 destekliyor:

    • 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 düzende (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ırmayacağını belirtir.

  • videos.insert yöntemi, aşağıdaki tabloda listelenen birkaç yeni hatayı 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ı belirtiyor.
    badRequest invalidVideoGameRating İstek meta verileri geçersiz bir video oyunu derecelendirmesi belirtiyor.
    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 adlı kaynağa eklendi:

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

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

    • channelType parametresi, tüm kanalları veya yalnızca programları almak için kanal aramasını kısıtlamanıza olanak tanır.

    • videoType parametresi, video aramasını tüm videoları veya yalnızca filmleri ya da yalnızca program bölümlerini alacak şekilde kısıtlamanıza olanak tanır.

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

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

  • Birkaç API yöntemi, yalnızca YouTube içerik iş ortakları için tasarlanmış 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 işlem yapan bir YouTube İYS kullanıcısını tanımladığını gösterir. Kullanıcının kimlik doğrulaması için kullandığı İçerik Yönetim Sistemi hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.

      Bu parametre, birçok farklı YouTube kanalının sahibi olan ve bunları yöneten içerik iş ortakları için tasarlanmıştır. Bu parametre, söz konusu iş ortaklarının bir kez kimlik doğrulaması yapmasına ve her bir kanal için kimlik doğrulama bilgileri sağlamak zorunda kalmadan tüm video ve kanal verilerine erişmesine olanak tanır.

      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 söyler.

    • 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ıtlama talimatı verir.

25 Şubat 2013

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

  • API, video kaynakları için birkaç yeni bölümü ve özelliği destekler:

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

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

      Bu parçaların tümü yalnızca video sahibi tarafından alınabilir. Aşağıdaki listede yeni bölümler kısaca açıklanmaktadır. video kaynak belgelerinde ise her bölümün içerdiği tüm özellikler tanımlanmaktadır.

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

      • processingProgress nesnesi, YouTube'un yüklenen video dosyasını işleme süreciyle ilgili bilgiler 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ümde, video için dosya ayrıntıları veya küçük resimler gibi farklı veri ya da içerik türlerinin mevcut olup olmadığı da belirtilir.

        Bu nesne, video yükleyicinin YouTube'un yüklenen video dosyasını işleme sürecindeki ilerleme durumunu takip edebilmesi için sorgulanacak ş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ı belirtir.
      • caption: Videoda altyazı olup olmadığını gösterir.
      • licensedContent: Videonun, bir YouTube içerik iş ortağı tarafından hak talebinde bulunulan içerik barındırıp barındırmadığını gösterir.

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

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

  • part parametresinin tanımı; videos.list, videos.insert ve videos.update yöntemleri için güncellenerek yukarıda açıklanan yeni eklenen bölümlerin yanı sıra yanlışlıkla atlanan recordingDetails bölümünü de içerecek şekilde değiştirildi.

  • 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.

  • Her küçük resim nesnesi artık resmin genişliğini ve yüksekliğini belirtiyor. Küçük resimler şu anda activity, channel, playlist, playlistItem, search result, subscription ve video kaynaklarında döndürülür.

  • 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 belgelerinde, bir 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ğlar.

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öntemi için 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 kod örnekleri artık kullanılabilir:

  • activity kaynağı artık YouTube'un otomatik olarak oluşturulan bir YouTube kanalına video eklemesiyle gerçekleşen channelItem işlemini bildirebilir. (YouTube, YouTube web sitesinde önemli bir yer edinen 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 tanımlanmıyor. Bu nedenle...
    • relatedToVideo parametresi relatedToVideoId olarak yeniden adlandırıldı.
    • published parametresi, aşağıda açıklanan iki yeni parametreyle (publishedAfter ve publishedBefore) 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şik 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 sendikasyon videolarını almak için parametre değerini true olarak ayarlayın.

  • Birçok API kaynağı yeni özellikleri destekler. Aşağıdaki tabloda kaynaklar ve yeni özellikleri belirtilmiştir:

    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 Kanala eklenen bir kaynak hakkında bilgi içeren nesne. Bu özellik yalnızca snippet.type, channelItem ise kullanılabilir.
    activity contentDetails.channelItem.resourceId object Kanala eklenen kaynağı tanımlayan bir nesne. Diğer resourceId özellikleri gibi, video veya oynatma listesi gibi kaynak türünü belirten bir kind özelliği içerir. Ayrıca, bu kaynağı benzersiz şekilde tanımlayan kimliği belirten birkaç özellikten (videoId, playlistId vb.) 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 içerir.
    video recordingDetails.location object Bu nesne, videoyla ilişkili coğrafi konum bilgilerini içerir.
    video recordingDetails.location.latitude double Derece cinsinden enlem.
    video recordingDetails.location.longitude double Derece cinsinden boylam.
    video recordingDetails.location.elevation double Dünya'nın üzerindeki rakım (metre cinsinden).
    video recordingDetails.locationDescription string Videonun kaydedildiği konumun 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öntemleriyle ilgili dokümanlarda, istek gövdesinde belirtilmesi gereken veya istek gövdesindeki değerlere göre güncellenen özellikler artık tanımlanmaktadır. Aşağıdaki tabloda bu yöntemlerin yanı sıra gerekli veya değiştirilebilir özellikler listelenmiştir.

    Not: Diğer yöntemlerle ilgili belgelerde zorunlu ve değiştirilebilir özellikler zaten 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 mevcut bir oynatma listesiyle aynı başlığa sahip bir oynatma listesi oluşturmaya veya güncellemeye çalışırsanız API artık playlistAlreadyExists hatası bildirmez.

  • Birkaç API yöntemi yeni hata türlerini destekler. Aşağıdaki tabloda yöntem ve yeni desteklenen hatalar belirtilmiştir:

    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 yetkilendirilmemiş.
    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.