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

Bu sayfada, YouTube Live Streaming API değişiklikleri ve doküman güncellemeleri listelenmiştir. Bu değişiklik kaydına abone olun. Abone ol

9 Ekim 2023

Yalnızca referans olarak, hangi etiket kimliklerinin hangi Süper Etiketlerle ilişkili olduğunu bu CSV dosyasında bulabilirsiniz. Hem liveChatMessage kaynağının snippet.superStickerDetails.superStickerMetadata.stickerId özelliğinin hem de superChatEvent kaynağının snippet.superStickerMetadata.stickerId özelliğinin 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, yayına manuel olarak reklam arası eklemenize olanak tanıyan liveCuepoints özelliğine ek olarak artık yayına sabit aralıklarla otomatik olarak videonun ortasında gösterilen reklam araları ekleme özelliğini de destekliyor.

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

  • videonun ortasında gösterilen reklam araları arasındaki aralığın uzunluğu.
  • reklam işaret noktaları için planlama stratejisi. İşaretçi noktaları tüm izleyiciler için eşzamanlı olarak eklenebilir veya işaretçi noktalarının zamanlaması izleyiciye göre değişiklik gösterebilir. İkinci strateji, YouTube'un işaret noktalarını daha yüksek bir hızda planlamasına olanak tanır. Bu sayede izleyiciler, uygun olduklarında işaret noktalarını alabilir.
  • Videonun ortasında gösterilen reklamların gösterilmediği bir dönemdir. Bu özellik için yayın sahibi, videonun ortasında gösterilen reklamların belirli bir zamana kadar duraklatılmasını belirtir.

Belgelerde, bu özelliği desteklemek için yapılan aşağıdaki API değişiklikleri yansıtılmaktadır:

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

1 Ağustos 2023

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

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

    • snippet.title
    • status.privacyStatus

    Bu alanlar istekten çıkarılırsa değiştirilmez.

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 noktası eklemesine olanak tanıyan liveCuepoints.insert yönteminin yerini alır.

    Birkaç kılavuz, bu yeni yöntemin kullanılabilirliğini yansıtacak şekilde güncellendi.

  • Not: Bu, desteği sonlandırılan bir özellik duyurusudur.

    liveCuepoints.insert yöntemi kullanımdan kaldırıldı. liveCuepoints.insert yöntemine yönelik destek 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öntemine ilişkin dokümanlar kaldırıldı. Bu yöntemle ilgili kullanımdan kaldırma bildirimi Eylül 2020'de yayınlandı.

1 Ekim 2022

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

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

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

    Bu alanlar istekten çıkarılırsa değiştirilmez.

  • Eski liveBroadcast alanlarına ait 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 mülkü artık iki yeni değeri destekliyor:

    • membershipGiftingEvent
    • giftMembershipReceivedEvent

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

15 Eylül 2021

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

  • snippet.type mülkü artık iki yeni değeri destekliyor:

    • newSponsorEvent
    • memberMilestoneChatEvent

  • liveChatMessage kaynağının yeni snippet.memberMilestoneChatDetails mülkü ve alt öğeleri, Üye Dönüm Noktası Mesajları etkinliğiyle ilgili bilgileri içerir. Benzer şekilde, yeni snippet.newSponsorDetails mülkü ve alt öğeleri Yeni Sponsor etkinliği hakkında bilgi 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 belirtecek şekilde güncellendi. Bu durum, API işlevinde bir değişikliğe işaret etmez.

    Bir canlı yayını çocuklara yönelik olarak tanımlamak 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ğin sonlandırılmasıyla ilgili bir duyuru ve önceki bir desteğin sonlandırılmasıyla ilgili duyuruda yapılan bir 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 yasaklanmış (403) bir hata döndürecek ve yöntem daha sonra tamamen kaldırılacaktır. Müşteriler, YouTube'un besleme sunucularına gönderilen videoya yer paylaşımı ekleyerek kendi zaman planlamalarını uygulamaya devam edebilir.

    16 Nisan 2020'de yapılan kullanımdan kaldırma duyurusundaki kullanımdan kaldırma tarihi, başlangıçta 1 Eylül 2020 olarak planlanmıştı. Bu tarih 1 Ekim 2020'ye ertelendi. Bu nedenle, desteği sonlandırılan özellikler ve liveBroadcasts.control yönteminin desteği aynı anda sonlandırılacaktır.

