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

Bu sayfada, YouTube Live Streaming API değişiklikleri ve doküman güncellemeleri listelenmektedir. Bu değişiklik günlüğüne abone olun. Abone ol

9 Temmuz 2025

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ı etkinliklerin bölgesel kullanılabilirliğini yönetebilmeniz için canlı yayınlara yönelik coğrafi kısıtlamalar belirtmenize olanak tanır.

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 özelliği ve alt öğeleri, hediye etkinliği hakkında bilgi içerir.

12 Ocak 2026

API artık canlı yayınlarda ara reklamların etkinleştirilmesini ve otomatik ara reklam yerleştirmeyi destekliyor.

Yayın sahibi, yayın yayının ortasındaki reklamlara uygun olduğu sürece yayında yayının ortasındaki reklamları etkinleştirebilir. Sahip, bir yayın için orta kısımdaki reklamları istediği zaman devre dışı da bırakabilir.

Bir yayında ara reklamlar etkinleştirilmişse yayın sahibi, otomatik ara reklam eklemeyi etkinleştirebilir. Ayrıca, yayın için otomatik reklamları istedikleri zaman devre dışı bırakabilirler.

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

  • YouTube'un videonun ortasında reklam ekleme özelliğini 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 planlama stratejisi. İşaret noktaları, tüm izleyiciler için aynı anda eklenebilir veya işaret noktalarının zamanlaması izleyiciden izleyiciye değişebilir. Bu strateji, YouTube'un işaret noktalarını daha hızlı bir şekilde planlamasına olanak tanır. Böylece izleyiciler, işaret noktası almaya uygun olduklarında işaret noktası alabilir.
    2. Videonun ortasında gösterilen reklam araları arasındaki aralığın uzunluğu.

Bu özelliği desteklemek için dokümanlarda aşağıdaki API değişiklikleri yapılmıştır:

  • liveBroadcast kaynağının monetizationDetails nesnesi, ara reklam etkinleştirme ve otomatik reklam yapılandırmaları için alanlar içerir.
  • Videonun ortasında gösterilen reklamları etkinleştirmek veya devre dışı bırakmak için update yöntemi kullanılabilir. Bu yöntem, canlı yayın için otomatik reklamları ayarlamak üzere de kullanılabilir. Belgelerde, canlı yayınlarda 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 Etiketlerle ilişkili olduğunu bu CSV dosyasında bulabilirsiniz. liveChatMessage kaynağının snippet.superStickerDetails.superStickerMetadata.stickerId özelliği ve superChatEvent kaynağının snippet.superStickerMetadata.stickerId özelliğiyle ilgili tanımlar, bu bilgileri yansıtacak şekilde güncellendi.

15 Eylül 2023

API artık canlı yayınlara reklam eklemenin yeni bir yolunu destekliyor. YouTube, liveCuepoints özelliğine ek olarak artık sabit aralıklarla yayınlara otomatik olarak ara reklam araları ekleme özelliğini de destekliyor. liveCuepoints özelliği, yayınlara manuel olarak reklam araları eklemenize olanak tanır.

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. Bu strateji, YouTube'un işaret noktalarını daha hızlı bir şekilde planlamasına olanak tanır. Böylece izleyiciler, işaret noktası almaya uygun olduklarında işaret noktası alabilir.
  • Ara reklamların gösterilmediği bir dönem. Bu özellik için yayın sahibi, belirli bir zamana kadar ara reklam eklemenin duraklatıldığını belirtir.

Bu özelliği desteklemek için dokümanlarda aşağıdaki API değişiklikleri yapılmış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ın planlanmasıyla ilgili ek bilgileri belirtir.
  • liveBroadcast.list yönteminin part parametresi monetizationDetails değerini destekler.
  • update yöntemi, canlı yayınlarda belirli bir süre için videonun ortasında gösterilen reklam eklemeyi duraklatmak amacıyla 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 bu 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 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 almıştır.

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

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

    liveCuepoints.insert yöntemi artık kullanımdan kaldırıldı. liveCuepoints.insert yönteminin desteği 1 Mayıs 2023'te veya sonrasında kaldırılacak. API kullanıcıları, uygulamalarını liveBroadcasts.cuepoint yöntemini çağıracak şekilde güncellemelidir.

  • liveBroadcasts.control yöntemiyle ilgili dokümanlar kaldırıldı. Bu yöntem için Eylül 2020'de kullanımdan kaldırma bildirimi yayınlandı.

