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

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

9 Ekim 2023

Yalnızca referans olması için, bu CSV dosyasında hangi Süper Etiketler ile ilgili olan çıkartma kimliklerinin olduğunu 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

Bu API artık canlı yayınlara reklam eklemenin yeni bir yöntemini destekliyor. Yayına manuel olarak reklam araları eklemenizi sağlayan liveCuepoints özelliğine ek olarak YouTube artık videonun ortasında gösterilen reklam aralarını sabit aralıklarla yayına otomatik olarak ekleyen bir özelliği desteklemektedir.

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 zaman planlaması stratejisi sunar. İşaret noktaları, tüm görüntüleyenler için eşzamanlı olarak eklenebilir veya işaret noktalarının zamanlaması izleyiciden izleyiciye değişebilir. Bu strateji, YouTube'un işaret noktalarını daha yüksek bir hızda planlamasına olanak tanır. Bu sayede, izleyiciler uygun olduğunda işaret noktaları alabilir.
  • videonun ortasında gösterilen reklamların gösterilmediği dönem. Bu özellik için yayın sahibi, videonun ortasında gösterilen reklam eklemenin belirli bir zamana kadar duraklatıldığını belirtir.

Dokümanlarda, bu özelliği desteklemek üzere yapılan aşağıdaki API değişiklikleri açıklanmaktadır:

  • liveBroadcast kaynağı artık bir monetizationDetails nesnesi içeriyor. Nesnenin alanları, yayın için otomatik reklam eklemenin etkinleştirilip etkinleştirilmediğini gösterir ve işaret noktalarının planlanmasına ilişkin ek bilgileri belirtir.
  • liveBroadcast.list yönteminin part parametresi, monetizationDetails değerini destekler.
  • update yöntemi, canlı yayında videonun ortasında gösterilen reklamların eklenmesini belirli bir süre boyunca duraklatmak için kullanılabilir. Dokümanlar artık canlı yayının para kazanma ayrıntıları güncellenirken oluşabilecek çeşitli hatalar da tanımlanmaktadır.

1 Ağustos 2023

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

  • liveBroadcasts.update yöntemi artık şu alanlar için değer belirtilmesini gerektirmez:

    • snippet.title
    • status.privacyStatus

    Bu alanların istekten atlanması değişmeden kalır.

1 Kasım 2022

  • Yeni liveBroadcasts.cuepoint yöntemi, YouTube'da canlı yayın yayınlayan kanal sahiplerinin 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ı eklemesini sağlayan liveCuepoints.insert yönteminin yerini almıştır.

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

  • Not: Bu bir kullanımdan kaldırma duyurusudur.

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

  • liveBroadcasts.control yönteminin belgeleri kaldırıldı. Bu yöntem için Eylül 2020'de bir kullanımdan kaldırma bildirimi yayınlandı.

1 Ekim 2022

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

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

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

    Bu alanların istekten atlanması değişmeden kalır.

  • Eski liveBroadcast alanlarıyla ilgili dokümanlar kaldırıldı:

    • contentDetails.enableContentEncryption
    • contentDetails.startWithSlate

1 Nisan 2022

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

  • snippet.type özelliği artık iki yeni değeri destekliyor:

    • membershipGiftingEvent
    • giftMembershipReceivedEvent

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

15 Eylül 2021

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

  • snippet.type özelliği artık iki yeni değeri destekliyor:

    • newSponsorEvent
    • memberMilestoneChatEvent

  • liveChatMessage kaynağının yeni snippet.memberMilestoneChatDetails mülkü ve alt öğeleri, Üye Dönüm Noktası Mesajı Chat etkinliğiyle ilgili bilgileri içerir. Benzer şekilde, yeni snippet.newSponsorDetails mülkü ve alt öğeleri Yeni Sponsor etkinliğiyle ilgili bilgileri 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ı destekliyor. Hata nedeni: userRequestsExceedRateLimit.

21 Eylül 2020

  • liveBroadcast kaynağının status.madeForKids özelliğinin tanımı, özelliğin salt okunur olduğunu netleştirmek için güncellendi. Bu durum, API işlevinde bir değişikliğ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, bir kullanımdan kaldırma duyurusu ve önceki bir kullanımdan kaldırma duyurusuyla ilgili güncellemeyi içerir.

    liveBroadcasts.control yöntemi, 1 Ekim 2020'de veya sonrasında kullanımdan kaldırılacaktır. Bu tarihten sonra, bu yönteme yapılan tüm çağrılar yasak (403) hatası döndürecek ve yöntem daha sonra tamamen kaldırılacaktır. Müşteriler, YouTube'un besleme sunucularına gönderilen videoya yer paylaşımı ekleyerek kendi seçenek listelerini uygulamaya devam edebilir.

    Başlangıçta 1 Eylül 2020 için planlanan, 16 Nisan 2020 tarihinde yapılan kullanımdan kaldırma duyurusuyla ilgili kullanımdan kaldırma tarihi ertelenmiştir ve artık 1 Ekim 2020'de veya sonrasında gerçekleşecektir. Bu nedenle, söz konusu kullanımdan kaldırma duyurusunda yer alan ve liveBroadcasts.control yöntemindeki özelliklerin tümü aynı anda kullanımdan kaldırılacaktır.

17 Temmuz 2020

Not: Bu, kullanımdan kaldırma duyurusundan önce yapılmış bir güncellemedir.

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

Kodunuz hâlâ cdn.format alanını kullanıyorsa cdn.frameRate ve cdn.resolution özelliklerini kullanarak kare hızını ve çözünürlüğü ayrı olarak belirtmek için güncellenmesi gerekir.

