YouTube Live Streaming API - Düzeltme Geçmişi

Bu sayfada, YouTube Live Streaming API değişiklikleri ve doküman güncellemeleri listelenir.

12 Ekim 2026

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

18 Ağustos 2026

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

  • liveBroadcasts.update yönteminin belgeleri, para kazanmayla ilgili yeni hataları içerecek şekilde güncellendi: preconditionFailed (412) (neden: videoNotEligibleForAdsMonetization) ve backendError (503) (neden: backendError).

17 Ağustos 2026

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

  • liveBroadcast kaynağının yeni snippet.categoryId mülkü, canlı yayınla ilişkili video kategorisini ayarlamanıza, güncellemenize ve almanıza olanak tanır.

20 Temmuz 2026

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

9 Temmuz 2026

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

1 Haziran 2026

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

  • liveBroadcast kaynağının contentDetails.availabilityConfig özelliği, canlı yayınlar için coğrafi kısıtlamalar belirlemenize olanak tanır. Böylece canlı etkinliklerin bölgesel kullanılabilirliğini yönetebilirsiniz.

26 Mart 2026

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

  • snippet.type özelliği artık yeni giftEvent değerini destekliyor.

  • liveChatMessage kaynağının yeni snippet.giftEventDetails mülkü ve alt öğeleri, hediye etkinliğiyle ilgili bilgiler içerir.

12 Ocak 2026

API artık canlı yayınlar için videonun ortasında gösterilen reklamları ve videonun ortasında gösterilen reklamların otomatik olarak eklenmesini destekliyor.

Yayın sahibi, yayının ara reklamlar için uygun olması koşuluyla yayında ara reklamları etkinleştirmeyi seçebilir. Sahip, dilediği zaman yayındaki ara reklamları devre dışı bırakabilir.

Bir yayın için ara reklamlar etkinleştirilmişse yayın sahibi, otomatik ara reklam eklemeyi etkinleştirmeyi seçebilir. Ayrıca, bir yayın için otomatik reklamları istedikleri zaman kapatabilirler.

Yayın sahibi, otomatik reklamları etkinleştirdiğinde aşağıdaki seçeneklerden birini belirleyebilir:

  • YouTube'un ara reklam ekleme işlemini optimize etmesine izin verin. Bu seçenek üç modu destekler:
    • Düşük: Daha düşük kazanç potansiyeli, izleyiciler için daha kesintisiz deneyim
    • Orta: Orta düzeyde kazanç potansiyeli, dengeli izleyici deneyimi
    • Yüksek: Daha yüksek kazanç potansiyeli, izleyiciler için daha kesintili deneyim
  • Videonun ortasında gösterilen reklam ekleme stratejisini ve aralığını manuel olarak yapılandırın. Bu durumda, sahibin iki parametre ayarlaması gerekir:
    1. Reklam işaret noktaları için zamanlama stratejisi. İşaret noktaları tüm izleyiciler için aynı anda eklenebilir veya işaret noktalarının zamanlaması izleyiciden izleyiciye değişebilir. İkinci strateji, YouTube'un işaret noktalarını daha yüksek bir oranda planlamasına olanak tanır. Bu sayede izleyiciler, uygun olduklarında işaret noktalarını alabilir.
    2. Videonun ortasında gösterilen reklam araları arasındaki sürenin uzunluğu.

Belgeler, bu özelliği desteklemek için aşağıdaki API değişikliklerini yansıtır:

  • liveBroadcast kaynağının monetizationDetails nesnesi, videonun ortasında gösterilen reklamların etkinleştirilmesi ve otomatik reklam yapılandırmaları için alanlar içerir.
  • update yöntemi, videonun ortasında gösterilen reklamları etkinleştirmek veya devre dışı bırakmak için kullanılabilir. Bu yöntem, canlı yayın için otomatik reklamları ayarlamak amacıyla da kullanılabilir. Belgelerde, canlı yayın için para kazanma ve otomatik reklam ayarları güncellenirken ortaya çıkabilecek birkaç yeni hata tanımlanmaktadır.

14 Temmuz 2025

liveChatMessages.streamList yönteminin açıklaması, streamList API kullanımları hakkında rehberlik sağlayacak şekilde güncellendi.

9 Ekim 2023

Yalnızca referans amaçlı olarak, hangi çıkartma kimliklerinin hangi Süper Etiketler ile ilgili olduğunu bu CSV dosyasında bulabilirsiniz. liveChatMessage kaynağının snippet.superStickerDetails.superStickerMetadata.stickerId özelliğinin ve superChatEvent kaynağının snippet.superStickerMetadata.stickerId özelliğinin tanımları bu bilgiyi yansıtacak şekilde güncellendi.

15 Eylül 2023

API artık canlı yayınlara reklam eklemenin yeni bir yolunu destekliyor. YouTube, yayına manuel olarak reklam arası eklemenize olanak tanıyan liveCuepoints özelliğinin yanı sıra, artık yayına sabit aralıklarla otomatik olarak ara reklam ekleme özelliğini de destekliyor.

Yayın sahibi otomatik reklamları etkinleştirirse reklam davranışının aşağıdaki yönlerini görüntüleyebilir:

  • Videonun ortasında gösterilen reklam araları arasındaki aralığın uzunluğu.
  • Reklam işaret noktaları için planlama stratejisi. İşaret noktaları tüm izleyiciler için aynı anda eklenebilir veya işaret noktalarının zamanlaması izleyiciden izleyiciye değişebilir. İkinci strateji, YouTube'un işaret noktalarını daha yüksek bir oranda planlamasına olanak tanır. Böylece izleyiciler, uygun olduklarında işaret noktalarını alabilir.
  • Ara reklamların gösterilmediği bir dönem. Bu özellik için yayın sahibi, ara reklam ekleme işleminin belirli bir zamana kadar duraklatıldığını belirtir.

Belgeler, bu özelliği desteklemek için aşağıdaki API değişikliklerini yansıtır:

  • liveBroadcast kaynağı artık bir monetizationDetails nesnesi içeriyor. Nesnenin alanları, yayın için otomatik reklam eklemenin etkin olup olmadığını gösterir ve işaret noktalarını planlamak için ek bilgiler belirtir.
  • liveBroadcast.list yönteminin part parametresi monetizationDetails değerini destekler.
  • update yöntemi, canlı yayınlarda ara reklam eklemeyi belirli bir süre duraklatmak için kullanılabilir. Belgelerde artık canlı yayınların para kazanma ayrıntıları güncellenirken oluşabilecek çeşitli hatalar da belirtiliyor.

1 Ağustos 2023

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

  • liveBroadcasts.update yönteminde artık şu alanlar için değer belirtilmesi gerekmiyor:

    • snippet.title
    • status.privacyStatus

    Bu alanlar istekten çıkarılırsa değiştirilmeden kalır.

