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 yöntemini destekliyor. Bir yayına manuel olarak reklam arası eklemenizi sağlayan liveCuepoints'ye ek olarak YouTube artık videonun ortasında gösterilen reklam aralarını belirli aralıklarla otomatik olarak yayınlama özelliğini de desteklemektedir.

Yayın sahibi otomatik reklamları etkinleştirirse reklam davranışının şu 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 hakkında daha fazla bilgi edinin. İş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 etkinleştirilip etkinleştirilmediğini belirtir ve işaret noktalarının planlanması için ek bilgiler 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. Dokümanlarda artık canlı yayının para kazanma bilgileri güncellenirken oluşabilecek çeşitli hatalar da tanımlanıyor.

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 bu yayına işaret noktaları eklemesine olanak tanır. Bu da 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.

    Birçok kılavuz, bu yeni yöntemin kullanılabilirliğini yansıtacak şekilde güncellenmiştir.

  • Not: Bu, desteği sonlandırılan bir özellikle ilgili duyurudur.

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

  • liveBroadcasts.control yö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ıldığında bunlar değiştirilmez.

  • Eski liveBroadcast alanları için 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ği hakkında bilgi 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ı Mesajı etkinliği hakkında bilgi içeriyor. 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üncellenmelidir.

6 Temmuz 2020

HLS Aracılığıyla Canlı YouTube İçeriği Yayınlama rehberi 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, kullanımdan kaldırma duyurusudur. Bu değişiklikler 1 Eylül 2020 tarihinde veya sonrasında geçerli olacaktır. Değişikliklerin geçerli olduğu gerçek tarih, aşağıda kullanımdan kaldırma tarihi olarak belirtilmiştir.

    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ğıdaki durumlarda başvurunuz etkilenir:

    • liveBroadcast kaynağının isDefaultBroadcast property özelliğinin değerini kontrol eder. Bu özellik, desteği sonlandırılma tarihinden sonra döndürülmez.
    • liveStream kaynağının isDefaultStream property ö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ği sonlandırılacak. 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ırma tarihi itibarıyla:

    • YouTube artık varsayılan yayınlar ve canlı 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 özellikle ilgili duyurudur.

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'de veya bu tarihten sonra artık 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 Besin 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 Aracılığıyla Canlı YouTube İçeriği Yayınlama rehberi, DELETE isteklerinin isteğe bağlı olduğunu ve YouTube'un HLS uç noktasının bunları yok saydığını belirtmek için güncellendi. Performans nedeniyle YouTube, istemcilerin DELETE istekleri göndermemelerini ö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.

Ayrıca YouTube API Hizmetleri Hizmet Şartları ve Geliştirici Politikaları da güncellendi. 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ı:

  • Bu açıklamalarda, her Medya Oynatma Listesi'ne hem onaylanan segmentleri hem de öne çıkan segmentleri dahil etmenin en iyi uygulama olduğu açıklanıyor. 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ş öne çıkan 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 desteklemektedir. 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ı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 belgeleri, 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 dokümanlarına 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 mülk 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 geçerli kullanıcının yayınları hakkında veri 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 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ınları sırasında takipçiler tarafından satın alınır.

  • liveChatMessage kaynağında snippet.type özelliği, 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 parametresinin bulunmadığını yansıtacak şekilde güncellendi.

3 Nisan 2017

Canlı sohbet mesajlarının nasıl listeleneceğini, ekleneceğini ve silineceğini 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 eklenen 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 bir 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 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 Hayran 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 destekliyor.

      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 mülkü artık 2160p değerini destekliyor.

  • Yeni ve güncellenmiş hatalar

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

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

12 Ocak 2017