6 Temmuz 2020

HLS Aracılığıyla Canlı YouTube İçeriği Yayınlama rehberi birkaç değişiklikle güncellendi:

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 için uygun kullanım alanlarıyla ilgili ek bilgiler listelenmektedir.

16 Nisan 2020

Bu güncelleme, yeni bir mülk ve kullanımdan kaldırma duyurusunu içeriyor:

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

    Yayın ömrü belgesi, contentDetails.enableAutoStart veya contentDetails.enableAutoStop özelliklerini true olarak ayarladığınızda canlı YouTube etkinliği oluşturma ve yönetme işleminin adım adım nasıl değiştiğini açıklayacak şekilde güncellendi.

  • Not: Bu bir kullanımdan kaldırma duyurusudur. Bu değişiklikler 1 Eylül 2020 tarihinde veya sonrasında yürürlüğe girecektir. Değişikliklerin yürürlüğe gireceği gerçek tarih, aşağıda kullanımdan kaldırma tarihi olarak kullanılmaktadır.

    Bu güncellemede, zarar verebilecek bir değişiklik açıklanmaktadır. YouTube'da canlı içerik akışı için kanalların varsayılan liveStream ve liveBroadcast kaynaklarını kullanan API istemci uygulamalarını etkiler. Özellikle kalıcı yayın ve akışla ilişkili yayın kimliği ve akış kimliği artık yeni yayın başlatmak için kullanılamaz.

    Aşağıdaki durumlarda uygulamanız etkilenir:

    • liveBroadcast kaynağının isDefaultBroadcast özelliğinin değerini kontrol eder. Bu mülk, kullanımdan kaldırma tarihinden sonra iade edilmeyecektir.
    • liveStream kaynağının isDefaultStream özelliğinin değerini kontrol eder. Bu mülk, kullanımdan kaldırma tarihinden sonra iade edilmeyecektir.
    • liveBroadcasts.list yöntemini çağırır ve broadcastType parametre değerini persistent veya all olarak ayarlar. Bu parametre, söz konusu değişikliklerin bir parçası olarak kullanımdan kaldırılacaktır. Kullanımdan kaldırma tarihi itibarıyla:
      • broadcastType parametre değeri persistent ise liveBroadcasts.list yöntemi herhangi bir sonuç döndürmez.
      • broadcastType parametre değeri all ise liveBroadcasts.list yöntemi bu tarihten önce var olan kalıcı yayınları döndürmez.

    Arka plan olarak YouTube, son birkaç yıldır canlı yayın özelliğinin etkinleştirildiği kanallar için otomatik olarak varsayılan bir yayın ve bir de varsayılan yayın oluşturdu. Varsayılan akış süresiz olarak mevcuttu, kendisiyle ilişkilendirilmiş bir başlangıç veya bitiş zamanı yoktu ve silinemedi. Benzer şekilde, varsayılan yayın kalıcı olarak kabul edildi. Her zaman vardı ve belirli bir etkinliğe bağlı değildi.

    Kullanımdan kaldırma tarihi itibarıyla:

    • YouTube artık varsayılan canlı yayınlar ve yayınlar oluşturmayacak. API istemcilerinin varsayılan kaynakları kullanmak yerine liveBroadcast ve liveStream kaynaklarını oluşturup yönetebilmesi ve bu kaynakları birbirine bağlayabilmesi gerekir.
    • Bir kanalın varsayılan yayını ve varsayılan akışı aktif olarak canlıysa, yani kullanımdan kaldırma işleminin uygulamaya konduğu tarihte kanal bunları canlı bir 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 akışı tekrar kullanamaz.
    • Kanalın varsayılan yayını ve varsayılan akışı aktif olarak canlı yayında değilse kullanımdan kaldırma süreci yürürlüğe girdikten sonra YouTube, video yayınlamak için bu kaynakları kullanma girişimlerini yoksayar.

    Başvurunuz bu durumdan etkileniyorsa lütfen aşağıdaki belgelere göz atın. Bu belgeler, bu değişikliğin ardından başvurunuzun beklendiği gibi çalışmaya devam etmesi için güncellemenize yardımcı olacaktır:

    • Yeni bir taşıma rehberinde, şu anda varsayılan yayınları ve akışları kullanan API istemcilerinde geliştiricilerin ele alması gerekebilecek adımlar açıklanmaktadır.
    • Yayın hayatı kılavuzu, YouTube'da canlı etkinlik oluşturmayı ve yönetmeyi açıklayan adım adım bir süreçte size yol gösterir. Her adımda, belirli bir işlemi tamamlamak için yapmanız gereken API çağrıları veya diğer işlemler açıklanır. YouTube varsayılan akışları ve yayınları desteklemeyi bıraktığında uygulamanızın bu süreci takip etmesi gerekir.

31 Mart 2020

Not: Bu bir kullanımdan kaldırma duyurusudur.

sponsor kaynağı ve sponsors.list yöntemi kullanımdan kaldırılmış ve bunların yerini member kaynağı ve members.list yöntemi almıştır.

sponsors.list yöntemi, 30 Eylül 2020'de veya sonrasında artık desteklenmeyecektir. API istemcileri, bunun yerine members.list yöntemini kullanmak için sponsors.list yöntemine yapılan çağrıları güncellemelidir. Yeni kaynak hakkında daha fazla bilgi için lütfen YouTube Data API düzeltme geçmişine bakın.