1 Kasım 2022

  • Yeni liveBroadcasts.cuepoint yöntemi, YouTube'da canlı yayın yapan tüm kanal sahiplerinin bu yayına reklam aralarını tetikleyebilecek işaret noktaları eklemesine olanak tanır. Bu yöntem, yalnızca YouTube içerik iş ortaklarının canlı yayınlara işaret noktaları eklemesine olanak tanıyan liveCuepoints.insert yönteminin yerini alır.

    Bu yeni yöntemin kullanılabilirliğini yansıtmak için çeşitli kılavuzlar güncellendi.

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

    liveCuepoints.insert yönteminin desteği sonlandırıldı. liveCuepoints.insert yöntemi için destek, 1 Mayıs 2023'te veya daha sonra kaldırılacaktır. API kullanıcıları, uygulamalarını liveBroadcasts.cuepoint yöntemini çağıracak şekilde güncellemelidir.

  • liveBroadcasts.control yöntemiyle ilgili belgeler kaldırıldı. Bu yöntemle ilgili desteği sonlandırma bildirimi Eylül 2020'de yayınlanmıştı.

1 Ekim 2022

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

  • liveBroadcasts.update yönteminde artık şu alanlar için değer belirtilmesi gerekmiyor:

    • contentDetails.enableContentEncryption
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart
    • contentDetails.startWithSlate

    Bu alanlar istekten çıkarılırsa değiştirilmeden kalır.

  • Kullanımdan kaldırılan liveBroadcast alanlarıyla ilgili dokümanlar kaldırıldı:

    • contentDetails.enableContentEncryption
    • contentDetails.startWithSlate

1 Nisan 2022

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

  • snippet.type özelliği artık iki yeni değeri destekliyor:

    • membershipGiftingEvent
    • giftMembershipReceivedEvent

  • liveChatMessage kaynağının yeni snippet.membershipGiftingDetails mülkü ve alt öğeleri, hediye üyelik etkinliğiyle ilgili bilgiler içerir. Benzer şekilde, yeni snippet.giftMembershipReceivedDetails mülkü ve alt öğeleri, Hediye Üyelik Alındı etkinliğiyle ilgili bilgileri içerir.

15 Eylül 2021

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

  • snippet.type özelliği artık iki yeni değeri destekliyor:

    • newSponsorEvent
    • memberMilestoneChatEvent

  • liveChatMessage kaynağının yeni snippet.memberMilestoneChatDetails mülkü ve alt öğeleri, Üye Dönüm Noktası Mesajı etkinliği hakkında bilgi içerir. Benzer şekilde, yeni snippet.newSponsorDetails özelliği ve alt öğeleri, Yeni Sponsor etkinliğiyle ilgili bilgileri içerir.

1 Aralık 2020

API'nin liveBroadcasts.transition yöntemi, kullanıcının belirli bir zaman aralığında çok fazla istek gönderdiğini belirten yeni bir 403 (Forbidden) hatasını destekler. Hata nedeni: userRequestsExceedRateLimit.

21 Eylül 2020

  • liveBroadcast kaynağının status.madeForKids özelliğinin tanımı, özelliğin salt okunur olduğunu netleştirmek için güncellendi. Bu durum, API işlevinde bir değişiklik olduğu anlamına gelmez.

    Canlı yayını çocuklara yönelik olarak belirlemek için yayını oluşturmak üzere liveBroadcasts.insert yöntemini çağırırken status.selfDeclaredMadeForKids özelliğini true olarak ayarlayın.

  • Not: Bu değişiklik, bir desteği sonlandırma duyurusu ve önceki bir desteği sonlandırma duyurusuna yönelik bir güncelleme içerir.

    liveBroadcasts.control yöntemi 1 Ekim 2020'de veya bu tarihten sonra kullanımdan kaldırılacaktır. Bu tarihten sonra, bu yönteme yapılan tüm çağrılar yasak (403) hatası döndürecek ve yöntem daha sonra tamamen kaldırılacak. Müşteriler, YouTube'un besleme sunucularına gönderilen videoya bir yer paylaşımı ekleyerek kendi klaketlerini uygulamaya devam edebilir.

    16 Nisan 2020'de yapılan desteği sonlandırma duyurusunda, desteği sonlandırma tarihi 1 Eylül 2020 olarak belirlenmişti. Bu tarih ertelendi ve desteği sonlandırma işlemi 1 Ekim 2020'de veya bu tarihten sonra gerçekleşecek. Bu nedenle, söz konusu desteği sonlandırma duyurusunda yer alan özelliklerin ve liveBroadcasts.control yönteminin desteği aynı anda sonlandırılacak.

17 Temmuz 2020

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

liveStream kaynağının Nisan 2016'da desteği sonlandırılan cdn.format alanı, 17 Ağustos 2020'den itibaren desteklenmeyecektir. Bu alanı kullanmaya devam eden istekler, bu tarihten itibaren başarısız olur.

Kodunuzda hâlâ cdn.format alanı kullanılıyorsa kare hızını ve çözünürlüğü ayrı ayrı belirtmek için cdn.frameRate ve cdn.resolution özelliklerini kullanarak kodu güncellemeniz gerekir.

6 Temmuz 2020

HLS ile Canlı YouTube İçeriği Yayınlama kılavuzunda birkaç değişiklik yapıldı:

  • Medya segmenti için önerilen süre bir ila dört saniye olarak güncellendi.
  • Yeni bir bölümde, YouTube İçerik Stüdyosu'ndan HLS besleme URL'si alma işlemi açıklanmaktadır.
  • file parametre değerini biçimlendirme talimatları, yeni HLS besleme URL'sini tamamlama bölümüne taşındı. Bu talimatlar, HLS besleme URL'sinin YouTube API'den mi yoksa YouTube İçerik Stüdyosu'ndan mı alındığına bakılmaksızın geçerlidir.

Ayrıca yeni besleme protokolü karşılaştırması, YouTube'un desteklediği besleme protokollerini, her protokol için desteklenen codec'leri ve her protokolün uygun kullanım alanlarıyla ilgili ek bilgileri listeler.

16 Nisan 2020