1 Ekim 2022

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

  • liveBroadcasts.update yöntemi artık bu alanlar için değer belirtilmesini gerektirmiyor:

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

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

  • Eski 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, üyelik hediye etme etkinliği hakkında bilgiler içerir. Benzer şekilde, yeni snippet.giftMembershipReceivedDetails özelliği ve alt özellikleri, Hediye Üyelik Alındı etkinliği hakkında bilgi 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 özelliği 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şlevinde bir değişikliği yansıtmaz.

    Bir 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, desteği sonlandırma duyurusunu ve önceki bir desteği sonlandırma duyurusunun güncellenmesini içerir.

    liveBroadcasts.control yönteminin desteği 1 Ekim 2020'de veya bu tarihten sonra sonlandı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ılacaktır. Müşteriler, YouTube'un alım sunucularına gönderilen videoya yer paylaşımı ekleyerek kendi çekimlerini yine de uygulayabilir.

    Başlangıçta 1 Eylül 2020 olarak planlanan 16 Nisan 2020'de yapılan kullanımdan kaldırma duyurusunun kullanımdan kaldırma tarihi ertelendi ve 1 Ekim 2020'de veya bu tarihten sonra gerçekleşecek. Bu nedenle, 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 duyurulan desteği sonlandırma işlemine yönelik bir güncellemedir.

Nisan 2016'da kullanımdan kaldırılan liveStream kaynağının cdn.format alanı, 17 Ağustos 2020'den itibaren artık desteklenmeyecektir. Bu alanı kullanmaya devam eden istekler söz konusu tarihten itibaren başarısız olacaktır.

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

6 Temmuz 2020

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

  • Medya segmenti için önerilen süre 1-4 saniye olarak güncellendi.
  • Yeni bir bölümde, YouTube İçerik Stüdyosu'ndan HLS alım URL'si alma hakkında bilgi verilmektedir.
  • file parametre değerini biçimlendirme talimatları yeni HLS Besleme URL'sini Tamamlama bölümüne taşındı. Bu talimatlar, HLS alım URL'sinin YouTube API'den veya YouTube İçerik Stüdyosu'ndan alınmasına bakılmaksızın geçerlidir.

Ayrıca, yeni alma protokolü karşılaştırması, YouTube'un desteklediği alma 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ği sonlandırma duyurusu içerir:

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

    Yayın ömrü belgesi, contentDetails.enableAutoStart veya contentDetails.enableAutoStop özelliklerini true olarak ayarlarsanız YouTube'da canlı etkinlik 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ği sonlandırma duyurusudur. Bu değişiklikler 1 Eylül 2020'den itibaren 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 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ınları başlatmak için kullanılamayacaktır.

    Aşağıdaki koşullardan 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ığı tarihten itibaren:
      • 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, o zamandan önce var olan kalıcı yayınları döndürmez.

    Geçmiş birkaç yıldır YouTube, canlı yayın özelliği etkinleştirilen kanallar için otomatik olarak varsayılan bir yayın ve varsayılan bir 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 da kalıcı olarak kabul edildi. Her zaman vardı ve belirli bir etkinliğe bağlı değildi.

    Kullanımdan kaldırılma tarihi itibarıyla:

    • YouTube artık varsayılan yayınlar ve canlı 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 akışı tekrar kullanamaz.
    • Bir kanalın varsayılan yayını ve varsayılan akışı aktif olarak canlı değilse desteğin sonlandırılması yürürlüğe girdikten sonra YouTube, video yayınlamak için bu kaynakları kullanma girişimlerini yoksayar.

    Uygulamanız etkileniyorsa lütfen aşağıdaki belgeleri inceleyin. Bu belgeler, uygulamanızı bu değişiklikten sonra da beklendiği gibi çalışacak şekilde güncellemenize yardımcı olacaktır:

    • Yeni taşıma kılavuzu, geliştiricilerin şu anda varsayılan yayınları ve akışları kullanan API istemcilerinde ele almaları 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 takip etmesi gerekir.