11 Mart 2020

HLS Aracılığıyla Canlı YouTube İçeriği Yayınlama kılavuzunun Besleme uç noktası bölümü, kodlayıcının birincil ve yedek besleme URL'lerini oluştururken file= parametre değerini tamamlamak için kullanması gereken süreci netleştirmek amacıyla güncellendi.

4 Şubat 2020

HLS 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ı belirtecek şekilde güncellendi. YouTube, performansı korumak amacıyla istemcilerin DELETE istekleri göndermemesini önerir.

10 Ocak 2020

API artık YouTube'un "çocuklara özel" olarak adlandırdığı çocuklara yönelik içerikleri tanımlama özelliğini destekliyor. 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 edebilmesi için iki yeni mülkü desteklemektedir:
    • selfDeclaredMadeForKids özelliği, içerik üreticilerin canlı yayının çocuklara yönelik olup olmadığını belirtmesine olanak tanır. Bu özellik, liveBroadcasts.insert yöntemiyle yayın oluştururken ayarlanabilir. Bu özelliğin yalnızca kanal sahibi API isteğini yetkilendirdiyse liveBroadcast kaynaklarını içeren API yanıtlarına dahil edileceğini unutmayın.
    • madeForKids özelliği, tüm API kullanıcılarının yayının "çocuklara özel" durumunu alabilmesini sağlar. Örneğin, durum selfDeclaredMadeForKids özelliğinin değerine göre belirlenebilir. Kanalınız, videolarınız veya yayınlarınızın kitlesini ayarlama hakkında daha fazla bilgi için YouTube Yardım Merkezi'ne bakın.
  • YouTube Data API'deki channel kaynağı, yeni selfDeclaredMadeForKids ve madeForKids özelliklerini de destekler.

YouTube API Hizmetleri Hizmet Şartları'nı 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'ne göre yürürlüğe girecektir.

20 Ağustos 2019

HLS Aracılığıyla Canlı YouTube İçeriği Yayınlama kılavuzunun Şartlar bölümü iki değişiklikle güncellendi:

  • Her Medya Oynatma Listesi'ne hem onaylanan segmentleri hem de önemli segmentleri eklemenin en iyi uygulama olduğu açıklanıyor. Bu uygulama, sunucu tarafında bir Medya Oynatma Listesi'nin kaybolması durumunda segmentin atlanma olasılığını azaltır. Örneğin, her Medya Oynatma Listesi'ne en fazla iki onaylanmış segment ve beş bekleyen segment ekleyebilirsiniz.
  • Artık her Medya Segmenti için bir Medya Oynatma Listesi göndermek zorunludur. Bu, bir Medya Oynatma Listesi'nin kaybolması durumunda sunucunun hızlı bir şekilde kurtarabilmesini sağlar. Bu uygulama daha önce öneri olarak listeleniyordu.

28 Haziran 2019

YouTube artık HLS beslemesini destekliyor. Bu nedenle liveStream kaynağının ingestionType özelliği, HLS kullanılarak YouTube'a beslenen akışları tanımlamak için yeni hls değerini destekler.

Yeni HLS üzerinden canlı YouTube içeriği yayınlama kılavuzu, kodlayıcıdan YouTube'a canlı içerik akışı yapmak için HLS'yi kullanma kurallarını sağlar. Kılavuz, kodlayıcı tedarikçi firmalarının ürünlerine HLS yayınlama desteği eklemelerine yardımcı olmayı amaçlar.

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çıklayacak ve API Gezgini widget'ı aracılığıyla dinamik, yüksek kaliteli kod örnekleri sağlayacak şekilde güncellendi. Örnek için liveBroadcasts.list yönteminin dokümanlarına bakın. Sayfalarda artık API yöntemlerini açıklayan iki yeni öğe var:

    • API Gezgini widget'ı, yetkilendirme kapsamlarını seçmenizi, örnek parametre ve özellik değerlerini girmenizi, ardından gerçek API isteklerini göndermenizi ve gerçek API yanıtlarını görmenizi sağlar. Widget, girdiğiniz kapsamları ve değerleri kullanmak için dinamik olarak güncellenen tam kod örneklerini gösteren tam ekran 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 almak veya geçerli kullanıcının yayınlarıyla ilgili verileri almak için liveBroadcasts.list yöntemini çağırabilirsiniz.

      API Gezgini'ni kullanım alanınız için örnek değerlerle doldurmak veya bu değerleri önceden doldurulmuş olarak tam ekran API Gezgini'ni açmak için bu bölümdeki bağlantıları kullanabilirsiniz. Bu değişikliklerin amacı, kendi uygulamanızda uygulamaya çalıştığınız kullanım alanı için doğrudan uygulanabilecek kod örneklerini görmenizi kolaylaştırmaktır.

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

  • Kod örnekleri sayfasında da yukarıda açıklanan özelliklerin tümünü sunan yeni bir kullanıcı arayüzü bulunur. Bu aracı kullanarak farklı yöntemlerin kullanım alanlarını keşfedebilir, API Gezgini'ne değerleri 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ıyla ilgili dokümanlar, her iki kaynağın da artık Süper Etiketler hakkında bilgi içerebileceği gerçeğini yansıtacak şekilde güncellendi. Super Stickers, resim içeren bir Süper Chat mesajı türüdür. Diğer Süper Chat'lerde olduğu gibi, Süper Etiket mesajı da YouTube canlı yayını sırasında bir takipçi tarafından satın alınır.

  • Bir liveChatMessage kaynağında, kaynağın Süper Etiket hakkında bilgi içerdiğini belirtmek için snippet.type özelliği artık superStickerEvent olarak ayarlanır. Bu durumda, kaynak Süper Etiket hakkında ek bilgilerin bulunduğu snippet.superStickerDetails nesnesini de içerir.
  • Bir superChatEvent kaynağındaki snippet.isSuperStickerEvent boole değeri, Süper Chat mesajının aynı zamanda bir 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ının 2017'nin başlarında kullanımdan kaldırılmış olan fanFundingEvents artık içermediği gerçeğini yansıtacak şekilde güncellendi.