17 Temmuz 2020

Not: Bu, desteği sonlandırılan bir özellikle ilgili önceki duyurunun güncellenmiş halidir.

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

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

6 Temmuz 2020

HLS üzerinden canlı YouTube içeriği yayınlama kılavuzu, birkaç değişiklikle güncellendi:

  • Medya segmenti için önerilen süre bir ila dört saniye olarak güncellendi.
  • YouTube Creator Studio'dan HLS Besleme URL'si alma hakkında bilgi edinmek için yeni bir bölüme göz atın.
  • file parametre değerini biçimlendirme talimatları, yeni HLS Besleme URL'sini tamamlama bölümüne taşındı. Bu talimatlar, HLS besleme URL'sinin YouTube API'sinden mi yoksa YouTube İçerik Stüdyosu'ndan mı alındığına bakılmaksızın geçerlidir.

Ayrıca yeni besleme protokolü karşılaştırmasında YouTube'un desteklediği besleme protokolleri, her protokol için desteklenen codec'ler ve her protokolün uygun kullanım alanları ile ilgili ek bilgiler listelenir.

16 Nisan 2020

Bu güncelleme, yeni bir mülkü ve desteği sonlandırılan bir özelliği içerir:

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

    Yayınların ömrü belgesi, contentDetails.enableAutoStart veya contentDetails.enableAutoStop özelliklerini true olarak ayarladığınızda canlı YouTube etkinliği oluşturma ve yönetmeyle ilgili adım adım açıklamalı sürecin nasıl değiştiğini açıklamak için güncellendi.

  • Not: Bu, desteği sonlandırılan bir özellik duyurusudur. Bu değişiklikler 1 Eylül 2020 tarihinde veya sonrasında geçerli olacaktır. Değişikliklerin geçerlilik kazanacağı gerçek tarihe aşağıda desteği sonlandırılma tarihi denir.

    Bu güncelleme, önemli olabilecek bir değişiklikle ilgilidir. 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ğıdakilerden herhangi biri geçerliyse uygulamanız etkilenir:

    • liveBroadcast kaynağının isDefaultBroadcast özelliğinin değerini kontrol eder. Bu özellik, desteği sonlandırılma tarihinden sonra döndürülmez.
    • liveStream kaynağının isDefaultStream özelliğinin değerini kontrol eder. Bu özellik, desteği sonlandırılma tarihinden sonra döndürülmez.
    • liveBroadcasts.list yöntemini çağırır ve broadcastType parametre değerini persistent veya all olarak ayarlar. Bu parametre, bu değişikliklerin bir parçası olarak desteğini kaybedecek. Kullanımdan kaldırılma tarihinden itibaren:
      • broadcastType parametresinin değeri persistent ise liveBroadcasts.list yöntemi herhangi bir sonuç döndürmez.
      • broadcastType parametresinin değeri all ise liveBroadcasts.list yöntemi, bu tarihten önce var olan kalıcı yayınları döndürmez.

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

    Kullanımdan kaldırılma tarihinden itibaren:

    • YouTube artık varsayılan yayınlar ve yayınlar oluşturmayacaktır. 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 aktarımı etkin durumdaysa (yani kanal, desteğin sonlandırıldığı sırada bunları canlı yayın için kullanıyorsa) devam eden yayın etkilenmez. Ancak bu yayın sona erdikten sonra kanal, varsayılan yayını ve varsayılan yayını tekrar kullanamaz.
    • Bir kanalın varsayılan yayını ve varsayılan akışı etkin olarak yayınlanmıyorsa desteğin sonlandırılması yürürlüğe girdikten sonra YouTube, video yayınlamak için bu kaynakları kullanmaya yönelik girişimleri yoksayar.

    Uygulamanız bu durumdan etkileniyorsa lütfen aşağıdaki dokümanlara göz atın. Bu dokümanlar, uygulamanızı bu değişiklikten sonra da beklendiği gibi çalışacak şekilde güncellemenize yardımcı olacaktır:

    • Yeni bir taşıma kılavuzunda, geliştiricilerin şu anda varsayılan yayınları ve akışları kullanan API istemcilerinde uygulaması gerekebilecek adımlar açıklanmaya çalışılmaktadır.
    • Yayınların yaşam döngüsü kılavuzunda, YouTube'da canlı etkinlik oluşturma ve yönetme hakkında adım adım açıklamalı bilgiler bulabilirsiniz. Her adımda, belirli bir işlemi tamamlamak için yapmanız gereken API çağrıları veya diğer işlemler açıklanmaktadır. YouTube, varsayılan yayınları ve canlı yayınları desteklemeyi bıraktığında uygulamanızın bu süreci uygulaması gerekir.