Bu güncelleme, yeni bir özellik ve desteğin sonlandırılmasıyla ilgili bir duyuru içeriyor:

  • liveBroadcast kaynağı artık contentDetails.enableAutoStop özelliğini destekliyor. Bu özellik, kanal sahibi bağlı video akışında video akışını durdurduktan yaklaşık bir dakika sonra yayının otomatik olarak durdurulup durdurulmayacağını belirtir.

    Yayınların yaşam döngüsü belgesi, contentDetails.enableAutoStart veya contentDetails.enableAutoStop özelliklerini true olarak ayarlamanız durumunda canlı YouTube etkinliği oluşturma ve yönetme sürecinin adım adım nasıl değiştiğini açıklayacak şekilde güncellendi.

  • Not: Bu, desteğin sonlandırılmasıyla ilgili bir duyurudur. Bu değişiklikler 1 Eylül 2020'de veya bu tarihten sonra geçerli olacaktır. Değişikliklerin geçerlilik kazanacağı tarih, aşağıda desteğin sonlandırılma tarihi olarak belirtilmiştir.

    Bu güncellemede, zarar veren değişiklik olabilecek bir değişiklik açıklanmaktadır. Bu değişiklik, YouTube'da canlı içerik yayınlamak için kanalların varsayılan liveStream ve liveBroadcast kaynaklarını kullanan API istemci uygulamalarını etkiler. Özellikle, kalıcı yayın ve canlı yayınla ilişkili yayın kimliği ve canlı yayın kimliği artık yeni yayın başlatmak için kullanılamayacak.

    Aşağıdakilerden herhangi biri geçerliyse uygulamanız bu durumdan etkilenir:

    • liveBroadcast kaynağının isDefaultBroadcast özelliğinin değerini kontrol eder. Bu özellik, kullanımdan kaldırılma tarihinden sonra döndürülmeyecek.
    • liveStream kaynağının isDefaultStream özelliğinin değerini kontrol eder. Bu özellik, desteğin sonlandırılma tarihinden sonra döndürülmeyecek.
    • liveBroadcasts.list yöntemini çağırır ve broadcastType parametre değerini persistent veya all olarak ayarlar. Bu parametre, bu değişiklikler kapsamında kullanımdan kaldırılacak. Desteğin sonlandırıldığı tarih itibarıyla:
      • broadcastType parametre değeri persistent ise liveBroadcasts.list yöntemi herhangi bir sonuç döndürmez.
      • broadcastType parametre değeri all ise liveBroadcasts.list yöntemi, bu zamandan önce mevcut olan kalıcı yayınları döndürmez.

    YouTube, son birkaç yıldır canlı yayın özelliği etkinleştirilen kanallar için otomatik olarak varsayılan bir yayın ve varsayılan bir canlı yayın oluşturuyordu. Varsayılan yayın süresiz olarak mevcuttu, ilişkili bir başlangıç veya bitiş zamanı yoktu ve silinemiyordu. Benzer şekilde, varsayılan yayın kalıcı olarak kabul ediliyordu. Her zaman mevcuttu ve belirli bir etkinliğe bağlı değildi.

    Desteği sonlandırma tarihi itibarıyla:

    • YouTube artık varsayılan yayınlar ve canlı yayınlar oluşturmayacak. API istemcilerinin, varsayılan kaynakları kullanmak yerine liveBroadcast ve liveStream kaynaklarını oluşturup yönetebilmesi ve bu kaynakları birbirine bağlayabilmesi gerekir.
    • Bir kanalın varsayılan yayını ve varsayılan akışı etkin bir şekilde canlıysa (yani kanal, kullanımdan kaldırma işlemi yürürlüğe girdiğinde bunları canlı yayın için kullanıyorsa) devam eden yayın etkilenmez. Ancak bu yayın sona erdikten sonra kanal, varsayılan yayını ve varsayılan canlı yayını tekrar kullanamaz.
    • Bir kanalın varsayılan yayını ve varsayılan akışı etkin bir şekilde canlı değilse, kullanımdan kaldırma işlemi yürürlüğe girdikten sonra YouTube, video yayınlamak için bu kaynakları kullanma girişimlerini yok sayar.

    Uygulamanız bu durumdan etkileniyorsa lütfen aşağıdaki belgelere bakın. Bu belgeler, uygulamanızı bu değişiklikten sonra da beklendiği gibi çalışmaya devam edecek şekilde güncellemenize yardımcı olacaktır:

    • Yeni bir geçiş rehberi, geliştiricilerin şu anda varsayılan yayınları ve akışları kullanan API istemcilerinde ele alması gerekebilecek adımları açıklamaya çalışır.
    • Yayınların yaşam döngüsü kılavuzu, YouTube'da canlı etkinlik oluşturma ve yönetme sürecini adım adım açıklar. Her adımda, belirli bir işlemi tamamlamak için yapmanız gereken API çağrıları veya diğer işlemler açıklanır. YouTube, varsayılan akışları ve yayınları desteklemeyi bıraktığında uygulamanızın bu süreci izlemesi gerekir.

31 Mart 2020

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

sponsor kaynağı ve sponsors.list yönteminin desteği sonlandırıldı ve bunların yerini member kaynağı ve members.list yöntemi aldı.

sponsors.list yöntemi, 30 Eylül 2020'den itibaren desteklenmeyecektir. API istemcileri, sponsors.list yöntemine yapılan çağrıları members.list yöntemini kullanacak şekilde güncellemelidir. Yeni kaynak hakkında daha fazla bilgi için lütfen YouTube Data API düzeltme geçmişini inceleyin.

11 Mart 2020

HLS ile Canlı YouTube İçeriği Yayınlama kılavuzunun Besleme uç noktası bölümü, bir kodlayıcının birincil ve yedek besleme URL'lerini oluştururken file= parametre değerini tamamlamak için kullanması gereken süreci netleştirmek amacıyla güncellendi.

4 Şubat 2020

HLS Üzerinden Canlı YouTube İçeriği Yayınlama kılavuzu, DELETE isteklerinin isteğe bağlı olduğunu ve YouTube'un HLS uç noktasının bunları yoksaydığını belirtecek şekilde güncellendi. Performansla ilgili nedenlerden dolayı YouTube, istemcilerin DELETE istekleri göndermemesini önerir.

10 Ocak 2020

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

  • liveBroadcast kaynağı, içerik üreticilerin ve izleyicilerin "çocuklara özel" içerikleri tanımlayabilmesi için iki yeni özelliği destekler:
    • selfDeclaredMadeForKids özelliği, içerik üreticilerin canlı yayının çocuklara yönelik içerik olup olmadığını belirtmesine olanak tanır. Bu özellik, liveBroadcasts.insert yöntemiyle yayın oluşturulurken ayarlanabilir. Bu özelliğin yalnızca, kanal sahibi API isteğini yetkilendirdiyse liveBroadcast kaynaklarını içeren API yanıtlarına dahil edildiğini unutmayın.
    • madeForKids özelliği, tüm API kullanıcılarının bir yayının "çocuklara özel" durumunu almasına olanak tanır. Örneğin, durum selfDeclaredMadeForKids özelliğinin değerine göre belirlenebilir. Kanalınız, videolarınız veya yayınlarınız için kitle ayarlama hakkında daha fazla bilgi edinmek istiyorsanız YouTube Yardım Merkezi'ni ziyaret edin.
  • YouTube Data API'de channel kaynağı, yeni selfDeclaredMadeForKids ve madeForKids özelliklerini de destekler.

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

20 Ağustos 2019

Canlı YouTube İçeriklerini HLS ile Yayınlama kılavuzunun Koşullar bölümünde iki değişiklik yapıldı:

  • Her medya oynatma listesine hem onaylanmış segmentleri hem de onaylanmamış segmentleri dahil etmenin en iyi uygulama olduğunu açıklar. Bu uygulama, sunucu tarafında bir medya oynatma listesi kaybolursa segmentin atlanma olasılığını azaltır. Örneğin, her medya oynatma listesine en fazla iki onaylanmış segment ve en fazla beş onaylanmamış segment ekleyebilirsiniz.
  • Artık her medya segmenti için bir medya oynatma listesi göndermek zorunludur. Bu sayede, bir medya oynatma listesi kaybolursa sunucu hızlı bir şekilde kurtarılabilir. Bu uygulama daha önce öneri olarak listeleniyordu.

28 Haziran 2019

YouTube artık HLS beslemesini destekliyor. Buna göre, liveStream kaynağının ingestionType özelliği, HLS kullanılarak YouTube'a aktarılan yayınları tanımlamak için yeni hls değerini destekler.