3 Nisan 2017

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

13 Şubat 2017

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

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

    • liveCuepoints.insert yöntemi, onBehalfOfContentOwner parametresinin şu anda zorunlu olduğu gerçeğini 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şkilendirilmiş bir hesap tarafından yetkilendirilmesi gerektiğini belirtecek şekilde güncellenmiştir.

9 Şubat 2017

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

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

    • superChatEvents.list yönteminin yeni hl parametresi, snippet.displayString özellik değerinin belirli bir dilin kurallarına göre biçimlendirilmesi gerektiğini belirtmenizi sağlar. Bu mülkün tanımı da uygun şekilde güncellendi.

      Parametre değeri, i18nLanguages.list yöntemi tarafından döndürülen listeye eklenmiş bir dil kodu olmalıdır. Varsayılan değer en şeklindedir. Bu, varsayılan davranıştır. Yani ekran dizelerini İngilizcede kullanılacakları gibi biçimlendirirler. Örneğin, varsayılan olarak bir dize $1,00 yerine $1.00 şeklinde biçimlendirilir.

1 Şubat 2017

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

  • Yeni kaynaklar ve yöntemler

    • Yeni superChatEvent kaynağı, bir takipçinin YouTube canlı yayını sırasında satın aldığı Super Chat mesajını temsil eder. YouTube canlı sohbet akışında Süper Chat'ler, diğer mesajlar arasında iki şekilde öne çıkar:

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

      Super Chat'in rengi, sohbet şeridinde kalma süresi 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.

      Bu API, bir kanalın son 30 gün içinde gerçekleştirdiği canlı yayınlardaki Süper Chat etkinliklerini listeleme yöntemini 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öntemlerde yapılan güncellemeler

    • snippet.type özelliği artık kaynağın bir Süper Chat'i açıkladığını belirten superChatEvent değerini destekliyor.

      Ayrıca, liveChatMessage kaynağının yeni snippet.superChatDetails mülkü ve alt öğeleri Süper Chat etkinliği hakkında bilgi içerir.

    • liveStream kaynağının cdn.resolution özelliği artık 2160p değerini destekliyor.

  • Yeni ve güncellenen 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 göstermek üzere 400 (Bad Request) hataları döndürür. İki yeni hatanın hata nedenleri sırasıyla invalidEmbedSetting ve invalidProjection şeklindedir.

12 Ocak 2017

Not: Bu bir kullanımdan kaldırma duyurusudur.

Yeni Super Chat özelliğinin yayınlanmasıyla birlikte YouTube, Hayran Bağışları özelliğini kullanımdan kaldırdı ve Takipçi Bağışları 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:

  • Yeni yayınlanan YouTube API Hizmetleri Hizmet Şartları ("Güncellenen Şartlar"), YouTube Mühendislik ve Geliştiriciler Blogu'nda ayrıntılı olarak ele alınmıştır ve mevcut Hizmet Şartları'nda kapsamlı güncellemeler içermektedir. 10 Şubat 2017'den itibaren yürürlüğe girecek Güncellenen Şartlar'a ek olarak bu güncelleme, geliştiricilerin uyması gereken politikaların açıklanmasına 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çıklanmıştır. Ayrıca, Güncellenen Şartlar'da veya bu destekleyici belgelerde yapılacak değişiklikler de söz konusu düzeltme geçmişinde açıklanacaktır. Düzeltme geçmişindeki RSS özet akışı listesinde yapılan değişikliklere ilgili dokümandaki bir bağlantıdan abone olabilirsiniz.

20 Mayıs 2016

YouTube artık DASH beslemesini desteklemektedir. Bu doğrultuda, liveStream kaynağının ingestionType özelliği, DASH kullanarak YouTube'a aktarılan akışları tanımlamak için yeni dash değerini destekler.

Yeni DASH aracılığıyla Canlı YouTube İçeriği Yayınlama kılavuzu, bir kodlayıcıdan YouTube'daki canlı verilerin akışı için DASH Yayınlama biçiminin kullanımıyla ilgili yönergeler içermektedir. Kodlayıcı tedarikçi firmalarının, ürünlerine DASH yayınlama desteği eklemelerine yardımcı olmak amacıyla tasarlanmıştır.