31 Mart 2020

Not: Bu, desteği sonlandırılan bir özellik duyurusudur.

sponsor kaynağı ve sponsors.list yöntemi artık kullanılmıyor olup 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 kullanmak için güncellemelidir. Yeni kaynak hakkında daha fazla bilgi edinmek için lütfen YouTube Data API düzeltme geçmişine bakın.

11 Mart 2020

HLS üzerinden canlı YouTube içeriği yayınlama kılavuzunun Besleme uç noktası bölümünde, birincil ve yedek besleme URL'lerini oluştururken kodlayıcının file= parametre değerini tamamlamak için kullanması gereken süreci açıklığa kavuşturmak amacıyla güncelleme yapıldı.

4 Şubat 2020

HLS üzerinden canlı YouTube içeriği yayınlama kılavuzu, DELETE isteklerinin isteğe bağlı olduğunu ve YouTube'un HLS uç noktasının bunları yok saydığını belirtecek şekilde güncellendi. YouTube, performans nedeniyle istemcilerin DELETE isteği göndermemesini önerir.

10 Ocak 2020

API artık YouTube'un "çocuklara özel" olarak adlandırdığı çocuklara yönelik içerikleri tanımlama özelliğini destekliyor. 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 tespit etmesine olanak tanımak için iki yeni özelliği destekler:
    • 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öntemi aracılığıyla yayın oluştururken 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, API kullanıcıları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ın, videolarınızın veya yayınlarınızın kitlesini ayarlama hakkında daha fazla bilgi için YouTube Yardım Merkezi'ne göz atın.
  • YouTube Data API'de channel kaynağı, yeni selfDeclaredMadeForKids ve madeForKids özelliklerini de destekler.

YouTube API Hizmetleri Hizmet Şartları ve Geliştirici Politikaları'nı da güncelledik. Daha fazla bilgi için lütfen YouTube API Hizmetleri Hizmet Şartları - Düzeltme Geçmişi'ni inceleyin. YouTube API Hizmetleri Hizmet Şartları ve Geliştirici Politikaları'nda yapılan değişiklikler 10 Ocak 2020 Pasifik Saati'nde yürürlüğe girecektir.

20 Ağustos 2019

HLS üzerinden canlı YouTube içeriği yayınlama rehberinin Şartlar bölümünde iki değişiklik yapıldı:

  • Her medya oynatma listesine hem kabul edilen hem de öne çıkan segmentleri eklemenin en iyi uygulama olduğunu açıklar. Bu uygulama, sunucu tarafında bir medya oynatma listesi kaybolursa bir segmentin atlanma olasılığını azaltır. Örneğin, her medya oynatma listesine en fazla iki onaylanmış segment ve en fazla beş seçkin segment ekleyebilirsiniz.
  • Artık her medya segmenti için bir medya oynatma listesi göndermek zorunludur. Bu sayede, bir medya oynatma listesi kaybolursa sunucunun hızlıca kurtarılması sağlanır. Bu uygulama daha önce öneri olarak listeleniyordu.

28 Haziran 2019

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