Yeni HLS ile Canlı YouTube İçeriği Yayınlama kılavuzu, bir kodlayıcıdan YouTube'a canlı içerik yayınlamak için HLS'yi kullanma ile ilgili yönergeler sağlar. Bu kılavuz, kodlayıcı tedarikçilerinin ürünlerine HLS yayın desteği eklemelerine yardımcı olmayı amaçlar.

4 Nisan 2019

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

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

    • API Gezgini widget'ı, yetkilendirme kapsamlarını seçmenize, örnek parametre ve özellik değerlerini girmenize, ardından gerçek API istekleri gönderip gerçek API yanıtlarını görmenize olanak tanır. Widget'ta, girdiğiniz kapsamları ve değerleri kullanacak şekilde dinamik olarak güncellenen tam kod örneklerini gösteren bir tam ekran görünümü de bulunur.

    • Yaygın kullanım alanları bölümünde, sayfada açıklanan yöntemin bir veya daha fazla yaygın kullanım alanı açıklanır. Örneğin, belirli bir yayınla ilgili verileri veya mevcut kullanıcının yayınlarıyla ilgili verileri almak için liveBroadcasts.list yöntemini çağırabilirsiniz.

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

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

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

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

25 Şubat 2019

liveChatMessage ve superChatEvent kaynaklarının dokümanları, her iki kaynağın da artık Süper Etiketler hakkında bilgi içerebileceğini yansıtacak şekilde güncellendi. Süper Etiketler, resim gösteren bir Süper Chat mesajı türüdür. Diğer Süper Chat'ler gibi Süper Etiket mesajı da YouTube canlı yayını sırasında takipçiler tarafından satın alınır.

  • liveChatMessage kaynağında, snippet.type mülkü artık kaynağın bir Süper Etiket hakkında bilgi içerdiğini belirtmek için superStickerEvent olarak ayarlanır. Bu durumda kaynak, Süper Etiket hakkında ek bilgiler içeren snippet.superStickerDetails nesnesini de içerir.
  • superChatEvent kaynağında, snippet.isSuperStickerEvent boole değeri, Süper Chat sohbet mesajının aynı zamanda bir Süper Etiket olup olmadığını gösterir. Bu durumda snippet.superStickerMetadata nesnesi, Süper Etiket ile ilgili ek ayrıntılar içerir.

5 Nisan 2018

superChatEvents.list yönteminin açıklaması, API yanıtının artık 2017'nin başlarında desteği sonlandırılan fanFundingEvents değerini içermediğini yansıtacak şekilde güncellendi.

3 Nisan 2017

Canlı sohbet mesajlarını listeleme, ekleme ve silme işlemlerinin nasıl yapılacağını gösteren yeni Java kod örnekleri eklendi. Örnekler aşağıdaki yöntemleri çağırır:

13 Şubat 2017

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

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

    • liveCuepoints.insert yöntemi, onBehalfOfContentOwner parametresinin şu anda zorunlu olduğunu yansıtacak şekilde güncellendi. Ayrıca, yöntemin açıklaması, bu yönteme yapılan çağrıların bir YouTube içerik sahibiyle ilişkili hesap tarafından yetkilendirilmesi gerektiğini belirtecek şekilde güncellendi.

9 Şubat 2017

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

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

    • superChatEvents.list yönteminin yeni hl parametresi, snippet.displayString özellik değerinin belirli bir dilin kurallarına göre biçimlendirilmesi gerektiğini belirtmenize olanak tanır. Bu özelliğin tanımı da buna göre güncellendi.

      Parametre değeri, i18nLanguages.list yöntemi tarafından döndürülen listede yer alan bir dil kodu olmalıdır. Varsayılan değer en şeklindedir. Bu, varsayılan davranışın, görünen dizeleri İngilizce'de kullanılacakları şekilde biçimlendirmek olduğu anlamına gelir. Örneğin, varsayılan olarak bir dize $1,00 yerine $1.00 olarak biçimlendirilir.

1 Şubat 2017

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

  • Yeni kaynaklar ve yöntemler

    • Yeni superChatEvent kaynağı, bir takipçinin YouTube canlı yayını sırasında satın aldığı Süper Chat mesajını temsil eder. YouTube canlı sohbet akışında Süper Chat'ler, diğer mesajlardan iki şekilde ayrılır:

      • Süper Chat mesajları renkli olarak vurgulanır.
      • Süper Chat mesajları, bilgi bandında belirli bir süre boyunca sabitlenmiş olarak kalır.

      Süper Chat'in rengi, bilgi bandında sabitlenmiş olarak kalma süresi ve maksimum mesaj uzunluğu, satın alma tutarına göre belirlenir. Süper Chat hakkında daha fazla bilgi için YouTube Yardım Merkezi'ni ziyaret edin.

      API, bir kanalın son 30 gün içindeki canlı yayınlarına ait Süper Chat etkinliklerini listelemek için bir yöntemi destekler. Bu yöntem, kanalın son canlı yayınındaki takipçi desteği etkinlikleriyle (fanFundingEvents) ilgili verileri de döndürür.

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

    • snippet.type mülkü artık superChatEvent değerini destekliyor. Bu değer, kaynağın bir Süper Chat'i tanımladığını gösterir.

      Ayrıca, liveChatMessage kaynağının yeni snippet.superChatDetails özelliği ve alt özellikleri, Süper Chat etkinliği hakkında bilgi içerir.

    • liveStream kaynağının cdn.resolution özelliği artık 2160p değerini destekliyor.

  • Yeni ve güncellenmiş hatalar

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

      Hata ayrıntıları
      liveBroadcasts.insert, liveBroadcasts.update liveBroadcasts.insert ve liveBroadcasts.update yöntemleri, eklenen veya güncellenen liveBroadcast kaynağının contentDetails.enableEmbed ya da contentDetails.projection özelliği için geçersiz bir değer içerdiğini belirtmek üzere 400 (Bad Request) hataları döndürür. İki yeni hatanın hata nedenleri sırasıyla invalidEmbedSetting ve invalidProjection şeklindedir.

12 Ocak 2017

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

Yeni Süper Chat özelliğinin kullanıma sunulmasıyla birlikte YouTube, Takipçi Desteği özelliğini kullanımdan kaldırdı. Takipçi Desteği API'si ise 28 Şubat 2017'de devre dışı bırakılacak. Bu tarihten itibaren:

11 Ağustos 2016

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

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

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

20 Mayıs 2016

YouTube artık DASH beslemesini destekliyor. Buna göre, liveStream kaynağının ingestionType özelliği, DASH kullanılarak YouTube'a aktarılan yayınları tanımlamak için yeni dash değerini destekler.

Yeni DASH ile Canlı YouTube İçeriği Yayınlama kılavuzu, bir kodlayıcıdan YouTube'da canlı veri akışı yapmak için DASH yayınlama biçimini kullanmayla ilgili yönergeler sağlar. Kodlayıcı tedarikçilerinin ürünlerine DASH yayın desteği eklemesine yardımcı olmak için tasarlanmıştır.