Not: Bu, desteği sonlandırılan bir özellikle ilgili duyurudur.

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 YouTube'da canlı içerik yayınlama kılavuzunda, bir kodlayıcıdan YouTube'da canlı veri akışı sağlamak için DASH yayın biçimini kullanmayla ilgili yönergeler yer alır. Kodlayıcı tedarikçilerinin ürünlerine DASH yayınlama desteği eklemesine yardımcı olmak amaçlanı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üncellemesi
      • YouTube artık saniyede 30 veya 60 kare hızında 1440p çözünürlükteki akışları 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 değerleridir.
        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üncellemesi
      • liveBroadcast kaynağı aşağıdaki yeni özellikleri içerir:

        Özellikler
        contentDetails.boundStreamLastUpdateTimeMs Yayının contentDetails.boundStreamId mülkünün referans verdiği canlı yayının en son güncellendiği tarih ve saat.
        contentDetails.projection Yayının projeksiyon biçimi. Özelliğin varsayılan değeri rectangular. Tesis için geçerli değerler 360 ve rectangular değerleridir.
      • liveBroadcast kaynağını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 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, sohbet moderatörü tarafından silinen bir mesajla ilgili bilgiler içeriyor. 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, yasanın kendisiyle ilgili (yasağın kalıcı mı yoksa geçici mi olduğu) bilgileri de içerir. Ban geçiciyse nesnenin özelliklerinden biri, ban süresini belirtir.

        Bu nesne yalnızca snippet.type mülk 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ığı içinde ç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.
      • Üç özelliğin herhangi biri için bir değer belirtmezseniz API, 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 belirtir ancak cdn.resolution değerini 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 bir 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 sahibi olduğu 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 kaynak ve yöntemlerde yapılan güncellemeler

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

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

      Bu özellik, yayınınızda altyazının etkinleştirilip etkinleştirilmediğini ve sağladığınız altyazı türünün durumunu gösterir:
      • closedCaptionsDisabled: Altyazılar canlı yayın için devre dışı bırakıldı.
      • closedCaptionsHttpPost: Altyazıları, HTTP POST aracılığıyla canlı yayınınızla ilişkili bir besleme URL'sine gönderirsiniz.
      • closedCaptionsEmbedded: Altyazılar, video akışında EIA-608 ve/veya CEA-708 biçimleri kullanılarak kodlanır.
      contentDetails.enableClosedCaptions Bu mülk, 17 Aralık 2015 itibarıyla kullanımdan kaldırılmıştır. Bunun yerine contentDetails.closedCaptionsType özelliğini kullanın. Bu mülkü zaten kullanan API istemcileri için:
      • Özellik değerinin true olarak ayarlanması, contentDetails.closedCaptionsType özelliğinin closedCaptionsHttpPost olarak ayarlanmasıyla eşdeğerdir.
      • Özellik değerinin false olarak ayarlanması, contentDetails.closedCaptionsType özelliğinin closedCaptionsDisabled olarak ayarlanmasıyla eşdeğerdir.
    • liveBroadcasts.list yönteminin yeni broadcastType parametresi, API yanıtları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. 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 durum 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 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 özellikten 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 belgeler 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 durumunu 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ı başlıklı 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. Bu yayınlar farklı zamanlarda yapılıyorsa yayıncıların aynı akışı birçok farklı yayın için yeniden kullanması yaygın karşılaşılan 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 canlı yayın 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ılar için görünür olması için gereken süreyi kısaltabilir ancak yayını izleyenler için çözünürlüğü de etkileyebilir.
      statistics.totalChatCount Yayınla ilişkili canlı sohbet mesajlarının toplam sayısı. Yayın kullanıcı tarafından görü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ğeri 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ğini yetkilendiren kullanıcının YouTube'da canlı video yayını yapma özelliği etkinleştirilmediyse liveBroadcast ve liveStream kaynakları için tüm yöntemler bu hatayı döndürür. Kullanıcının canlı video akışı gerçekleştirememesinin nedenlerini açıklayan ayrıntılara https://www.youtube.com/features adresinden ulaşabilirsiniz.
    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ğlı olabileceğini ancak video akışının birden fazla yayına bağlı olabileceğ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ı için 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 söz konusu zamanda güvenilir şekilde planlanabileceği geçerli tarihe yeterince 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ı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ı için kullanılacak besleme URL'sini belirtir.

  • liveBroadcast kaynağının snippet.scheduledEndTime özelliği artık süresiz olarak devam edecek şekilde planlanmış 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, seçenek listesi değişikliğinin gerçekleşeceği tarihi ve saati belirtmenizi sağlar. 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ği hem liveBroadcastListResponse hem de liveStreamListResponse için kullanımdan kaldı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. İstek, her iki özelliği de hariç tutabilir 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ştirildi:

    • startWithSlateCuepoint özelliği, 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:

    • Dizin sayfası, Başlangıç kılavuzu ve Yayının ömrü eğiticisinde 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: Snippet başlığı 1 ile 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çim 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ı.