31 Mart 2020

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

sponsor kaynağı ve sponsors.list yöntemi 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 edinmek için lütfen YouTube Data API revizyon geçmişini inceleyin.

11 Mart 2020

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

4 Şubat 2020

HLS ile Canlı YouTube İçeriği Yayınlama rehberi, DELETE isteklerinin isteğe bağlı olduğunu ve YouTube'un HLS uç noktasının bu istekleri yok saydığını belirtecek şekilde güncellendi. YouTube, performans nedeniyle istemcilerin DELETE isteği göndermemesini önerir.

10 Ocak 2020

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

  • liveBroadcast kaynağı, içerik üreticilerin ve izleyicilerin "çocuklara özel" içerikleri belirlemesini sağlamak için iki yeni özelliği destekliyor:
    • selfDeclaredMadeForKids mülkü, içerik üreticilerin canlı yayınları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, herhangi bir API kullanıcısının bir yayının "çocuklara özel" durumunu almasını sağlar. Örneğin, durum selfDeclaredMadeForKids özelliğinin değerine göre belirlenebilir. Kanalınız, videolarınız veya yayınlarınızın kitlesini ayarlama hakkında daha fazla bilgi için YouTube Yardım Merkezi'ne göz atın.
  • 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, 10 Ocak 2020'de Pasifik Saati ile yürürlüğe girecektir.

20 Ağustos 2019

HLS ile Canlı YouTube İçeriği Yayınlama rehberinin 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 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, medya oynatma listesi kaybolursa sunucunun hızlıca kurtarılmasını sağlar. Bu uygulama daha önce öneri olarak listeleniyordu.

28 Haziran 2019

YouTube artık HLS alımını destekliyor. Bu nedenle, 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 YouTube'da Canlı İçerik Yayınlama rehberi, HLS'yi kullanarak bir kodlayıcıdan YouTube'a canlı içerik yayınlama ile ilgili yönergeler sunar. Bu kılavuz, kodlayıcı satıcılarının ürünlerine HLS yayını desteği eklemesine yardımcı olmayı amaçlamaktadır.

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, 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ğerleri girmenize, ardından gerçek API istekleri göndermenize ve gerçek API yanıtlarını görmenize olanak tanır. Ayrıca widget, tam ekran görünümü sunar. Bu görünümde, girdiğiniz kapsamları ve değerleri kullanmak için dinamik olarak güncellenen tam kod örnekleri gösterilir.

    • 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 zaten doldurulmuş şekilde açabilirsiniz. Bu değişiklikler, kendi uygulamanızda uygulamaya çalıştığınız kullanım alanıyla doğrudan alakalı kod örneklerini görmenizi kolaylaştırmayı amaçlamaktadır.

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

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

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

25 Şubat 2019

liveChatMessage ve superChatEvent kaynaklarının dokümanları, artık her iki kaynağın da 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.

  • Bir liveChatMessage kaynağında, kaynağın Süper Çıkartma hakkında bilgi içerdiğini belirtmek için snippet.type özelliği artık superStickerEvent olarak ayarlanıyor. Bu durumda kaynak, Super Sticker hakkında ek bilgiler içeren snippet.superStickerDetails nesnesini de içerir.
  • Bir superChatEvent kaynağında, boolean snippet.isSuperStickerEvent değeri, Super Chat mesajının aynı zamanda bir Süper Etiket olup olmadığını gösterir. Bu durumda snippet.superStickerMetadata nesnesi, Super Sticker hakkında ek ayrıntılar içerir.

5 Nisan 2018

superChatEvents.list yönteminin açıklaması, 2017'nin başlarında desteği sonlandırılan fanFundingEvents'nin artık API yanıtında yer almadığını 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. Örneklerde aşağıdaki yöntemler çağrılır:

13 Şubat 2017

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

  • Mevcut kaynaklar ve yöntemlerdeki 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öntemlerdeki 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 İngilizcede 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 hayranın YouTube canlı yayını sırasında satın aldığı Süper Chat mesajını temsil eder. YouTube canlı sohbet akışında Super Chat, diğer mesajlar arasından iki şekilde öne çıkar:

      • Süper Chat'ler belirli bir renkle vurgulanır.
      • Super Chat'ler, belirli bir süre boyunca sohbet şeridinde kalır.

      Süper Chat'in rengi, sohbet şeridinde sabit kalacağı 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 Destek Olma etkinlikleriyle (fanFundingEvents) ilgili verileri de döndürür.

  • Mevcut kaynaklar ve yöntemlerdeki güncellemeler

    • snippet.type özelliği artık kaynağın Süper Chat'i tanımladığını belirten superChatEvent değerini destekliyor.

      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ği sonlandırma duyurusudur.

YouTube, yeni Süper Chat özelliğinin kullanıma sunulmasıyla birlikte Takipçi Desteği özelliğinin desteğini sonlandırdı. Takipçi Desteği API'si 28 Şubat 2017'de devre dışı bırakılacak. Bu tarih itibarıyla:

11 Ağustos 2016

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

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

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

20 Mayıs 2016

YouTube artık DASH yüklemeyi destekliyor. Bu nedenle, liveStream kaynağının ingestionType özelliği, DASH kullanılarak YouTube'a alınan 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ınlama biçimini kullanmayla ilgili yönergeler sunar. Bu kılavuz, kodlayıcı sağlayıcıların ürünlerine DASH teslimat desteği eklemesine yardımcı olmayı amaçlamaktadır.