18 Nisan 2016

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

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

    • liveStream kaynak güncellemesi

      • YouTube artık saniyedeki kare sayısı (FPS) 30 veya 60 olan 1440p çözünürlüklü yayınları destekliyor.

        Ayrıca liveStream kaynağı, gelen video verilerinin kare hızını ve çözünürlüğünü belirtmek için yeni özellikler içerir:

        Özellikler
        cdn.frameRate Gelen video verilerinin kare hızı. Geçerli değerler 30fps ve 60fps'dir.
        cdn.resolution Gelen video verilerinin çözünürlüğü. Geçerli özellik değerleri: 1440p, 1080p, 720p, 480p, 360p ve 240p.

      • liveStream kaynağının cdn.frameRate ve cdn.resolution özellikleri kullanıma sunulduğundan kaynağın cdn.format özelliği artık kullanımdan kaldırılmıştır. cdn.format özelliği, çözünürlüğü ve kare hızını tek bir değerde belirtir.

        Yeni desteklenen alanlara geçiş yapmanızı öneririz. Bu süre zarfında cdn.format çalışmaya devam eder. Ayrıca, cdn.format özelliği veya cdn.frameRate ve cdn.resolution özellikleri için değer belirttiğiniz sürece canlı yayın ekleme istekleri şu anda başarılı olur. Üç özellik için de değer sağlarsanız değerler uyuşmadığında API hata döndürebilir.

        cdn.format özelliğinin desteği sonlandırılmış olsa da API'nin saniyedeki kare sayısı (FPS) 30 veya 60 olan 1440p yayınları desteklediğini yansıtmak için artık iki yeni değeri (1440p ve 1440p_hfr) desteklediğini unutmayın.

    • liveBroadcast kaynak güncellemesi

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

        Özellikler
        contentDetails.boundStreamLastUpdateTimeMs Yayının contentDetails.boundStreamId mülkü tarafından referans verilen canlı yayının en son güncellendiği tarih ve saat.
        contentDetails.projection Yayının projeksiyon biçimi. Özelliğin varsayılan değeri rectangular. Özellik için geçerli değerler 360 ve rectangular'dir.

      • liveBroadcast kaynağının statistics.totalChatCount mülküyle ilgili tanım, mülk değerinin yalnızca yayında en az bir sohbet mesajı varsa gösterileceğini belirtecek şekilde güncellendi.

    • liveChatMessage kaynak güncellemesi

      • snippet.type özelliği, aşağıdaki madde işaretinde açıklanan yeni özelliklere karşılık gelen iki yeni değeri (messageDeletedEvent ve userBannedEvent) destekler. snippet.authorChannelId özelliğinin tanımı da bu yeni mesaj türleri için özellik değerinin neyi tanımladığını açıklayacak şekilde güncellendi.

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

        Özellikler
        snippet.messageDeletedDetails Bu nesne, bir sohbet moderatörü tarafından silinen mesajla ilgili bilgiler içerir. Nesne yalnızca snippet.type özellik değeri messageDeletedEvent ise mevcuttur.
        snippet.userBannedDetails Bu nesne, sohbete katılması yasaklanan bir kullanıcı hakkında bilgi içerir. Nesne, yasaklamanın kendisiyle ilgili bilgileri de içerir. Örneğin, yasaklamanın kalıcı mı yoksa geçici mi olduğu belirtilir. Yasaklama geçiciyse nesnenin özelliklerinden biri yasaklamanın süresini belirtir.

        Bu nesne yalnızca snippet.type özellik değeri userBannedEvent ise mevcuttur.

  • Yeni ve güncellenmiş hatalar

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

      Hata ayrıntıları
      liveBroadcasts.bind liveBroadcasts.bind yöntemi, kullanıcının belirli bir zaman aralığında çok fazla istek gönderdiğini belirtmek için 403 (Forbidden) hatası döndürür. Hatanın nedeni: userRequestsExceedRateLimit.

      liveBroadcasts.insert ve liveBroadcasts.update yöntemleri aynı hatayı zaten destekliyor.
      liveStreams.insert liveStreams.insert yöntemi, isteğin eklemeye çalıştığı liveStream kaynağında geçersiz bir özellik değerini tanımlayan dört yeni 400 (Bad Request) hatasını destekler. Aşağıdaki listede hata nedenleri ve ilişkili oldukları özellikler belirtilmiştir:
      liveStreams.insert liveStreams.insert yöntemi, her biri isteğin eklemeye çalıştığı liveStream kaynağında gerekli bir değerin bulunmadığını belirten iki yeni 400 (Bad Request) hatasını destekler. Aşağıdaki listede hata nedenleri ve ilişkili oldukları özellikler belirtilmiştir:
      Daha açık belirtmek gerekirse bir liveStream kaynağı eklediğinizde cdn.format özelliği veya cdn.frameRate ve cdn.resolution özellikleri için bir değer belirtmeniz gerekir.
      • Üç özellikten herhangi biri için değer belirtmezseniz API, formatRequired hatası döndürür.
      • cdn.resolution için bir değer belirtip cdn.frameRate için belirtmezseniz API, frameRateRequired hatası döndürür.
      • cdn.frameRate için bir değer belirtip cdn.resolution için belirtmezseniz API, resolutionRequired hatası döndürür.
      liveStreams.update İstek, aşağıdaki değiştirilemez özelliklerden herhangi birinin değerini değiştirmeye çalışırsa liveStreams.update yöntemi bir 403 (Forbidden) hatası döndürür: Hata yanıtındaki reason, liveStreamModificationNotAllowed.

18 Aralık 2015

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