18 Nisan 2016

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

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

    • liveStream kaynak güncellemesi

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

        Ayrıca liveStream kaynağı, gelen video verilerinin kare hızını ve çözünürlüğünü belirtmek için yeni özellikleri içerir:

        Özellikler
        cdn.frameRate Gelen video verilerinin kare hızı. Geçerli değerler 30fps ve 60fps'dir.
        cdn.resolution Gelen video verilerinin çözünürlüğü. Geçerli mülk değerleri şunlardır: 1440p, 1080p, 720p, 480p, 360p ve 240p.

      • liveStream kaynağının cdn.frameRate ve cdn.resolution özelliklerinin kullanıma sunulmasıyla birlikte kaynağın cdn.format desteği sonlandırılmıştır. cdn.format özelliği, çözünürlüğü ve kare hızını tek bir değerde belirtir.

        Yeni desteklenen alanlara geçiş yapmanızı öneririz. Bu arada cdn.format çalışmaya devam ediyor. Ayrıca, cdn.format mülkü ya da cdn.frameRate ve cdn.resolution mülkleri için değer belirttiğiniz sürece canlı yayın ekleme istekleri hâlihazırda başarılı olur. Üç mülkün tamamı için değer sağlarsanız değerlerin uyumsuz olması durumunda API hata döndürebilir.

        cdn.format özelliği kullanımdan kaldırılmış olsa da, artık saniyede 30 veya 60 kare hızında gerçekleşen 1440p akışlara yönelik API desteğini yansıtmak için 1440p ve 1440p_hfr olmak üzere iki yeni değeri destekliyor.

    • liveBroadcast kaynak güncellemesi

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

        Özellikler
        contentDetails.boundStreamLastUpdateTimeMs Yayının contentDetails.boundStreamId mülkü tarafından referans verilen canlı yayının en son güncellendiği tarih ve saat.
        contentDetails.projection Yayının projeksiyon biçimi. Mülkün varsayılan değeri: rectangular. Mülk için geçerli değerler 360 ve rectangular'dir.

      • liveBroadcast kaynağının statistics.totalChatCount özelliğinin tanımı, özellik değerinin yalnızca yayında en az bir sohbet mesajı olması durumunda görüneceğini belirtecek şekilde güncellendi.

    • liveChatMessage kaynak güncellemesi

      • snippet.type özelliği, aşağıdaki maddede açıklanan yeni özelliklere karşılık gelen iki yeni değeri (messageDeletedEvent ve userBannedEvent) destekler. snippet.authorChannelId özelliğinin tanımı, özellik değerinin bu yeni mesaj türleri için neleri tanımladığını açıklayacak şekilde de 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 özellik değeri messageDeletedEvent ise mevcuttur.
        snippet.userBannedDetails Bu nesne, sohbete katılması yasaklanan bir kullanıcıyla ilgili bilgiler içeriyor. Nesne aynı zamanda yasağın kendisi hakkında, diğer bir deyişle yasağın kalıcı mı yoksa geçici mi olduğu hakkında da bilgiler içerir. Yasak geçiciyse nesnenin özelliklerinden biri yasağın süresini belirtir.

        Bu nesne yalnızca snippet.type özellik değeri userBannedEvent olduğunda mevcuttur.

  • Yeni ve güncellenen 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ı desteklemektedir.
      liveStreams.insert liveStreams.insert yöntemi, isteğin eklemeye çalıştığı liveStream kaynağında geçersiz bir özellik değerini tanımlayan dört yeni 400 (Bad Request) hatasını destekler. Aşağıdaki listede hata nedenleri ve ilişkilendirildikleri özellikler tanımlanmaktadır:
      liveStreams.insert liveStreams.insert yöntemi iki yeni 400 (Bad Request) hatasını destekler. Bu hataların her biri, gerekli değerin, isteğin eklemeye çalıştığı liveStream kaynağında olmadığını gösterir. Aşağıdaki listede hata nedenleri ve ilişkilendirildikleri özellikler tanımlanmaktadır:
      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 hiçbiri için değer belirtmezseniz API bir formatRequired hatası döndürür.
      • cdn.resolution için bir değer belirtir ancak cdn.frameRate için belirtmezseniz API bir frameRateRequired hatası döndürür.
      • cdn.frameRate için bir değer belirtir ancak cdn.resolution için belirtmezseniz API bir resolutionRequired hatası döndürür.
      liveStreams.update İstek, aşağıdaki değiştirilemez özelliklerin herhangi birinin değerini değiştirmeye çalışırsa liveStreams.update yöntemi 403 (Forbidden) hatası döndürür: Hata yanıtındaki reason değeri: liveStreamModificationNotAllowed.

18 Aralık 2015

