Bu sayfada, YouTube Data API (v3) değişiklikleri ve belge güncellemeleri listelenmektedir. Bu değişiklik günlüğüne abone olun.
30 Nisan 2024
Not: Bu, kullanımdan kaldırma duyurusudur.
Bu güncelleme aşağıdaki değişiklikleri içerir:
API artık kanal tartışmaları ekleme veya alma özelliğini desteklememektedir. Bu değişiklik, kanallara yorum yayınlamayı desteklemeyen YouTube web sitesinde desteklenen işlevle tutarlıdır.
13 Mart 2024
Not: Bu, kullanımdan kaldırma duyurusudur.
Bu güncelleme aşağıdaki değişiklikleri içerir:
captions.insert
ve captions.update
yöntemleri için sync
parametresi kullanımdan kaldırıldı. YouTube, 12 Nisan 2024'ten itibaren parametreyi desteklemeyi bırakacaktır.
Bu değişikliğin sonucunda geliştiriciler, altyazı parçalarını eklerken veya güncellerken zamanlama bilgilerini eklemelidir. Aksi takdirde yükleme başarısız olur.
12 Mart 2024
Bu güncelleme aşağıdaki değişiklikleri içerir:
captions
kaynağıyla ilgili belgeler, snippet.name
alanı için izin verilen maksimum uzunluğun 150 karakter olduğunu belirtecek şekilde güncellendi. Kanal adı bundan uzunsa API bir nameTooLong
hatası döndürür.
7 Mart 2024
Not: Bu, kullanımdan kaldırma duyurusudur.
channel
kaynak özelliği brandingSettings.channel.moderateComments
kullanımdan kaldırıldı. YouTube, 7 Mart 2024'ten itibaren parametreyi desteklemeyi bırakacaktır.
31 Ocak 2024
Bu güncelleme aşağıdaki değişiklikleri içerir:
channels.list
yönteminin yeni forHandle
parametresi, bir kanalın YouTube herkese açık kullanıcı adını belirterek kanal hakkında bilgi almanızı sağlar.
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, kullanımdan kaldırma duyurusudur.
comments.markAsSpam
yöntemi birkaç yıldır kullanımdan kaldırılmıştır. Bu yöntem, YouTube'da şu anda desteklenmemektedir ve API üzerinden artık desteklenmemektedir.
comments.markAsSpam
yöntemini referans alan tüm dokümanlara kullanımdan kaldırma bildirimi 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 olarak belirttiği videoları içerecek şekilde filtrelemenizi sağlar.
18 Ağustos 2023
video
kaynağının liveStreamingDetails.concurrentViewers
tanımı, YouTube Data API'nin döndürdüğü eşzamanlı izleyici sayısının YouTube Analytics aracılığıyla kullanılabilen işlenmiş ve spam'den arındırılmış eşzamanlı izleyici sayısından farklı olabileceğini göz önünde bulundurarak güncellendi. YouTube Yardım Merkezi'nde canlı yayın metrikleri hakkında daha fazla bilgi edinebilirsiniz.
7 Ağustos 2023
12 Haziran 2023'te duyurulduğu gibi, search.list
yönteminin relatedToVideoId
parametresi kullanımdan kaldırılmıştır. Bu parametre artık desteklenmiyor ve parametreye yönelik referanslar API dokümanlarından kaldırılmıştır.
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, kullanımdan kaldırma duyurusudur.
search.list yönteminin relatedToVideoId
parametresi kullanımdan kaldırıldı. YouTube, 7 Ağustos 2023'ten itibaren parametreyi desteklemeyi bırakacaktır.
Şu anda search.list
yönteminin dokümanlarına kullanımdan kaldırma bildirimi eklenmiştir. Bu parametre, 7 Ağustos 2023'te veya sonrasında search.list
dokümanlarından tamamen kaldırılacaktır.
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 uzundan dize olarak düzeltildi.
5 Ağustos 2022
YouTube, altyazı kimliklerinin oluşturulma biçimini değiştirdi ve bu değişiklik kapsamında tüm altyazı parçalarına yeni altyazı kimlikleri atıyor. Bu değişiklik, caption_id
değerlerini depolayan uygulamalar için geriye dönük olarak uyumsuz bir değişiklik olabilir 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ı parçası kimliklerini destekleyecektir. Ancak 1 Aralık 2022'de veya sonrasında YouTube, eski altyazı parçası kimliklerini desteklemeyi durduracak. Bu sırada, bu API yöntemlerinden herhangi birinin eski altyazı parçası kimliğiyle çağrılması captionNotFound
hatasına neden olur.
Bu değişikliğe hazırlanmak için şu andan itibaren 1 Aralık 2022 tarihine kadar depolanan tüm altyazı parçası verilerini tamamen değiştirmeyi planlamanız gerekir. Yani altyazı parçası verilerini depoladığınız herhangi bir video için o anda depolanan verileri silmeniz, ardından videonun mevcut altyazı parçası grubunu almak ve verileri API yanıtında normalde yaptığınız gibi depolamak için captions.list
yöntemini çağırmanız gerekir.
12 Temmuz 2022
YouTube API Hizmetleri Hizmet Şartları güncellendi. Daha fazla bilgi için lütfen YouTube API Hizmetleri Hizmet Şartları - Düzeltme Geçmişi'ni inceleyin.
27 Nisan 2022
videos.insert
yönteminin açıklaması, yüklenen videolar için maksimum dosya boyutunun 128 GB'tan 256 GB'a çıkarıldığını belirtmek üzere 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 unutmayın.
Bu değişiklik, API davranışındaki bir değişikliği değil, belgelerdeki bir düzeltmeyi temsil etmektedir.
15 Aralık 2021
18 Kasım 2021'de duyurulduğu üzere, video beğenmeme sayılarının YouTube genelinde gizli olarak belirlenmesiyle ilgili değişiklikler sonucunda video
kaynağının statistics.dislikeCount
özelliği artık gizli hâle getirildi.
YouTube'un resmi blogunda bu değişiklik hakkında daha fazla bilgi edinebilirsiniz.
18 Kasım 2021
Videoların beğenmeme sayılarını YouTube platformunun tamamında gizli hale getirmek için yapılan değişikliklerle birlikte, video
kaynağının statistics.dislikeCount
özelliği 13 Aralık 2021'den itibaren gizli hale getirilecektir. Bu, mülkün yalnızca API isteğinin video sahibi tarafından kimliği doğrulandığı takdirde videos.list
uç noktasından gelen bir API yanıtına dahil edileceği anlamına gelir.
videos.rate
uç noktası bu değişiklikten etkilenmez.
Beğenmeme sayılarını herkese açık olarak göstermeyen ve hâlâ API istemcileri için beğenmeme sayısına ihtiyaç duyan geliştiriciler, muafiyet için izin verilenler listesine eklenmek üzere başvuruda bulunabilir. Muafiyet başvurusunda bulunmak için bu başvuru formunu doldurmanız gerekir.
YouTube'un resmi blogunda bu değişiklik hakkında daha fazla bilgi edinebilirsiniz.
2 Temmuz 2021
Not: Bu, kullanımdan kaldırma duyurusudur.
commentThreads.update
uç noktası kullanımdan kaldırıldı ve artık desteklenmiyor.
Bu uç nokta işlevi, diğer API uç noktaları üzerinden kullanılabilir. Bunun yerine, comments.update
commentThreads
kaynağı gerektiriyorsa commentThreads.list
yöntemine ikincil bir çağrı yapın.
1 Temmuz 2021
YouTube'un API Hizmetlerini kullanan tüm geliştiricilerin,varsayılan olarak ayrılan 10.000 birimlik kotadan daha fazlasını alabilmeleri için API Uygunluk Denetimini tamamlamaları gerekir. Bugüne kadar hem uygunluk denetleme süreci hem de ek kota birimi tahsisi istekleri, YouTube API Hizmetleri - Denetim ve Kota Genişletme Formu'nu doldurup gönderen geliştiriciler tarafından gerçekleştirilmiştir.
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 doldurulmasıyla ilgili bir kılavuz ekliyoruz:
- Denetlenen Geliştirici İstek Formu: API Uyumluluk Denetiminden geçmiş olan geliştiriciler, tahsis edilen kotanın artırılmasını istemek için bu daha kısa formu doldurup gönderebilirler.
- İtiraz Formu: API projeleri, uygunluk denetiminde başarısız olan (veya kota birimi artışı reddedilmiş) geliştiriciler bu formu doldurup gönderebilir.
- Yönetim Değişikliği Formu: Bir API projesiyle ilişkili olarak yönetim değişikliği (ör. hisse alımı veya satışı, birleşme veya başka bir kurumsal işlem aracılığıyla) yaşayan geliştiriciler veya geliştirici adına bir API istemcisi çalıştıran taraflar bu formu doldurup göndermelidir. Bu, YouTube'un API ekibinin kayıtlarımızı güncellemesini, yeni API projesinin kullanım alanı uyumluluğunu denetlemesini ve geliştiricinin mevcut kota tahsisini doğrulamasını sağlar.
Her yeni form, YouTube API'yi kullanma amacınız hakkında bize bilgi verir ve size daha iyi yardımcı olabilmemizi sağlar.
Daha fazla ayrıntıyı yeni API Uygunluk Denetlemeleri kılavuzumuzda bulabilirsiniz.
12 Mayıs 2021
Not: Bu, kullanımdan kaldırma duyurusudur.
Bu güncelleme aşağıdaki API değişikliklerini kapsar:
-
channel
kaynağınıncontentDetails.relatedPlaylists.favorites
özelliği kullanımdan kaldırıldı. 28 Nisan 2016 tarihli düzeltme geçmişi girişinde belirtildiği üzere, favori videolar işlevi birkaç yıldır kullanımdan kaldırılmıştır.Bu güncellemeden önce, bir API istemcisi mevcut olmayan bir favoriler listesine video eklemeye çalıştığında API yine de yeni bir oynatma listesi oluşturuyordu. Bundan sonra, bu durumda oynatma listesi oluşturulmayacak ve API hata verecektir. Öğeleri ekleyerek, değiştirerek veya silerek favori oynatma listelerini değiştirme girişimleri de önceki duyurular doğrultusunda 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 desteklenmemektedir. Dolayısıyla bunlar da artık API üzerinden desteklenmemektedir.brandingSettings.channel.defaultTab
brandingSettings.channel.featuredChannelsTitle
brandingSettings.channel.featuredChannelsUrls[]
brandingSettings.channel.profileColor
brandingSettings.channel.showBrowseView
brandingSettings.channel.showRelatedChannels
Mülklerin tümü
channel
kaynak gösteriminden ve tanımları kaynağın mülk listesinden kaldırıldı. Ayrıca bu özelliklerle ilişkili hatalar yönteme özel belgelerden kaldırılmıştır. -
Aşağıdaki
channelSection
kaynak özellikleri kullanımdan kaldırıldı. Bu özellikler, YouTube Studio kullanıcı arayüzünde ve YouTube'da zaten desteklenmemektedir. Dolayısıyla bunlar da artık API üzerinden desteklenmemektedir.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öntemininhl
parametresi de desteklenmediğinden kullanımdan kaldırıldı.Mülklerin tümü
channelSection
kaynak gösteriminden ve tanımları kaynağın mülk listesinden kaldırıldı. Ayrıca bu özelliklerle ilişkili hatalar yönteme özel belgelerden kaldırılmıştır. -
channelSection
kaynağınınsnippet.type
özelliği için aşağıdaki değerler kullanımdan kaldırılmıştır. Bu değerler, YouTube kanal sayfalarında halihazırda desteklenmemektedir ve dolayısıyla API üzerinden de desteklenmemektedir.likedPlaylists
likes
postedPlaylists
postedVideos
recentActivity
recentPosts
-
playlist
kaynağınınsnippet.tags[]
özelliği kullanımdan kaldırıldı. Bu özellik YouTube'da zaten desteklenmediği için artık API üzerinden desteklenmiyor.
9 Şubat 2021
playlistItem
kaynağı, iki yeni özelliği destekler:
snippet.videoOwnerChannelId
özelliği, oynatma listesi videosunu yükleyen kanalın kimliğini tanımlar.snippet.videoOwnerChannelTitle
özelliği, oynatma listesi videosunu yükleyen kanalın adını tanımlar.
28 Ocak 2021
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
playlistItems.delete
,playlistItems.insert
,playlistItems.list
,playlistItems.update
,playlists.delete
,playlists.list
veplaylists.update
yöntemlerinin tümü yeni birplaylistOperationUnsupported
hatasını destekliyor. Hata, bir istek, belirli bir oynatma listesi için izin verilmeyen bir işlem gerçekleştirmeye çalıştığında ortaya çıkar. Örneğin, bir kullanıcı yüklediği videolar oynatma listesinden bir videoyu veya oynatma listesini silemez.Her durumda, bu hata bir
400
HTTP yanıt kodu (Hatalı İstek) döndürür. -
playlistItems.list
yöntemininwatchHistoryNotAccessible
vewatchLaterNotAccessible
hataları dokümanlardan kaldırıldı. Aslında 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'de, yerleştirilmiş YouTube oynatıcısı üzerinden toplanan ve gönderilen veriler hakkında ek bilgiler sağlanmaktadır. Kullanıcının oynatma amacını belirtmek için oynatıcıyla etkileşimde bulunmadan önce herhangi bir YouTube yerleştirilmiş oynatıcısı aracılığıyla bize gönderdiğiniz tüm kullanıcı verilerinden siz sorumlu olursunuz. Otomatik oynatmayı false (yanlış) değerine ayarlayarak kullanıcı oynatıcıyla etkileşimde bulunmadan önce YouTube ile paylaşılan verileri sınırlayabilirsiniz.
- Yeni Bölüm III.E.4.j, içerikleri site ve uygulamalarınıza yerleştirmeden önce Çocuklara Özel (Çocuklara Özel) özelliğinin durumunu kontrol etmeyle ilgilidir. API İstemcinize yerleştirdiğiniz videoların ne zaman çocuklara özel olduğunu bilmek ve yerleştirilmiş oynatıcıdan toplanan verileri uygun şekilde kullanmak sizin sorumluluğunuzdadır. Bu nedenle, herhangi bir yerleşik YouTube oynatıcı aracılığıyla API İstemcinize yerleştirmeden önce YouTube Data API Hizmeti'ni kullanarak içeriklerin durumunu kontrol etmeniz gerekir.
Yeni Bir videonun MadeForKids durumunu bulma rehberinde, YouTube Data API Hizmeti'ni kullanarak videoların Çocuklara Özel durumunun nasıl aranacağı açıklanmıştır.
Bu değişikliklerle birlikte Yerleşik Oynatıcı Parametresi dokümanlarına, Otomatik oynatmayı etkinleştirirseniz oynatmanın, oynatıcıyla herhangi bir kullanıcı etkileşimi olmadan gerçekleşeceğini, oynatma verilerinin toplanması ve paylaşılmasının sayfa yüklendiğinde gerçekleşeceğini açıklayan bir hatırlatma eklendi.
8 Ekim 2020
Bu güncelleme, channel
kaynağıyla ilgili üç küçük değişikliği kapsamaktadır:
- Kanalın küçük resimlerini tanımlayan
snippet.thumbnails
nesnesi, yeni oluşturulan kanallar için boş olabilir ve doldurulması bir gün kadar sürebilir. statistics.videoCount
özelliği, kanalın herkese açık videolarının sayısını (sahipler dahil) 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 uzunluğu (500 karakter) aşması veya çıkış karaktersiz tırnak işareti ("
) içermesi durumunda kısaltılabilir. 500 karakter sınırının anahtar kelime başına değil, tüm anahtar kelimelerin toplam uzunluğuna ilişkin bir sınır olduğunu unutmayın. Bu davranış, YouTube web sitesindekiyle tutarlıdır.
9 Eylül 2020
Not: Bu, kullanımdan kaldırma duyurusudur.
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 geçerlilik kazanacaktır. Bunu göz önünde bulunduran geliştiriciler, artık aşağıda listelenen API özelliklerinden hiçbirini kullanmamalıdır.
-
Aşağıdaki API kaynakları, yöntemler, parametreler ve kaynak özellikleri derhal kullanımdan kaldırılmıştır ve bu duyurunun yapıldığı tarihte veya bu tarihten sonra çalışmayı durduracaktır:
- Aşağıdaki
channel
kaynak özellikleri:statistics.commentCount
özelliğibrandingSettings.image
nesnesi ve tüm alt özellikleribrandingSettings.hints
listesi ve tüm alt özellikleri
channels.list
yönteminincategoryId
filtre parametresiguideCategories
kaynağı veguideCategories.list
yöntemi
- Aşağıdaki
-
API isteği
managedByMe
parametresinitrue
olarak ayarlarsachannels.list
yönteminin API yanıtları artıkprevPageToken
özelliğini içermez. Bu değişiklik diğerchannels.list
istekleri içinprevPageToken
özelliğini ya da isteklerinnextPageToken
özelliğini etkilemez. -
channel
kaynağınıncontentDetails.relatedPlaylists.watchLater
vecontentDetails.relatedPlaylists.watchHistory
özelliklerinin ikisinin de 11 Ağustos 2016 tarihinde kullanımdan kaldırıldığı duyuruldu. AyrıcaplaylistItems.insert
yönteminin veplaylistItems.delete
yönteminin bu oynatma listeleri için desteği de tamamen sonlandırıldı ve iki özellik de dokümanlardan kaldırıldı. -
30 Temmuz 2013 tarihinde kullanımdan kaldırıldığı duyurulan
channels.list
yöntemininmySubscribers
parametresi dokümanlardan kaldırıldı. Kimliği doğrulanan kullanıcının kanalına abone olan kullanıcıların listesini almak içinsubscriptions.list
yöntemini ve yönteme aitmySubscribers
parametresini kullanın. -
channel
kaynağının 27 Kasım 2017 tarihinde kullanımdan kaldırıldığı duyurulaninvideoPromotion
nesnesi ve tüm alt özellikleri dokümanlardan kaldırıldı.
29 Temmuz 2020
part
parametresiyle ilişkili ek maliyeti kaldırarak API istekleri için kota ücretlendirme sürecimizi basitleştirdik. Hemen geçerli olmak üzere, yalnızca çağrılan yöntem için taban maliyet alınır. Basitleştirilmiş kota hakkında daha fazla bilgiyi burada bulabilirsiniz.
Bu değişikliğin sonucunda, çoğu API çağrısı marjinal şekilde daha düşük bir kota maliyetine sahip olacak ve bazı API çağrılarının maliyeti yine aynı olacaktır. Bu değişiklik, API çağrılarının maliyetini artırmaz. Genel olarak bunun olası etkisi, Google Cloud Console'da görebileceğiniz ayrılan kotanızın biraz daha artmasıdır.
YouTube API Hizmetleri'ne erişmeye devam ettiklerinden emin olmak için tüm geliştiricilerin projeleri için uygunluk denetimi yapmalarını kesinlikle öneririz.
Bu düzeltme geçmişi girişi ilk olarak 20 Temmuz 2020'de yayınlandı.
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ıtlanacaktır. Bu kısıtlamanın kaldırılması için her projenin bir denetime tabi tutulması ve projenin Hizmet Şartları'na uygunluğun doğrulanması gerekir.
Video yüklemek için doğrulanmamış bir API istemcisi kullanan içerik üreticiler, videolarının gizli olarak kilitlendiğini ve resmi veya denetlenmiş bir istemci kullanarak kısı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. Bununla birlikte, YouTube API Hizmetlerine erişmeye devam ettiklerinden emin olmak için tüm geliştiricilerin projeleri için uygunluk denetimini tamamlamalarını önemle tavsiye ederiz.
21 Temmuz 2020
[Güncelleme tarihi: 28 Temmuz 2020.] 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 yürürlüğe girmedi. Sonuç olarak, doğruluk sağlamak amacıyla belgeler geri döndürüldü. Karışıklığı önlemek amacıyla, değişikliği açıklayan düzeltme geçmişi girişi kaldırıldı ve yakın gelecekte yeniden yayınlanacaktır.
7 Temmuz 2020
Not: Bu, kullanımdan kaldırma duyurusudur.
videos.insert
yönteminin autoLevels
ve stabilize
parametreleri kullanımdan kaldırıldı ve her iki parametre de belgeden kaldırıldı. Bunların değerleri göz ardı edilir ve yeni yüklenen videoların işlenme şeklini etkilemez.
15 Haziran 2020
Yeni YouTube Geliştirici Politikaları'na uyma rehberi, API müşterilerinizin 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 sağlar.
Bu kılavuz, YouTube'un API Hizmet Şartları'nın belirli unsurlarını nasıl uyguladığına dair bilgiler sunar ancak mevcut dokümanların yerini almaz. Kılavuzda, geliştiricilerin API uygunluk denetimleri sırasında en sık sorduğu sorulardan bazıları ele alınmaktadır. Bu özelliğin, politikalarımızı nasıl yorumlayıp uyguladığımızı anlamanıza yardımcı olarak özellik geliştirme sürecinizi basitleştireceğini umuyoruz.
4 Haziran 2020
Not: Bu, kullanımdan kaldırma duyurusundan önce yapılmış bir güncellemedir.
Kanal bülten özelliği artık tamamen kullanımdan kaldırıldı. 17 Nisan 2020'de duyurulan bu değişiklik şu anda yürürlüğe girmiştir. Sonuç olarak, activities.insert
yöntemi artık desteklenmemektedir ve activities.list
yöntemi artık kanal bültenlerini döndürmez. Daha ayrıntılı bilgi için lütfen
YouTube Yardım Merkezi'ni ziyaret edin.
17 Nisan 2020
Not: Bu, kullanımdan kaldırma duyurusudur.
YouTube, kanal bülten özelliğini kullanımdan kaldırıyor. Bunun sonucunda, activities.insert
yöntemi kullanımdan kaldırılacak ve activities.list
yöntemi kanal bültenleri döndürmeyi durduracak. Bu değişiklikler, 18 Mayıs 2020'de veya sonrasında API'de geçerli olacaktır. Daha ayrıntılı bilgi için lütfen
YouTube Yardım Merkezi'ni ziyaret edin.
31 Mart 2020
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
Yeni kaynaklar ve yöntemler
-
Yeni
member
kaynağı, bir YouTube kanalının kanal üyesini temsil eder. Üyeler, içerik üreticilere düzenli olarak maddi destek sağlar ve özel avantajlardan yararlanır. Örneğin, içerik üretici bir sohbet için üyelere özel 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ğı artık kullanımdan kaldırıldı. API istemcileri, bunun yerinemembers.list
yöntemini kullanmak içinsponsors.list
yöntemine yapılan çağrıları güncellemelidir. -
Yeni
membershipsLevel
kaynağı, API isteğini yetkilendiren içerik üreticinin yönettiği bir fiyatlandırma düzeyini tanımlar.membershipsLevels.list
yöntemi, içerik üreticinin tüm üyelik seviyelerinin listesini getirir.
-
10 Ocak 2020
API artık YouTube'un "çocuklara özel" olarak adlandırdığı çocuklara yönelik içerikleri tanımlama özelliğini destekliyor. YouTube Yardım Merkezi'nden "çocuklara özel" içerikler hakkında daha fazla bilgi edinin.
channel
ve video
kaynakları, içerik üreticilerin ve izleyicilerin çocuklara özel içerikleri tanımlamasını sağlayan iki yeni özelliği desteklemektedir:
-
selfDeclaredMadeForKids
özelliği, içerik üreticilerin bir kanalın mı yoksa videonun mı çocuklara özel olduğunu belirtebilmesini sağlar.
Kanallar için bu özellik,channels.update
yöntemi çağrılırken ayarlanabilir. Videolar için bu özellik,videos.insert
veyavideos.update
yöntemleri çağrılırken ayarlanabilir.
Bu özelliğin yalnızca, kanal sahibi API isteğini yetkilendirdiysechannel
veyavideo
kaynaklarını içeren API yanıtlarına dahil edileceğ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, durumselfDeclaredMadeForKids
özelliğinin değerine göre belirlenebilir. Kanalınızın, videolarınızın veya yayınlarınızın kitlesini ayarlama hakkında daha fazla bilgi için YouTube Yardım Merkezi'ne göz atın.
Ayrıca YouTube API Hizmetleri Hizmet Şartları ve Geliştirici Politikaları'nı da güncelledik. Daha fazla bilgi için lütfen YouTube API Hizmetleri Hizmet Şartları - Düzeltme Geçmişi'ni inceleyin. YouTube API Hizmetleri Hizmet Şartları ve Geliştirici Politikaları'nda yapılan değişiklikler, 10 Ocak 2020 Pasifik Saati'nde yürürlüğe girecektir.
10 Eylül 2019
API referans belgeleri, YouTube'da ve dolayısıyla API yanıtlarında abone sayılarının raporlanma yönteminde yapılan değişikliği yansıtacak şekilde güncellendi. Değişikliğin sonucunda, YouTube Data API Hizmeti tarafından döndürülen abone sayıları, 1.000'den fazla abone olan abone sayıları için üç anlamlı değere yuvarlandı. 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 istek gönderdiği durumlarda bile bu mülk değerini etkiler. Kanal sahipleri, tam abone sayılarını YouTube Studio'da 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 diğer herkese açık YouTube kullanıcı arayüzlerinde nasıl kısaltıldığına dair örnekler gösterilmektedir:
Ö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 belgeleri, her yöntemin yaygın kullanım alanlarını daha iyi açıklamak ve API Gezgini widget'ı üzerinden dinamik, yüksek kaliteli kod örnekleri sağlamak için güncellenmiştir. Örnek için
channels.list
yönteminin dokümanlarına bakın. Artık sayfalarda API yöntemlerini açıklayan iki yeni öğe bulunmaktadır:-
API Gezgini widget'ı; yetkilendirme kapsamlarını seçmenizi, örnek parametre ve özellik değerlerini girmenizi, ardından gerçek API isteklerini göndermenizi ve gerçek API yanıtlarını görmenizi sağlar. Widget aynı zamanda, girdiğiniz kapsamları ve değerleri kullanmak için dinamik olarak güncellenen kod örneklerini eksiksiz olarak gösteren bir tam ekran görünümü sunar.
-
Yaygın kullanım alanları bölümünde, sayfada açıklanan yöntemin bir veya daha fazla yaygın kullanım alanı açıklanmaktadır. Örneğin, belirli bir kanalla ilgili verileri almak veya geçerli kullanıcının kanalıyla ilgili verileri almak için
channels.list
yöntemini çağırabilirsiniz.API Gezgini'ni kullanım alanınız için örnek değerlerle doldurmak veya bu değerler önceden doldurulmuş şekilde tam ekran API Gezgini'ni açmak için bu bölümdeki bağlantıları kullanabilirsiniz. Bu değişikliklerin amacı, kendi uygulamanızda uygulamaya çalıştığınız kullanım alanı için doğrudan uygulanabilecek kod örneklerini görmenizi kolaylaştırmaktır.
Kod örnekleri şu anda Java, JavaScript, PHP, Python ve curl için desteklenmektedir.
-
-
Ayrıca kod örnekleri aracı, yukarıda açıklanan özelliklerin tamamını sunan yeni bir kullanıcı arayüzü ile güncellenmiştir. Bu aracı kullanarak farklı yöntemlerin kullanım alanlarını keşfedebilir, API Gezgini'ne değerleri yükleyebilir ve Java, JavaScript, PHP ve Python'da kod örneklerini almak için tam ekran API Gezgini'ni açabilirsiniz.
Bu değişiklikle birlikte, önceden Java, JavaScript, PHP ve Python için kullanılabilir kod örneklerinin listelendiği sayfalar kaldırıldı.
-
Java, JavaScript, PHP ve Python için hızlı başlangıç kılavuzları güncellendi. Düzeltilmiş kılavuzlarda, API Gezgini'ndeki kod örnekleri kullanılarak bir örneğin API anahtarı ve OAuth 2.0 istemci kimliğiyle bir örneğin nasıl çalıştırılacağı açıklanmaktadır.
Yukarıda açıklanan değişikliklerin, 2017'de API dokümanlarına 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ınsnippet.thumbnails
özelliğinin tanımı, uygulamanızda küçük resimler görüntülerken kodunuzun resim URL'lerini tam olarak API yanıtlarında döndürüldüğü şekilde kullanması gerektiğini belirtecek şekilde güncellendi. Örneğin, uygulamanız, API yanıtında döndürülen bir URL'dehttps
alanı yerinehttp
alan adını kullanmamalıdır.Temmuz 2018'den itibaren kanal küçük resmi URL'leri yalnızca
https
alanında kullanılabilecektir. URL'ler, API yanıtlarında bu şekilde görünecektir. Bu süre geçtikten sonra, uygulamanızhttp
alanından YouTube resimleri yüklemeye çalışırsa uygulamanızda bozuk resimler görebilirsiniz. -
Not: Bu, kullanımdan kaldırma duyurusudur.
video
kaynağınınrecordingDetails.location.altitude
özelliği kullanımdan kaldırıldı. Videoların bu özellik için değer döndüreceğine dair herhangi bir garanti verilmez. Benzer şekilde, API istekleri söz konusu mülk için bir değer ayarlamaya çalışsa bile gelen verilerin depolanmaması mümkündür.
22 Haziran 2018
Daha önce Uygulama ve Taşıma rehberi olarak bilinen Uygulama kılavuzu, v2 API'den v3 API'ye geçiş talimatlarını kaldıracak şekilde güncellendi. Ayrıca, favori videolar gibi v3 API'de desteği sonlandırılan özelliklere yönelik talimatlar da kaldırılmıştır.
27 Kasım 2017
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
Not: Bu, kullanımdan kaldırma duyurusudur.
YouTube,
channel
kaynağınıninvideoPromotion
nesnesi aracılığıyla API'de desteklenen Öne Çıkan Video ve Öne Çıkan Web Sitesi özelliklerine yönelik desteği kaldırıyor. Bunun sonucunda, tüm alt özellikleri 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ırkeninvideoPromotion
bölümünü alma girişimleri boş birinvideoPromotion
döndürür veya hiçbirinvideoPromotion
verisi döndürmez.channels.update
çağrılırkeninvideoPromotion
verilerini güncelleme girişimleri en azından 27 Mayıs 2018'e kadar başarılı bir yanıt döndürür, ancak işlem yok olarak değerlendirilir. Bu da gerçekte güncelleme yapmayacağı anlamına gelir.
27 Mayıs 2018'den sonra bu isteklerin, örneğin
invalidPromotion
öğesinin geçersiz bir bölüm olduğunu belirten hata mesajları döndürmesi mümkündür.
16 Kasım 2017
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
Etkileşimli kod snippet'i aracı artık Node.js kod örneklerini destekliyor. Örnekler,
channels.list
yöntemi gibi neredeyse tüm API yöntemlerinin belgelerinde de görülebilir.Özelleştirilebilir örnekler, size Node.js uygulaması için kullanıma özel bir başlangıç noktası sağlamak üzere tasarlanmıştır. İşlev, Node.js hızlı başlangıç kılavuzundaki koda benzer. Ancak örnekler, hızlı başlangıç kılavuzunda görünmeyen bazı yardımcı program işlevleri içerir:
removeEmptyParameters
işlevi, API istek parametrelerine karşılık gelen anahtar/değer çiftlerinin bir listesini alır ve değer içermeyen parametreleri kaldırır.createResource
işlevi, bir API kaynağındaki özelliklere karşılık gelen anahtar/değer çiftlerinin listesini alır. Daha sonra özellikleri,insert
veupdate
işlemlerinde kullanılabilecek bir JSON nesnesine dönüştürür. Aşağıdaki örnekte, bir dizi özellik adı ve değerin yanı sıra 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ü indirilmek ve yerel olarak çalıştırılmak üzere tasarlanmıştır. Daha fazla bilgi için kod snippet'i aracı talimatlarındaki tüm kod örneklerini yerel olarak çalıştırma ön koşullarını inceleyin.
25 Ekim 2017
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
Etkileşimli kod snippet'i aracındaki Python kod örnekleri, kullanımdan kaldırılmış olan
oauth2client
kitaplığının yerinegoogle-auth
vegoogle-auth-oauthlib
kitaplıklarını kullanacak şekilde güncellendi.Bu değişikliğe ek olarak araç, artık biraz farklı yetkilendirme akışları kullanan yüklü Python uygulamaları ve Python web sunucusu uygulamaları için tam kod örnekleri sağlıyor. Tam örnekleri (ve bu değişikliği) görmek için:
- Etkileşimli kod snippet'i aracına veya
channels.list
yöntemi gibi herhangi bir API yönteminin dokümanlarına gidin. - Kod örneklerinin üzerindeki
Python
sekmesini tıklayın. - Snippet'ten tam örneğe geçiş yapmak için sekmelerin üzerindeki açma/kapatma düğmesini tıklayın.
- Sekme artık
InstalledAppFlow
yetkilendirme akışını kullanan eksiksiz bir kod örneği göstermelidir. Örneğin üst tarafındaki açıklamada bu durum açıklanmakta ve aynı zamanda bir web sunucusu uygulaması için örneğin bağlantısı verilmektedir. - Web sunucusu örneğine geçmek için bağlantıyı tıklayın. Bu örnek, Flask web uygulaması çerçevesini ve farklı bir yetkilendirme akışını kullanmaktadır.
Bu örneklerin tümü indirilmek ve yerel olarak çalıştırılmak üzere tasarlanmıştır. Örnekleri çalıştırmak istiyorsanız kod snippet'i aracı talimatlarında bulunan tüm kod örneklerini yerel olarak çalıştırma talimatlarına bakın.
- Etkileşimli kod snippet'i aracına veya
29 Ağustos 2017
Bu güncelleme aşağıdaki değişiklikleri içerir:
search.list
yöntemininforContentOwner
parametresinin tanımı, bu parametretrue
olarak ayarlanırsatype
parametresininvideo
olarak ayarlanması gerektiğini hatırlatacak şekilde güncellendi.search.list
yöntemininregionCode
parametresinin tanımı, parametrenin arama sonuçlarını belirtilen bölgede görüntülenebilecek videolarla kısıtladığını netleştirecek şekilde güncellendi.- YouTube, marka logolarını ve simgelerini güncelledi. Yeni "YouTube ile geliştirilmiş" logolar, marka bilinci oluşturma kuralları sayfasından indirilebilir. Bu sayfada diğer yeni YouTube logoları ve simgeleri de 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. Kılavuzda, YouTube Data API'nın Objective-C veya Swift diliyle yazılmış basit bir iOS uygulamasında 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 istekleri yürütme
- Kod snippet'leri ve tam kod örnekleri arasında geçiş yapma
- Ortak metin işlevlerini kullanma
- Mevcut kaynakları yükleme (güncelleme yöntemleri için)
Not: Araç, API yöntemleriyle ilgili API referans dokümanlarına da yerleştirilmiştir (örnek).
1 Haziran 2017
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
Not: Bu, kullanımdan kaldırma duyurusudur.
Aşağıdaki
video
kaynak özellikleri kullanımdan kaldırılıyor. Mülkler 1 Aralık 2017'ye kadar desteklenecek olsa da videoların bu tarihe kadar bu mülkler için değer döndürmeye devam edeceğine dair bir garanti yoktur. Benzer şekilde, bu özellik değerlerini ayarlayanvideos.insert
vevideos.update
istekleri söz konusu tarihten önce hata oluşturmaz ancak gelen verilerin depolanmaması mümkündür.
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 getirecek şekilde güncellendi.
channels.list
veyavideos.rate
gibi API yöntemlerini açıklayan sayfalarda artık Java, JavaScript, PHP, Python, Ruby, Apps Komut Dosyası ve Go'daki kod snippet'lerini görüntüleyip özelleştirmenizi sağlayan etkileşimli bir araç bulunmaktadır.Herhangi bir yöntem için araç, bir veya daha fazla kullanım alanına ait kod snippet'lerini gösterir ve her kullanım alanı, söz konusu yöntemi çağırmanın yaygın bir yöntemini açıklar. Örneğin, belirli bir kanal veya geçerli kullanıcının kanalı hakkında veri almak için
channels.list
yöntemini çağırabilirsiniz.Kod örnekleriyle de etkileşimde bulunabilirsiniz:
-
Parametre ve özellik değerlerini değiştirdiğinizde, kod snippet'leri sağladığınız değerleri yansıtacak şekilde dinamik olarak güncellenir.
-
Kod snippet'leri ve tam örnekler arasında geçiş yapın. Kod snippet'i, kodun API yöntemini çağıran kısmını gösterir. Tam bir örnek, bu snippet'in yanı sıra istekleri yetkilendirmek ve göndermek için ortak kod içerir. Tam örnekler, komut satırından veya yerel web sunucusundan kopyalanıp çalıştırılabilir.
-
Bir düğmeyi tıklayarak istekleri yerine getirin. (İstekleri yürütmek için aracı, API'yi sizin adınıza çağırması için yetkilendirmeniz gerekir.)
Bu aracın, kullanılabildiği sayfalarda API Gezgini'nin yerini aldığını unutmayın. (Üzerinde çalıştığınız isteği API Gezgini'ne yükleme seçeneğine de sahip olmanız için her sayfada bir bağlantı gösterilir.)
-
-
Ayrıca Veri API Kod Snippet'leri aracı da yukarıda açıklanan özelliklerin tümünü sunan yeni bir kullanıcı arayüzüyle güncellendi. Bu sayfadaki başlıca yeni özellikler şunlardır:
- Veri yazan API istekleri için destek.
- Java örnekleri için destek.
- Kullanıcıları yetkilendirmek ve API istekleri oluşturmak için daha esnek ve kapsamlı standart kod.
27 Nisan 2017
Bu güncelleme aşağıdaki değişiklikleri içerir:
- Yeni hızlı başlangıç kılavuzlarında, YouTube Data API isteklerinde bulunan basit bir uygulamanın nasıl oluşturulacağı açıklanmaktadır. Kılavuzlar şu anda Android, Apps Komut Dosyası, Go, Java, JavaScript, Node.js, PHP, Python ve Ruby için mevcuttur.
30 Mart 2017
Bu güncelleme aşağıdaki değişiklikleri içerir:
channel
kaynağının yenitopicDetails.topicCategories[]
özelliği, kanalın içeriğini açıklayan Wikipedia URL'lerinin listesini içerir. URL'ler, kaynağıntopicDetails.topicIds[]
özelliğinde döndürülen konu kimliklerine karşılık gelir.playlistItem
kaynağının yenicontentDetails.videoPublishedAt
özelliği, videonun YouTube'da yayınlandığı zamanı tanımlar. Kaynak zaten öğenin oynatma listesine eklendiği zamanı tanımlayansnippet.publishedAt
özelliğini içerir.channel
kaynağı gibivideo
kaynağı da artık videonun içeriğini açıklayan Wikipedia URL'lerinin listesini içerentopicDetails.topicCategories[]
özelliğini döndürüyor.video
kaynakları için URL'ler, kaynağıntopicDetails.relevantTopicIds[]
özelliğinde döndürülen konu kimliklerine karşılık gelir.video
kaynağının yenicontentDetails.contentRating.mpaatRating
özelliği, Amerikan Sinema Filmleri Derneği'nin bir film fragmanına veya önizlemesine verdiği puanı tanımlar.
27 Şubat 2017
İlk olarak 11 Ağustos 2016 tarihinde duyurulduğu üzere YouTube, desteklenen konu kimlikleri listesini seçilmiş bir liste olarak değiştirmiştir. Desteklenen konu kimliklerinin tam listesi channel
ve video
kaynaklarının topicDetails
özelliklerinin yanı sıra search.list
yönteminin topicId
parametresinde de bulunur.
Seçilmiş listede birkaç değişiklik olduğunu unutmayın:
- Aşağıdaki konular
Society
konusunun alt konuları olarak eklendi:Ad konu kimliği İşletme /m/09s1f
Sağlık /m/0kt51
Askeriye /m/01h6rj
Politika /m/05qt0
Din /m/06bvp
- Önceden
Entertainment
alt öğesi olanAnimated cartoon
konusu kaldırıldı. - Önceden
Music
alt öğesi olanChildren's music
konusu kaldırıldı.
Bu değişikliğin bir sonucu olarak, videoyla ilgili konular artık her zaman video
kaynağının topicDetails.relevantTopicIds[]
özellik değerinde döndürülüyor.
29 Kasım 2016
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
Konu kimlikleri listesinde, 10 Şubat 2017 tarihinden itibaren desteklenecek üç küçük değişiklik yapılmıştır:
- Daha önce
Sports
kategorisinin alt öğesi olanProfessional wrestling
kategorisi artıkEntertainment
kategorisinin alt kategorisidir. Entertainment
öğesinin alt öğesi olanTV shows
kategorisi yenidir.- Daha önce
Lifestyle
alt kategorisi olanHealth
kategorisi kaldırıldı.
Ayrıca birkaç üst kategori (
Entertainment
,Gaming
,Lifestyle
,Music
veSports
) bulunduğunu unutmayın.Tennis
gibi bir alt kategoriyle ilişkilendirilmiş tüm videolar aynı zamanda üst kategoriyle (Sports
) de ilişkilendirilir. - Daha önce
10 Kasım 2016
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
11 Ağustos 2016'da duyurduğumuz ilk duyuruda, Freebase ve Freebase API'nin kullanımdan kaldırılması için konu kimlikleriyle ilgili bazı değişiklikler yapılması gerekiyor. Konu kimlikleri,
channel
vevideo
kaynaklarıyla ilişkili konuları tanımlar. Belirli bir konuyla ilgili kanalları veya videoları bulmak içintopicId
arama parametresini de kullanabilirsiniz.10 Şubat 2017'de YouTube, şimdiye kadar döndürülen çok daha ayrıntılı kimlikler yerine az sayıda konu kimliği döndürmeye başlayacak. Ayrıca mevcut API davranışıyla tutarlı olan kanal ve videoların herhangi bir konuyla ilişkilendirilmesinin garanti edilmediğini unutmayın.
API istemcilerinizi bu değişikliklere hazırlayabilmeniz için aşağıdaki API parametrelerinin ve özelliklerinin tanımları, bu süreden sonra desteklenecek konu kimliklerini listeleyecek şekilde güncellendi. Kategori listesinin tüm tesisler için aynı olduğunu unutmayın.
channel
kaynağınıntopicDetails.topicIds[]
özelliği.video
kaynağınıntopicDetails.relevantTopicIds[]
özelliği.search.list
yönteminintopicId
parametresi.
-
Not: Bu, kullanımdan kaldırma duyurusudur.
Aşağıdaki özelliklerin desteği sonlandırılıyor:
channel
kaynağınıntopicDetails.topicIds[]
özelliği. Bu mülk, 10 Kasım 2017'ye kadar desteklenecektir.video
kaynağınıntopicDetails.relevantTopicIds[]
özelliği. Bu mülk, 10 Kasım 2017'ye kadar desteklenecektir.video
kaynağınıntopicDetails.topicIds[]
özelliği. Bu özellik, 10 Şubat 2017'den sonraki değerleri içermez. (Bu tarihten sonratopicDetails.relevantTopicIds[]
özelliği değeri, videoyla ilişkilendirilmiş tüm konuları tanımlayacaktır.)
-
Freebase kullanımdan kaldırılmış olduğundan, Searching with Freebase Topics (Freebase Konuları ile Arama) kılavuzu dokümanlardan kaldırılmıştır. Bu rehberde, bir uygulamanın Freebase API ile nasıl çalışacağını gösteren kod örnekleri yer alıyordu.
Ayrıca, konu kimlikleriyle ilgili birkaç kod örneği
search.list
yönteminin dokümanlarından kaldırılmıştır.
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. Yeniplayer.embedHeight
veplayer.embedWidth
özellikleri, yerleştirilmiş oynatıcının boyutlarını tanımlar. Bu özellikler yalnızca API isteği,maxHeight
veyamaxWidth
parametrelerinden en az biri için bir değer belirtirse döndürülür. Bu iki yeni parametrenin açıklaması, bu düzeltme geçmişi girişinin sonraki bölümlerinde açıklanmıştır. -
Yeni
hasCustomThumbnail
özelliği, video yükleyicinin video için özel bir küçük resim sağlayıp sağlamadığını ifade eder. Bu özelliğin yalnızca videoyu yükleyen kişi tarafından görülebildiğini unutmayın. -
Yeni
fpbRatingReasons[]
, videonun FPB (Güney Afrika) derecelendirmesini alma nedenlerini tanımlar. -
Yeni
mcstRating
, bir videonun Vietnam'da aldığı derecelendirmeyi tanımlar.
-
-
videos.list
yöntemi,maxHeight
vemaxWidth
olmak üzere iki yeni parametreyi destekler.video
kaynaklarındaplayer
bölümünü alırken bu 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ıyla eşleşecek şekilde ayarlanır. Böylece, gömülü oynatıcının videoyu çerçeveleyen siyah çubuklar olmamasını sağlar. Örneğin, bir videonun en boy oranı 16:9 ise oynatıcının genişliği 640 piksel olur.Yeni parametrelerle, varsayılan boyutlar yerine yerleştirme kodunun 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 çubuklar içermemesini sağlamak için oynatıcı boyutlarını uygun şekilde ölçeklendirir. Her iki parametrenin de yerleştirilmiş oynatıcının maksimum boyutlarını belirttiğini unutmayın. Bu nedenle, her iki parametre de belirtilirse bir boyut yine de söz konusu boyut için izin verilen maksimum sayıdan küçük olabilir.
Örneğin, bir videonun 16:9 en boy oranına sahip olduğunu varsayalım. Bu nedenle,
maxHeight
veyamaxWidth
parametresi ayarlanmazsaplayer.embedHtml
etiketi 640x360 boyutunda bir oynatıcı içerir.maxHeight
parametresi720
değerine ayarlanır vemaxWidth
parametresi ayarlanmazsa API 1280x720 boyutunda bir oynatıcı döndürür.maxWidth
parametresi960
değerine ayarlanır vemaxHeight
parametresi ayarlanmazsa API 960x540 boyutunda bir oynatıcı döndürür.maxWidth
parametresi960
olarak ayarlanır vemaxHeight
parametresi450
olarak ayarlanırsa API, 800x450 boyutunda bir oynatıcı döndürür.
Yukarıda açıklanan yeni
player.embedHeight
veplayer.embedWidth
özellikleri, oynatıcının boyutlarını tanımlar.
-
-
Mevcut yöntem, özellik ve parametrelerde yapılan güncellemeler
-
channelSection
kaynak açıklaması, kanalların hedefleme verileri ayarlamadan en fazla 10 raf oluşturabileceğini ve hedefleme verileriyle en fazla 100 raf oluşturabileceğini belirtecek şekilde güncellendi.Ayrıca,
channelSection
kaynağınıntargeting
özelliği, hedefleme seçeneklerinin yalnızca API kullanılarak ayarlanabildiği gerçeğini yansıtacak şekilde güncellenmiştir. Kanal bölümü, YouTube web sitesindeki kullanıcı arayüzü kullanılarak değiştirilirse hedefleme seçenekleri silinir. -
i18nLanguage
kaynağınınsnippet.name
özelliğinin tanımı, değerin, bir dilini18nLanguage.list
yöntemininhl
parametresi tarafından belirtilen dilde yazıldığı şekilde adını temsil ettiğini yansıtacak şekilde düzeltildi. -
playlistItem
kaynağınıncontentDetails.note
özelliği, özellik değerinin maksimum uzunluğunun 280 karakter olduğunu belirtecek şekilde güncellendi. -
playlistItem
kaynağınıncontentDetails.startAt
vecontentDetails.endAt
özellikleri kullanımdan kaldırıldı.playlistItems.insert
veyaplaylistItems.update
isteklerinde ayarlanırsa bu alanlar yoksayılır. -
playlistItems.delete
veplaylistItems.update
yöntemleri, diğer birçok yöntem için zaten desteklenenonBehalfOfContentOwner
parametresini artık desteklemektedir. Bu yöntemi kullanan isteklerin,https://www.googleapis.com/auth/youtubepartner
kapsamına erişim sağlayan bir jetonla yetkilendirilmesi gerekir. -
search.list
yöntemininpublishedBefore
vepublishedAfter
parametreleri, parametre değerlerinin kapsayıcı olduğunu belirtecek şekilde güncellendi. Dolayısıyla, örneğinpublishedBefore
parametresi ayarlanırsa API, belirtilen zamandan önce veya zamanda oluşturulan kaynakları döndürür. -
video
kaynağınıncontentDetails.contentRating.grfilmRating
özelliği üç ek değeri destekler:grfilmK12
,grfilmK15
vegrfilmK18
. -
videos.insert
yönteminin açıklaması, yüklenen videolar için maksimum dosya boyutunun 64 GB'tan 128 GB'a çıkarıldığını belirtmek üzere 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 etkinliği verilerinin bu API üzerinden kullanılamadığını belirtmek için bu hatayı döndürür. Yetkisiz bir istektehome
parametresinitrue
olarak ayarlarsanız bu hata oluşabilir.invalidValue (400)
invalidContentDetails
playlistItems.insert
yöntemi, istektekicontentDetails
nesnesinin geçersiz olduğunu belirtmek için bu hatayı döndürür. Bu hatanın oluşmasını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ınamadığı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 bunların API kullanılarak alınamadığını belirtmek için bu hatayı döndürür.badRequest (400)
uploadLimitExceeded
videos.insert
yöntemi, kanalın yükleyebileceği video sayısını aştığını belirtmek için bu hatayı döndürür.forbidden (403)
forbiddenEmbedSetting
videos.update
yöntemi, API isteğinin video için geçersiz bir yerleştirme ayarı belirlemeye çalıştığını belirtmek amacıyla bu hatayı döndürür. Bazı kanalların canlı yayınlar için yerleşik oynatıcılar sunma izni olmayabilir. Daha fazla bilgi için YouTube Yardım Merkezi'ne göz atın. -
Oynatma listesine yinelenen bir video eklerseniz
playlistItems.insert
yöntemi artık hata döndürmez. Bu hata, favori videolar gibi yinelemelere izin vermeyen ancak artık desteklenmeyen bazı oynatma listelerinde daha önce oluşuyordu. Genel olarak, oynatma listeleri yinelenen videolara izin verir.
-
-
Diğer güncellemeler
-
15 Eylül 2016 tarihli düzeltme geçmişi girişi,
channel
kaynağınıncontentDetails.relatedPlaylists.watchHistory
vecontentDetails.relatedPlaylists.watchLater
özellikleri bir yanıta dahil edildiğinde, her zaman sırasıylaHL
veWL
değerlerini içerecek ş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 itibarıyla değişeceği gerçeğ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'da yayınlanacaktır.
-
Aşağıdaki değişiklikler artık geçerli. 11 Ağustos 2016 tarihli düzeltme geçmişi güncellemesinde bu değişikliklere ilişkin bildirim gönderilmiştir:
-
activities.list
yöntemi,home
parametresitrue
değerine ayarlandığında çağrılırsa API yanıtı artık oturumunu kapatmış bir YouTube kullanıcısının ana sayfada göreceği öğelere benzer öğeler içerir.Bu, 11 Ağustos 2016'da yapılan düzeltme geçmişi güncellemesinde açıklanan davranıştan daha iyi bir kullanıcı deneyimi sağlamayı amaçlayan küçük bir değişikliktir. Bu güncellemede,
home
parametresini kullanan isteklerin boş bir liste döndüreceği belirtiliyordu. -
channel
kaynağınıncontentDetails.relatedPlaylists.watchHistory
vecontentDetails.relatedPlaylists.watchLater
özellikleri artık tüm kanallar için sırasıylaHL
veWL
değerlerini içeriyor.Daha açık bir ifadeyle, bu özellikler yalnızca kendi kanalıyla ilgili verileri alan yetkili bir kullanıcı tarafından görülebilir. Yetkili bir kullanıcı, kendi kanalıyla ilgili verileri aldığında bile özellikler her zaman
HL
veWL
değerlerini içerir. Bu nedenle, izleme geçmişi ve daha sonra izle oynatma listesi kimlikleri API üzerinden alınamaz.Ayrıca kanalın izleme geçmişi veya daha sonra izle oynatma listeleri için oynatma listesi ayrıntılarını (
playlists.list
) ya da oynatma listesi öğelerini (playlistItems.list
) alma istekleri artık boş listeler döndürüyor. Bu davranış, yeniHL
veWL
değerlerinin yanı sıra API İstemcinizin halihazırda depolamış olabileceği izleme geçmişi veya daha sonra izle oynatma listesi kimlikleri için de geçerlidir.
-
-
video
kaynağınınfileDetails.recordingLocation
nesnesi ve alt özellikleri artık döndürülmez. Daha önce bu veriler (üstfileDetails
nesnesi gibi) yalnızca videonun sahibi tarafından alınabiliyordu.
11 Ağustos 2016
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
YouTube Mühendislik ve Geliştiriciler Blogu'nda ayrıntılı olarak açıklanan, yeni yayınlanan YouTube API Hizmetleri Hizmet Şartları ("Güncellenen Şartlar"), geçerli Hizmet Şartları'nda kapsamlı bir güncelleme seti sunmaktadır. 10 Şubat 2017'de yürürlüğe girecek olan Güncellenen Şartlar'a ek olarak bu güncelleme, geliştiricilerin uyması gereken politikaların açıklanmasına yardımcı olacak bazı destekleyici dokümanlar içerir.
Yeni dokümanların tamamı Güncellenen Şartlar'ın düzeltme geçmişinde açıklanmıştır. Ayrıca, Güncellenen Şartlar'da veya bu destekleyici belgelerde yapılacak değişikliklerin durumu da söz konusu düzeltme geçmişinde açıklanacaktır. Söz konusu düzeltme geçmişindeki değişiklikleri listeleyen bir RSS özet akışına ilgili dokümandaki bağlantıdan abone olabilirsiniz.
-
Freebase ve Freebase API'nin kullanımdan kaldırılması, konu kimlikleriyle ilgili bazı değişikliklere neden oluyor. Konu kimlikleri aşağıdaki API kaynaklarında ve yöntemlerinde kullanılır:
channel
kaynağınıntopicDetails
bölümü, kanalla ilişkilendirilmiş konuları tanımlar.video
kaynağınıntopicDetails
bölümü, videoyla ilişkilendirilmiş konuları tanımlar.search.list
yönteminintopicId
parametresi, belirli bir konuyla ilgili videoları veya kanalları aramanıza olanak tanır.
Bu özelliklerde yapılan değişiklikler:
-
10 Şubat 2017 itibarıyla YouTube, şu ana kadar döndürülen çok daha ayrıntılı kimlikler yerine az sayıda konu kimliği döndürmeye başlayacak. Bu desteklenen konular Spor veya Basketbol gibi üst düzey kategorizasyonları tanımlar ancak örneğin, belirli takımları veya oyuncuları tanımlamaz. Başvurunuzu bu değişikliğe hazırlamak için size zaman kazandırmak amacıyla, bazı desteklenen konuları duyuracağız.
-
Daha önce aldığınız Freebase konu kimlikleri, 10 Şubat 2017 tarihine kadar içerik aramak için kullanılabilir. Ancak bu süre sonunda, arama sonuçlarını konuya göre almak için yalnızca bir önceki öğede tanımlanan daha küçük konu kümesini kullanabilirsiniz.
-
10 Şubat 2017'den sonra, daha küçük düzeydeki desteklenen konu kimlikleri arasında yer almayan bir konu kimliği kullanarak sonuç aramaya çalışırsanız API boş bir sonuç kümesi döndürür.
-
12 Eylül 2016'dan itibaren pek çok API alanı ve parametresi kullanımdan kaldırılıyor:
-
activities.list
yöntemininhome
parametresi, yetkili bir kullanıcının YouTube ana sayfasında görüntülenecek etkinlik feed'ini alabilmesini sağlar. 12 Eylül 2016'dan sonra bu parametreyi kullanan istekler boş bir liste döndürür. -
channel
kaynağınıncontentDetails.relatedPlaylists.watchHistory
vecontentDetails.relatedPlaylists.watchLater
özellikleri, yalnızca kendi kanalıyla ilgili veri alan yetkili bir kullanıcı tarafından görülebilir. 12 Eylül 2016'dan sonracontentDetails.relatedPlaylists.watchHistory
,HL
değerini vecontentDetails.relatedPlaylists.watchLater
özelliği tüm kanallar içinWL
değerini döndürecektir.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 tarihinden sonra boş bir liste döndürecek. Bu oynatma listelerinden herhangi birindeki oynatma listesi öğeleri (playlistItems.list
) için yapılan istekler de bu sürenin sonunda boş bir liste döndürür. Bu durum, yeniHL
veWL
değerlerinin yanı sıra API İstemcinizin halihazırda depolamış olabileceği izleme geçmişi veya daha sonra izle oynatma listesi kimlikleri için de geçerlidir. -
video
kaynağınınfileDetails.recordingLocation
nesnesi veya alt özelliklerinden herhangi biri 12 Eylül 2016'dan sonra döndürülmeyecektir. ÜstfileDetails
nesnesi sadece bir video sahibi tarafından alınabileceği için bu veriler yalnızca videonun sahibi tarafından alınabilir.
-
13 Haziran 2016
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
channel
kaynağınıncontentDetails.googlePlusUserId
özelliği kullanımdan kaldırıldı. Önceden bu özellik, yalnızca kanal bir Google+ profiliyle ilişkilendirilmişse mevcuttu. Kullanımdan kaldırma işleminden sonra mülk artık hiçbirchannel
kaynağına dahil edilmeyecek. -
comment
kaynağınınsnippet.authorGoogleplusProfileUrl
özelliği kullanımdan kaldırıldı. Önceden bu özellik, yalnızca kanal bir Google+ profiliyle ilişkilendirilmişse mevcuttu. Kullanımdan kaldırma işleminden sonra mülk artık hiçbircomment
kaynağına dahil edilmeyecek.
Kullanımdan kaldırma işleminden sonra bu özelliklerin ikisi de döndürülmeyeceğinden her iki mülk de ilgili kaynak dokümanlarından kaldırılmıştır.
31 Mayıs 2016
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
subscriptions.list
yönteminin yenimyRecentSubscribers
parametresi, kimliği doğrulanmış kullanıcının kanalındaki abonelerin listesini, kanala abone oldukları zamanın ters kronolojik sırasına göre alır.Yeni parametrenin yalnızca kimliği doğrulanmış kullanıcının kanalına en son 1.000 abonenin alınmasını desteklediğini unutmayın. Abonelerin tam listesini almak için
mySubscribers
parametresini kullanın. Belirli bir sırada abone döndürmeyen parametre, alınabilecek abone sayısını sınırlamaz. -
snippet.thumbnails.(key)
özelliğinin tanımı, bazı videolarda daha fazla küçük resim boyutu kullanılabileceğini belirtmek amacıyla etkinlik, playlistItem, oynatma listesi, arama sonucu, küçük resim ve video kaynakları için güncellendi.standard
resmi 640 piksel genişliğinde ve 480 piksel yüksekliğindedir.maxres
resmi 1.280 piksel genişliğinde ve 720 piksel yüksekliğindedir.
-
channelSection.list
yöntemininpart
parametresinin tanımı,targeting
parçasının2
kota birimi karşılığında alınabileceğini belirtecek şekilde güncellendi. -
Hatalı şekilde yetkilendirilen bir istek
video
kaynağınınfileDetails
,processingDetails
veyasuggestions
bölümlerini almaya çalıştığındavideos.list
yöntemi artık yasak (403
) hatası döndürüyor. Bu bölümler yalnızca videonun sahibi tarafından kullanılabilir.
17 Mayıs 2016
Yeni Veri API Kod Snippet'leri aracı, yaygın YouTube Veri API'si 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 ait kod örneklerini gösterir. Örneğin, search.list
yöntemi için beş kod snippet'i sağlar:
- Videoları anahtar kelimeye göre listeleyin
- Videoları konuma göre listeleme
- Canlı etkinlikleri listeleyin
- Kimliği doğrulanmış kullanıcının videolarını arayın
- İlgili videoları listeleyin
Araç, her kullanım alanı için API isteğinde kullanılan parametreleri görüntüler. Parametre değerlerini değiştirebilirsiniz. Bu durumda araç, sağladığınız parametre değerlerini yansıtacak şekilde kod snippet'lerini günceller.
Son olarak, araç her isteğe verilen API yanıtını gösterir. İstek parametrelerini değiştirdiyseniz API yanıtı, sağladığınız parametre değerlerine dayanır. API yanıtlarının gösterilmesi için sizin adınıza istek göndermek üzere aracı yetkilendirmeniz gerektiğini unutmayın.
28 Nisan 2016
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
video
kaynağının yenicontentDetails.projection
özelliği, videonun projeksiyon biçimini belirtir. Geçerli özellik değerleri360
verectangular
şeklindedir. -
video
kaynağınınrecordingDetails.location
vefileDetails.recordingLocation
özellikleri, iki özellik arasındaki farkı açıklayacak şekilde güncellenmiştir:recordingDetails.location
özelliği, video sahibinin videoyla ilişkilendirmek istediği konumu tanımlar. Bu konum düzenlenebilir, herkese açık videolarda aranabilir ve genel videolarda kullanıcılara gösterilebilir.fileDetails.recordingLocation
özellik değeri sabittir ve yüklenen orijinal video dosyasıyla ilişkilendirilen konumu temsil eder. Bu değer yalnızca video sahibi tarafından görülebilir.
-
channel
kaynağınıncontentDetails.relatedPlaylists.favorites
özelliğinin tanımı, özellik değerinin boş bir oynatma listesine işaret eden ve getirilemeyen bir oynatma listesi kimliği içerebileceğine dikkat edilecek şekilde güncellendi. Bunun nedeni, favori videolar işlevinin kullanımdan kaldırılmış olmasıdır. Bu mülkün API kullanımdan kaldırma politikasına tabi olmadığını unutmayın. -
comments.insert
,comments.update
,commentThreads.insert
veyacommentThreads.update
yöntemiyle döndürülebilenineligibleAccount
hatasının tanımı, hatanın API isteğini yetkilendirmek için kullanılan YouTube hesabı kullanıcının Google hesabıyla birleştirilmediğinde oluştuğunu yansıtacak şekilde güncellenmiştir.
20 Nisan 2016
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
channels.update
yöntemininpart
parametresinin tanımı,localizations
bu parametre için de geçerli bir değer olacak şekilde güncellendi. -
Başlangıç kılavuzunun Kota Kullanımı bölümü, gerçek kota ve kota kullanımınızı görebileceğiniz Google Developers Console'a bağlanacak şekilde güncellenmiştir.
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ümanları, yüklenen kanal banner'ı resmi için önerilen boyutun 2560 x 1440 piksel olduğunu belirtecek şekilde güncellendi. Minimum boyut (2048 x 1152 piksel) değişmedi. -
channel
kaynağının yenisnippet.customUrl
özelliği, kanalla ilişkilendirilmiş özel URL'yi tanımlar. (Tüm kanalların özel URL'leri yoktur.) URL'nin nasıl ayarlanacağının yanı sıra YouTube Yardım Merkezi'nde özel URL almaya ilişkin uygunluk koşulları da açıklanmaktadır. -
channel
kaynağınınbrandingSettings.watch
nesnesi ve tüm alt özellikleri kullanımdan kaldırıldı. -
search.list
isteğine verilen API yanıtı artıkregionCode
ö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ı döndürmesi talimatını verir.Tesis değeri, bölgeyi tanımlayan iki harfli ISO ülke kodudur.
i18nRegions.list
yöntemi, desteklenen bölgelerin listesini döndürür. Varsayılan değerUS
değeridir. Desteklenmeyen bir bölge belirtilirse YouTube, sorguyu işlemek için varsayılan değer yerine başka bir bölgeyi seçebilir. -
videoAbuseReportReason
kaynağınınsnippet.label
vesnippet.secondaryReasons[].label
özelliklerinin tanımları, özelliklerin kötüye kullanım raporuna bağlı nedenlerle yerelleştirilmiş etiket metni içerdiği belirtilecek şekilde güncellendi.Ayrıca
videoAbuseReportReasons.list
yöntemi artık, API yanıtında etiket metni için kullanılması gereken dili belirtenhl
parametresini desteklemektedir.en_US
, varsayılan parametre değeridir. -
video
kaynağının yenicontentDetails.contentRating.ecbmctRating
özelliği, bir videonun derecelendirmesini Kültür ve Turizm Bakanlığı'nın Türkiye Değerlendirme ve Sınıflandırma Kurulu'ndan alır.Ayrıca, diğer derecelendirme sistemlerine ilişkin API özellikleri aşağıdaki yeni özellik değerlerini destekler:
contentDetails.contentRating.fpbRating
(Güney Afrika)
Puan: 10; tesis değeri:fpb10
contentDetails.contentRating.moctwRating
(Tayvan)
Puan: R-12; mülk değeri:moctwR12
contentDetails.contentRating.moctwRating
(Tayvan)
Puan: R-15; mülk değeri:moctwR15
-
video
kaynağınınliveStreamingDetails.activeLiveChatId
özelliği, videoyla ilişkili etkin canlı sohbetin kimliğini içerir. Özellik değeri yalnızca videonun, canlı sohbetin etkin olduğu geçerli bir canlı yayın olması durumunda mevcuttur. Yayın ve canlı sohbet sona erdikten sonra mülk artık video için döndürülmez. -
video
kaynağınınstatus.rejectionReason
özelliği, yenilegal
özellik 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
vechannelSections.delete
yöntemleri, belirtilen kanal bölümünün oluşturulamayacağını, güncellenemeyeceğini veya silinemeyeceğini belirtmek için bu hatayı döndürür.badRequest (400)
styleRequired
channelSections.insert
vechannelSections.update
yöntemleri, API isteğinde gönderilenchannelSection
kaynağınınsnippet.style
özelliği için bir değer belirtmesi gerektiğini belirtmek amacıyla bu hatayı döndürür.badRequest (400)
typeRequired
channelSections.insert
vechannelSections.update
yöntemleri, API isteğinde gönderilenchannelSection
kaynağınınsnippet.type
özelliği için bir değer belirtmesi gerektiğini belirtmek amacıyla bu hatayı döndürür.badRequest (400)
processingFailure
commentThreads.list
yöntemi, API sunucusunun isteği başarılı bir şekilde işleyemediğini belirtmek için bu hatayı döndürür. Bu geçici bir hata olabileceği gibi, genellikle istek girişinin geçersiz olduğunu gösterir. Geçerli olduğundan emin olmak için istek gövdesindekicommentThread
kaynağının yapısını kontrol edin.forbidden (403)
commentsDisabled
commentThreads.list
yöntemi,videoId
parametresiyle tanımlanan videonun yorumları devre dışı bıraktığını belirtmek için bu hatayı döndürür.badRequest (400)
commentTextTooLong
commentThreads.insert
yöntemi, eklenencomment
kaynağınınsnippet.topLevelComment.snippet.textOriginal
özelliğinde çok fazla karakter içerdiğini belirtmek için bu hatayı döndürür.invalidValue (400)
videoAlreadyInAnotherSeriesPlaylist
playlistItems.insert
yöntemi, oynatma listesine eklemeye çalıştığınız videonun zaten başka bir dizi oynatma listesinde olduğunu belirtmek için bu hatayı döndürür. Dizi oynatma listeleri hakkında daha fazla bilgi için YouTube Yardım Merkezi'ne göz atın.badRequest (400)
subscriptionForbidden
subscriptions.insert
yöntemi, maksimum abonelik sayınıza ulaştığınızı veya yakın zamanda çok fazla abonelik oluşturduğunuzu belirtmek için bu hatayı döndürür. İkinci durumda, isteği birkaç saat sonra yeniden deneyebilirsiniz.badRequest (400)
invalidCategoryId
videos.update
yöntemi, yüklenenvideo
kaynağındakisnippet.categoryId
özelliğinin geçersiz bir kategori kimliği belirttiğini belirtmek için bu hatayı döndürür. Desteklenen kategorileri almak içinvideoCategories.list
yöntemini kullanın.badRequest (400)
invalidDescription
videos.update
yöntemi, yüklenenvideo
kaynağındakisnippet.description
özelliğinin geçersiz bir değer belirttiğini belirtmek için bu hatayı döndürür.badRequest (400)
invalidPublishAt
videos.update
yöntemi, yüklenenvideo
kaynağındakistatus.publishAt
özelliğinin geçersiz bir zamanlanmış yayınlama saati belirttiğini belirtmek için bu hatayı döndürür.badRequest (400)
invalidRecordingDetails
videos.update
yöntemi, yüklenenvideo
kaynağındakirecordingDetails
nesnesinin geçersiz kayıt ayrıntıları belirttiğini belirtmek için bu hatayı döndürür.badRequest (400)
invalidTags
videos.update
yöntemi, yüklenenvideo
kaynağındakisnippet.tags
özelliğinin geçersiz bir değer belirttiğini belirtmek için bu hatayı döndürür.badRequest (400)
invalidTitle
videos.update
yöntemi, yüklenenvideo
kaynağındakisnippet.title
özelliğinin geçersiz veya boş bir video başlığı belirttiğini belirtmek için bu hatayı döndürür.badRequest (400)
invalidVideoMetadata
videos.update
yöntemi, istek meta verilerinin geçersiz olduğunu belirtmek için bu hatayı döndürür. Bu hata, istek birvideo
kaynağınınsnippet
bölümünü güncelleyip hemsnippet.title
hem desnippet.categoryId
özellikleri için bir değer ayarlamazsa ortaya çıkar.
18 Aralık 2015
Avrupa Birliği (AB) yasaları, AB'deki son kullanıcılara belirli açıklamalar yapılmasını ve bu kullanıcılardan izin alınmasını zorunlu kılar. Bu nedenle, Avrupa Birliği'ndeki son kullanıcılar için AB Kullanıcı Rızası Politikası'na uymanız gerekmektedir. YouTube API Hizmet Şartlarımıza bu şartla ilgili bir bildirim ekledik.
19 Kasım 2015
API artık playlist
ile 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 desteklemektedir.
-
Yerelleştirilmiş başlıklar ve açıklamalar ayarlama
Bir kaynak için
insert
veyaupdate
yöntemini çağırırken kaynak için yerelleştirilmiş değerler belirleyebilirsiniz. Bir kaynak için yerelleştirilmiş değerler ayarlamak üzere aşağıdakilerin ikisini de yapın:-
Kaynağın
snippet.defaultLanguage
özelliği için bir değer ayarlandığından emin olun. Bu özellik, kaynağınsnippet.title
vesnippet.description
özelliklerinin dilini tanımlar. Bu değer, desteklenen herhangi bir uygulama dili veya diğer ISO 639-1:2002 dil kodları olabilir. Örneğin, başlığı ve açıklaması İngilizce olan bir video yüklersenizsnippet.defaultLanguage
özelliğinien
olarak ayarlarsınız.channel
kaynaklarını güncellemek için not: Birchannel
kaynağı içinsnippet.defaultLanguage
özelliğini ayarlamak istiyorsanızbrandingSettings.channel.defaultLanguage
özelliğini güncellemeniz gerekir. -
localizations
nesnesini güncellediğiniz kaynağa ekleyin. Her nesne anahtarı, bir uygulama dilini veya ISO 639-1:2002 dil kodunu tanımlayan bir dizedir ve her tuş, 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. Videoya yerelleştirilmiş Almanca ve İspanyolca başlıklar ve açıklamalar da ekleniyor:
{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", ... }, "localizations": "de": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" }, "es": { "title": "Jugar al fútbol", "description": "Nosotros jugamos fútbol en el parque los domingos", } } }
Önemli: Bir kaynağın yerelleştirilmiş verilerini gü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 videoya Portekiz verileri eklenmesi için daha sonra istek gönderdiyseniz isteğin Almanca, İspanyolca ve Portekizce için yerelleştirilmiş verileri içermesi gerekir.
-
-
Yerelleştirilmiş değerleri alma
API, bir kaynağın yerelleştirilmiş değerlerini almanın iki yolunu destekler:
-
YouTube web sitesinin desteklediği belirli bir uygulama diline yerelleştirilmiş verileri almak için
channels.list
,channelSections.list
,playlists.list
veyavideos.list
isteğinizehl
parametresini ekleyin. Söz konusu dilde yerelleştirilmiş kaynak ayrıntıları mevcutsa kaynağınsnippet.localized
nesnesi, yerelleştirilmiş değerleri içerir. Ancak yerelleştirilmiş ayrıntılar mevcut değilsesnippet.localized
nesnesi, kaynağın varsayılan dilindeki kaynak ayrıntılarını içerir.Örneğin, bir
videos.list
isteğinin yerelleştirilmiş Almanca ve İspanyolca verilerle yukarıda açıklanan videoya ait verileri aldığını varsayalım.hl
parametreside
olarak ayarlanırsa kaynak şu 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
parametresifr
olarak ayarlanırsasnippet.localized
nesnesi, İngilizce başlığı ve açıklamayı içerir çünkü kaynak için varsayılan dil İngilizcedir ve yerelleştirilmiş Fransızca ayrıntılar mevcut değildir.Önemli:hl
parametresi yalnızca YouTube web sitesinin desteklediği uygulama dillerini tanımlayan değerleri destekler. Yerelleştirilmiş metnin diğer dillerde kullanılıp kullanılamadığını belirlemek için kaynağınlocalizations
bölümünü almanız ve yerelleştirilmiş metnin var olup olmadığını belirlemek için filtre uygulamanız gerekir.
Örneğin, yerelleştirilmiş metnin Apalaş İngilizcesi’nde mevcut olup olmadığını belirlemek için tüm yerelleştirmelerin listesini almanız gerekir.
-
Bir kaynak alırken bu kaynağın yerelleştirilmiş tüm ayrıntılarını almak için
part
parametre değerinelocalizations
ekleyin. YouTube uygulama dilinin geçerli olmadığı bir dil için yerelleştirilmiş veriler 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 filtreleme yapmanız gerekir.
-
-
Yerelleştirilmiş metin değerleriyle ilgili hatalar
API, yerelleştirilmiş metin değerleri için aşağıdaki yeni hataları da destekler:
Hata türü Hata ayrıntısı Açıklama badRequest (400)
defaultLanguageNotSetError
Bu hata, bir kaynak için localizations
nesnesini eklemeye veya güncellemeye çalışan isteğin başarısız olduğunu gösterir. Bunun nedeni,snippet.defaultLanguage
özelliğinin söz konusu kaynak için ayarlı olmamasıdır.channels.update
,channelSections.insert
,channelSections.update
,playlists.insert
,playlists.update
,videos.insert
vevideos.update
yöntemleri bu hatayı destekler.badRequest (400)
localizationValidationError
Bu hata, 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
veplaylists.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öntemininorder
parametresi, canlı yayınlarıviewCount
değerine göre sıralarsanız API sonuçlarının, yayınlar devam ederken yayının eşzamanlı görüntüleyen sayısına göre sıralandığını hatırlatacak şekilde güncellendi. -
search.list
yöntemininrelatedToVideoId
parametresi, parametre ayarlanmışsa desteklenen diğer parametrelerin yalnızcapart
,maxResults
,pageToken
,regionCode
,relevanceLanguage
,safeSearch
,type
(video
olarak ayarlanmalıdır) vefields
olduğunu belirtecek şekilde güncellendi. Bu güncelleme, API davranışında bir değişikliğe işaret etmemektedir. -
video
kaynağınınsnippet.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 video olarak yüklenir ve daha sonra herkese açık hâle getirilirse özellik değeri videonun herkese açık hale getirildiği zamanı belirtir. Güncellenen tanımda, değerin gizli ve liste dışı videolar için nasıl doldurulduğu da açıklanmaktadır.Bu değişiklik, API davranışında herhangi bir değişikliğe işaret etmez.
-
video
kaynağınınstatus.publishAt
özelliğinin tanımı şu şekilde güncellendi:videos.update
yöntemini çağırırken bu özelliğin değerini ayarlarsanız video gizli olsa bilestatus.privacyStatus
özellik değerini deprivate
olarak ayarlamanız gerekir.- Talep, bir videonun geçmişteki bir zamanda yayınlanmasını planlarsa hemen yayınlanır. Bu nedenle,
status.publishAt
özelliğini geçmiş bir tarih ve saate ayarlamanın etkisi, videonunprivacyStatus
özelliğininprivate
değerindenpublic
değerine değiştirilmesiyle aynıdır.
-
video
kaynağınıncontentDetails.contentRating.cncRating
özelliği, videonun derecelendirmesini Fransa'nın Commission deClassification sinematographique'den belirtir. Bu özellik, kullanımdan kaldırılancontentDetails.contentRating.fmocRating
özelliğinin yerini alıyor. -
channel
kaynağının brandingSettings.channel.keywords tanımı, daha önce belirtildiği gibi özellik değerinin virgülle ayrılmış liste değil, boşlukla ayrılmış dize listesi içerdiğini doğru şekilde yansıtacak şekilde güncellendi. Bu güncelleme, API davranışında bir değişikliğe işaret etmemektedir. -
thumbnails.set
yöntemiyle ilgili dokümanlar, istek gövdesinin yüklediğiniz ve bir videoyla ilişkilendirdiğiniz küçük resmi içerdiğini doğru şekilde yansıtacak şekilde güncellendi. İsteğin gövdesi birthumbnail
kaynağı içermiyor. Daha önce dokümanlarda, bu yöntemi çağırırken istek gövdesi sağlamamanız gerektiği belirtiliyordu. Bu güncelleme, API davranışında bir değişikliğe işaret etmemektedir. -
activity
kaynağının açıklaması,activities.list
yönteminin şu anda yeni video yorumlarıyla ilgili kaynakları içermediği gerçeğini yansıtacak şekilde güncellendi. Kaynağınsnippet.type
vecontentDetails.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 Kodu badRequest (400)
Neden invalidMetadata
Açıklama kind
özelliği, sağlanan kimlik türüyle eşleşmiyor.commentThreads.update
comments.insert
comments.update
HTTP Yanıt Kodu badRequest (400)
Neden commentTextTooLong
Açıklama Eklenen veya güncellenen comment
kaynağısnippet.topLevelComment.snippet.textOriginal
özelliğinde çok fazla karakter içeriyor.playlistItems.insert
playlistItems.update
HTTP Yanıt Kodu forbidden (403)
Neden playlistItemsNotAccessible
Açıklama Bu istek için belirtilen oynatma listesi öğesini ekleme, güncelleme veya silme yetkisi yok. playlists.delete
playlists.insert
playlists.update
HTTP Yanıt Kodu badRequest (400)
Neden playlistForbidden
Açıklama Bu işlem yasaklanmış veya istek düzgün şekilde yetkilendirilmemiş. search.list
HTTP Yanıt Kodu badRequest (400)
Neden invalidLocation
Açıklama location
ve/veyalocationRadius
parametre değeri yanlış biçimlendirilmiş.search.list
HTTP Yanıt Kodu badRequest (400)
Neden invalidRelevanceLanguage
Açıklama relevanceLanguage
parametre değeri yanlış biçimlendirilmiş.subscriptions.insert
HTTP Yanıt Kodu badRequest (400)
Neden subscriptionForbidden
Açıklama Bu hata, aşağıdakilerden herhangi biri doğru olduğunda oluşur: - Oluşturmaya çalıştığınız abonelik zaten mevcut
- Maksimum abonelik sayısına zaten ulaştınız
- Kendi kanalınıza abone olmaya çalışıyorsunuz ancak kanalınız desteklenmiyor.
- Yakın zamanda çok fazla abonelik oluşturdunuz ve isteği yeniden denemeden önce birkaç saat beklemeniz gerekiyor.
videos.update
HTTP Yanıt Kodu badRequest (400)
Neden invalidDefaultBroadcastPrivacySetting
Açıklama İstek, varsayılan yayın için geçersiz bir gizlilik ayarı belirlemeye çalışıyor.
-
28 Ağustos 2015
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
Mevcut kaynaklar ve yöntemlerde yapılan güncellemeler
-
video
kaynağınınstatistics.favoriteCount
özelliği kullanımdan kaldırıldı.Kullanımdan kaldırma politikamız uyarınca bu mülk, bu duyurudan sonra en az bir yıl boyunca
video
kaynaklarında yer almaya devam edecek. Ancak özellik değeri artık her zaman0
olarak ayarlandı.
-
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ınsnippet.tags[]
özelliğinin tanımı, API sunucusunun mülk değerinin uzunluğunu nasıl hesapladığı hakkında daha fazla bilgi sağlamak için güncellendi. Bu güncellemenin, API'nin davranışındaki bir değişikliği yansıtmadığını unutmayın.Tanıma artık özellikle, bir etiket boşluk içeriyorsa API sunucusunun etiket değerini tırnak içine alınmış gibi işlediği ve tırnak işaretlerinin karakter sınırına dahil edildiği belirtilmektedir. Bu nedenle, karakter sınırlaması açısından, Foo-Baz etiketi yedi karakter içerirken, Foo Baz etiketi dokuz karakter içerir.
-
commentThreads.insert
yöntemi artık, daha önce bir yorumun ve bu yoruma verilen yanıtların yazarın Google+ profilinde de yayınlanmasının gerekli olup olmadığını belirtenshareOnGooglePlus
parametresini desteklemez. Parametre bir istek tarafından gönderilirse API sunucusu parametreyi yoksayar ancak isteği başka bir şekilde 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 yeniorder
parametresi, API yanıtının yorum ileti dizilerini listelemesi gereken sırayı belirtir. Mesaj dizileri zamana veya alaka düzeyine göre sıralanabilir. Varsayılan davranış, verilerin zamana göre sıralanmasıdır. -
video
kaynağının yenisnippet.defaultAudioLanguage
özelliği, videonun varsayılan ses parçasında konuşulan dili belirtir. -
video
kaynağınıncontentDetails.licensedContent
özelliğinin tanımı, içeriğin orijinal olarak YouTube içerik iş ortağına bağlı bir kanala yüklenmiş ve ardından bu iş ortağı tarafından hak talebinde bulunulmuş olması gerektiğini netleştirecek şekilde güncellendi. Bu durum, gerçek API davranışında herhangi bir değişikliğe işaret etmez. -
captions.delete
,captions.download
,captions.insert
,captions.list
vecaptions.update
yöntemleri artık, diğer birçok yöntem için zaten desteklenenonBehalfOfContentOwner
parametresini destekliyor. Bu yöntemi kullanan isteklerin,https://www.googleapis.com/auth/youtubepartner
kapsamına erişim sağlayan bir jetonla yetkilendirilmesi gerekir.
-
-
Yeni ve güncellenmiş hatalar
-
API artık aşağıdaki hataları desteklemektedir:
Hata ayrıntıları videos.rate
HTTP Yanıt Kodu badRequest (400)
Neden emailNotVerified
Açıklama Kullanıcı, videoyu derecelendirmeden önce e-posta adresini doğrulamalıdır. videos.rate
HTTP Yanıt Kodu badRequest (400)
Neden videoPurchaseRequired
Açıklama Kiralık videolar, yalnızca bunları kiralayan kullanıcılar tarafından değerlendirilebilir. -
subscriptions.delete
vesubscriptions.insert
yöntemleri artıkaccountClosed
veaccountSuspended
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ığından işaretlenme nedeni hakkında bilgiler 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şaretlemek için bir yöntem sunar. İsteğin gövdesi, işaretlenen videoyu ve videonun kötüye kullanım amaçlı içerik barındırdığının nedenini belirten bir JSON nesnesi içerir. Geçerli nedenler, yukarıda açıklananvideoAbuseReportReason.list
yönteminden elde edilebilir.Ayrıca taşıma rehberi, kötüye kullanım amaçlı video bildirme örneği eklenerek güncellendi. Bu değişiklikle birlikte v3 API, artık desteklemeyi planladığı tüm v2 API özelliklerini destekliyor. Bu özelliklerin tümü taşıma kılavuzunda da açıklanmıştır.
-
-
Mevcut kaynaklar ve yöntemlerde yapılan güncellemeler
-
search.list
yönteminin yeniforDeveloper
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şkilendirilmiş proje numarasıyla otomatik olarak etiketlenir.
Bir arama isteği daha sonra
forDeveloper
parametresinitrue
olarak ayarladığında API sunucusu, geliştiriciyi tanımlamak için isteğin yetkilendirme kimlik bilgilerini kullanır. Bu nedenle, bir geliştirici, sonuçları kendi uygulaması veya web sitesi üzerinden yüklenen videolarla kısıtlayabilir ancak diğer uygulamalar veya siteler aracılığıyla yüklenen videolarla sınırlamaz.Yeni özellik, v2 API'sinin desteklediği geliştirici etiketleri işlevine benzer olsa da benzer işlevler sunar.
-
channel
kaynağının yenisnippet.country
özelliği, kanal sahiplerinin kanallarını belirli bir ülkeyle ilişkilendirmesine olanak tanır.Not: Bir
channel
kaynağı içinsnippet.country
özelliğini ayarlamak istiyorsanızbrandingSettings.channel.country
özelliğini güncellemeniz gerekir. -
API artık
channelSection
kaynaklarını hedeflemeyi destekliyor. Kanal bölümü hedefleme, bir içerik bölümünün görünürlüğünü belirli ölçütlerle eşleşen kullanıcılarla kısıtlamak için bir yol sağlar.API, üç hedefleme seçeneği sunar. 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.
-
targeting.languages[]
: YouTube uygulama dillerinin listesi. Bu dillerden birini seçen kullanıcılar ilgili kanal bölümünü görebilir. -
targeting.regions[]
: YouTube'un tercih ettiği içerik bölgelerinin listesi. Kanal bölümü, bu bölgelerden birini seçen kullanıcıların yanı sıra bu bölgelerden birinin otomatik olarak seçildiği kullanıcılar tarafından da görülebilir. -
targeting.countries[]
: Kanal bölümünün göründüğü ülkelerin listesi. Listedeki her değer bir ISO 3166-1 alfa-2 ülke kodudur.
-
-
video
kaynağınıncontentDetails.duration
özelliğinin tanımı, değerin saat, gün gibi değerleri yansıtabileceğini yansıtacak şekilde düzeltildi. -
channelSections.delete
,playlistItems.delete
,playlists.delete
,subscriptions.delete
vevideos.delete
yöntemlerinin dokümanları, başarılı olduğunda bu yöntemlerin tamamının HTTP204
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çeriyorsachannelSections.insert
vechannelSections.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çeriyorsachannelSections.insert
vechannelSections.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çeriyorsachannelSections.insert
vechannelSections.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 ekleyemiyorsacomments.insert
yöntemi bu hatayı döndürür. BircommentThread
kaynağındasnippet.canReply
özelliği, geçerli görüntüleyenin ileti dizisine yanıt verip veremeyeceğini ifade eder.badRequest (400)
invalidChannelId
İstekteki channelId
parametresi geçersiz bir kanal kimliği belirtirsesearch.list
yöntemi bu hatayı döndürür.badRequest (400)
subscriptionForbidden
API kullanıcısı, kullanıcının kendi kanalına abone olmaya çalışırsa subscriptions.insert
yöntemi bu hatayı döndürür. -
captions.update
yöntemi artıkinvalidMetadata
vevideoNotFound
hatalarını desteklemiyor.
-
16 Nisan 2015
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
Taşıma rehberi, v2 API'sinin yorum işlevini kullanmaya devam eden uygulamaları nasıl taşıyacağınızı açıklayacak şekilde güncellendi.
Kılavuzda ayrıca v2 API'nin desteklemediği ancak v3 API'sinde desteklenen çeşitli yorum yazma özellikleri de belirtilmiştir. Bunlardan bazıları:
- Kanal hakkında yorum alma
- Bir kanalla ilgili tüm yorum ileti dizilerini alma. Bu, API yanıtının kanal veya videolarından herhangi biri hakkında yorumlar içerebileceği anlamına gelir.
- Yorum metnini güncelleme
- Bir yorumu spam olarak işaretleme
- Yorumun denetleme durumunu ayarlama
-
Push bildirimlerine abone olma kılavuzu, bildirimlerin daha önce belirtildiği gibi Superfeedr merkezine değil, yalnızca Google PubSubHubBub merkezine aktarıldığını yansıtacak şekilde güncellendi.
9 Nisan 2015
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
API'nin yeni
commentThread
vecomment
kaynakları, yorumları almanızı, eklemenizi, güncellemenizi, silmenizi ve denetlemenizi sağlar.-
Bir
commentThread
kaynağı, bir YouTube yorum ileti dizisiyle ilgili bilgiler içerir. Üst düzey bir yorum ve yoruma verilen yanıtlar (varsa) bu ileti dizisine dahildir.commentThread
kaynağı, bir video veya kanal hakkındaki 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 yoruma verilen tüm yanıtları içermeyebileceğini ve belirli bir yoruma ilişkin tüm yanıtları almak istiyorsanızcomments.list
yöntemini kullanmanız gerektiğini hatırlatmak isteriz. Ayrıca, bazı yorumlara yanıt verilmez.API,
commentThread
kaynakları için aşağıdaki yöntemleri destekler:commentThreads.list
– Yorum ileti dizilerinin listesini alın. Belirli bir video veya kanalla ilişkili yorumları almak için bu yöntemi kullanın.commentThreads.insert
– Yeni bir üst düzey yorum oluşturun. (Mevcut bir yorumu yanıtlamak içincomments.insert
yöntemini kullanın.)commentThreads.update
– Üst düzey bir yorumda değişiklik yapabilirsiniz.
-
Bir
comment
kaynağı, tek bir YouTube yorumuyla ilgili bilgileri içerir.comment
kaynağı, bir video veya kanal hakkındaki bir yorumu temsil edebilir. Ayrıca yorum, üst düzey bir yorum veya üst düzey bir yoruma yanıt da olabilir.API,
comment
kaynakları için aşağıdaki yöntemleri destekler:comments.list
– Yorum listesini alın. 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 denetleme durumunu ayarlayabilirsiniz. Örneğin, bir yorumu herkese açık olarak görüntülemek için temizleyebilir veya görüntülenmeye uygun olmadığı düşünülerek reddedebilirsiniz. API isteği, yorumlarla ilişkili kanalın veya videonun sahibi tarafından yetkilendirilmelidir.comments.delete
– Yorumu silin.
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
vecommentThreads.update
yöntemlerine yapılan ç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 bildirimlerine yönelik yeni desteği açıklanmaktadır. Bir kanal aşağıdaki etkinliklerden herhangi birini yaptığında PubSubHubBub geri çağırma sunucunuz Atom feed bildirimleri alabilir:
- bir video yüklediğinde
- bir videonun başlığını güncelliyor
- Bir videonun açıklamasını günceller
-
Taşıma rehberi ayrıca push bildirimleri için sunulan yeni desteği belirtmek üzere güncellendi. Bununla birlikte, v2 API'si, v3 API'sinde desteklenmeyen çok sayıda başka push bildirimi türünü desteklediğinden PubSubHubBub desteğinden bahsedilmesi, söz konusu kılavuzun Kullanımdan kaldırıldı bölümünde listelenmeye devam etmektedir.
-
API'nin yeni
https://www.googleapis.com/auth/youtube.force-ssl
kapsamı, daha öncehttps://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çeriyorsavideos.rate
yöntemi bu hatayı döndürür. -
subscriptions.insert
yöntemi, daha önce istekle tanımlanan abonenin abonelik oranı sınırını aştığını belirtensubscriptionLimitExceeded
hatasını artık desteklememektedir.
2 Nisan 2015
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
Yeni
captions
kaynağı, bir YouTube altyazı parçasını temsil eder. Bir altyazı parçası tam olarak bir YouTube videosuyla ilişkilendirilir.API; altyazı parçalarını listeleme, ekleme, güncelleme, indirme ve silme yöntemlerini destekler.
-
Taşıma rehberi, v2 API'sinde altyazı işlevini kullanmaya devam eden uygulamaların nasıl taşınacağını açıklamak üzere güncellendi.
-
API'nin yeni
https://www.googleapis.com/auth/youtube.force-ssl
kapsamı, API sunucusuyla iletişimin SSL bağlantısı üzerinden gerçekleşmesini gerektirir.Bu yeni kapsam,
https://www.googleapis.com/auth/youtube
kapsamıyla aynı erişimi sağlar. YouTube API sunucusu yalnızca HTTPS uç noktası üzerinden kullanılabildiğinden bu iki kapsam işlevsel olarak aynıdır. Sonuç olarak,https://www.googleapis.com/auth/youtube
kapsamı SSL bağlantısı gerektirmese de API isteğinde bulunmanın başka bir yolu yoktur.Yeni kapsam,
caption
kaynağının tüm yöntemlerine yapılan çağrılar için gereklidir.
11 Mart 2015
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
YouTube Data API (v3) taşıma rehberi, v3 API'nin desteklediği ve v2 API'nin desteklemediği özellikleri listeleyen v3 API'deki yeni adlı yeni bir sekme içerir. Aynı özellikler daha önce vardı ve rehberdeki diğer sekmelerde listelenmeye devam ediyor. Örneğin bir kanalın video içi tanıtım kampanyası verilerinin nasıl güncelleneceğini açıklayan yeni özellik Kanallar (profiller) sekmesinin altında da listelenir.
-
YouTube Data API (v3) taşıma rehberi, v3 API'nin aşağıdaki v2 API özelliğini destekleyeceğini belirtmek için güncellendi:
-
YouTube Data API (v3) taşıma rehberi, aşağıdaki v2 API özelliklerinin v3 API'de desteklenmeyeceğini belirtmek için güncellendi:
-
Video önerilerini alma – v3 API, yalnızca geçerli API kullanıcısı için önerilen videoları içeren bir listeyi almaz. Ancak
activities.list
yöntemini çağırıphome
parametre değerinitrue
olarak ayarlayarak önerilen videoları bulmak için v3 API'yi kullanabilirsiniz.API yanıtında,
snippet.type
özelliğinin değerirecommendation
ise kaynak, önerilen videoya karşılık gelir. Bu durumdacontentDetails.recommendation.reason
vecontentDetails.recommendation.seedResourceId
özellikleri, videonun neden önerildiği hakkında bilgi içerir. Yanıtta önerilen sayıda videonun bulunacağının garantisi yoktur. -
Yeni abonelik videolarını al – v3 API, yalnızca API kullanıcısının abone olduğu kanallara son zamanlarda yüklenen videoları içeren bir listeyi almaz. Ancak
activities.list
yöntemini çağırıphome
parametre değerinitrue
olarak ayarlayarak yeni abonelik videoları bulmak için v3 API'yi kullanabilirsiniz.API yanıtında,
snippet.type
özelliğinin değeriupload
ise kaynak yeni bir abonelik videosuna karşılık gelir. Yanıtta belirli sayıda yeni abonelik videosu bulunacağının garanti edilmediğini unutmayın. -
Feed güncellemeleri için push bildirimleri: v2 API, YouTube kullanıcıları için kullanıcı etkinliği feed'lerini izlemek amacıyla Basit Güncelleme Protokolü (SUP) veya PubSubHubbub kullanarak push bildirimlerini destekliyordu. Yeni kanal abonelikleri ve videolar değerlendirildiğinde, paylaşıldığında, favori olarak işaretlendiğinde, yorum yapıldığında veya yüklendiğinde bildirimler alındı.
v3 API'si, PubSubHubbub protokolünü kullanan 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'si, kanalın herkese açık YouTube profiline girildiği şekliyle kullanıcının konumunu tanımlamak için
<yt:location>
etiketini kullandı. Bazı geliştiriciler, bir kanalı belirli bir ülkeyle ilişkilendirmek için bu alanı kullansalar da alanın verileri bu amaçla tutarlı bir şekilde kullanılamıyordu. -
Geliştirici etiketlerini ayarlayın veya alın – v2 API, anahtar kelimeleri veya geliştirici etiketlerini video yüklendiği sırada videoyla ilişkilendirme özelliğini 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'si benzer ancak aynı olmayan bir özellik sağlar. Özel olarak belirtmek gerekirse, geliştirici, kendi uygulaması tarafından yüklenen videoları arayabilir. Bu özellik için yüklenen her video, Google Developers Console'da geliştiricinin uygulamasıyla ilişkilendirilmiş proje numarasıyla otomatik olarak etiketlenir. Daha sonra geliştirici, video aramak için aynı proje numarasını kullanır.
-
Videoları yayınlanma tarihine, görüntüleme sayısına veya derecelendirmeye göre listeleyin – v2 API'deki
orderby
parametresi, bir oynatma listesindeki videoları konum, süre, yayınlanma tarihi, başlık ve diğer çeşitli değerlere göre sıralamanıza olanak tanır. v3 API'sinde oynatma listesi öğeleri genellikle konuma göre artan düzende sıralanır ve diğer sıralama seçenekleri kullanılamaz.Birkaç istisna vardır. Yeni bir yükleme, favori video, beğenilen video veya son izlenen video, aşağıdaki oynatma listesi türleri için otomatik olarak ilk öğe (
snippet.position
=0
) olarak eklenir. Bu nedenle, bu listelerin her biri, öğelerin listeye eklenme zamanına dayalı olarak en yeniden en eskiye doğru etkili bir şekilde 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, listedeki son öğe olarak eklendiğini, dolayısıyla bu listenin en eski öğeden en yeni öğeye doğru etkili bir şekilde sıralanacağını unutmayın.
-
Toplu işleme – v3 API, v2 API'nin desteklediği toplu işleme kullanım alanlarından birini destekler. v3 API'lerinin
channels.list
,channelSections.list
,guideCategories.list
,playlistItems.list
,playlists.list
,subscriptions.list
,videoCategories.list
vevideos.list
yöntemlerinin tümü, kimliklerin (video kimlikleri, kanal kimlikleri vb.) virgülle ayrılmış listesini belirtmek için kullanılabilenid
parametresini destekler. Bu yöntemleri kullanarak, tek bir istekle birden çok kaynağın listesini alabilirsiniz.
Bu değişikliklerle birlikte kılavuz artık eski (v2) API'de desteklenen tüm işlevleri, ancak şu anki API sürümünde (v3) kullanımdan kaldırılacak olanları tanımlıyor.
-
4 Mart 2015
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
channelSections.delete
vechannelSections.update
yöntemleri, diğer birçok yöntem için zaten desteklenenonBehalfOfContentOwner
parametresini artık desteklemektedir. -
Aşağıdaki mülkler ve bunların alt özellikleri kullanımdan kaldırılmıştır:
brandingSettings.image.backgroundImageUrl
brandingSettings.image.largeBrandedBannerImageImapScript
brandingSettings.image.largeBrandedBannerImageUrl
brandingSettings.image.smallBrandedBannerImageImapScript
brandingSettings.image.smallBrandedBannerImageUrl
Not: Bu mülklerin hiçbiri API'nin Kullanımdan Kaldırılması Politikası'na tabi değildi.
-
video
kaynağının yenicontentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons
özelliği, videonun DJCQT (Brezilya) derecelendirmesini neden aldığını açıklayan nedenleri tanımlar. -
API artık aşağıdaki hataları desteklemektedir:
Hata türü Hata ayrıntısı Açıklama notFound (404)
channelNotFound
İsteğin id
parametresi, bulunamayan bir kanalı belirtiyorsachannels.update
yöntemi bu hatayı döndürür.badRequest (400)
manualSortRequiredinvalidValue
İstek, oynatma listesi öğesinin konumunu ayarlamaya çalışır ancak oynatma listesi manuel sıralamayı kullanmıyorsa playlistItems.insert
veplaylistItems.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 kaynaktansnippet.position
öğesini kaldırarak bu hatayı giderebilirsiniz. Oynatma listesi öğesinin listede belirli bir konumda olmasını istiyorsanız önce oynatma listesinin sıralama ayarını Manuel olarak güncellemeniz gerekir. Bu ayar YouTube Video Yöneticisi'nden yapılabilir.forbidden (403)
channelClosed
İsteğin channelId
parametresi kapatılmış bir kanalı belirtiyorsaplaylists.list
yöntemi bu hatayı döndürür.forbidden (403)
channelSuspended
İsteğin channelId
parametresi askıya alınmış bir kanalı belirtiyorsaplaylists.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şseplaylists.list
yöntemi bu hatayı döndürür.notFound (404)
channelNotFound
İsteğin channelId
parametresi, bulunamayan bir kanalı belirtiyorsaplaylists.list
yöntemi bu hatayı döndürür.notFound (404)
playlistNotFound
İsteğin id
parametresi, bulunamayan bir oynatma listesini belirtiyorsaplaylists.list
yöntemi bu hatayı döndürür.notFound (404)
videoNotFound
İsteğin id
parametresi, bulunamayan bir videoyu belirtiyorsavideos.list
yöntemi bu hatayı döndürür.badRequest (400)
invalidRating
İstek, rating
parametresi için beklenmeyen bir değer içeriyorsavideos.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ı istemenizi sağlayanrelevanceLanguage
parametresini desteklemektedir.YouTube Data API (v3) taşıma rehberi de bu yeni parametrenin nasıl kullanılacağını açıklayan şekilde güncellendi. Parametre, mevcut API sürümü (v3) ile 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) taşıma rehberi de v2 API'nin filmler, fragmanlar, televizyon programları, televizyon sezonları ve televizyon bölümlerini açıklamak için sağladığı özel feed'ler ve meta veri alanlarının kullanımdan kaldırıldığını belirtecek şekilde güncellendi.
14 Ocak 2015
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
YouTube Data API (v3) taşıma rehberi, JavaScript kullanarak video yüklemek için v3 API'nin nasıl kullanılacağının açıklandığı şekilde güncellendi. (Ayrıntılar için Video yükleme bölümüne bakın.) Bu işlev, v2 API'sinin desteklediği tarayıcı tabanlı yükleme işleviyle karşılaştırılabilir. Taşıma kılavuzunda yapılan bu değişikliğin gerçek bir API değişikliğini değil, istemci taraflı JavaScript ile video yüklemek için yeni örnek kodun kullanılabilirliğini yansıttığını unutmayın.
Videoları JavaScript istemci kitaplığı ve CORS ile yükleme desteği göz önünde bulundurulduğunda, taşıma rehberinde tarayıcı tabanlı yükleme özelliği, v3 API'de desteği sonlandırılmış olabilecek bir özellik olarak listelenmiyor.
-
videos.insert
yöntemiyle ilgili dokümanlar, yukarıda açıklanan yeni JavaScript kod örneğini içerecek şekilde güncellenmiştir. 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şti.Önemli: Çoğu durumda, bilgileri daha düşük bir kota maliyetiyle almak için diğer API yöntemlerini kullanabilirsiniz. Örneğin, GoogleDevelopers kanalına yüklenen videoları bulmanın iki yolunu düşünün.
-
Kota maliyeti: 100 birim
search.list
yöntemini çağırın veGoogleDevelopers
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
parametresiniGoogleDevelopers
vepart
parametresinicontentDetails
olarak ayarlayın. API yanıtındacontentDetails.relatedPlaylists.uploads
özelliği, kanalın yüklenen videoları için oynatma listesi kimliğini belirtir.Daha sonra,
playlistItems.list
yöntemini çağırın veplaylistId
parametresini yakalanan kimliğe vepart
parametresinisnippet
olarak ayarlayın.
-
8 Ekim 2014
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
channel
kaynağında iki yeni özellik yer alır:-
status.longUploadsStatus
özelliği, kanalın 15 dakikadan uzun videolar yüklemeye uygun olup olmadığını belirtir. Bu mülk, yalnızca kanal sahibi API isteği için yetki verdiyse döndürülür. Geçerli özellik değerleri şunlardır:allowed
– Kanal, 15 dakikadan uzun videolar yükleyebilir.eligible
: Kanal, 15 dakikadan uzun videolar yükleyebilir. Ancak önce bu özelliğin etkinleştirilmesi gerekir.disallowed
– Kanal, 15 dakikadan uzun videolar yükleyemez veya yüklemeye uygun değildir.
Bu değerler hakkında daha fazla bilgi için özellik tanımına bakın. Bu özellikle ilgili daha ayrıntılı bilgileri 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ı belirtir. Bu özellik, tanıtımları videonun tıklanma ve izleme deneyimini sekteye uğratma olasılığının daha düşük olduğu bir noktasında göstermeye çalışır. Bu özellik ayrıca her videoda gösterilecek tek bir tanıtım seçer.
-
-
video
kaynağınınsnippet.title
vesnippet.categoryId
özelliklerinin tanımları, API'ninvideos.update
yöntemine yapılan çağrıları işleme şeklini netleştirmek için güncellendi. Birvideo
kaynağınınsnippet
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 belirlemeniz gerekir.Bir
video
kaynağınınsnippet
bölümünü güncellemeye çalışır ve bu özelliklerin her ikisi için de değer belirlemezseniz API,invalidRequest
hatası döndürür. Bu hatanın açıklaması da güncellendi. -
video
kaynağının Yeni Zelanda Film ve Edebiyat Sınıflandırma Ofisi'nden bir videonun puanını tanımlayancontentDetails.contentRating.oflcRating
özelliği artık iki yeni derecelendirmeyi destekliyor:oflcRp13
veoflcRp16
. Bunlar sırasıylaRP13
veRP16
derecelendirmelerine karşılık gelir. -
channelBanners.insert
yöntemi artık aşağıdaki hatayı desteklemektedir:Hata türü Hata ayrıntısı Açıklama badRequest
bannerAlbumFull
Kanal sahibinin YouTube Kanal Resmi albümünde çok fazla resim var. Kanal sahibi http://photos.google.com adresine gitmeli, albümler sayfasına gitmeli ve bu albümdeki resimlerden bazılarını kaldırmalıdır.
12 Eylül 2014
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
search.list
yöntemine yapılan bir çağrının kota maliyeti, belirtilen kaynak parçalarının maliyetine ek olarak 1 birimden 2 birim olarak değiştirildi.
13 Ağustos 2014
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
subscriptions.insert
yöntemi artık aşağıdaki hatayı desteklemektedir:Hata türü Hata ayrıntısı Açıklama badRequest
subscriptionLimitExceeded
İstekle tanımlanan abone, abonelik oranı sınırını aştı. Birkaç saat sonra tekrar abone olmayı deneyebilirsiniz.
12 Ağustos 2014
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
Uygulamanızı YouTube Data API'ye Taşıma (v3) başlıklı yeni kılavuzda, YouTube Data API'deki (v2) işlevlerin yerine getirilmesi için YouTube Data API'nin (v3) nasıl kullanılacağı açıklanmaktadır. Eski API, 4 Mart 2014 tarihi itibarıyla resmi olarak kullanımdan kaldırılmıştır. Kılavuz, v2 API'yi kullanmaya devam eden uygulamaları en son API sürümüne taşımanıza yardımcı olmak için hazırlanmıştır.
8 Temmuz 2014
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
playlists.insert
yöntemi artık aşağıdaki hatayı desteklemektedir:Hata türü Hata ayrıntısı Açıklama badRequest
maxPlaylistExceeded
Kanalda zaten izin verilen maksimum sayıda oynatma listesi bulunduğundan bir oynatma listesi oluşturulamıyorsa bu hata oluşur.
18 Haziran 2014
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
Her API yönteminin açıklaması, söz konusu yönteme yapılan bir çağrının neden olduğu kota maliyetini içerecek şekilde güncellenmiştir. Benzer şekilde,
part
parametrelerinin tanımları, bir API çağrısında alınabilecek her bir bölümün kota maliyetini belirtecek şekilde güncellendi. Örneğin,subscriptions.insert
yöntemine yapılan bir çağrının yaklaşık 50 birimlik kota maliyeti olur.subscription
kaynağı da üç parça (snippet
,contentDetails
vesubscriberSnippet
) içerir ve bunların her birinin iki birim maliyeti vardır.Kota maliyetlerinin uyarı yapılmaksızın değişebileceğini lütfen unutmayın.
-
video
kaynağı artık videoların çeşitli ulusal derecelendirme kuruluşlarından aldığı derecelendirmeleri tanımlayan 43 yeni içerik derecelendirme sistemini destekliyor. Desteklenen yeni derecelendirme sistemleri: Arjantin, Avusturya, Belçika, BulgaristanİsviçreİsviçreİsviçreİsviçreİsviçreŞiliİsviçreŞili, Mısır, İsviçre, İsviçre, Şili, İsviçre, Şili, ,İsviçre, , Mısır, Arjantin, Avusturya, Mısır, )
28 Mayıs 2014
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
search.list
yöntemi artık bir coğrafi konumla ilişkilendirilmiş videoları aramanıza olanak tanıyanlocation
velocationRadius
parametrelerini desteklemektedir. Konuma göre sonuç almak için isteğin her iki parametreye ait bir değeri belirtmesi gerekir ve istek 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 videoyla ilişkilendirilen konumun, videonun arama sonuçlarına dahil edilebilmesi için alanın merkezinden olabileceği maksimum mesafeyi belirtir.
-
13 Mayıs 2014
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
channel
kaynağınıninvideoPromotion.items[]
özelliği, kanalınız için genellikle yalnızca bir tane tanıtılan öğe ayarlayabileceğinizi gösterecek şekilde güncellendi. Çok fazla sayıda tanıtılan öğe eklemeye çalışırsanız API, HTTP400
durum koduna sahiptooManyPromotedItems
hatasını döndürür. -
channelSection
kaynağı artık öne çıkan birkaç yeni içerik türü hakkında bilgi içerebilir.channelSection
kaynağınınsnippet.type
özelliği artık aşağıdaki değerleri destekliyor:postedPlaylists
: Kanal sahibinin kanalın etkinlik feed'inde yayınladığı oynatma listeleripostedVideos
: Kanal sahibinin kanalın etkinlik feed'inde yayınladığı videolarsubscriptions
: kanal sahibinin abone olduğu kanallar
-
video
kaynağının yenicontentDetails.contentRating.ifcoRating
özelliği, bir videonun İrlanda Film Sınıflandırma Ofisi'nden aldığı derecelendirmeyi tanımlar. -
watermark
kaynağınınposition.cornerPosition
özelliğinin tanımı, filigran her zaman oynatıcının sağ üst köşesinde görünecek şekilde güncellendi. -
search.list
yöntemi içinq
parametresinin tanımı, sorgu teriminin belirli bir arama terimiyle ilişkilendirilmiş videoları hariç tutmak için NOT (-
) Boole operatörünü kullanabileceğini belirtecek şekilde güncellendi. Değer, çeşitli arama terimlerinden biriyle ilişkili videoları bulmak için Boole OR (|
) operatörünü de kullanabilir. -
Bir
search.list
çağrısına verilen API yanıtında döndürülenpageInfo.totalResults
özelliğinin tanımı, değerin yaklaşık bir değer olduğunu ve tam bir değeri temsil edemeyebileceğini belirtecek şekilde güncellendi. Ayrıca maksimum değer 1.000.000'dur. Sayfalara ayırma 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çinnextPageToken
veprevPageToken
özellik değerlerini kullanın. -
watermarks.set
vewatermarks.unset
yöntemleri, API'nin bu yöntemlere yapılan başarılı istekler için HTTP204
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 sitesi için uygulama dili Google Hesabı ayarlarına, tarayıcı diline veya IP konumuna göre otomatik olarak seçilebilir. Ayrıca kullanıcılar, YouTube site alt bilgisinden istediği kullanıcı arayüzü dilini manuel olarak da seçebilir.API, desteklenen uygulama dillerini listeleyen bir yöntemi destekler. Desteklenen diller,
videoCategories.list
veguideCategories.list
gibi API yöntemleri çağrılırkenhl
parametresinin değeri olarak kullanılabilir. -
Yeni
i18nRegion
kaynağı, YouTube kullanıcısının tercih edilen içerik bölgesi olarak seçebileceği coğrafi alanı tanımlar. İçerik bölgesi, içerik yerel ayarı olarak da adlandırılabilir. YouTube web sitesi için içerik bölgesi, YouTube alanı veya kullanıcının IP konumu gibi buluşsal yöntemlere göre otomatik olarak seçilebilir ve kullanıcı, YouTube site alt bilgisinden istenen içerik bölgesini manuel olarak da seçebilir.API, desteklenen içerik bölgelerini listeleme yöntemini destekler.
search.list
,videos.list
,activities.list
vevideoCategories.list
gibi API yöntemleri çağrılırkenregionCode
parametresinin değeri olarak desteklenen bölge kodları kullanılabilir.
7 Nisan 2014
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
Yeni
channelSection
kaynağı, kanalın öne çıkarmayı seçtiği bir grup videoyla ilgili bilgileri içerir. Örneğin, bir bölümde kanalın en son yüklemeleri, en popüler yüklemeleri ya da bir veya daha fazla oynatma listesindeki videolar öne çıkarılabilir.API kanal bölümlerini listeleme, ekleme, güncelleme veya silme yöntemlerini destekler. Belirli bir kanal kimliği belirterek veya benzersiz bir kanal bölüm kimlikleri listesi belirterek, kimliği doğrulanmış kullanıcının kanalına ilişkin kanal bölümleri listesini alabilirsiniz.
Hata dokümanları da API'nin bu yeni yöntemler için özellikle desteklediği hata mesajlarını açıklayacak şekilde güncellenmiştir.
-
video
kaynağınınfileDetails
nesnesinin tanımı, bu nesnenin yalnızca videonunprocessingDetails.fileDetailsAvailability
özelliğininavailable
değerine sahip olması durumunda döndürüleceğini açıklayacak şekilde güncellendi.Benzer şekilde,
video
kaynağınınsuggestions
nesnesinin tanımı, bu nesnenin yalnızca videonunprocessingDetails.tagSuggestionsAvailability
özelliğinin veyaprocessingDetails.editorSuggestionsAvailability
özelliğininavailable
değerine sahip olması durumunda döndürüleceğini açıklayacak şekilde güncellendi. -
videos.insert
vevideos.update
yöntemleriyle ilgili dokümanlar, bu yöntemler çağrılırkenstatus.publishAt
özelliğinin ayarlanabileceğini yansıtacak şekilde güncellendi. -
channel
kaynağınıninvideoPromotion
nesnesinin tanımı, nesnenin yalnızca kanal sahibi tarafından alınabileceğini açıklayacak şekilde güncellendi. -
videos.rate
yönteminin parametre listesi, söz konusu yönteminonBehalfOfContentOwner
parametresini desteklemediğini yansıtacak şekilde güncellenmiştir. Bu parametreyi ayarlayanvideos.rate
istekleri500
hatası döndürdüğü için bu bir doküman hatasıydı.
31 Mart 2014
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
video
kaynağının yenistatus.publishAt
özelliği, gizli bir videonun yayınlanmak üzere planlandığı tarih ve saati belirtmenizi sağlar. Bu özellik, yalnızca videonun gizlilik durumuprivate
ise ve video daha önce hiç yayınlanmamışsa ayarlanabilir. Bu yeni mülk, kullanımdan kaldırma politikasına tabi değildir.
13 Mart 2014
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
API artık
channel
kaynaklarınıncontentOwnerDetails
bölümünü destekliyor. Bu yeni bölüm, kanala bağlı içerik sahibinin kimliği ve içerik sahibi ile kanalın bağlandığı tarih ve saat gibi kanalla bağlantılı YouTube iş ortakları için alakalı kanal verilerini içerir. Bu yeni bölümün, kullanımdan kaldırma politikasına tabi olmadığını unutmayın. -
Dokümanlarda artık aşağıdaki özellikler için desteklenen maksimum karakter uzunluğu listelenmektedir:
Kaynak Özellik Maksimum uzunluk channel
invideoPromotion.items[].customMessage
40 karakter video
snippet.title
100 karakter video
snippet.description
5.000 bayt video
snippet.tags
500 karakter. Mülk değerinin bir liste olduğunu ve listedeki öğeler arasında bulunan virgüllerin sınıra dahil edildiğini unutmayın. -
channel
kaynağınınbrandingSettings.watch.featuredPlaylistId
özelliği kullanımdan kaldırıldı. API, değerini belirlemeye çalışırsanız hata döndürür. -
Aşağıdaki
video
kaynak özellikleri, bir videoyu eklerken veya güncellerken ayarlanabilecek değerler listesine eklenmiştir: -
Hata belgelerinde artık her hata türü için HTTP yanıt kodu belirtilmektedir.
-
API artık aşağıdaki hataları desteklemektedir:
Hata türü Hata ayrıntısı Açıklama badRequest (400)
invalidCriteria
İstek, birbiriyle bağlantılı olmayan filtre parametreleri belirtiyorsa channels.list
yöntemi bu hatayı döndürür.badRequest (400)
channelTitleUpdateForbidden
Bir kanalın brandingSettings
bölümünü güncellemeye vebrandingSettings.channel.title
özelliğinin değerini değiştirmeye çalışırsanızchannels.update
yöntemi bu hatayı döndürür. (Mülkü 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 belirtirsechannels.update
yöntemi bu hatayı döndürür.badRequest (400)
invalidTimingOffset
invideoPromotion
bölümü geçersiz bir zamanlama ofseti belirtirsechannels.update
yöntemi bu hatayı döndürür.badRequest (400)
tooManyPromotedItems
invideoPromotion
bölümü, izin verilen tanıtılan öğe sayısından daha fazla öğe belirtiyorsachannels.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 belirtirsechannels.update
yöntemi bu hatayı döndürür.forbidden (403)
websiteLinkNotAllowed
invideoPromotion.items[].id.websiteUrl
özelliği izin verilmeyen bir URL'yi belirtirsechannels.update
yöntemi bu hatayı döndürür.required (400)
requiredTimingType
İstek, YouTube'un tanıtılan bir öğeyi ne zaman göstermesi gerektiğiyle ilgili varsayılan zamanlama ayarlarını belirtmezse channels.update
yöntemi bu hatayı döndürür.required (400)
requiredTiming
channels.update
yöntemi, tanıtılan her öğe için birinvideoPromotion.items[].timing
nesnesi belirtmelidir.required (400)
requiredWebsiteUrl
channels.update
yöntemi, tanıtılan her öğe için birinvideoPromotion.items[].id.websiteUrl
özelliği belirtmelidir.badRequest (400)
invalidPublishAt
İstek meta verileri, geçersiz bir zamanlanmış yayınlama saati belirtiyorsa videos.insert
yöntemi bu hatayı döndürür.
4 Mart 2014
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
YouTube Data API v3, artık YouTube API'leri Hizmet Şartları'nda açıklanan Kullanımdan Kaldırma Politikası'na tabidir. Kullanımdan kaldırma politikasına tabi API'lerin listelendiği sayfanın, bazı v3 API işlevlerinin politikaya tabi olmasını özellikle hariç tuttuğunu unutmayın.
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 tane filtre parametresi için değer belirtmenize gerek olmadığını doğru şekilde yansıtacak şekilde güncellendi. Bunun yerine, sıfır filtre parametresi veya tek bir filtre parametresi için bir değer ayarlayabilirsiniz. -
search.list
yöntemi parametrelerinin tanımları, aşağıdaki parametrelerin herhangi biri için de bir değer belirtirseniztype
parametresinin değerinivideo
olarak ayarlamanız gerektiğini hatırlatacak şekilde güncellendi:eventType
videoCaption
videoCategoryId
videoDefinition
videoDimension
videoDuration
videoEmbeddable
videoLicense
videoSyndicated
videoType
-
Yüklenen kanal banner resimlerinin minimum boyutu 2048 x 1152 piksele düşürüldü. (Daha önce, minimum boyut 2120 x 1192 pikseldi.) Ayrıca
channel
kaynak belgelerinin, API'den sunulan tüm banner resimlerinin maksimum boyutlarını belirttiğini unutmayın. Örneğin, televizyon uygulamaları içinbrandingSettings.image.bannerTvImageUrl
resminin maksimum boyutu 2120 x 1192 pikseldir, ancak gerçek resim 2048 x 1152 piksel olabilir. Kanal resmini farklı cihazlarda görüntülenecek şekilde optimize etme hakkında daha fazla bilgiyi YouTube Yardım Merkezi'nde bulabilirsiniz. -
Aşağıdaki
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
mülkünün maksimum uzunluğu 30 karakterdir.brandingSettings.channel.featuredChannelsUrls[]
özelliği artık 100 adede kadar kanalı listeleyebilir.brandingSettings.channel.unsubscribedTrailer
mülk değeri (ayarlanırsa) kanal sahibine ait olan herkese açık veya liste dışı bir videonun YouTube video kimliğini belirtmelidir.
-
channels.update
yöntemi artıkinvideoPromotion.items[].promotedByContentOwner
mülkünde yapılan güncellemeleri desteklemektedir. Bu özellik, tanıtım görüntülenirken içerik sahibinin adının gösterilip gösterilmeyeceğini belirtir. Yalnızca mülk değerini belirleyen API isteği içerik sahibi adınaonBehalfOfContentOwner
parametresi kullanılarak yapılıyorsa ayarlanabilir. -
playlistItems.list
veplaylistItems.insert
yöntemleri, diğer birçok yöntem için zaten desteklenenonBehalfOfContentOwner
parametresini artık desteklemektedir. -
contentDetails.contentRating.acbRating
özelliği artık filmler için Avustralya Sınıflandırma Kurulu'ndan (ACB) veya çocuklara yönelik televizyon programları için Avustralya İletişim ve Medya Kurumu'ndan (ACMA) bir derecelendirme belirtebilmektedir. -
Yeni
contentDetails.contentRating.catvRating
vecontentDetails.contentRating.catvfrRating
özellikleri, bir videonun aldığı derecelendirmeleri Kanada TV Sınıflandırma Sistemi'ne ve sırasıyla Québec'te kullanılan Fransızca dilindeki Régie du cinéma derecelendirme sistemine göre tanımlar. -
videoCategory
kaynağının yenisnippet.assignable
özelliği, güncellenen videoların veya yeni yüklenen videoların bu video kategorisiyle ilişkilendirilip ilişkilendirilemeyeceğini ifade eder. -
Aşağıdaki yöntemler için kod örnekleri eklendi:
activities.insert
(Git)channelBanners.insert
(Python)channels.update
(Python)playlistItems.list
(Git)search.list
(Git)thumbnails.set
(Java)videos.insert
(Git)
24 Ekim 2013
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
API, canlı yayın içeriğini bulup ö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ğının canlı yayın içeriğinin olup olmadığını ifade eder. Geçerli özellik değerleriupcoming
,active
venone
'dir.-
video
kaynağının yenisnippet.liveBroadcastContent
özelliği, videonun yaklaşan veya etkin bir canlı yayın olduğunu belirtir. Aşağıdaki listede, mülkün olası değerleri açıklanmaktadır:upcoming
– Video henüz başlamamış olan 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ülenebilir olan tamamlanmış yayınların özellik değeri olacaktır.
-
video
kaynağının yeniliveStreamingDetails
özelliği, canlı video yayınıyla ilgili meta verileri içeren bir nesnedir. Bu meta verileri almak içinpart
parametre değerinin kaynak parçaları listesineliveStreamingDetails
öğesini ekleyin. Meta veri aşağıdaki yeni özellikleri içerir:liveStreamingDetails.actualStartTime
– Yayının gerçekte başladığı zaman. (Bu değer, yayının durumuactive
olduğunda sunulacaktır.)liveStreamingDetails.actualEndTime
– Yayının fiilen sona erdiği zaman. (Bu değer, yayın sona erdiğinde görüntülenecektir.)liveStreamingDetails.scheduledStartTime
– Yayının başlamasının planlandığı zaman.liveStreamingDetails.scheduledEndTime
– Yayının sona ermesinin planlandığı zaman. Özellik değeri boşsa veya özellik mevcut değilse yayın, süresiz olarak devam edecek şekilde planlanır.liveStreamingDetails.concurrentViewers
– Canlı yayını izleyen kullanıcı sayısıdır.
Bu meta verileri almak için
videos.list
,videos.insert
veyavideos.update
yöntemini çağırırkenpart
parametre değerineliveStreamingDetails
kodunu ekleyin.
Canlı yayın içeriğini tanımlamaya ilişkin iki özelliğin daha 1 Ekim 2013 tarihinde kullanıma sunulduğunu unutmayın:
search.list
yönteminineventType
parametresi ve arama sonucununsnippet.liveBroadcastContent
özelliği. -
-
videos.insert
yöntemi artık YouTube'un videonun kanalına abone olan kullanıcılara yeni videoyla ilgili bildirim göndermesinin gerekip gerekmediğini belirtennotifySubscribers
parametresini destekliyor. Parametrenin varsayılan değeri olanTrue
, abonelere yeni yüklenen videoların bildirileceğini ifade eder. Ancak çok sayıda video yükleyen bir kanal sahibi, kanalın abonelerine her yeni videoyla ilgili bildirim gönderilmesini önlemek için değeriFalse
olarak ayarlamayı tercih edebilir. -
channels.update
yöntemi çağrılırken değiştirilebilecek özelliklerin listesi,invideoPromotion.items[].customMessage
veinvideoPromotion.items[].websiteUrl
özelliklerini içerecek şekilde güncellendi. Ayrıca liste, değiştirilebilenbrandingSettings
özelliklerini tanımlayacak şekilde değiştirilmiştir. BubrandingSettings
özellikleri zaten değiştirilebilir. Bu nedenle, dokümanlardaki değişiklik, API'nin mevcut işlevinde yapılan bir değişikliği yansıtmaz. -
playlists.insert
,playlists.update
veplaylists.delete
yöntemleri artık, diğer birçok yöntem için zaten desteklenenonBehalfOfContentOwner
parametresini destekliyor. -
playlists.insert
yöntemi, diğer birçok yöntem için zaten desteklenenonBehalfOfContentOwnerChannel
parametresini artık desteklemektedir. -
video
kaynağınıncontentDetails.contentRating.tvpgRating
özelliği artıkTV-14
derecelendirmesine karşılık gelenpg14
değerini desteklemektedir. -
Arama sonuçlarının bir parçası olan
snippet.liveBroadcastContent
özelliğinin tanımı,live
geçerli bir özellik değeri olduğunu ancakactive
geçerli bir özellik değeri olmadığını yansıtacak şekilde düzeltildi. -
video
kaynağınıncontentDetails.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 yeniinvideoPromotion.items[].promotedByContentOwner
özelliği, tanıtım görüntülenirken içerik sahibi adının gösterilip gösterilmeyeceğini belirtir. Bu alan, yalnızca değeri belirleyen API isteği içerik sahibi adına yapılıyorsa ayarlanabilir. Daha fazla bilgi içinonBehalfOfContentOwner
parametresine bakın.
1 Ekim 2013
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
channel
kaynağının yeniauditDetails
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ıninvideoPromotion.items[].id.type
özelliği artıkrecentUpload
değerini destekliyor. Bu değer, tanıtılan öğenin belirtilen kanaldan en son yüklenen video olduğunu ifade eder.Kanal varsayılan olarak video içi tanıtım verilerinin ayarlandığı kanalla aynıdır. Ancak, yeni
invideoPromotion.items[].id.recentlyUploadedBy
özelliğinin değerini o kanalın kanal kimliğine ayarlayarak başka bir kanaldan en son yüklenen videoyu tanıtabilirsiniz. -
channel
kaynağı, televizyon uygulamalarında kanal sayfalarında görüntülenen 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ğının canlı yayın içeriğinin olup olmadığını ifade eder. Geçerli özellik değerleriupcoming
,active
venone
'dir.- Bir
video
kaynağı içinupcoming
değeri videonun henüz başlatılmamış canlı yayın olduğunu belirtirkenactive
değeri videonun devam eden bir canlı yayın olduğunu belirtir. - Bir
channel
kaynağı içinupcoming
değeri, kanalın henüz başlatılmamış planlanmış bir yayının olduğunu belirtir.acive
değeri ise kanalın devam eden bir canlı yayını olduğunu gösterir.
- Bir
-
watermark
kaynağında,targetChannelId
özelliği nesneden dizeye dönüştürülmüştür.targetChannelId
özelliği artık filigran resminin bağlandığı kanalın YouTube kanal kimliğini belirten bir alt özellik içermek yerine bu değerin kendisini belirtir. Bu nedenle kaynağıntargetChannelId.value
özelliği kaldırıldı. -
thumbnails.set
yöntemi, diğer birçok yöntem için zaten desteklenenonBehalfOfContentOwner
parametresini artık desteklemektedir. -
search.list
yöntemi artık aramayı yalnızca etkin, yaklaşmakta olan veya tamamlanmış yayın etkinliklerini döndürecek şekilde kısıtlayaneventType
parametresini desteklemektedir. -
Yeni
contentDetails.contentRating.mibacRating
özelliği, İtalya'daki Ministero dei Beni e delle Attivita Culturali e del Turismo'nun bir videonun 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
Derecelendirilen videonun sahibi söz konusu videoya ilişkin derecelendirmeleri 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 kanalın videoları oynatılırken görüntülenen bir resmi tanımlar. Ayrıca, resmin bağlanacağı hedef kanalı ve video oynatma sırasında filigranın ne zaman görüneceğini ve ne kadar süre boyunca görüneceğini belirleyen zamanlama ayrıntılarını da belirtebilirsiniz.watermarks.set
yöntemi, kanalın filigran resmini yükler ve ayarlar.watermarks.unset
yöntemi, kanalın filigran resmini siler.Hata dokümanlarında, API'nin özellikle
watermarks.set
vewatermarks.unset
yöntemleri için desteklediği hata mesajları açıklanmaktadır. -
channel
kaynağının yenistatistics.hiddenSubscriberCount
özelliği, kanalın abone sayısının gizli olup olmadığını gösteren bir boole değeri içerir. Bu nedenle, kanalın abone sayısı herkes tarafından görülebiliyorsa mülkün değerifalse
olur. -
playlists.list
yöntemi artıkonBehalfOfContentOwner
veonBehalfOfContentOwnerChannel
parametrelerini desteklemektedir. Her iki parametre de diğer birçok yöntem için zaten desteklenmektedir. -
videos.list
yöntemi artık, grafiğin alınması gereken içerik bölgesini tanımlayanregionCode
parametresini desteklemektedir. Bu parametre yalnızcachart
parametresiyle birlikte kullanılabilir. Parametre değeri bir ISO 3166-1 alfa-2 ülke kodudur. -
error documentation
hükümlerinde, birden fazla API yönteminde oluşabilecek aşağıdaki yeni yaygın istek hatası açıklanmaktadır: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ıninvideoPromotion
nesnesi aşağıdaki yeni ve güncellenmiş özelliklere sahip:-
API artık bir web sitesinin tanıtılan öğe olarak belirtilebilmesini destekliyor. Bunu yapmak için
invideoPromotion.items[].id.type
özelliğinin değeriniwebsite
olarak ayarlayın ve URL'yi belirtmek için yeniinvideoPromotion.items[].id.websiteUrl
özelliğini kullanın. Promosyonda gösterilecek özel bir mesaj tanımlamak için yeniinvideoPromotion.items[].customMessage
özelliğini de kullanın.Bağlantılar; ilişkili web sitelerine, satıcı sitelerine veya sosyal ağ sitelerine yönlendirilebilir. İçeriğiniz için bağlantıları etkinleştirme hakkında daha fazla bilgi edinmek üzere ilişkilendirilmiş web siteleri ve satıcı sitelerine yönelik YouTube Yardım Merkezi talimatlarını inceleyin.
Tanıtım amaçlı bağlantılar ekleyerek, bu bağlantıların trafiği yetkisiz sitelere yönlendirmek için kullanılmayacağını ve bu bağlantıların YouTube'un AdWords politikalarına, YouTube reklam politikaları, YouTube Topluluk Kuralları ve YouTube Hizmet Şartları'na uygun olacağını kabul edersiniz.
-
Video oynatma sırasında tanıtılan öğeleri görüntülemek için zamanlama ayarlarıyla ilgili özellikler yeniden yapılandırıldı:
-
invideoPromotion.timing
nesnesiinvideoPromotion.items[].timing
klasörüne taşındı. Bu nesne artıkinvideoPromotion.items[]
listesinde tanıtılan her bir öğe için zamanlama verilerini özelleştirmenize olanak tanıyor. -
Yeni
invideoPromotion.defaultTiming
nesnesi, promosyonunuz için varsayılan zamanlama ayarlarını belirtir. Bu ayarlar, kanalınızın videolarından biri oynatılırken tanıtılan bir öğenin ne zaman gösterileceğini tanımlar. Tanıtılan herhangi bir öğe için varsayılan zamanlamayıinvideoPromotion.items[].timing
nesnesini kullanarak geçersiz kılabilirsiniz. -
Yeni
invideoPromotion.items[].timing.durationMs
özelliği, promosyonun görüntülenmesi gereken süreyi milisaniye cinsinden belirtir.invideoPromotion.defaultTiming
nesnesi, tanıtılan öğenin gösterileceği varsayılan süreyi belirten birdurationMs
alanı da içerir.
-
-
Hem
invideoPromotion.items[].type
hem deinvideoPromotion.items[].videoId
özellikleriinvideoPromotion.items[].id
nesnesine taşındı.
-
-
subscriptions.list
yöntemi artıkonBehalfOfContentOwner
veonBehalfOfContentOwnerChannel
parametrelerini desteklemektedir. Her iki parametre de diğer birçok yöntem için zaten desteklenmektedir. -
Bir
thumbnails.set
isteğine verilen API yanıtında,youtube#thumbnailListResponse
olankind
özellik değeriyoutube#thumbnailSetResponse
olarak değiştirildi. -
Aşağıdaki yöntemler için kod örnekleri eklendi:
channels.update
(Java, Python)playlists.insert
(.NET, PHP)subscriptions.insert
(PHP, Python)thumbnails.set
(PHP, Python)videos.insert
(PHP)videos.list
(PHP)videos.rate
(Python)videos.update
(Java, PHP, Python)
Gösterdiği işlev artık
videos.rate
yöntemi tarafından işlendiği içinplaylistItems.insert
yöntemine ilişkin Python örneğinin de kaldırıldığını unutmayın. -
error documentation
hükümlerinde,mine
istek parametresini destekleyen tüm API yöntemlerinde oluşabilecek aşağıdaki yeni istek bağlamı hatası açıklanmaktadır:Hata türü Hata ayrıntısı Açıklama badRequest
invalidMine
mine
parametresi, kimliği doğrulanan 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 kimliğinizi doğrulamanız veya çağrılan yöntem için kullanılabiliyorsaonBehalfOfContentOwnerChannel
parametresini sağlayarak iş ortağının kanallarından biri olarak hareket etmeniz gerekir.
8 Ağustos 2013
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
YouTube Data API'yi Kullanmaya Başlama kılavuzunun Kota Kullanımı bölümü, video yükleme işleminin kota maliyetinde yaklaşık 16.000 birimden yaklaşık 1.600 birime yapılan değişikliği yansıtacak şekilde güncellendi.
30 Temmuz 2013
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
Bir
channelBanner
kaynağında,kind
özelliğinin değeriyoutube#channelBannerInsertResponse
ikenyoutube#channelBannerResource
olarak değiştirildi. Bu kaynak,channelBanners.insert
isteğine yanıt olarak döndürülür. -
channel
kaynağının yenibrandingSettings.channel.profileColor
özelliği, kanal içeriğini tamamlayan bir belirgin renk belirtir. Özellik değeri, bir pound işareti (#
) ve ardından,#2793e6
gibi altı karakterli bir onaltılık dizedir. -
API artık bir aboneliğin kanaldaki tüm etkinlikler için mi yoksa yalnızca yeni yüklemeler için mi geçerli olacağını belirtme özelliğini destekliyor.
subscription
kaynağının yenicontentDetails.activityType
özelliği, aboneye bildirim gönderilecek etkinlik türlerini tanımlar. Geçerli özellik değerleriall
veuploads
şeklindedir. -
videos.list
yöntemi, YouTube'daki en popüler videoların grafiğini almak için yeni parametreleri destekler:chart
parametresi, almak istediğiniz grafiği tanımlar. Şu anda yalnızcamostPopular
değeri desteklenmektedir.chart
parametresinin bir filtre parametresi olduğunu, yani diğer filtre parametreleriyle (id
vemyRating
) aynı istekte kullanılamayacağını unutmayın.videoCategoryId
parametresi, grafiğin alınması gereken video kategorisini tanımlar. Bu parametre yalnızcachart
parametresiyle birlikte kullanılabilir. Grafikler varsayılan olarak belirli bir kategoriyle sınırlı değildir.
-
video
kaynağının yenitopicDetails.relevantTopicIds[]
özelliği, video veya içeriğiyle alakalı Freebase konu kimliklerinin listesini sağlar. Bu konuların konularından bahsedilebilir veya bu konulara videoda değinilebilir. -
video
kaynağınınrecordingDetails.location.elevation
özelliğirecordingDetails.location.altitude
olarak,fileDetails.recordingLocation.location.elevation
mülkü isefileDetails.recordingLocation.location.altitude
olarak yeniden adlandırıldı. -
video
kaynağınıncontentDetails.contentRating
nesnesi, bir videonun MPAA derecelendirmeleri, TVPG derecelendirmeleri vb. dahil çeşitli derecelendirme şemaları altında aldığı derecelendirmeleri belirtir. API artık her derecelendirme sistemi için videonun derecelendirilmediğini belirten bir derecelendirme değerini desteklemektedir. MPAA derecelendirmelerinde "derecelendirilmemiş" derecelendirmesinin sıklıkla, filmin kesilmiş versiyonunun resmi bir derecelendirme aldığı filmlerin kesilmemiş sürümlerini tanımlamak için kullanıldığını unutmayın. -
video
kaynağının yenicontentDetails.contentRating.ytRating
özelliği, yaş kısıtlaması olan içerikleri 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ğeriytAgeRestricted
olur. Mülk yoksa veya mülk değeri boşsa içerik, yaş kısıtlamalı olarak tanımlanmamıştır. -
channels.list
yöntemininmySubscribers
parametresi kullanımdan kaldırıldı. Kimliği doğrulanmış kullanıcının kanalına abonelerin listesini almak içinsubscriptions.list
yöntemini vemySubscribers
parametresini kullanın. -
channelBanners.insert
,channels.update
,videos.getRating
vevideos.rate
yöntemleri artıkonBehalfOfContentOwner
parametresini destekliyor. Bu parametre, kimliği doğrulanmış kullanıcının parametre değerinde belirtilen içerik sahibi adına hareket ettiğini gösterir. -
channels.update
yönteminin belgeleri, söz konusu yönteminchannel
kaynağınınbrandingSettings
nesnesini ve alt özelliklerini güncellemek için kullanılabileceğini yansıtacak şekilde güncellenmiştir. Dokümanlarda artıkchannel
kaynağınıninvideoPromotion
nesnesi için ayarlayabileceğiniz güncellenmiş özellikler listesi de listelenmektedir. -
error documentation
hükümlerinde aşağıdaki yeni hatalar açıklanmaktadır:Hata türü Hata ayrıntısı Açıklama forbidden
accountDelegationForbidden
Bu hata belirli bir API yöntemine özgü değildir. Kimliği doğrulanan kullanıcının belirtilen Google hesabı adına hareket etme yetkisi olmadığını gösterir. forbidden
authenticatedUserAccountClosed
Bu hata belirli bir API yöntemine özgü değildir. Kimliği doğrulanan kullanıcının YouTube hesabının kapatıldığını belirtir. Kullanıcı başka bir Google Hesabı adına hareket ediyorsa bu hata diğer hesabın kapatıldığını gösterir. forbidden
authenticatedUserAccountSuspended
Bu hata belirli bir API yöntemine özgü değildir. Kimliği doğrulanan kullanıcının YouTube hesabının askıya alındığını belirtir. Kullanıcı başka bir Google Hesabı adına hareket ediyorsa 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şkilendirilen kanalı tanımlayamadığını belirtir. İstek yetkilendirildiyse ve onBehalfOfContentOwner
parametresini kullanıyorsaonBehalfOfContentOwnerChannel
parametresini de ayarlamanız gerekir.forbidden
cmsUserAccountNotFound
Bu hata belirli bir API yöntemine özgü değildir. CMS kullanıcısının belirtilen içerik sahibi adına işlem yapmasına izin verilmiyor. notFound
contentOwnerAccountNotFound
Bu hata belirli bir API yöntemine özgü değildir. Belirtilen içerik sahibi hesabı bulunamadı. badRequest
invalidPart
Bu hata belirli bir API yöntemine özgü değildir. İsteğin part
parametresi, aynı anda yazılamayan bölümleri belirtiyor.badRequest
videoChartNotFound
İstek, desteklenmeyen veya kullanılamayan bir video grafiği belirttiğinde videos.list
yöntemi bu hatayı döndürür.notFound
videoNotFound
videos.update
yöntemi, güncellemeye çalıştığınız videonun bulunamadığını belirtmek için bu hatayı döndürür. İstek gövdesindeid
özelliği değerinin doğru olup olmadığını kontrol edin.
10 Haziran 2013
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
channels.list
yönteminin yeniforUsername
parametresi, YouTube kullanıcı adını belirterek kanal hakkında bilgi almanızı sağlar. -
activities.list
yöntemi artık API'ye belirtilen ülkeyle alakalı sonuçlar döndürmesini bildirenregionCode
parametresini desteklemektedir. YouTube, yetkili kullanıcının YouTube'daki önceki etkinliği etkinlik feed'ini oluşturmak için yeterli bilgi sağlamadığında bu değeri kullanır. -
Oynatma listesi kaynakları artık
snippet.tags
özelliğini içeriyor. Mülk, yalnızca kendi oynatma listeleri hakkında veri alan yetkili kullanıcılara döndürülür. Yetkili kullanıcılar,playlists.insert
veyaplaylists.update
yöntemlerini çağırırken de oynatma listesi etiketleri ayarlayabilir. -
Daha önce
channels.list
vesearch.list
yöntemleri için desteklenenonBehalfOfContentOwner
parametresi artıkvideos.insert
,videos.update
vevideos.delete
yöntemleri için de desteklenmektedir. Bu parametreninvideos.insert
yöntemine yapılan bir çağrıda kullanılması durumunda isteğin, videonun ekleneceği kanalı tanımlayan yenionBehalfOfContentOwnerChannel
parametresi için bir değer de belirtmesi gerektiğini unutmayın. Kanal,onBehalfOfContentOwner
parametresinin belirttiği içerik sahibine bağlı olmalıdır.Bu parametre, isteğin yetkilendirme kimlik bilgilerinin, parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube CMS kullanıcısını tanımladığını belirtir. Kullanıcının kimlik doğrulaması yaptığı CMS hesabı, belirtilen YouTube içerik sahibine bağlanmalıdır.
Bu parametre, birçok farklı YouTube kanalına sahip olan ve bunları yöneten içerik iş ortakları için tasarlanmıştır. Parametre, bu iş ortaklarının her bir kanal için kimlik doğrulama bilgileri sağlamak zorunda kalmadan bir kez kimlik doğrulaması yapmasını ve tüm video ve kanal verilerine erişim elde etmesini sağlar.
Özellikle bu sürümle ilgili olarak, parametre artık içerik iş ortaklarının, kendilerine ait YouTube kanallarında video eklemesine, güncellemesine veya silmesine olanak tanıyor.
-
error documentation
hükümlerinde aşağıdaki yeni hatalar açıklanmaktadır: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ı belirtir. Bu hata, çeşitli API yöntemleri için desteklenen onBehalfOfContentOwner
parametresinin kullanımıyla ilişkilidir.unauthorized
authorizationRequired
İstek, home
parametresini kullandığı ancak düzgün şekilde yetkilendirilmediğindeactivities.list
yöntemi bu hatayı döndürür. -
Kanal kimliği zaten kaynağın
id
özelliği kullanılarak belirtildiği içinchannels
kaynağındainvideoPromotion.channelId
özelliği kaldırıldı. -
Yeni Kanal Kimlikleriyle Çalışma kılavuzunda, API'nin kanal kimliklerini nasıl kullandığı açıklanmaktadır. Kılavuz, API'nin önceki sürümünden geçiş yapan ve
default
kullanıcısı için içerik isteğinde bulunan veya artık her YouTube kanalının benzersiz bir kullanıcı adına sahip olduğu fikrini temel alan uygulamalara sahip geliştiriciler için yararlı olabilir. Bu durum artık geçerli değil.
22 Mayıs 2013
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
Yeni
channelBanners.insert
yöntemi,channel
kaynağının yenibrandingSettings.image.bannerExternalUrl
özelliğini kullanarak daha sonra kanalın banner resmi olarak ayarlanabilecek bir banner resmi yüklemenizi sağlar. -
channels.update
yöntemiyle ilgili dokümanlar, yöntem çağrılırken değiştirilebilecek özellikleri listeleyecek şekilde güncellendi. -
video
kaynak dokümanlarında artıkunspecified
,suggestions.processingErrors[]
,suggestions.processingHints[]
,suggestions.processingWarnings[]
vesuggestions.editorSuggestions[]
mülkleri için geçerli bir özellik değeri olarak listelenmiyor. -
videos.list
yöntemininmaxResults
parametresi artık5
varsayılan değerine sahip. -
error documentation
dosyasında artıkchannelBanners.insert
vesubscriptions.list
yöntemleri için hatalar listelenmektedir. Ayrıca,channels.update
yöntemi için bazı yeni hatalar da listelenir.
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 listelenmektedir.
-
Python kod örneklerinin listelendiği sayfada artık abonelik ekleme, oynatma listesi oluşturma ve video güncelleme ile ilgili örnekler yer alıyor.
10 Mayıs 2013
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
YouTube artık deneysel API özelliklerini ve hizmetlerini tanımlamamaktadır. Bunun yerine, artık kullanımdan kaldırma politikasına tabi olan YouTube API'lerinin bir listesini sunuyoruz.
8 Mayıs 2013
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
Kanal kaynakları artık kanalla ilişkili bir tanıtım kampanyasıyla ilgili bilgileri içeren
inVideoPromotion
nesnesini destekliyor. Bir kanal, video oynatılırken tanıtılan videonun küçük resimlerini video oynatıcıda göstermek için video içi tanıtım kampanyası kullanabilir.Bir
channels.list
isteğindekipart
parametre değerineinvideoPromotion
ekleyerek bu verileri alabilirsiniz. -
Yeni
channels.update
yöntemi, kanalın video içi tanıtım kampanyası verilerini güncellemek için kullanılabilir. Yöntemin yalnızcachannel
kaynağınıninvideoPromotion
bölümündeki güncellemeleri desteklediğini, henüz bu kaynağın diğer bölümlerinde yapılan 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ı veya Google+ hesabına bağlı bir kullanıcıyı tanımlayıp tanımlamadığını gösteren
status.isLinked
özelliğini destekliyor. Bu bağlantılardan birine sahip bir kullanıcı, video yükleme gibi çeşitli işlemler için ön koşul olarak herkese açık bir YouTube kimliğine sahiptir. -
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 derecelendirmeleri alan
videos.getRating
yöntemini desteklemektedir. -
videos.list
yönteminin yenimyRating
parametresi, kimliği doğrulanmış kullanıcınınlike
veyadislike
derecelendirmesi ile değerlendirdiği videoların listesini almanızı sağlar.Hem
myRating
hem deid
parametresi artık filtre parametreleri olarak kabul edilir. Yani bir API isteğinin, parametrelerden tam olarak birini belirtmesi gerekir. (Öncedenid
parametresi, bu yöntem için zorunlu bir parametreydi.)Bu yöntem, video derecelendirme bilgilerini almaya çalışan ancak bu işlemi yapmak için gerekli yetkiye sahip olmayan istekler için
forbidden
hatası döndürür. -
myRating
parametresinin kullanıma sunulmasıyla birlikte,videos.list
yöntemi de sayfalara ayırmayı destekleyecek şekilde güncellenmiştir. Bununla birlikte, sayfalandırma parametrelerinin yalnızcamyRating
parametresini kullanan istekler için desteklendiğini unutmayın. (id
parametresini kullanan istekler için çağrı 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 geri almak istediğiniz belirli bir sayfayı tanımlar. -
Bir
videos.list
isteğine yanıt olarak döndürülenyoutube#videoListResponse
kaynağı artık, toplam sonuç sayısı ve mevcut sonuç kümesindeki sonuç sayısı gibi ayrıntıları içerenpageInfo
nesnesini içeriyor.youtube#videoListResponse
kaynağı,nextPageToken
veprevPageToken
özelliklerini de içerebilir. Bu özelliklerin her biri, sonuç grubundaki belirli bir sayfayı almak için kullanılabilecek bir jeton sağlar.
-
-
videos.insert
yöntemi aşağıdaki yeni parametreleri destekler:autoLevels
: YouTube'a, videonun ışık ve rengini otomatik olarak iyileştirme talimatı vermek için bu parametre değerinitrue
olarak ayarlayın.stabilize
: YouTube'a, kamera hareketlerinden kaynaklanan titremeleri gidererek videoyu ayarlaması talimatını vermek için bu parametre değerinitrue
olarak ayarlayın.
-
channelTitle
özelliği, aşağıdaki kaynaklar içinsnippet
öğesine eklendi:playlistItem
– Bu ö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:
activities.insert
(Rubi)playlistItems.list
(.NET)search.list
(.NET)subscriptions.insert
(Java, Ruby)videos.insert
(.NET, Ruby)
-
subscriptions.list
yönteminin yenimySubscribers
parametresi, kimliği doğrulanmış durumda olan kullanıcıların abonelerinin listesini almanızı sağlar. Bu parametre yalnızca doğru şekilde yetkilendirilmiş bir istekte kullanılabilir.Not: Bu işlev,
channels.list
yöntemi için şu anda desteklenenmySubscribers
parametresinin yerini almak amacıyla tasarlanmıştır. Bu parametre kullanımdan kaldırılacak. -
Bir
video
kaynağında,unspecified
özellik değeri artık aşağıdaki özelliklerin hiçbiri için olası bir değer değildir: -
Beklenmeyen bir parametre içeren API istekleri artık
badRequest
hatası veriyor ve hatanın bildirilen nedeniunexpectedParameter
. -
Oynatma listesi zaten izin verilen maksimum sayıda öğe güncellendiğinde
playlistItems.insert
yönteminin döndürdüğü hata. Bu hata artıkforbidden
hatası olarak rapor ediliyor. Hatanın nedeni deplaylistContainsMaximumNumberOfVideos
olarak belirlenmiştir.
19 Nisan 2013
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
Yeni
videos.rate
yöntemi, kullanıcının bir video içinlike
veyadislike
derecelendirmesi belirlemesine veya videodan puanı kaldırmasına olanak tanır.Hata dokümanları da API'nin
videos.rate
yöntem çağrısına yanıt olarak döndürebileceği hataları listeleyecek şekilde güncellendi. -
Küçük resimler artık API dokümanlarında ayrı bir kaynak olarak tanımlanmıştır. Yeni
thumbnails.set
yöntemi ise YouTube'a özel video küçük resmi yüklemenize ve bir video için ayarlamanıza olanak tanır.Hata dokümanları da API'nin
thumbnails.set
yöntem çağrısına yanıt olarak döndürebileceği hataları listeleyecek şekilde güncellendi.Bu değişikliğin, küçük resim görüntüleri döndüren mevcut kaynakları gerçekten etkilemediğini unutmayın. Küçük resimler bu kaynaklarda önceden olduğu gibi döndürülür. Ancak dokümanlarda artık API'nin döndürebileceği farklı küçük resim boyutlarının adları listelenmektedir.
-
channel
kaynağının yenibrandingSettings
bölümü, kanalın kanal sayfasına ve video izleme sayfalarına ilişkin ayarları, metni ve resimleri tanımlar. -
playlistItem
kaynağı aşağıdaki yeni özellikleri içerir:-
Yeni
status
nesnesi, oynatma listesi öğesiyle ilgili durum bilgilerini içerir.status.privacyStatus
özelliği ise oynatma listesi öğesinin gizlilik durumunu tanımlar.
-
-
video
kaynağı aşağıdaki yeni özellikleri içerir:-
status.publicStatsViewable
özelliği, izleme sayfasındaki genişletilmiş video istatistiklerinin herkese açık olarak görüntülenip görüntülenemeyeceğini belirtir. Varsayılan olarak bu istatistikler görüntülenebilirdir. Bu mülkün değerifalse
olarak ayarlanmış olsa bile videonun görüntüleme sayısı ve puanları gibi istatistikler herkese açık olmaya devam eder. Bu özelliğin değerini,videos.insert
veyavideos.update
yöntemini çağırırken ayarlayabilirsiniz. -
contentDetails.contentRating
nesnesi, videonun çeşitli derecelendirme şemalarına göre aldığı derecelendirmeleri içerir. Aşağıdaki listede, desteklenen derecelendirme sistemleri tanımlanmış ve her derecelendirme sistemiyle ilişkilendirilmiş tesisin bağlantısı yer almaktadır. Özellik tanımları, her sistem için desteklenen puan değerlerini tanımlar.Ülke Derecelendirme sistemi Özellik Amerika Birleşik Devletleri Amerikan Sinema Filmleri Derneği (MPAA) contentDetails.contentRating.mpaaRating
Amerika Birleşik Devletleri TV Ebeveyn Yönergeleri contentDetails.contentRating.tvpgRating
Avustralya Avustralya Sınıflandırma Kurulu (ACB) contentDetails.contentRating.acbRating
Brezilya Departamento de Justiça, Classificação, Qualificação e Títulos contentDetails.contentRating.djctqRating
Kanada Kanada Ev Videosu Derecelendirme Sistemi (CHVRS) contentDetails.contentRating.chvrsRating
Fransa Centre National du cinéma et de l'image animée (Fransız Kültür Bakanlığı) contentDetails.contentRating.fmocRating
Almanya Freiwillige Selbstkontrolle der Filmwirtschaft (FSK) contentDetails.contentRating.fskRating
İngiltere İngiliz Film Sınıflandırma Kurulu (BBFC) contentDetails.contentRating.bbfcRating
Hindistan Film Sertifikasyonu Merkez Kurulu (CBFC) contentDetails.contentRating.cbfcRating
Japonya 映倫管委標会 (EIRIN) contentDetails.contentRating.eirinRating
Kore 多溴물 yıllık modluğunuz (KMRB)) contentDetails.contentRating.kmrbRating
Meksika Radyo, Televizyon ve Sinematografi Genel Müdürlüğü (RTC) contentDetails.contentRating.rtcRating
Yeni Zelanda Film ve Edebiyat Sınıflandırma Ofisi contentDetails.contentRating.oflcRating
Rusya Rusya Federasyonu Ulusal Film Tescili contentDetails.contentRating.russiaRating
İspanya Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA) contentDetails.contentRating.icaaRating
-
-
playlistItems.update
yönteminin dokümanları,snippet.resourceId
özelliğinin istek gövdesi olarak gönderilen kaynakta belirtilmesi gerektiğini yansıtacak şekilde güncellendi. -
search.list
yöntemi artık aşağıdaki işlevleri desteklemektedir:-
Yeni
forMine
parametresi, aramayı yalnızca kimliği doğrulanmış kullanıcının videolarını alacak şekilde kısıtlar. -
order
parametresi artık sonuçları başlığa (order=title
) veya video sayısına göre azalan düzende (order=videoCount
) alfabetik olarak sıralama özelliğini desteklemektedir. -
Yeni
safeSearch
parametresi, arama sonuçlarında kısıtlanmış içerik bulunup bulunmadığını ifade eder.
-
-
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çinvideoCategories.list
yöntemini kullanın.badRequest
invalidRecordingDetails
metadata specifies invalid recording details.
badRequest
invalidVideoGameRating
İstek meta verileri, geçersiz bir video oyunu derecelendirmesi belirtiyor. badRequest
invalidVideoMetadata
İstek meta verileri geçersiz. -
onBehalfOfContentOwner
parametresi,videos.update
vevideos.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çinsnippet
öğesine eklendi: -
search.list
yöntemi aşağıdaki yeni parametreleri destekler:-
channelType
parametresi, tüm kanalları almak veya yalnızca programları almak için kanal aramasını kısıtlamanıza olanak tanır. -
videoType
parametresi, tüm videoları ya da yalnızca filmleri veya programların yalnızca bölümlerini almak için video aramasını kısıtlamanıza olanak tanır.
-
-
video
kaynağınınrecordingDetails
bölümünün tanımı, nesnenin yalnızca videonun coğrafi konum verisi veya kayıt süresi ayarlanmışsa video için döndürüleceğini belirtecek şekilde güncellendi. -
playlistItems.update
yöntemi artıkinvalidSnippet
hatası döndürüyor. Bu hata, API isteği geçerli bir snippet belirtmiyorsa döndürülür. -
YouTube içerik iş ortaklarına özel olarak tasarlanmış yeni parametreleri destekleyen çeşitli API yöntemleri vardır. YouTube içerik iş ortakları arasında film ve televizyon stüdyoları, plak şirketleri ve içeriklerini YouTube'da kullanıma sunan diğer içerik üreticiler yer alır.
-
onBehalfOfContentOwner
parametresi, isteğin yetkilendirme kimlik bilgilerinin parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube CMS kullanıcısını tanımladığını belirtir. Kullanıcının kimlik doğrulaması yaptığı CMS hesabı, belirtilen YouTube içerik sahibine bağlanmalıdır.Bu parametre, birçok farklı YouTube kanalına sahip olan ve bunları yöneten içerik iş ortakları için tasarlanmıştır. Parametre, bu iş ortaklarının her bir kanal için kimlik doğrulama bilgileri sağlamak zorunda kalmadan bir kez kimlik doğrulaması yapmasını ve tüm video ve kanal verilerine erişim elde etmesini sağlar.
channels.list
,search.list
,videos.delete
,videos.list
vevideos.update
yöntemlerinin tümü bu parametreyi destekler. -
channels.list
yöntemi tarafından desteklenenmanagedByMe
parametresi, API'yeonBehalfOfContentOwner
parametresinin belirttiği içerik sahibine ait tüm kanalları döndürmesi talimatını verir. -
search.list
yöntemi tarafından desteklenenforContentOwner
parametresi, API'ye arama sonuçlarını yalnızcaonBehalfOfContentOwner
parametresinin belirttiği içerik sahibine ait kaynakları içerecek şekilde kısıtlaması talimatı verir.
-
25 Şubat 2013
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
API,
video
kaynakları için birkaç yeni parça ve özelliği destekler:-
Yeni
fileDetails
,processingDetails
vesuggestions
bölümleri, video sahiplerine yükledikleri videolar hakkında bilgi verir. Bu veriler, video yüklemelerini etkinleştiren uygulamalarda çok yararlıdır ve aşağıdakileri içerir:- işleme durumu ve ilerleme durumu
- Video işlenirken karşılaşılan hatalar veya diğer sorunlar
- küçük resimlerin kullanılabilirliği
- Video veya meta veri kalitesini iyileştirmeye yönelik öneriler
- YouTube'a yüklenen orijinal dosyayla ilgili ayrıntılar
Bu bölümlerin tümü yalnızca videonun sahibi tarafından alınabilir. Aşağıdaki listede yeni bölümler kısaca açıklanmakta ve
video
kaynak dokümanlarında her bölümün içerdiği tüm özellikler tanımlanmaktadır.-
fileDetails
nesnesi; dosyanın çözünürlüğü, süresi, ses ve video codec'leri, akış bit hızları ve daha fazlası dahil olmak üzere YouTube'a yüklenen video dosyasıyla ilgili bilgileri içerir. -
processingProgress
nesnesi, YouTube'un yüklenen video dosyasını işleme süreciyle ilgili bilgiler içerir. Nesnenin özellikleri, geçerli işleme durumunu tanımlar ve YouTube videoyu işlemeyi bitirene kadar kalan süreyi tahmin eder. Bu bölüm, video için dosya ayrıntıları veya küçük resimler gibi farklı veri veya içerik türlerinin mevcut olup olmadığını da belirtir.Bu nesne, videoyu yükleyen kullanıcının YouTube'un yüklenen video dosyasını işleme sürecinde kaydettiği ilerlemeyi takip edebilmesi için anket yapılacak şekilde tasarlanmıştır.
-
suggestions
nesnesi, yüklenen videonun video kalitesini veya meta verilerini iyileştirme fırsatlarını belirleyen önerileri içerir.
-
contentDetails
bölümü dört yeni mülk içerir. Bu özellikler, kimliği doğrulanmamış isteklerle alınabilir.dimension
– Videonun 2D mi yoksa 3D mi olduğunu belirtir.definition
– Videonun standart veya yüksek tanımlı olup olmadığını belirtir.caption
– Videoda altyazı bulunup bulunmadığını gösterir.licensedContent
– Videoda bir YouTube içerik iş ortağının hak talebinde bulunduğu içerikler bulunup bulunmadığını gösterir.
-
status
bölümü iki yeni mülk içerir. Video sahipleri, bir video eklerken veya güncellerken her iki mülk 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ğerlercreativeCommon
veyoutube
'dir.
-
-
videos.list
,videos.insert
vevideos.update
yöntemleri içinpart
parametresinin tanımı, yukarıda açıklanan yeni eklenen bölümleri ve yanlışlıkla çıkarılanrecordingDetails
bölümünü listeleyecek şekilde güncellendi. -
channel
kaynağının yenicontentDetails.googlePlusUserId
özelliği, kanalla ilişkilendirilmiş Google+ profili 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
vevideo
kaynaklarında döndürülüyor. -
playlistItems.list
artık yalnızca belirtilen videoyu temsil eden oynatma listesi öğesini almak içinplaylistId
parametresiyle birlikte kullanılabilenvideoId
parametresini destekliyor.Parametrenin tanımladığı video oynatma listesinde bulunamazsa API bir
notFound
hatası döndürür. -
Hata dokümanlarında yeni bir
forbidden
hatası açıklanmaktadır. Bu hata, bir isteğin istenen işlem için düzgün şekilde yetkilendirilmediğini gösterir. -
channel
kaynağınınsnippet.channelId
özelliği kaldırıldı. Kaynağınid
özelliği aynı değeri sağlar.
30 Ocak 2013
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
Yeni hata sayfası, API'nin döndürebileceği hataları listeler. Bu sayfada, birden fazla API yöntemi için oluşabilecek genel hataların yanı sıra yönteme özgü hatalar 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:
activities.insert
- JavaplaylistItems.insert
– PythonplaylistItems.list
- Java, JavaScript, PHP, Python, Rubyplaylists.insert
- Java, JavaScript, Pythonsearch.list
- Java, JavaScript, Python, Rubyvideos.insert
- Java
-
YouTube, otomatik olarak oluşturulan bir YouTube kanalına video eklediğinde
activity
kaynağı artık birchannelItem
işlemini bildirebilir. (YouTube, YouTube web sitesinde önemli bir yere sahip olan konuları algoritmik olarak belirler ve bu konular için otomatik olarak kanallar oluşturur.) -
Aşağıdaki
search.list
parametre güncellendi:q
parametresi artık filtre olarak tanımlanmamaktadır. Bu nedenle...relatedToVideo
parametresi,relatedToVideoId
olarak yeniden adlandırıldı.published
parametresi, aşağıda açıklananpublishedAfter
vepublishedBefore
adlı iki yeni parametreyle değiştirildi.
-
search.list
yöntemi aşağıdaki yeni parametreleri destekler:Parametre adı Değer Açıklama channelId
string
Belirtilen kanal tarafından oluşturulan kaynakları döndürür. publishedAfter
datetime
Belirtilen süreden sonra oluşturulan kaynakları döndürür. publishedBefore
datetime
Belirtilen tarihten önce oluşturulan kaynakları döndürür. regionCode
string
Belirtilen ülke için kaynakları döndürür. videoCategoryId
string
Video arama sonuçlarını, yalnızca belirtilen video kategorisiyle ilişkili videoları içerecek şekilde filtreleyin. videoEmbeddable
string
Video arama sonuçlarını yalnızca bir web sayfasındaki yerleştirilmiş oynatıcıda oynatılabilecek 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 ortak kullanılan videoları almak için parametre değerini true
olarak ayarlayın. -
Pek çok API kaynağı yeni özellikleri destekler. Aşağıdaki tabloda kaynaklar ve bunların yeni özellikleri tanımlanmaktadır:
Kaynak Mülk adı Değer Açıklama activity
contentDetails.playlistItem.playlistItemId
string
YouTube'un oynatma listesindeki öğeyi benzersiz şekilde tanımlamak için atadığı oynatma listesi öğesinin kimliğidir. activity
contentDetails.channelItem
object
Kanala eklenen bir kaynakla ilgili bilgileri içeren nesne. Bu özellik yalnızca snippet.type
,channelItem
ise mevcuttur.activity
contentDetails.channelItem.resourceId
object
Kanala eklenen kaynağı tanımlayan bir nesnedir. Diğer resourceId
mülklerinde olduğu gibi, video veya oynatma listesi gibi kaynak türünü belirten birkind
özelliği içerir. Ayrıca, söz konusu kaynağı benzersiz şekilde tanımlayan kimliği belirtenvideoId
,playlistId
vb. özelliklerden tam olarak birini içerir.channel
status
object
Bu nesne, kanalın gizlilik durumuyla ilgili bilgileri içerir. channel
status.privacyStatus
string
Kanalın gizlilik durumu. Geçerli değerler private
vepublic
'dir.playlist
contentDetails
object
Bu nesne, oynatma listesinin içeriğiyle ilgili meta veriler içerir. playlist
contentDetails.itemCount
unsigned integer
Oynatma listesindeki videoların sayısı. playlist
player
object
Bu nesne, oynatma listesini yerleştirilmiş bir oynatıcıda oynatmak için kullanabileceğiniz bilgileri içerir. playlist
player.embedHtml
string
Oynatma listesini oynatan video oynatıcı 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şkilendirilmiş 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ünyadan yükseklik (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öntemlerinin dokümanlarında, artık istek gövdesinde belirtilmesi gereken veya istek gövdesindeki değerlere göre güncellenen özellikler 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öntemlere ilişkin dokümanlarda zorunlu ve değiştirilebilir özellikler zaten listeleniyor olabilir.
Yöntem Özellikler activities.insert
Zorunlu özellikler: snippet.description
snippet.description
contentDetails.bulletin.resourceId
playlists.update
Zorunlu özellikler: id
playlistItems.update
Zorunlu özellikler: id
videos.update
Zorunlu özellikler: id
-
Aynı kanalda zaten bulunan 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. -
Çeşitli API yöntemleri yeni hata türlerini destekler. Aşağıdaki tabloda yöntem ve yeni desteklenen hatalar tanımlanmaktadır:
Yöntem Hata türü Hata ayrıntısı Açıklama guideCategories.list
notFound
notFound
id
parametresiyle tanımlanan kılavuz kategorisi bulunamıyor. Geçerli değerlerin listesini almak için guideCategories.list yöntemini kullanın.playlistItems.delete
forbidden
playlistItemsNotAccessible
Bu isteğin, belirtilen oynatma listesi öğesini silme yetkisi yok. 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.