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öntemiyle ilgili doküman, yeni para kazanmayla ilgili hataları (preconditionFailed (412) (neden: videoNotEligibleForAdsMonetization) ve backendError (503) (neden: backendError)) içerecek şekilde güncellendi.

17 Ağustos 2026

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

  • liveBroadcast kaynağının yeni snippet.categoryId özelliği, 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ınlarda ara reklamların ve otomatik ara reklam yerleştirmenin etkinleştirilmesini destekliyor.

Yayın sahibi, yayının ara reklamlar için uygun olması koşuluyla yayında ara reklamları etkinleştirebilir. 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, yayın için otomatik reklamları diledikleri zaman devre dışı bırakabilirler.

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

  • YouTube'un ara reklam eklemeyi 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 için stratejiyi ve aralığı manuel olarak yapılandırın. Bu durumda, sahibin iki parametre ayarlaması gerekir:
    1. Reklam işaret noktaları için planlama stratejisi. İşaret noktaları, tüm izleyiciler için eşzamanlı olarak 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.
    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, ara reklam etkinleştirme 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 oluşabilecek çeşitli yeni hatalar tanımlanmaktadır.

14 Temmuz 2025

liveChatMessages.streamList yönteminin açıklaması, streamList API kullanımlarıyla ilgili rehberlik sağlamak için 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, 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. Bu sayede izleyiciler, uygun olduklarında işaret noktalarını alabilir.
  • Ara reklamların gösterilmediği bir dönemdir. Bu özellik için yayın sahibi, ara reklam eklemenin belirli bir zamana kadar duraklatıldığını belirtir.

Belgelerde, bu özelliği desteklemek için yapılan aşağıdaki API değişiklikleri yer almaktadı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öntemi artık şu alanlar için değer belirtilmesini gerektirmiyor:

    • snippet.title
    • status.privacyStatus

    Bu alanların istekten çıkarılması, alanların değişmeden kalmasına neden olur.

1 Kasım 2022

  • Yeni liveBroadcasts.cuepoint yöntemi, YouTube'da canlı yayın yapan tüm kanal sahiplerinin bu yayına işaret noktaları eklemesine olanak tanır. Bu işaret noktaları, reklam aralarını tetikleyebilir. 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önteminin desteği 1 Mayıs 2023'te veya sonrasında 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öntemi artık şu alanlar için değer belirtilmesini gerektirmiyor:

    • 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 özelliği ve alt öğeleri, Hediye Üyelik etkinliği hakkında 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 özellikleri, Yeni Sponsor etkinliği hakkında bilgiler 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şlevlerinde 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 kullanımdan kaldırma duyurusunda, kullanımdan kaldırma tarihi 1 Eylül 2020 olarak belirlenmişti. Bu tarih ertelendi ve 1 Ekim 2020'de veya daha sonraki bir tarihte gerçekleşecek. Bu nedenle, söz konusu duyuruda 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 tarihten itibaren, söz konusu alanı kullanmaya devam eden istekler başarısız olacaktır.

Kodunuzda hâlâ cdn.format alanı kullanılıyorsa bu alanın, kare hızını ve çözünürlüğü ayrı ayrı belirtecek şekilde cdn.frameRate ve cdn.resolution özelliklerini kullanarak güncellenmesi gerekir.

6 Temmuz 2020