17 Aralık 2015

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

  • Yeni kaynaklar ve yöntemler

    • API, canlı yayınlarda sohbet işlevini desteklemek için birkaç yeni kaynağı destekler. YouTube, canlı yayınlar sırasında canlı sohbet işlevini destekler. Bu kaynaklar ve yöntemler, sohbet mesajlarının alınmasını ve sohbetle ilgili yönetim işlevlerini destekler.

      Kaynaklar
      liveChatMessage Bu kaynak, YouTube canlı sohbetindeki bir mesajı temsil eder. YouTube, kısa mesajlar ve takipçi desteği etkinlikleri dahil olmak üzere çeşitli mesaj türlerini destekler. Bazı mesaj türleri, sohbetin belirli bir aşamasını (ör. yalnızca sponsorlara özel dönemin başlangıcı veya sohbetin sonu) tanımlar. API; canlı sohbet mesajlarını listeleme, ekleme ve silme yöntemlerini destekler.
      liveChatModerators Bu kaynak, bir sohbet moderatörünü tanımlar. Moderatörler, kullanıcıları sohbetten yasaklama veya mesajları kaldırma gibi bazı yönetim işlevlerini gerçekleştirebilir. API, canlı sohbet moderatörlerini listeleme, ekleme ve silme yöntemlerini destekler.
      liveChatBans Bu kaynak, belirli bir canlı sohbete mesaj göndermesi yasaklanan kullanıcıları tanımlar. Yasaklar geçici veya kalıcı olabilir. API, canlı sohbet yasakları ekleme ve silme yöntemlerini destekler.
      fanFundingEvents Bu kaynak, YouTube kanalındaki bir takipçi desteği etkinliğini temsil eder. Takipçi desteği, izleyicilerin YouTube içerik üreticilerine tek seferlik maddi destek sunmasına olanak tanır.

      API'nin fanFundingEvents.list yöntemi, bir kanalın takipçi desteği etkinliklerini listeler. Kanala ait bir canlı yayın sırasında canlı sohbet üzerinden başlatılan takipçi desteği etkinlikleri, yayının canlı sohbetinde bir fanFundingEvent mesajını da tetikler.

      Takipçi desteği hakkında daha fazla bilgiyi YouTube Yardım Merkezi'nde bulabilirsiniz.
      sponsors sponsor kaynağı, bir YouTube kanalının sponsorunu tanımlar. Sponsor, kanala aylık ücret öder. Kanalın canlı sohbetlerinde sponsorların mesajlarının yanında bir rozet gösterilir. Sponsorlar, kanalın sponsorlarına özel canlı sohbetlere de katılabilir.

      API'nin sponsors.list yöntemi, bir kanalın sponsorlarını listeler. Kullanıcılar bir kanalın canlı yayını sırasında kanala sponsor olmak için kaydolduğunda API, yayının canlı sohbetine bir newSponsorEvent mesajı da ekler.

      Sponsorluklar hakkında daha fazla bilgiyi YouTube Yardım Merkezi'nde bulabilirsiniz.

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

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

      Özellikler
      snippet.liveChatId Yayının YouTube canlı sohbetinin kimliği. Bu kimlikle, sohbet mesajlarını almak, eklemek veya silmek için liveChatMessage kaynağının yöntemlerini kullanabilirsiniz. Ayrıca sohbet moderatörleri ekleyebilir veya kaldırabilir, kullanıcıların canlı sohbetlere katılmasını engelleyebilir ya da mevcut yasakları kaldırabilirsiniz.
      contentDetails.closedCaptionsType Not: Bu özellik, contentDetails.enableClosedCaptions özelliğinin yerini alır.

      Bu özellik, yayınınız için altyazıların etkinleştirilip etkinleştirilmediğini ve etkinleştirildiyse ne tür altyazılar sağladığınızı belirtir:
      • closedCaptionsDisabled: Canlı yayın için altyazılar devre dışı bırakıldı.
      • closedCaptionsHttpPost: Altyazıları, HTTP POST aracılığıyla canlı yayınınızla ilişkili bir besleme URL'sine gönderirsiniz.
      • closedCaptionsEmbedded: Altyazılar, EIA-608 ve/veya CEA-708 biçimleri kullanılarak video akışında kodlanır.
      contentDetails.enableClosedCaptions Bu özelliğin desteği 17 Aralık 2015'te sonlandırılmıştır. Bunun yerine contentDetails.closedCaptionsType özelliğini kullanın. Bu mülkü kullanan API istemcileri için:
      • Özellik değerini true olarak ayarlamak, contentDetails.closedCaptionsType özelliğini closedCaptionsHttpPost olarak ayarlamakla eşdeğerdir.
      • Özellik değerini false olarak ayarlamak, contentDetails.closedCaptionsType özelliğini closedCaptionsDisabled olarak ayarlamakla eşdeğerdir.

    • liveBroadcasts.list yönteminin yeni broadcastType parametresi, bir API yanıtını etkinlik yayınlarını, kalıcı yayınları veya tüm yayınları içerecek şekilde filtrelemenize olanak tanır.

      Kalıcı yayın, her zaman mevcut olan ve belirli bir etkinliğe bağlı olmayan yayındır. Özellikle bir kanalın varsayılan yayını kalıcı bir yayındır ve YouTube İçerik Stüdyosu'ndaki Canlı Yayın Kontrol Paneli üzerinden erişilebilir. Kanalın diğer yayınları etkinlik yayınlarıdır.

  • liveStream kaynağının status.healthStatus.configurationIssues[].type alanı, aşağıdaki yeni sağlık durumu hatalarını bildirir:

    Hatalar
    audioTooManyChannels Ses ikiden fazla kanala sahip, ancak sadece bir (mono) veya iki (stereo) kanal destekleniyor. Lütfen ses kanalı sayısını düzeltin.
    frameRateHigh Mevcut kare hızı çok yüksek. Lütfen kare hızını %(framerate)s fps veya daha düşük bir değere ayarlayın.

  • Önceki doküman güncellemesinin yayınlanma tarihi düzeltildi.

  • Yeni ve güncellenmiş hatalar

    • API, yukarıda listelenen yeni kaynaklar için tanımlanan hatalara ek olarak aşağıdaki yeni hataları da destekler:

      Hata ayrıntıları
      liveBroadcasts.update
      HTTP yanıt koduforbidden (403)
      NedenclosedCaptionsTypeModificationNotAllowed
      AçıklamacontentDetails.closedCaptionsType değeri yalnızca yayın created veya ready durumundayken değiştirilebilir.
      liveBroadcasts.update
      HTTP yanıt koduinvalidValue (400)
      NedeninvalidEnableClosedCaptions
      AçıklamaliveBroadcast kaynağında, contentDetails.enableClosedCaptions özelliğinin değeri contentDetails.closedCaptionType ayarının değeriyle uyumlu değil. Kaynağı, iki özellikten yalnızca birini içerecek şekilde değiştirin ve isteği yeniden gönderin.

19 Ağustos 2015

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

  • Yeni kaynaklar ve yöntemler

    • Not: liveChat kaynağı ve yöntemleriyle ilgili belgeler gizlidir ve yalnızca belirli YouTube iş ortakları tarafından görülebilir.

      Yeni liveChat kaynağı, YouTube'daki bir canlı yayın sırasında yayınlanan bir yorumu içerir. API, bu kaynak için iki yöntemi destekler:

      Yöntemler
      liveChats.list Bir yayının canlı sohbet mesajlarını listeler.
      liveChats.insert Yeni bir sohbet mesajı oluşturun.

      Canlı sohbet mesajları yalnızca yayın canlıyken alınabilir ve yayınlanabilir.

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

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

      Özellikler
      snippet.isDefaultStream Bu yayının kanalın varsayılan yayını olup olmadığını gösterir. Bir kanalın varsayılan yayını süresiz olarak mevcuttur, kendisiyle ilişkili bir başlangıç veya bitiş zamanı yoktur ve silinemez. Varsayılan akışların işleyiş şekli hakkında daha fazla bilgi için mülkün tanımına bakın.
      status.healthStatus Bu nesne, akış sorunlarını tanımlamak, teşhis etmek ve çözmek için kullanılabilecek bilgiler içerir. Nesne, canlı video akışının durumunu değerlendirmenize yardımcı olacak bir dizi alt özellik içerir.

      Özellikle status.healthStatus.configurationIssues[] nesnesi, video akışını etkileyen sorunları listeler. API'nin bildirdiği tüm sorunlar, Canlı Yayın Kaynakları İçin Yapılandırma Sorunları adlı yeni bir belgede listelenir.
      contentDetails.isReusable Yayın akışının yeniden kullanılabilir olup olmadığını gösterir. Yeniden kullanılabilir yayın akışları, birden fazla yayına bağlanabilir. Yayıncılar, farklı zamanlarda gerçekleşen birçok farklı yayın için aynı yayını yeniden kullanabilir.

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

      Özellikler
      snippet.isDefaultBroadcast Bu yayının kanal için varsayılan yayın olup olmadığını gösterir. Bir YouTube kanalında canlı yayın etkinleştirildiğinde YouTube, kanal için varsayılan bir yayın ve varsayılan bir canlı yayın oluşturur. Yayın, kanal sahibinin YouTube'a canlı videoyu nasıl gönderdiğini tanımlar. Canlı yayın ise izleyicilerin varsayılan yayını nasıl görebileceğini belirler. Varsayılan yayınların işleyiş şekli hakkında daha fazla bilgi için özelliğin tanımına bakın.
      contentDetails.enableLowLatency Bu yayının düşük gecikmeli akış için kodlanıp kodlanmayacağını belirtir. Düşük gecikmeli yayın, videonun yayını izleyen kullanıcılara gösterilmesi için gereken süreyi azaltabilir ancak yayını izleyenlerin çözünürlüğünü de etkileyebilir.
      statistics.totalChatCount Yayınla ilişkili canlı sohbet mesajlarının toplam sayısı. Yayın kullanıcı tarafından görülebiliyorsa ve canlı sohbet özelliği etkinse özellik ve değeri mevcuttur. Bu özelliğin, yayın sona erdikten sonra bir değer belirtmeyeceğini unutmayın. Bu nedenle, bu özellik tamamlanmış bir canlı yayının arşivlenmiş videosundaki sohbet mesajlarının sayısını tanımlamaz.

  • Yeni ve güncellenmiş hatalar

    • API, yeni liveChat kaynağı için tanımlanan hatalara ek olarak aşağıdaki yeni hatayı da destekler:

      Hata ayrıntıları
      liveStreams.update
      HTTP yanıt koduforbidden (403)
      NedenliveStreamModificationNotAllowed
      AçıklamaAPI, yeniden kullanılabilir bir yayını yeniden kullanılamaz olarak değiştirmenize veya tam tersini yapmanıza izin vermez. Daha fazla bilgi için Yayınları ve Canlı Yayınları Anlama başlıklı makaleyi inceleyin.