Yeni HLS ile YouTube'da canlı içerik yayınlama kılavuzunda, bir kodlayıcıdan YouTube'a canlı içerik yayınlamak için HLS'nin kullanımıyla ilgili yönergeler yer alır. Kılavuz, kodlayıcı tedarikçi firmalarının ürünlerine HLS yayınlama 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 vardır:

    • API Gezgini widget'ı, yetkilendirme kapsamlarını seçmenize, örnek parametre ve özellik değerleri girmenize, ardından gerçek API isteklerini göndermenize ve gerçek API yanıtlarını görmenize olanak tanır. Widget, girdiğiniz kapsamları ve değerleri kullanmak için dinamik olarak güncellenen tam kod örneklerini gösteren tam ekran bir görünüm de sunar.

    • Yaygın kullanım alanları bölümünde, sayfada açıklanan yöntemin bir veya daha fazla yaygın kullanım alanı açıklanmaktadır. Örneğin, belirli bir 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ız için örnek değerlerle doldurabilir veya tam ekran API Gezgini'ni bu değerlerle doldurulmuş şekilde açabilirsiniz. Bu değişiklikler, kendi uygulamanızda uygulamaya çalıştığınız kullanım alanı için doğrudan geçerli olan kod örneklerini görmenizi kolaylaştırmayı amaçlamaktadır.

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

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

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

25 Şubat 2019

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

  • liveChatMessage kaynağında snippet.type mülkü, kaynağın Süper Etiket hakkında bilgi içerdiğini belirtmek için artık superStickerEvent olarak ayarlanmıştır. Bu durumda kaynak, Süper Etiket hakkında ek bilgiler içeren snippet.superStickerDetails nesnesini de içerir.
  • superChatEvent kaynağındaki snippet.isSuperStickerEvent doğru/yanlış değeri, Süper Chat mesajının aynı zamanda Süper Etiket olup olmadığını belirtir. Bu durumda snippet.superStickerMetadata nesnesi, Süper Etiket ile ilgili ek ayrıntılar içerir.

5 Nisan 2018

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

3 Nisan 2017

Canlı sohbet mesajlarını listelemeyi, eklemeyi ve silmeyi gösteren yeni Java kod örnekleri eklendi. Örnekler aşağıdaki yöntemleri çağırır:

13 Şubat 2017

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

  • Mevcut kaynaklar ve yöntemlerle ilgili güncellemeler

    • liveCuepoints.insert yöntemi, onBehalfOfContentOwner parametresinin şu anda gerekli olduğunu yansıtacak şekilde güncellendi. Ayrıca, yöntemin açıklaması, bu yönteme yapılan çağrıların YouTube İçerik Sahibi ile 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öntemlerle ilgili güncellemeler

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

      Parametre değeri, i18nLanguages.list yöntemi tarafından döndürülen listeye dahil edilmiş bir dil kodu olmalıdır. Varsayılan değer en'tür. Bu, varsayılan davranışın görüntüleme dizelerini İngilizce olarak kullanılacağı şekilde biçimlendirmek olduğu anlamına gelir. Örneğin, bir dize varsayılan olarak $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 YouTube canlı yayını sırasında bir takipçi tarafından satın alınan Süper Chat mesajını temsil eder. YouTube canlı sohbet akışında Süper Chat, diğer mesajlar arasından iki şekilde öne çıkar:

      • Süper Chat'ler belirli bir renkle vurgulanır.
      • Süper Chat'ler, belirli bir süre boyunca sohbet şeridinde sabit 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 Chat'ler hakkında daha fazla bilgiyi YouTube Yardım Merkezi'nde bulabilirsiniz.

      API, bir kanalın önceki 30 gün içindeki canlı yayınlarında gerçekleşen Süper Chat etkinliklerini listelemeyi destekler. Bu yöntem, kanalın son canlı yayınındaki Takipçi Bağışları etkinlikleri (fanFundingEvents) ile ilgili verileri de döndürür.

  • Mevcut kaynaklar ve yöntemlerle ilgili güncellemeler

    • snippet.type mülkü artık kaynağın bir Süper Chat'i tanımladığını belirten superChatEvent değerini desteklemektedir.

      Ayrıca, liveChatMessage kaynağının yeni snippet.superChatDetails mülkü ve alt öğeleri, Süper Chat etkinliğiyle ilgili bilgileri 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 veya contentDetails.projection özelliği için geçersiz bir değer içerdiğini belirtmek üzere 400 (Bad Request) hataları döndürür. İki yeni hatanın hata nedenleri sırasıyla invalidEmbedSetting ve invalidProjection'dir.