HLS ile Canlı YouTube İçeriği Yayınlama kılavuzu birkaç değişiklikle güncellendi:

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 mülk ve desteğin sonlandırılmasıyla ilgili bir duyuru içerir:

  • 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ı gösterir.

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

  • Not: Bu, desteği sonlandırma duyurusudur. Bu değişiklikler 1 Eylül 2020'de veya bu tarihten sonra geçerli olacaktır. Değişikliklerin yürürlüğe gireceği asıl 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 akışla ilişkili yayın kimliği ve akış kimliği artık yeni yayın başlatmak için kullanılamayacak.

    Aşağıdaki durumlardan herhangi biri geçerliyse uygulamanız etkilenir:

    • liveBroadcast kaynağının isDefaultBroadcast özelliğinin değerini kontrol eder. Bu özellik, desteğin sonlandı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 parametrenin desteği, bu değişiklikler kapsamında sonlandı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.

    Geçtiğimiz birkaç yıl boyunca YouTube, 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 akış süresiz olarak mevcuttu, 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ğin sonlandırıldığı tarih itibarıyla:

    • YouTube artık varsayılan yayınlar ve yayınlar oluşturmayacak. API istemcilerinin, varsayılan kaynaklara güvenmek 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ışı aktif olarak canlıysa (yani kanal, desteğin sonlandırıldığı sırada canlı yayın için bunları 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ın süreci 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 bu kaynak ile yöntemin 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

Canlı YouTube İçeriklerini HLS ile 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 ile 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ı yok saydığı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ğine yetki verdiyse 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ı - Revizyon 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

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

  • Bu dokümanda, her medya oynatma listesine hem onaylanmış hem de bekleyen segmentlerin eklenmesinin en iyi uygulama olduğu açıklanmaktadır. Bu uygulama, sunucu tarafında bir medya oynatma listesi kaybolursa bir segmentin atlanma olasılığını azaltır. Örneğin, her medya oynatma listesine en fazla iki onaylanmış segment ve en fazla beş bekleyen segment ekleyebilirsiniz.
  • Artık her medya segmenti için bir medya oynatma listesi göndermeniz gerekiyor. 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. Bu nedenle, liveStream kaynağının ingestionType özelliği, HLS kullanılarak YouTube'a aktarılan akışları tanımlamak için yeni hls değerini destekler.

Yeni HLS ile Canlı YouTube İçeriği Yayınlama kılavuzunda, bir kodlayıcıdan YouTube'a canlı içerik yayınlamak için HLS'nin nasıl kullanılacağına dair yönergeler yer alır. Bu kılavuz, kodlayıcı tedarikçilerinin ürünlerine HLS yayın desteği eklemesine 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çıklamak ve API Gezgini widget'ı aracılığıyla dinamik ve yüksek kaliteli kod örnekleri sağlamak için 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çıklanmaktadı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ıyla doğrudan ilgili kod örneklerini görmenizi kolaylaştırmayı amaçlamaktadır.

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

  • Kod örnekleri 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 örneklerinin listelendiği 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 mesajları da YouTube canlı yayını sırasında takipçiler tarafından satın alınır.

  • liveChatMessage kaynağında, snippet.type özelliği artık kaynağın bir Süper Etiket hakkında bilgi içerdiğini belirtmek için superStickerEvent olarak ayarlanmıştır. Bu durumda kaynak, Süper Etiketler hakkında ek bilgiler içeren snippet.superStickerDetails nesnesini de içerir.
  • superChatEvent kaynağında, snippet.isSuperStickerEvent boole değeri, Süper Chat mesajının aynı zamanda bir Süper Etiket olup olmadığını gösterir. Bu durumda snippet.superStickerMetadata nesnesi, Süper Etiket hakkında 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 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 kodu ö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 bir 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'dır. Bu, varsayılan davranışın, görüntüleme dizelerini İngilizce'de kullanılacak ş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'ler bir renkle vurgulanır.
      • Süper Chat mesajları, belirli bir süre boyunca bilgi bandında sabitlenmiş olarak kalır.

      Süper Chat'in rengi, ticker'da sabitlendiği süre ve maksimum mesaj uzunluğu, satın alma tutarına göre belirlenir. Süper Sohbet hakkında daha fazla bilgiyi YouTube Yardım Merkezi'nde bulabilirsiniz.

      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 öğeleri, Süper Chat etkinliği hakkında bilgiler 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 özelliği ya da contentDetails.projection özelliği için geçersiz bir değer içerdiğini belirtmek üzere 400 (Bad Request) hatalarını döndürür. İki yeni hatanın hata nedenleri sırasıyla invalidEmbedSetting ve invalidProjection'dir.

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 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 destekleyici belgelerde gelecekte yapılacak değişiklikler de bu düzeltme geçmişinde açıklanacaktır. İlgili dokümandaki bir bağlantıdan, düzeltme geçmişindeki değişiklikleri listeleyen bir RSS özet akışına abone olabilirsiniz.

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 YouTube'da Canlı İçerik Yayınlama kılavuzu, YouTube'da bir kodlayıcıdan canlı veri akışı yapmak için DASH yayın biçimini kullanmayla ilgili yönergeler sunar. Kodlayıcı satıcılarının ürünlerine DASH teslimat 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 kaynaklarda ve yöntemlerde yapılan güncellemeler

    • liveStream kaynak güncellemeleri

      • 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 özelliklerinin kullanıma sunulmasıyla birlikte, kaynağın cdn.format özelliği kullanımdan kaldırıldı. 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. Üç özelliğin tümü için değer sağlarsanız değerler uyuşmadığı takdirde API hata döndürebilir.

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

    • liveBroadcast kaynak güncellemesi

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

        Özellikler
        contentDetails.boundStreamLastUpdateTimeMs Yayın contentDetails.boundStreamId özelliği 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'dir. Özellik için geçerli değerler 360 ve rectangular şeklindedir.

      • liveBroadcast kaynağının statistics.totalChatCount özelliğiyle ilgili tanım, özellik 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, özellik değerinin bu yeni mesaj türleri için 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 iletiyle ilgili bilgileri içerir. Nesne yalnızca snippet.type özelliğinin değeri messageDeletedEvent ise bulunur.
        snippet.userBannedDetails Bu nesne, sohbete katılması yasaklanan bir kullanıcı hakkında bilgi içerir. Nesne, yasağın kalıcı mı yoksa geçici mi olduğu gibi yasakla ilgili bilgileri de içerir. 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ını döndürür. Hata 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ğındaki geçersiz bir özellik değerini tanımlayan dört yeni 400 (Bad Request) hatayı 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 net bir ifadeyle, 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 belirtirseniz ancak cdn.resolution için değer belirtmezseniz API, resolutionRequired hatası döndürür.
      liveStreams.update İstek, aşağıdaki değiştirilemeyen ö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ı gerekir. Bu nedenle, Avrupa Birliği'ndeki son kullanıcılar için AB Kullanıcı Rızası Politikası'na uymanız gerekir. YouTube API Hizmet Şartları'na bu şartla ilgili bir bildirim 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, etkin canlı yayınlar sırasında canlı sohbet işlevini destekler. Bu kaynaklar ve yöntemleri, 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 de 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) belirtir. 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 para desteği vererek gönüllü olarak desteklemesine 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 de yayının Canlı Sohbetinde fanFundingEvent mesajını 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. Sponsorlar, 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 kaynaklarda 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 aynıdır.
      • Özellik değerini false olarak ayarlamak, contentDetails.closedCaptionsType özelliğini closedCaptionsDisabled olarak ayarlamakla eşdeğerdir.

    • liveBroadcasts.list yönteminin yeni broadcastType parametresi, 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ında aşağıdaki yeni sağlık durumu hataları bildirilir:

    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

    • Yukarıda listelenen yeni kaynaklar için tanımlanan hatalara ek olarak API, 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ğı yalnızca iki özellikten 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ğında, YouTube'da canlı yayın sırasında gönderilen bir yorum yer alıyor. 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 gönderilebilir.

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

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

      Özellikler
      snippet.isDefaultStream Bu yayının kanal için varsayılan yayın olup olmadığını gösterir. Bir kanalın varsayılan yayını süresiz olarak devam eder, 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, LiveStream Kaynakları İçin Yapılandırma Sorunları adlı yeni bir belgede listelenir.
      contentDetails.isReusable Yayının yeniden kullanılabilir olup olmadığını gösterir. Yeniden kullanılabilir yayınlar, birden fazla canlı yayına bağlanabilir. Yayıncıların, farklı zamanlarda gerçekleşen yayınlar için aynı yayını yeniden kullanması yaygın bir durumdur.

    • 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 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ını inceleyin.
      contentDetails.enableLowLatency Bu yayının düşük gecikmeli akış için kodlanıp kodlanmayacağını belirtir. Düşük gecikmeli akış, yayını izleyen kullanıcıların videoyu görmesi için gereken süreyi azaltabilir ancak akışın izleyicileri için çözünürlüğü 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 mülk ve değeri bulunur. 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ı 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) canlı video akışını destekliyor. Bu sayede oyun ve diğer hızlı aksiyon videoları daha akıcı bir şekilde oynatılıyor. YouTube'da 60 fps'de canlı yayın başlattığınızda YouTube, yüksek kare hızında 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ını yapması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ınlayamadığını açıklayan ayrıntılar, kullanıcının kanal ayarlarında (https://www.youtube.com/features) yer alabilir.
    rateLimitExceeded userRequestsExceedRateLimit liveBroadcasts.insert ve liveStreams.insert yöntemlerinin her ikisi de, 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 akışı yoksa özellik için 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ı kanallar için API isteklerini tamamlamak üzere 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 İsteği yetkilendiren kullanıcı YouTube'da canlı video yayınlayamıyorsa liveBroadcasts.insert, liveBroadcasts.transition ve liveStreams.insert yöntemleri bu hatayı döndürür. Kullanıcının neden canlı video yayınlayamadığını açıklayan ayrıntılar, kullanıcının kanal ayarlarında (https://www.youtube.com/features) yer alabilir.

  • 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, liveBroadcasts.insert ve liveBroadcasts.update isteklerinde artık bu özellik zorunlu değildir.

    Bu özellik için 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ıp 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 mülklerinin açıklamalarında belirtilen bir enableArchive mülkü 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 ekleneceği tarih ve saati belirtir. Bir istek, bu özellik ve settings.offsetTimeMs özelliği için bir 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çenekte ne zaman değişiklik yapılacağını tarih ve saat olarak belirtmenize olanak tanır. Bir istekte bu parametre ve offsetTimeMs parametresi için bir değer belirtilirse API hata döndürür.

  • liveBroadcasts.list isteğine verilen API yanıtında, kind mülkünün 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 mülkü, startWithSlate olarak yeniden adlandırıldı.
    • enableArchive mülkünün adı recordFromStart olarak değiştirildi.
    • 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 geçiş reklamları ekleme özelliğini desteklemiyor. Aşağıdaki belgeler bu değişikliği yansıtacak şekilde güncellenmiştir:

    • Dizin sayfasında, Başlangıç kılavuzunda ve Yayınları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. (Yalnızca ad değeri desteklenir.

    • liveCuepoint kaynağının settings.eventState özelliğinin desteği sonlandırıldı ve bu özellik dokümanlardan kaldırı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 bir şekilde açıklamak ve mümkün olduğunda bu hataların nasıl çözüleceği konusunda rehberlik sunmak için 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ğini içermiyor veya bu özellik için bir değer 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ı.