21 Mayıs 2015

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

  • YouTube artık saniyede 60 kare (fps) hızında canlı video akışını destekliyor. Bu sayede oyun ve diğer hızlı aksiyon videoları daha akıcı bir şekilde oynatılabiliyor. YouTube'da 60 fps'de canlı yayın başlattığınızda YouTube, yüksek kare hızlı görüntülemenin henüz kullanılamadığı cihazlarda yayını 30 fps'de de kullanılabilir hale getirir.

    liveStream kaynağının cdn.format özelliği, bu özellik için iki yeni değeri destekler: 720p_hfr ve 1080p_hfr.

    Bu özellik hakkında daha fazla bilgi için YouTube İçerik Üretici Blogu'nu inceleyin.

21 Ağustos 2014

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

  • liveBroadcasts.control yönteminin walltime parametresinin tanımı, özellik değerinin ISO 8601 biçiminde (YYYY-MM-DDThh:mm:ss.sssZ) belirtildiğini gösterecek şekilde güncellendi.

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

    Hata türü Hata ayrıntısı Açıklama
    insufficientPermissions liveStreamingNotEnabled API isteğini yetkilendiren kullanıcının YouTube'da canlı video yayınlamasına izin verilmemişse liveBroadcast ve liveStream kaynakları için tüm yöntemler bu hatayı döndürür. Kullanıcının neden canlı video yayını yapamadığını açıklayan ayrıntılar, https://www.youtube.com/features adresindeki kanal ayarlarında bulunabilir.
    rateLimitExceeded userRequestsExceedRateLimit liveBroadcasts.insert ve liveStreams.insert yöntemleri, kullanıcının belirli bir zaman aralığında çok fazla istek gönderdiğini belirtmek için bu hatayı döndürür.

