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

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

Hangi etiket kimliklerinin hangi Süper Etiketlerle ilişkili olduğunu yalnızca referans amaçlı olarak 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 canlı yayına otomatik olarak ara reklam araları ekleme özelliğini de destekliyor. Bu özellik, canlı yayına 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.
  • Videonun ortasında gösterilen reklamların gösterilmediği bir dönem. Bu özellik için yayın sahibi, belirli bir zamana kadar videonun ortasında gösterilen 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 videonun ortasında gösterilen reklamların eklenmesini belirli bir süre için 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 alı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üncellemeli.

  • 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 şu 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 öğeleri, Hediye Üyelik Alındı etkinliği hakkında bilgiler 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 öğeleri, 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. Hatanın nedeni userRequestsExceedRateLimit.

21 Eylül 2020

  • liveBroadcast kaynağının status.madeForKids özelliği 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, kullanımdan kaldırma duyurusu ve önceki bir kullanımdan kaldırma duyurusunda yapılan güncellemeyi 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ı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ğin sonlandırılmasıyla ilgili bir güncellemedir.

Nisan 2016'da desteği sonlandı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 Canlı YouTube İçeriği 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 veriliyor.
  • 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'sinden 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'de veya sonrasında 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ülmeyecektir.
    • liveStream kaynağının isDefaultStream özelliğinin değerini kontrol eder. Bu özellik, desteğin sonlandırılma tarihinden sonra döndürülmeyecektir.
    • liveBroadcasts.list yöntemini çağırır ve broadcastType parametre değerini persistent veya all olarak ayarlar. Bu parametre, bu değişiklikler kapsamında kullanımdan kaldırılacak. Desteğin sonlandırıldığı 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ç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 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ılması yürürlüğe girdiğinde 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ışmaktadı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ği sonlandırma duyurusudur.

sponsor kaynağı ve sponsors.list yöntemi kullanımdan kaldırıldı ve 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ı güncelleyerek bunun yerine members.list yöntemini kullanmalıdır. 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 Canlı YouTube İçeriği 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 istekleri 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 özelliği, 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 yönelik" 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. Buna göre, liveStream kaynağının ingestionType özelliği, HLS kullanılarak YouTube'a aktarılan yayınları tanımlamak için yeni hls değerini destekler.

Yeni HLS ile Canlı YouTube İçeriği Yayınlama rehberi, bir kodlayıcıdan YouTube'a canlı içerik yayınlamak için HLS'yi kullanmayla 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 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ğerleri girmenize, ardından gerçek API istekleri göndermenize ve gerçek API yanıtlarını görmenize olanak tanır. Ayrıca, tam ekran görünümünde tam kod örnekleri gösterilir. Bu örnekler, girdiğiniz kapsamları ve değerleri kullanmak için dinamik olarak güncellenir.

    • 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 mevcut 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, Süper Etiket 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 öğelerinin 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 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ö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 şeklindedir. 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 takipçinin 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 mesajları, 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 listeleme yöntemini destekler. Bu yöntem, kanalın son canlı yayınındaki Fan Funding etkinlikleriyle (fanFundingEvents) ilgili verileri de döndürür.

  • Mevcut kaynaklar ve yöntemlerdeki güncellemeler

    • snippet.type özelliği artık kaynağın bir 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 alımını 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ı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ı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 statistics.totalChatCount mülkünün tanımı, mülk değerinin yalnızca yayında en az bir sohbet mesajı varsa gösterileceğini belirtecek şekilde güncellendi.

    • liveChatMessage kaynak gü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 aynı hatayı zaten 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) hatasını 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ın yanı sıra sohbetle ilgili yönetim işlevlerini de destekler.

      Kaynaklar
      liveChatMessage Bu kaynak, YouTube canlı sohbetindeki bir mesajı temsil eder. YouTube, kısa mesajlar ve Fan Funding 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) 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 destek fonu etkinliklerini listeler. Kanala ait bir canlı yayın sırasında canlı sohbet üzerinden başlatılan Destek Olma 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, liveChatMessage kaynağının yöntemlerini kullanarak sohbet mesajlarını alabilir, ekleyebilir veya silebilirsiniz. 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ı 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 yer alıyor. 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 için 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 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. Configuration Issues for LiveStream Resources (Canlı Yayın Kaynaklarıyla İlgili Yapılandırma Sorunları) adlı yeni dokümanda, API'nin bildirdiği tüm sorunlar listelenmektedir.
      contentDetails.isReusable Akışın yeniden kullanılabilir olup olmadığını gösterir. 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 izleyicileri için çözünürlüğü 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 bulunur. 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 akışı 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'de de kullanılabilir hâle 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 Ü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 Kaynak ve liveBroadcasts.bind yöntemin 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üzeltme olup 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ıyla ilgili 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 güncel tarihe yakın olması gerektiğ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ına altyazı eklenip eklenemeyeceğini belirtir. Özellik değeri, yayın eklerken veya güncellerken ayarlanabilir ancak yayın testing veya live durumuna geçtikten sonra 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 devam edecek şekilde planlanan yayınları destekliyor. Bu değişiklikle birlikte, liveBroadcasts.insert ve liveBroadcasts.update isteklerinde artık bu özellik 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ı 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 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 contentDetails.closedCaptionsIngestionUrl'dır. Bu özellik, video akışıyla ilişkili altyazılar için alım URL'sini belirtir.

  • 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 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 özelliklerin ikisi de atlanabilir veya iki özellikten biri için 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öntemini kullanarak yayın içi reklam arası 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 – Bir yayının planlanan bitiş zamanı, planlanan başlangıç zamanından sonra olmalıdır.
    • liveBroadcasts.insert: Yayın, geçersiz bir gizlilik durumu belirtiyor.
    • liveBroadcasts.update: Kaynak, contentDetails.enableArchive özelliği için bir değer içermiyor veya ayarlamıyor.
    • liveBroadcasts.update: Kaynak, contentDetails.enableContentEncryption özelliği için bir değer içermiyor veya ayarlamıyor.
    • liveBroadcasts.update: Kaynak, contentDetails.enableDvr özelliği için bir değer içermiyor veya ayarlamıyor.
    • liveStreams.insert: Snippet başlığı 1 ila 128 karakter uzunluğunda olmalıdır.
    • liveStreams.update: Kaynak, snippet.title özelliği için bir değer içermiyor veya ayarlamıyor.

  • liveStream Kaynak dokümanları, 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ı.