12 Ocak 2017

Not: Bu, desteği sonlandırılan bir özellik 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 zengin bir güncelleme grubu sunar. Bu güncelleme, 10 Şubat 2017'den itibaren geçerli olacak Güncellenen Şartlar'a ek olarak, geliştiricilerin uyması gereken politikaları açıklamaya yardımcı olacak çeşitli destekleyici dokümanlar 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 bu destekleyici belgelerde gelecekte yapılacak değişiklikler de bu düzeltme geçmişinde açıklanacaktır. İlgili dokümandaki bir bağlantıdan, düzeltme geçmişindeki değişiklikleri listeleyen bir RSS özet akışına abone olabilirsiniz.

20 Mayıs 2016

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

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

18 Nisan 2016

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

  • Mevcut kaynaklar ve yöntemlerle ilgili güncellemeler

    • liveStream kaynak güncellemeleri

      • YouTube artık saniyede 30 veya 60 kare hızında 1440p çözünürlüklü yayınları desteklemektedir.

        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: 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ğinin desteği sonlandırıldı. cdn.format mülkü, çözünürlüğü ve kare hızını tek bir değerde belirtir.

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

        cdn.format mülkünün desteği sonlandırılmış olsa da API'nin saniyede 30 veya 60 kare hızında 1440p yayınları desteklediğini yansıtmak için artık 1440p ve 1440p_hfr olmak üzere iki yeni değeri desteklediğini unutmayın.

    • liveBroadcast kaynak güncellemeleri
    • liveChatMessage kaynak güncellemeleri

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

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

        Özellikler
        snippet.messageDeletedDetails Bu nesne, bir sohbet moderatörü tarafından silinen bir mesajla ilgili bilgileri içerir. Nesne yalnızca snippet.type mülk değeri messageDeletedEvent ise mevcuttur.
        snippet.userBannedDetails Bu nesne, sohbete katılması yasaklanan bir kullanıcıyla ilgili bilgileri içerir. Nesne, yasakla ilgili bilgileri de içerir. Örneğin, yasağın kalıcı veya geçici olup olmadığını belirtir. Yasaklar geçiciyse nesnenin özelliklerinden biri yasağın süresini belirtir.

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

  • Yeni ve güncellenmiş hatalar

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

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

      liveBroadcasts.insert ve liveBroadcasts.update yöntemleri zaten aynı hatayı destekliyor.
      liveStreams.insert liveStreams.insert yöntemi, isteğin eklemeye çalıştığı liveStream kaynağında geçersiz bir mülk değerini tanımlayan dört yeni 400 (Bad Request) hatasını destekler. Aşağıdaki listede hata nedenleri ve ilişkili oldukları özellikler belirtilmiştir:
      liveStreams.insert liveStreams.insert yöntemi, her biri isteğin eklemeye çalıştığı liveStream kaynağında gerekli bir değerin bulunmadığını belirten iki yeni 400 (Bad Request) hatası destekler. Aşağıdaki listede hata nedenleri ve ilişkili oldukları özellikler belirtilmiştir:
      Daha açık belirtmek gerekirse, 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 bir formatRequired hatası döndürür.
      • cdn.resolution için bir değer belirtirseniz ancak cdn.frameRate için belirtmezseniz API frameRateRequired hatası döndürür.
      • cdn.frameRate için bir değer belirtirseniz ancak cdn.resolution için belirtmezseniz API resolutionRequired hatası döndürür.
      liveStreams.update İstek, aşağıdaki değiştirilemeyen özelliklerden herhangi birinin değerini değiştirmeye çalışırsa liveStreams.update yöntemi bir 403 (Forbidden) hatası döndürür: Hata yanıtındaki reason, liveStreamModificationNotAllowed.

18 Aralık 2015