Avrupa Birliği (AB) yasaları, AB'deki son kullanıcılara belirli açıklamalar yapılmasını ve bu kullanıcılardan izin alınmasını zorunlu kılar. Bu nedenle, Avrupa Birliği'ndeki son kullanıcılar söz konusu olduğunda AB Kullanıcı Rızası Politikası'na uymanız gerekmektedir. YouTube API Hizmet Şartlarımıza 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

    • Bu API, canlı yayınlarda sohbet işlevini desteklemek için birçok yeni kaynağı desteklemektedir. YouTube, aktif canlı yayınlar sırasında canlı sohbet işlevini destekler. Bu kaynaklar ve yöntemleri, sohbet mesajlarının alınmasını ve sohbet için yönetim işlevlerini destekler.

      Kaynaklar
      liveChatMessage Bu kaynak, YouTube canlı sohbetindeki bir mesajı temsil eder. YouTube, kısa mesajlar ve Hayran Bağışları etkinlikleri de dahil olmak üzere çeşitli mesaj türlerini destekler. Bazı mesaj türleri, yalnızca sponsorlara özel bir dönemin başlangıcı veya sohbetin sonu gibi sohbetin belirli bir aşamasını 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ın sohbetten çıkmasını engelleme veya mesajları kaldırma gibi bazı yönetimsel işlevleri gerçekleştirebilir. API, canlı sohbet moderatörlerini listeleme, ekleme ve silme yöntemlerini destekler.
      liveChatBans Bu kaynak, belirli bir canlı sohbette mesaj yayınlaması yasaklanan bir kullanıcıyı tanımlar. Yasaklar geçici veya kalıcı olabilir. API, canlı sohbet yasağı ekleme ve silme yöntemlerini destekler.
      fanFundingEvents Bu kaynak, YouTube kanalındaki bir Hayran Bağışları etkinliğini temsil eder. Takipçi bağışları, izleyicilerin YouTube içerik üreticilerini tek seferlik maddi destekle gönüllü olarak desteklemesini sağlar.

      API'nin fanFundingEvents.list yöntemi, kanalın Hayran Bağışları etkinliklerini listeler. Takipçi bağışları, kanala ait canlı yayın sırasında canlı sohbet üzerinden başlatılan etkinlikler de yayının canlı sohbetine bir fanFundingEvent mesajı gönderilmesini tetikler.

      YouTube Yardım Merkezi'nde Takipçi Bağışları hakkında daha fazla bilgi edinin.
      sponsors sponsor kaynağı, bir YouTube kanalının sponsorunu tanımlar. Sponsor, kanala aylık ücret öder. Kanalın canlı sohbetlerinde sponsor mesajlarının yanında bir rozet gösterilir ve sponsorlar, kanal sponsorlarına özel canlı sohbetlere (bu tür durumlarda özel olarak) katılabilir.

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

      YouTube Yardım Merkezi'nde sponsorluklar hakkında daha fazla bilgi edinebilirsiniz.

  • Mevcut kaynaklar 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ı sohbete katılmasını engelleyebilir veya mevcut yasakları kaldırabilirsiniz.
      contentDetails.closedCaptionsType Not: Bu özellik, contentDetails.enableClosedCaptions özelliğinin yerini alır.

      Bu özellik, yayınınız için altyazıların etkin olup olmadığını ve etkin durumdaysa ne tür altyazı sağladığınızı belirtir:
      • closedCaptionsDisabled: Canlı yayın için 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 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 özelliği halihazırda kullanan API istemcileri için:
      • Özellik değerinin true değerine ayarlanması, contentDetails.closedCaptionsType özelliğinin closedCaptionsHttpPost değerine ayarlanmasıyla eşdeğerdir.
      • Özellik değerinin false değerine ayarlanması, contentDetails.closedCaptionsType özelliğinin closedCaptionsDisabled değerine ayarlanmasıyla eşdeğerdir.

    • liveBroadcasts.list yönteminin yeni broadcastType parametresi, bir API yanıtını etkinlik yayınlarını, kalıcı yayınları veya tüm yayınları içerecek şekilde filtrelemenize olanak tanır.

      Kalıcı yayın, her zaman var olan ve belirli bir etkinliğe bağlı olmayan yayınlardır. Özel olarak belirtmek gerekirse, bir kanalın varsayılan yayını kalıcı bir yayındır ve bu yayına YouTube İçerik Stüdyosu'ndaki Canlı Yayın Kontrol Paneli'nden erişilebilir. Kanalın diğer yayınları etkinlik yayınlarıdır.

  • liveStream kaynağının status.healthStatus.configurationIssues[].type alanı aşağıdaki yeni durum hatalarını rapor eder:

    Hatalar
    audioTooManyChannels Sesin ikiden fazla kanalı olmasına rağmen yalnızca bir (mono) veya iki (stereo) kanal desteklenir. Lütfen ses kanallarının sayısını düzeltin.
    frameRateHigh Geçerli kare hızı çok yüksek. Lütfen kare hızını %(framerate)s fps veya daha düşük bir değere ayarlayın.

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

  • Yeni ve güncellenen hatalar

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

      Hata ayrıntıları
      liveBroadcasts.update
      HTTP Yanıt Koduforbidden (403)
      NedenclosedCaptionsTypeModificationNotAllowed
      AçıklamacontentDetails.closedCaptionsType değeri yalnızca yayın created veya ready durumundayken değiştirilebilir.
      liveBroadcasts.update
      HTTP Yanıt KoduinvalidValue (400)
      NedeninvalidEnableClosedCaptions
      AçıklamaliveBroadcast kaynağında, contentDetails.enableClosedCaptions özelliğinin değeri contentDetails.closedCaptionType ayarının değeriyle uyumsuz. Kaynağı bu iki özellikten yalnızca birini içerecek şekilde değiştirip isteği yeniden gönderin.