18 Nisan 2016

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

  • Mevcut kaynaklar ve yöntemlerdeki güncellemeler

    • liveStream kaynak güncellemeleri

      • YouTube artık saniyede 30 veya 60 kare hızında 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 mülk değerleri şunlardır: 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çmenizi öneririz. Bu süre zarfında cdn.format çalışmaya devam eder. Ayrıca, canlı yayın ekleme istekleri şu anda cdn.format özelliği veya cdn.frameRate ve cdn.resolution özellikleri için değerler belirttiğiniz sürece 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 saniyede 30 veya 60 kare 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üncellemeleri

      • 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ınların projeksiyon biçimi. Özelliğin varsayılan değeri rectangular'dır. Özelliğin geçerli değerleri 360 ve rectangular'dir.

      • 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üncellemeleri

      • 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 bilgiler içerir. Nesne yalnızca snippet.type özellik değeri messageDeletedEvent ise bulunur.
        snippet.userBannedDetails Bu nesne, sohbete katılmaktan yasaklanan bir kullanıcıyla ilgili bilgiler içerir. Nesne, yasağın kendisiyle ilgili bilgileri de içerir. Örneğin, yasağın kalıcı mı yoksa geçici mi olduğu gibi. Yasak geçiciyse nesnenin özelliklerinden biri yasağın süresini belirtir.

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

  • 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 zaten aynı hatayı destekliyor.
      liveStreams.insert liveStreams.insert yöntemi, istekte eklenmeye çalışılan 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 bunlarla ilişkili ö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) hatayı destekler. Aşağıdaki listede hata nedenleri ve bunlarla ilişkili ö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 değer belirtmezseniz API, frameRateRequired hatası döndürür.
      • cdn.frameRate için bir değer belirtip cdn.resolution için değer 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 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 yapılmalı ve bu kullanıcılardan izin alınmalıdır. Bu nedenle, Avrupa Birliği'ndeki son kullanıcılar için AB Kullanıcı Rızası Politikası'na uymanız gerekir. Bu şartla ilgili bildirimi YouTube API Hizmet Şartları'na ekledik.

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 çeşitli yeni kaynakları 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 Fan Funding 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 bir kullanıcıyı tanımlar. Yasaklar geçici veya kalıcı olabilir. API, canlı sohbet yasaklarını ekleme ve silme yöntemlerini destekler.
      fanFundingEvents Bu kaynak, bir YouTube kanalındaki Takipçi Desteği etkinliğini temsil eder. Takipçi Desteği, izleyicilerin YouTube içerik üreticilerini tek seferlik maddi destekle gönüllü olarak desteklemesini sağlar.

      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 Fan Funding etkinlikleri de yayının canlı sohbetinde fanFundingEvent mesajını tetikler.

      Fan Funding hakkında daha fazla bilgiyi YouTube Yardım Merkezi'nde bulabilirsiniz.
      sponsors sponsor kaynağı, bir YouTube kanalının sponsorunu tanımlar. Sponsorlar, kanallara aylık ücret öder. Kanalın canlı sohbetlerinde sponsorun mesajlarının yanında bir rozet gösterilir. Sponsorlar, kanalda sponsorlara özel canlı sohbetler düzenlenirse bu sohbetlere de katılabilir.

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

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

  • Mevcut kaynaklar ve yöntemlerdeki güncellemeler

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

      Özellikler
      snippet.liveChatId Yayınla ilgili 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 engelleri kaldırabilirsiniz.
      contentDetails.closedCaptionsType Not: Bu özellik, contentDetails.enableClosedCaptions özelliğinin yerini alır.

      Bu özellik, yayınınızda altyazıların etkin olup olmadığını ve etkinse hangi tür altyazılar sağladığınızı belirtir:
      • closedCaptionsDisabled: Canlı yayında altyazılar devre dışıdır.
      • closedCaptionsHttpPost: Altyazıları, HTTP POST aracılığıyla canlı yayınınızla ilişkili bir alma 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ıldı. Bunun yerine contentDetails.closedCaptionsType özelliğini kullanın. Bu mülkü zaten kullanan API istemcileri için:
      • Özellik değerini true olarak ayarlamak, contentDetails.closedCaptionsType özelliğini closedCaptionsHttpPost olarak ayarlamaya eşdeğerdir.
      • Özellik değerini false olarak ayarlamak, contentDetails.closedCaptionsType özelliğini closedCaptionsDisabled olarak ayarlamaya 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 var olan ve belirli bir etkinliğe bağlı olmayan yayındır. 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 Geçerli 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ın 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ğı 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 dokümanlar 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 var. API, bu kaynak için iki yöntemi destekler:

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

      Canlı sohbet mesajları yalnızca yayın devam ederken alınabilir ve gönderilebilir.

  • Mevcut kaynaklar ve yöntemlerdeki güncellemeler

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

      Özellikler
      snippet.isDefaultStream Bu akışın kanalın varsayılan akışı 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 yayınının durumunu değerlendirmenize yardımcı olacak bir dizi alt özellik içerir.

      Özellikle status.healthStatus.configurationIssues[] nesnesi, video yayınını etkileyen sorunları listeler. Configuration Issues for LiveStream Resources (Canlı Yayın Kaynaklarıyla İlgili Yapılandırma Sorunları) adlı yeni belgede, API'nin bildirdiği tüm sorunlar listelenmektedir.
      contentDetails.isReusable Akışın yeniden kullanılabilir olup olmadığını belirtir. Yeniden kullanılabilir akışlar birden fazla 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ın varsayılan yayını olup olmadığını gösterir. YouTube kanalları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. Akış, kanal sahibinin YouTube'a canlı video gönderme şeklini tanımlar. Yayın ise izleyicilerin varsayılan akışı görme şeklidir. Varsayılan yayınların işleyiş şekli hakkında daha fazla bilgi için mülkün 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 akış, yayını izleyen kullanıcıların videoyu görmesi için gereken süreyi azaltabilir ancak akışın izleyiciler için çözünürlüğünü de etkileyebilir.
      statistics.totalChatCount Yayınla ilişkili toplam canlı sohbet mesajı sayısı. Yayın kullanıcı tarafından görülebiliyorsa ve canlı sohbet özelliği etkinse mülk ve değeri gösterilir. Bu özelliğin, yayın sona erdikten sonra 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ı belirlemez.

  • 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 hale getirmenize veya bunun tam tersini yapmanıza izin vermez. Daha fazla bilgi için Yayınlar ve Akışlar Hakkında 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 sorunsuz oynatılıyor. YouTube'da 60 FPS'de canlı yayın başlattığınızda YouTube, yüksek kare hızlı izlemenin henüz kullanılamadığı cihazlarda yayını 30 FPS olarak da sunar.

    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 Üreticileri Blogu'na göz atın.

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 belirtecek ş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ı etkinleştirilmemişse liveBroadcast ve liveStream kaynaklarıyla ilgili 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ümanda yapılan bir düzeltmedir. Temel API işlevselliği 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ıza testing aşaması ekleyemezsiniz. Bu durumda 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 yönelik 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öntemi çağırırken settings.walltime özelliği için bir değer ayarlayabileceğinizi belirtecek şekilde güncellendi.

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

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

    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, yayının güvenilir bir şekilde planlanabileceği kadar yakın olması gerektiğini açıklayacak şekilde 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ına altyazı eklenip eklenemeyeceğini belirtir. Özellik değeri, yayın eklerken veya güncellerken ayarlanabilir ancak yayın testing veya live durumundayken güncellenemez. Bu özelliği true olarak ayarlarsanız yayına bağlı liveStream kaynağı, yayının altyazıları için kullanılacak alım 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 bu özellik artık gerekli 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 contentDetails.recordFromStart özelliği (varsayılan değeri true idi) artık yalnızca yayın kanalının canlı yayınlarda 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ı güncelleyerek recordFromStart özelliğini false olarak ayarlamaya ç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 enableArchive mülkünü 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 için alım 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, bir slate değişikliğinin gerçekleşeceği tarihi ve saati 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 ö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ğinizde offsetTimeMs ve walltime parametreleri için değerler belirtiliyorsa liveBroadcasts.control yöntemi bu hatayı döndürür. Bir istekte her iki parametre de atlanabilir veya iki parametreden biri için bir değer belirtilebilir.
    invalidValue invalidWalltime liveBroadcasts.control yöntemi, walltime parametresinin değeri geçersizse bu hatayı döndürür.
    forbidden enableClosedCaptionsModificationNotAllowed liveBroadcasts.update yöntemi, contentDetails.enableClosedCaptions değerini güncellemeye çalıştığınızda ve yayın durumu created veya ready olmadığında bu hatayı döndürür.
    invalidValue conflictingTimeFields İsteğinizde settings.offsetTimeMs ve settings.walltime özellikleri için değerler belirtiliyorsa liveCuepoints.insert yöntemi bu hatayı döndürür. Bir istekte her iki özellik de atlanabilir veya iki özellikten biri için bir değer belirtilebilir.

    Ayrıca, liveStreams.update yöntemi artık liveStreams.insert yönteminin desteklediğine benzer bir cdnRequired hatasını 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 nesnesi kullanımdan kaldırıldı ve dokümanlardan çıkarıldı. slateSettings nesnesi veya özellikleri ile ilgili hata mesajları da kaldırıldı. Son olarak, Başlangıç kılavuzunun "Displaying Slates" (Slates Gösterme) bölümü kaldırıldı.

  • API artık liveCuepoints.insert yöntemiyle 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ı, Başlangıç kılavuzu ve Yayın süreci 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çıklayacak ve mümkün olduğunda bu hataların nasıl düzeltileceği konusunda rehberlik edecek şekilde güncellendi.

  • API artık çeşitli yeni hatalar döndürebilir. Aşağıdaki listede hata ve bu hatayı döndürebilecek API yöntemi tanımlanmaktadır:

    • liveBroadcasts.insert Yayınları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ı, daha önce belirtildiği gibi çoklu yayın ve WebM'nin desteklenen alım yöntemleri olmadığını yansıtacak şekilde güncellendi. cdn.format özelliği için biçimler 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ı.