Avrupa Birliği (AB) yasaları, AB'deki son kullanıcılara belirli bilgilerin verilmesini ve bu kullanıcılardan izin alınmasını zorunlu kılar. Bu nedenle, Avrupa Birliği'ndeki son kullanıcılar için AB Kullanıcı Rızası Politikası'na uymanız gerekir. YouTube API Hizmet Şartlarımız'a bu şartla ilgili bir bildirim ekledik.

17 Aralık 2015

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

  • Yeni kaynaklar ve yöntemler

    • API, canlı yayınlarda sohbet işlevini desteklemek için ç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 yanı sıra sohbet için yönetim işlevlerinin alınmasını destekler.

      Kaynaklar
      liveChatMessage Bu kaynak, YouTube canlı sohbetindeki bir mesajı temsil eder. YouTube, kısa mesajlar ve Takipçi Bağışları 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 bir 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, sohbet moderatörünü tanımlar. Moderatörler, kullanıcıları sohbetten çıkarma 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 yasaklanmış bir kullanıcıyı tanımlar. Banlar geçici veya kalıcı olabilir. API, canlı sohbet yasakları ekleme ve silme yöntemlerini destekler.
      fanFundingEvents Bu kaynak, bir YouTube kanalındaki Takipçi Desteği etkinliğini temsil eder. Takipçi Bağışları, izleyicilere YouTube içerik üreticilerini tek seferlik parasal desteklerle gönüllü olarak destekleme olanağı sunar.

      API'nin fanFundingEvents.list yöntemi, bir kanalın Takipçi Bağışları etkinliklerini listeler. Kanalın sahibi olduğu canlı yayın sırasında canlı sohbet üzerinden başlatılan Takipçi Bağışları etkinlikleri, yayının canlı sohbetinde de bir fanFundingEvent mesajı tetikler.

      Takipçi Bağışları 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 sponsorların mesajlarının yanında bir rozet gösterilir. Sponsorlar, kanala özel canlı sohbetlere de katılabilir.

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

      Sponsorluklar hakkında daha fazla bilgi edinmek için YouTube Yardım Merkezi'ni ziyaret edin.

  • Mevcut kaynaklar ve yöntemlerle ilgili güncellemeler

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

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

      Bu özellik, yayınınızda altyazıların etkin olup olmadığını ve etkinse ne 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 besleme URL'sine gönderirsiniz.
      • closedCaptionsEmbedded: Altyazılar, EIA-608 ve/veya CEA-708 biçimleri kullanılarak video akışına kodlanır.
      contentDetails.enableClosedCaptions Bu özelliğin desteği 17 Aralık 2015'ten itibaren sonlandırılmıştır. 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, bir API yanıtını etkinlik yayınları, 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 bir yayındır. Kanalların varsayılan yayınları kalıcı yayınlardı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ı raporlanır:

    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 az olarak ayarlayın.

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

  • Yeni ve güncellenmiş hatalar

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

      Hata ayrıntıları
      liveBroadcasts.update
      HTTP Yanıt Koduforbidden (403)
      NedenclosedCaptionsTypeModificationNotAllowed
      AçıklamacontentDetails.closedCaptionsType değeri yalnızca yayın created veya ready durumundayken değiştirilebilir.
      liveBroadcasts.update
      HTTP Yanıt KoduinvalidValue (400)
      NedeninvalidEnableClosedCaptions
      AçıklamacanlıYayın kaynağındaki contentDetails.enableClosedCaptions özelliğinin değeri, contentDetails.closedCaptionType ayarının değeriyle uyumlu değil. Kaynağı, yalnızca iki mülkten birini içerecek şekilde değiştirin ve ardından 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ğı, YouTube'da canlı yayın sırasında yayınlanan bir yorumu içeriyor. API, bu kaynak için iki yöntemi destekler:

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

      Canlı sohbet mesajları yalnızca yayın devam ederken alınabilir ve yayınlanabilir.

  • Mevcut kaynaklar ve yöntemlerle ilgili güncellemeler

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

      Özellikler
      snippet.isDefaultStream Bu yayının kanal için varsayılan yayın olup olmadığını belirtir. Kanalın varsayılan yayını süresiz olarak mevcuttur, 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 bilgileri içerir. Bu nesne, canlı video akışının sağlığını değerlendirmenize yardımcı olacak çeşitli alt mülkler içerir.

      Özellikle status.healthStatus.configurationIssues[] nesnesi, video akışını etkileyen sorunları listeler. Canlı Yayın Kaynakları İçin Yapılandırma Sorunları adlı yeni bir dokümanda, API'nin bildirdiği tüm sorunlar listelenmektedir.
      contentDetails.isReusable Akışların yeniden kullanılabilir olup olmadığını belirtir. Yani birden fazla yayına bağlanabilir. Yayıncıların, farklı zamanlarda gerçekleşen birçok farklı yayın için aynı yayını yeniden kullanması yaygın bir durumdur.

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

      Özellikler
      snippet.isDefaultBroadcast Bu yayının kanal için varsayılan yayın olup olmadığını belirtir. YouTube kanalı canlı yayın için etkinleştirildiğinde YouTube, kanal için varsayılan bir yayın ve varsayılan bir akış oluşturur. Yayın, kanal sahibinin canlı videoyu YouTube'a nasıl gönderdiğini tanımlar. Yayın ise izleyicilerin varsayılan yayını nasıl görebileceğini belirtir. 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 bir yayın, videonun yayını izleyen kullanıcılara gösterilmesi için gereken süreyi kısaltabilir ancak yayını izleyenlerin çözünürlüğünü de etkileyebilir.
      statistics.totalChatCount Yayınla ilişkili canlı sohbet mesajlarının toplam sayısı. Yayın kullanıcı tarafından görülebilir durumdaysa ve canlı sohbet özelliği etkinse mülk ve değeri mevcuttur. Bu özelliğin, yayın sona erdikten sonra bir değer belirtmeyeceğini unutmayın. Bu nedenle, tamamlanmış bir canlı yayının arşivlenmiş videosundaki sohbet mesajlarının sayısı bu mülkte tanımlanmaz.

  • 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 olarak değiştirmenize veya bunun tam tersini yapmanıza izin vermez. Daha fazla bilgi için Yayınları ve akışları anlama başlıklı makaleyi inceleyin.