2 Mayıs 2014

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

  • liveStream kaynağının ve liveBroadcasts.bind yönteminin açıklamaları, bir yayının yalnızca bir video akışına bağlanabileceğini ancak bir video akışının birden fazla yayına bağlanabileceğini belirtecek şekilde güncellendi. Bu değişiklik yalnızca dokümanlarda yapılan bir düzeltmedir. Temel API işlevi değişmemiştir.

  • liveBroadcast kaynağının contentDetails.monitorStream.enableMonitorStream özelliği, özelliğin değeri true ise yayınınızı live durumuna geçirmeden önce testing durumuna geçirmeniz gerektiğini açıklayacak şekilde güncellendi. (Özelliğin değeri false ise yayınınızda testing aşaması olamaz. Bu nedenle, yayını doğrudan live durumuna geçirebilirsiniz.

  • liveCuepoint kaynağının settings.offsetTimeMs özelliği, yayınınızda izleme yayını yoksa özellik için bir değer belirtmemeniz gerektiğini belirtecek şekilde güncellendi.

  • liveBroadcast ve liveStream kaynaklarına ait tüm yöntemler artık onBehalfOfContentOwner ve onBehalfOfContentOwnerChannel parametrelerini destekliyor. Bu parametreler, aynı içerik sahibiyle ilişkili farklı kanallara yönelik API isteklerini tamamlamak için aynı yetkilendirme kimlik bilgilerini kullanmanıza olanak tanır.

  • liveCuepoints.insert yönteminin dokümanları, bu yöntem çağrılırken settings.walltime özelliği için bir değer ayarlayabileceğinizi belirtecek şekilde güncellendi.

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

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

    Hata türü Hata ayrıntısı Açıklama
    insufficientPermissions livePermissionBlocked liveBroadcasts.insert, liveBroadcasts.transition ve liveStreams.insert yöntemleri, isteği yetkilendiren kullanıcı YouTube'da canlı video yayını yapamıyorsa bu hatayı döndürür. Kullanıcının neden canlı video yayını yapamadığını açıklayan ayrıntılar, https://www.youtube.com/features adresindeki kanal ayarlarında bulunabilir.

  • liveBroadcasts.insert yönteminin invalidScheduledStartTime hatası, planlanan başlangıç zamanının geçerli tarihe yeterince yakın olması gerektiğini ve böylece yayının o zamanda güvenilir bir şekilde planlanabileceğini netleştirmek için güncellendi.

13 Aralık 2013

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

  • liveBroadcast kaynağının yeni status.recordingStatus özelliği, yayının mevcut durumunu tanımlar.

  • liveBroadcast kaynağının yeni contentDetails.enableClosedCaptions özelliği, yayın için altyazıların alınıp alınamayacağını belirtir. Özellik değeri, bir yayın eklediğinizde veya güncellediğinizde ayarlanabilir ancak yayın testing veya live durumuna geçtiğinde güncellenemez. Bu özelliği true olarak ayarlarsanız yayına bağlı liveStream kaynağı, yayının altyazıları için kullanılacak besleme URL'sini belirtir.

  • liveBroadcast kaynağının snippet.scheduledEndTime özelliği artık süresiz olarak devam edecek şekilde planlanan yayınları destekliyor. Bu değişiklikle birlikte, özellik artık liveBroadcasts.insert ve liveBroadcasts.update isteklerinde zorunlu değildir.

    Bu özellik için bir değer belirtmeyen bir liveBroadcast kaynağı alırsanız yayın süresiz olarak devam edecek şekilde planlanır. Benzer şekilde, liveBroadcasts.insert veya liveBroadcasts.update yöntemini çağırır ve bu özellik için bir değer belirtmezseniz yayın süresiz olarak devam edecek şekilde planlanır.

  • liveBroadcast kaynağının varsayılan değeri true olan contentDetails.recordFromStart özelliği, artık yalnızca yayın kanalının canlı yayınlar için kayıtları devre dışı bırakmasına izin veriliyorsa false olarak ayarlanabilir.

    Kanalınızın kayıtları devre dışı bırakma izni yoksa ve recordFromStart özelliği false olarak ayarlanmış bir yayın eklemeye çalışırsanız API, Forbidden hatası döndürür. Ayrıca, kanalınızda bu izin yoksa ve bir yayını recordFromStart özelliğini false olarak ayarlayacak şekilde güncellemeye çalışırsanız API, modificationNotAllowed hatası döndürür.

  • liveBroadcast kaynağı artık contentDetails.enableDvr ve contentDetails.enableEmbed özelliklerinin açıklamalarında belirtilen enableArchive özelliğini içermiyor.

  • liveBroadcast kaynağının status.lifeCycleStatus özelliği için geçerli değerler listesi, her durumun açıklamasını içerecek şekilde güncellendi.

  • liveCuepoint kaynağının yeni settings.walltime özelliği, işaret noktasının eklenmesi gereken tarih ve saati belirtir. Bir istek, bu özellik ve settings.offsetTimeMs özelliği için değer belirten bir işaret noktası eklemeye çalışırsa API hata döndürür.

  • liveStream kaynağındaki yeni contentDetails nesnesi, yayınla ilgili bilgileri içerir. Şu anda nesnenin tek özelliği, video akışıyla ilişkili altyazıların besleme URL'sini belirten contentDetails.closedCaptionsIngestionUrl özelliğidir.

  • liveStream kaynağının status.streamStatus özelliği için geçerli değerler listesi, her durumun açıklamasını içerecek şekilde güncellendi.

  • liveBroadcasts.control yönteminin yeni walltime parametresi, seçilen seçeneğin ne zaman değişeceğini belirlemenize olanak tanır. Bir istek bu parametre ve offsetTimeMs parametresi için bir değer belirtirse API bir hata döndürür.

  • liveBroadcasts.list isteğine verilen API yanıtında, kind özelliğinin değeri youtube#liveBroadcastList yerine youtube#liveBroadcastListResponse olarak değiştirildi.

  • liveStreams.list isteğine verilen API yanıtında, kind özelliğinin değeri youtube#liveStreamList yerine youtube#liveStreamListResponse olarak değiştirildi.

  • eventId özelliğinin desteği hem liveBroadcastListResponse hem de liveStreamListResponse için sonlandırıldı.

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

    Hata türü Hata ayrıntısı Açıklama
    invalidValue conflictingTimeFields İsteğiniz offsetTimeMs ve walltime parametreleri için değerler belirtiyorsa liveBroadcasts.control yöntemi bu hatayı döndürür. Bir istekte her iki parametre de atlanabilir veya iki parametreden biri için değer belirtilebilir.
    invalidValue invalidWalltime walltime parametresinin değeri geçersizse liveBroadcasts.control yöntemi bu hatayı döndürür.
    forbidden enableClosedCaptionsModificationNotAllowed contentDetails.enableClosedCaptions değerini güncellemeye çalışırsanız ve yayının durumu created veya ready değilse liveBroadcasts.update yöntemi bu hatayı döndürür.
    invalidValue conflictingTimeFields İsteğiniz settings.offsetTimeMs ve settings.walltime özellikleri için değerler belirtiyorsa liveCuepoints.insert yöntemi bu hatayı döndürür. Bir istekte her iki özellik de atlanabilir veya iki özellikten biri için değer belirtilebilir.

    Ayrıca liveStreams.update yöntemi, liveStreams.insert yönteminin desteklediğine benzer bir cdnRequired hatasını artık desteklemiyor.

10 Mayıs 2013

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

2 Mayıs 2013

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

27 Mart 2013

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

  • liveBroadcast kaynağında aşağıdaki özellikler değişti:

    • startWithSlateCuepoint özelliği, startWithSlate olarak yeniden adlandırıldı.
    • enableArchive özelliği, recordFromStart olarak yeniden adlandırıldı.
    • slateSettings nesnesinin desteği sonlandırıldı ve dokümanlardan kaldırıldı. slateSettings nesnesi veya özellikleriyle ilgili hata mesajları da kaldırıldı. Son olarak, Başlangıç kılavuzunun "Seçenek listelerini görüntüleme" bölümü kaldırıldı.

  • API artık liveCuepoints.insert yöntemini kullanarak yayın içi seçme listeleri ekleme özelliğini desteklemiyor. Aşağıdaki belgeler bu değişikliği yansıtacak şekilde güncellenmiştir:

    • Dizin sayfası, Başlangıç kılavuzu ve Yayın yaşam döngüsü eğitiminde artık bu işlevden bahsedilmiyor.

    • liveCuepoint kaynağının settings.cueType özelliği artık özellik değeri olarak slate değerini desteklemiyor. (Desteklenen tek değer ad değeridir.

    • liveCuepoint kaynağının settings.eventState özelliği kullanımdan kaldırıldı ve dokümanlardan çıkarıldı.

18 Mart 2013

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

  • API'nin tüm hata mesajları, olası hataları daha net açıklayacak ve mümkün olduğunda bu hataların nasıl düzeltileceğiyle ilgili yol gösterecek şekilde güncellendi.

  • API artık birkaç yeni hata döndürebilir. Aşağıdaki listede, hata ve bu hatayı döndürebilecek API yöntemi belirtilmiştir:

    • liveBroadcasts.insert: Bir yayının planlanan bitiş zamanı, planlanan başlangıç zamanından sonra olmalıdır.
    • liveBroadcasts.insert: Yayın, geçersiz bir gizlilik durumu belirtiyor.
    • liveBroadcasts.update: Kaynak, contentDetails.enableArchive özelliği için bir değer içermiyor veya ayarlamıyor.
    • liveBroadcasts.update: Kaynak, contentDetails.enableContentEncryption özelliği için bir değer içermiyor veya ayarlamıyor.
    • liveBroadcasts.update: Kaynak, contentDetails.enableDvr özelliği için bir değer içermiyor veya ayarlamıyor.
    • liveStreams.insert: Snippet başlığı 1 ila 128 karakter uzunluğunda olmalıdır.
    • liveStreams.update: Kaynak, snippet.title özelliği için bir değer içermiyor veya ayarlamıyor.

  • liveStream kaynak dokümanları, çoklu yayın ve WebM'nin daha önce belirtildiği gibi desteklenen besleme yöntemleri olmadığını yansıtacak şekilde güncellendi. cdn.format özelliğinin biçim listesi buna göre güncellendi ve cdn.multicastIngestionInfo nesnesi ile alt özellikleri, kaynağın dokümanlarından kaldırıldı. Ayrıca http, desteklenen cdn.ingestionType değerleri listesinden kaldırıldı.