19 Ağustos 2015

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

  • Yeni kaynaklar ve yöntemler

    • Not: liveChat kaynağı ve yöntemleriyle ilgili belgeler gizlidir ve yalnızca belirli YouTube iş ortakları tarafından görülebilir.

      Yeni liveChat kaynağında, YouTube'daki canlı yayında yayınlanan bir yorum yer alır. API, bu kaynak için iki yöntemi destekler:

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

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

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

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

      Özellikler
      snippet.isDefaultStream Bu canlı yayının kanal için varsayılan yayın olup olmadığını belirtir. Bir kanalın varsayılan akışı süresiz olarak bulunur, kendisiyle ilişkilendirilmiş bir başlangıç ya da bitiş zamanı yoktur ve silinemez. Varsayılan akışların işleyiş şekli hakkında daha fazla bilgi için mülkün tanımına bakın.
      status.healthStatus Bu nesne, akış sorunlarını tanımlamak, teşhis etmek ve çözmek için kullanılabilecek bilgiler içerir. Nesne, canlı video akışının durumunu değerlendirmenize yardımcı olacak bir dizi alt özellik içerir.

      Özellikle status.healthStatus.configurationIssues[] nesnesi, video akışını etkileyen sorunları listeler. Canlı Yayın Kaynakları için Yapılandırma Sorunları adlı yeni dokümanda, API'nin bildirdiği tüm sorunlar listelenir.
      contentDetails.isReusable Akışın yeniden kullanılabilir olup olmadığını belirtir. Başka bir deyişle, birden fazla yayına bağlanabilir. Yayınlar farklı zamanlarda yayınlanıyorsa yayıncıların aynı akışı birçok farklı yayın için 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. Bir YouTube kanalı canlı yayın için etkinleştirildiğinde, YouTube kanal için varsayılan bir yayın ve varsayılan bir yayın oluşturur. Akış, kanal sahibinin canlı videoyu YouTube'a nasıl gönderdiğini tanımlar. Yayın, izleyicilerin varsayılan akışı nasıl görebileceğidir. Varsayılan yayınların nasıl çalıştığı hakkında daha fazla bilgi için özelliğin tanımına bakın.
      contentDetails.enableLowLatency Bu yayının düşük gecikmeli akış için kodlanıp kodlanmayacağını belirtir. Düşük gecikmeli akış, videonun yayını izleyen kullanıcılara görünür hale gelmesi için gereken süreyi azaltabilir. Bununla birlikte, yayını izleyenler için çözünürlüğü de etkileyebilir.
      statistics.totalChatCount Yayınla ilişkili toplam canlı sohbet mesajı sayısı. Yayın kullanıcı tarafından görülebiliyorsa ve canlı sohbet özelliği etkinleştirilmişse mülk ve değeri mevcuttur. Bu özelliğin yayın sona erdikten sonra değer belirtmeyeceğini unutmayın. Dolayısıyla bu mülk, tamamlanmış bir canlı yayının arşivlenmiş videosu için sohbet mesajı sayısını tanımlamaz.

  • Yeni ve güncellenen hatalar

    • API, yeni liveChat kaynağı için tanımlanan hatalara ek olarak aşağıdaki yeni hatayı destekler:

      Hata ayrıntıları
      liveStreams.update
      HTTP Yanıt Koduforbidden (403)
      NedenliveStreamModificationNotAllowed
      AçıklamaAPI, yeniden kullanılabilen bir akışı yeniden kullanılamaz olacak şekilde değiştirmenize (veya tam tersi) izin vermez. Daha fazla bilgi için Yayınları ve Akışları Anlama başlıklı makaleye bakın.

21 Mayıs 2015

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

  • YouTube artık saniyede 60 kare (fps) hızında canlı video akışını desteklemektedir. Bu, oyunlar ve diğer hızlı aksiyon videoları için daha akıcı oynatma anlamına gelir. YouTube'da 60 fps'de bir canlı yayın başlattığınızda YouTube, yüksek kare hızlı izlemenin henüz kullanılamadığı cihazlarda 30 fps'de yayının kullanılabilmesini de sağlar.

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

    Bu özellik hakkında daha fazla bilgi için YouTube İçerik Üreticileri Blogu'na göz atın.