21 Mayıs 2015

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

  • YouTube artık saniyede 60 kare (fps) canlı video yayınını destekliyor. Bu sayede oyun videoları ve diğer hızlı tempolu videolar daha akıcı oynatılabilir. YouTube'da 60 fps'de canlı yayın başlattığınızda YouTube, yüksek kare hızı izlemenin henüz kullanılamadığı cihazlarda yayını 30 fps'de de sunar.

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

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

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ğine yetki veren kullanıcının YouTube'da canlı video yayınlama yetkisi yoksa liveBroadcast ve liveStream kaynaklarına yönelik tüm yöntemler bu hatayı döndürür. Kullanıcının canlı video yayınlayamamasının nedenini https://www.youtube.com/features adresindeki kanal ayarlarında bulabilirsiniz.
    rateLimitExceeded userRequestsExceedRateLimit Hem liveBroadcasts.insert hem de liveStreams.insert yöntemleri, kullanıcının belirli bir zaman aralığında çok fazla istek gönderdiğini belirtmek için bu hatayı döndürür.

2 Mayıs 2014

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

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

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

  • liveCuepoint kaynağının settings.offsetTimeMs mülkü, yayınınızda izleme akışı yoksa mülk için bir değer belirtmeniz gerekmediğini belirtecek şekilde güncellendi.

  • liveBroadcast ve liveStream kaynaklarına yönelik tüm yöntemler artık onBehalfOfContentOwner ve onBehalfOfContentOwnerChannel parametrelerini desteklemektedir. 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 belirleyebileceğinizi belirtecek şekilde güncellendi.

  • Hata dokümanlarında artık her hata türünün HTTP yanıt kodu belirtilmektedir.

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

    Hata türü Hata ayrıntısı Açıklama
    insufficientPermissions livePermissionBlocked İsteğe yetki veren 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 canlı video yayınlayamamasının nedenini https://www.youtube.com/features adresindeki kanal ayarlarında bulabilirsiniz.

  • liveBroadcasts.insert yönteminin invalidScheduledStartTime hatası, planlanan başlangıç zamanının, yayının o tarihte güvenilir bir şekilde planlanabilmesi için geçerli tarihe yeterince yakın olması gerektiğini açıkça belirtecek ş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ın için altyazıların alınıp alınamayacağını belirtir. Mülk değeri, bir yayın eklediğinizde veya güncellediğinizde 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ında kullanılacak besleme URL'sini belirtir.

  • liveBroadcast kaynağının snippet.scheduledEndTime mülkü artık süresiz olarak devam etmesi planlanan yayınları destekliyor. Bu değişiklikle birlikte, liveBroadcasts.insert ve liveBroadcasts.update isteklerinde artık mülk gerekli değildir.

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

  • Varsayılan değeri true olan liveBroadcast kaynağının contentDetails.recordFromStart mülkü artık yalnızca yayın kanalının canlı yayınlar için kayıtları devre dışı bırakmasına izin verildiğinde false olarak ayarlanabilir.

    Kanalınızın kayıtları devre dışı bırakma izni yoksa ve recordFromStart mülkü 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 mülkünü false olarak ayarlayacak şekilde güncellemeye çalışırsanız API bir modificationNotAllowed hatası döndürür.

  • liveBroadcast kaynağı artık contentDetails.enableDvr ve contentDetails.enableEmbed mülklerinin açıklamalarında bahsedilen enableArchive mülkünü içermiyor.

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

  • liveCuepoint kaynağının yeni settings.walltime mülkü, işaret noktasının ekleneceği tarih ve saati belirtir. Bir istek, bu mülk ve settings.offsetTimeMs mülkü 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, akışla ilgili bilgileri içerir. Şu anda nesnenin tek özelliği contentDetails.closedCaptionsIngestionUrl'tür. Bu özellik, video akışıyla ilişkili altyazıların besleme URL'sini belirtir.

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

  • liveBroadcasts.control yönteminin yeni walltime parametresi, liste değişikliğinin gerçekleşeceği tarih ve saati belirtmenize olanak tanır. Bir istek bu parametre ve offsetTimeMs parametresi için bir değer belirtirse API hata döndürür.

  • liveBroadcasts.list isteğine verilen API yanıtında, kind mülkünün değeri youtube#liveBroadcastList yerine youtube#liveBroadcastListResponse olarak değiştirildi.

  • liveStreams.list isteğine verilen API yanıtında, kind mülkünün değeri youtube#liveStreamList yerine youtube#liveStreamListResponse olarak değiştirildi.

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

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

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

    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 mülkü, startWithSlate olarak yeniden adlandırıldı.
    • enableArchive mülkü, recordFromStart olarak yeniden adlandırıldı.
    • slateSettings nesnesi desteği sonlandırıldı ve dokümanlardan kaldırıldı. slateSettings nesnesi veya özellikleriyle ilgili hata mesajları da kaldırıldı. Son olarak, Başlangıç kılavuzunun "Liste görüntüleme" bölümü kaldırıldı.

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

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

    • liveCuepoint kaynağının settings.cueType özelliği artık özellik değeri olarak slate değerini desteklemiyor. (Yalnızca ad değeri desteklenir.

    • liveCuepoint kaynağının settings.eventState özelliğinin desteği sonlandırıldı ve dokümanlardan kaldırıldı.

18 Mart 2013

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

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

  • API artık birkaç yeni hata döndürebilir. Aşağıdaki listede hata ve bu hatayı döndürebilecek API yöntemi 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: Sana Özel snippet'i 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'in desteklenen besleme yöntemleri olmadığını yansıtacak şekilde güncellendi. cdn.format mülkünün biçimleri listesi buna göre güncellendi ve cdn.multicastIngestionInfo nesnesi ile alt mülkleri kaynağın dokümanlarından kaldırıldı. Ayrıca http, desteklenen cdn.ingestionType değerleri listesinden kaldırıldı.