21 Ağustos 2014

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

  • liveBroadcasts.control yönteminin walltime parametresinin tanımı, özellik değerinin ISO 8601 biçiminde (YYYY-MM-DDThh:mm:ss.sssZ) belirtildiğini gösterecek şekilde güncellendi.

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

    Hata türü Hata ayrıntısı Açıklama
    insufficientPermissions liveStreamingNotEnabled API isteğini yetkilendiren kullanıcı YouTube'da canlı video yayını için etkinleştirilmemişse liveBroadcast ve liveStream kaynakları için tüm yöntemler bu hatayı döndürür. Kullanıcının neden canlı video akışı yapamadığıyla ilgili ayrıntılar, https://www.youtube.com/features adresinde kullanıcının kanal ayarlarında bulunabilir.
    rateLimitExceeded userRequestsExceedRateLimit Hem liveBroadcasts.insert hem de liveStreams.insert yöntemleri, kullanıcının belirli bir zaman aralığı içinde ç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 belgelerde yapılan bir düzeltmedir. Temel API işlevi değişmemiştir.

  • liveBroadcast kaynağının contentDetails.monitorStream.enableMonitorStream özelliği, özelliğin değeri true olduğunda live durumuna geçirmeden önce yayınınızı testing durumuna geçirmeniz gerektiğini açıklayacak şekilde güncellendi. (Özelliğin değeri false ise yayınınız testing aşaması içeremez. Dolayısıyla yayını doğrudan live durumuna geçirebilirsiniz.

  • liveCuepoint kaynağının settings.offsetTimeMs özelliği, yayınınızda izleme akışı yoksa özellik için değer belirtmemeniz gerektiği belirtilecek ş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şkilendirilmiş farklı kanallar için API isteklerini tamamlamak amacıyla aynı yetkilendirme kimlik bilgilerini kullanmanıza olanak tanır.

  • liveCuepoints.insert yönteminin dokümanları, bu yöntemi çağırırken settings.walltime özelliği için bir değer ayarlayabileceğinizi belirtecek şekilde güncellendi.

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

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

    Hata türü Hata ayrıntısı Açıklama
    insufficientPermissions livePermissionBlocked İsteği yetkilendiren kullanıcı YouTube'da canlı video akışı gerçekleştiremiyorsa liveBroadcasts.insert, liveBroadcasts.transition ve liveStreams.insert yöntemleri bu hatayı döndürür. Kullanıcının neden canlı video akışı yapamadığıyla ilgili ayrıntılar, https://www.youtube.com/features adresinde kullanıcının kanal ayarlarında bulunabilir.

  • liveBroadcasts.insert yönteminin invalidScheduledStartTime hatası, planlanan başlangıç saatinin geçerli tarihe bir yayının o zamana güvenilir şekilde planlanabileceği kadar 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, altyazıların yayın için beslenip alınamayacağını belirtir. Özellik değeri, bir yayın eklerken veya güncellerken ayarlanabilir. Ancak yayın testing veya live durumuna geçtikten sonra güncellenemez. Bu özelliği true olarak ayarlarsanız yayına bağlı liveStream kaynağı, yayının altyazıları için kullanılacak besleme URL'sini belirtir.

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

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

  • liveBroadcast kaynağının zaten varsayılan değeri true olan contentDetails.recordFromStart özelliği, artık yalnızca yayın yapan kanalın canlı yayınlarda kayıtları devre dışı bırakmasına izin veriliyorsa false olarak ayarlanabilir.

    Kanalınızın kayıtları devre dışı bırakma izni yoksa ve recordFromStart özelliği false olarak ayarlanmış bir yayın eklemeye çalışırsanız API Forbidden hatası döndürür. Ayrıca kanalınız bu izne sahip değilse ve recordFromStart özelliğini false olarak ayarlamak için bir yayını güncellemeye çalışırsanız API modificationNotAllowed hatası döndürür.

  • liveBroadcast kaynağı artık contentDetails.enableDvr ve contentDetails.enableEmbed özelliklerinin açıklamalarında bahsedilen enableArchive özelliğini içermiyor.

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

  • liveCuepoint kaynağının yeni settings.walltime özelliği, işaret noktasının eklenmesi gereken tarih ve saati belirtir. İstek, bu özellik ve settings.offsetTimeMs özelliği için bir değer belirten 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'dır. Bu özellik, video akışıyla ilişkili altyazıların besleme URL'sini belirtir.

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

  • liveBroadcasts.control yönteminin yeni walltime parametresi, bir seçenek listesi değişikliğinin gerçekleşeceği tarih ve saati belirtmenizi sağlar. Bir istek bu parametre ve offsetTimeMs parametresi için değer belirtiyorsa API hata döndürür.

  • Bir liveBroadcasts.list isteğine verilen API yanıtında, kind özelliğinin youtube#liveBroadcastList olan değeri youtube#liveBroadcastListResponse olarak değiştirildi.

  • Bir liveStreams.list isteğine verilen API yanıtında, kind özelliğinin youtube#liveStreamList olan değeri youtube#liveStreamListResponse olarak değiştirildi.

  • eventId özelliği, hem liveBroadcastListResponse hem de liveStreamListResponse üzerinden 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ğer 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 özelliklerinin değerlerini belirtiyorsa liveCuepoints.insert yöntemi bu hatayı döndürür. İstek, her iki özelliği de atlayabilir veya iki özellikten biri için bir değer belirtebilir.

    Ayrıca liveStreams.update yöntemi, liveStreams.insert yönteminin desteklediğine benzer bir cdnRequired hatasını artık desteklemez.

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 mülkü, startWithSlate olarak yeniden adlandırıldı.
    • enableArchive mülkü, recordFromStart olarak yeniden adlandırıldı.
    • slateSettings nesnesi kullanımdan kaldırıldı ve dokümanlardan kaldırıldı. slateSettings nesnesi veya özellikleriyle ilgili hata mesajları da kaldırıldı. Son olarak, Başlarken kılavuzunun "Seçenek Seçeneklerini Görüntüleme" bölümü kaldırılmıştır.

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

    • Dizin sayfası, Başlangıç kılavuzu ve Bir yayının yaşamı eğiticisinde artık bu işlevden bahsedilmiyor.

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

    • liveCuepoint kaynağının settings.eventState özelliği kullanımdan kaldı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çıklayacak ve mümkün olduğunda bu hataların nasıl düzeltileceği konusunda yol gösterici bilgiler sağlayacak şekilde güncellendi.

  • API artık birkaç yeni hata döndürebilir. Aşağıdaki listede, hata ve o hatayı döndürebilecek API yöntemi tanımlanmıştır:

    • liveBroadcasts.insert – Yayının planlanan bitiş zamanı, planlanan başlangıç saatinden sonra olmalıdır.
    • liveBroadcasts.insert – Yayında geçersiz bir gizlilik durumu belirtilmiş.
    • liveBroadcasts.update: Kaynak, contentDetails.enableArchive özelliği için bir değer içermiyor veya içermiyor.
    • liveBroadcasts.update: Kaynak, contentDetails.enableContentEncryption özelliği için bir değer içermiyor veya içermiyor.
    • liveBroadcasts.update: Kaynak, contentDetails.enableDvr özelliği için bir değer içermiyor veya içermiyor.
    • liveStreams.insert – Snippet başlığı 1 ila 128 karakter uzunluğunda olmalıdır.
    • liveStreams.update: Kaynak, snippet.title özelliği için bir değer içermiyor veya içermiyor.

  • liveStream kaynak dokümanları, daha önce belirtildiği gibi çoklu yayın ve WebM'nin besleme yöntemlerini desteklemediğini yansıtacak şekilde güncellendi. cdn.format özelliğinin biçim listesi uygun şekilde güncellendi ve cdn.multicastIngestionInfo nesnesi ile alt özellikleri kaynağın dokümanlarından kaldırıldı. Ayrıca http, desteklenen cdn.ingestionType değerleri listesinden kaldırıldı.