Bu sayfada, YouTube Live Streaming API değişiklikleri ve doküman güncellemeleri listelenmiştir. Bu değişiklik kaydına abone olun.
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 birmonetizationDetails
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öntemininpart
parametresimonetizationDetails
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ıyanliveCuepoints.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 yenisnippet.membershipGiftingDetails
mülkü ve alt öğeleri, Üyelik Hediye Etme etkinliğiyle ilgili bilgileri içerir. Benzer şekilde, yenisnippet.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 yenisnippet.memberMilestoneChatDetails
mülkü ve alt öğeleri, Üye Dönüm Noktası Mesajı etkinliği hakkında bilgi içeriyor. Benzer şekilde, yenisnippet.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ınstatus.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ırkenstatus.selfDeclaredMadeForKids
özelliğinitrue
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ıkcontentDetails.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
veyacontentDetails.enableAutoStop
özelliklerinitrue
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
veliveBroadcast
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ınisDefaultBroadcast
property özelliğinin değerini kontrol eder. Bu özellik, desteği sonlandırılma tarihinden sonra döndürülmez.liveStream
kaynağınınisDefaultStream
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 vebroadcastType
parametre değerinipersistent
veyaall
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ğeripersistent
iseliveBroadcasts.list
yöntemi herhangi bir sonuç döndürmez.broadcastType
parametresinin değeriall
iseliveBroadcasts.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
veliveStream
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 verdiyseliveBroadcast
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, durumselfDeclaredMadeForKids
ö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ğı, yeniselfDeclaredMadeForKids
vemadeForKids
ö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ğındasnippet.type
özelliği, kaynağın Süper Etiket hakkında bilgi içerdiğini belirtmek için artıksuperStickerEvent
olarak ayarlanmıştır. Bu durumda kaynak, Süper Etiket hakkında ek bilgiler içerensnippet.superStickerDetails
nesnesini de içerir.superChatEvent
kaynağındakisnippet.isSuperStickerEvent
doğru/yanlış değeri, Süper Chat mesajının aynı zamanda Süper Etiket olup olmadığını belirtir. Bu durumdasnippet.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 yenihl
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ğeren
'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ı belirtensuperChatEvent
değerini destekliyor.Ayrıca,
liveChatMessage
kaynağının yenisnippet.superChatDetails
mülkü ve alt öğeleri, Süper Chat etkinliğiyle ilgili bilgileri içerir. -
liveStream
kaynağınıncdn.resolution
mülkü artık2160p
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
veliveBroadcasts.update
yöntemleri, eklenen veya güncellenenliveBroadcast
kaynağınıncontentDetails.enableEmbed
ya dacontentDetails.projection
özelliği için geçersiz bir değer içerdiğini belirtmek üzere400
(Bad Request
) hataları döndürür. İki yeni hatanın hata nedenleri sırasıylainvalidEmbedSetting
veinvalidProjection
'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:
liveChatMessages.list
yöntemi artıksnippet.type
değerine sahip,fanFundingEvent
olan mesajları döndürmeyecek. Benzer şekilde,liveChatMessage
kaynakları artıksnippet.fanFundingEventDetails
nesnesini içermeyecek.fanFundingEvents.list
yöntemi artık veri döndürmeyecek.
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
ve60fps
değerleridir.cdn.resolution
Gelen video verilerinin çözünürlüğü. Geçerli mülk değerleri: 1440p
,1080p
,720p
,480p
,360p
ve240p
. -
liveStream
kaynağınıncdn.frameRate
vecdn.resolution
özelliklerinin kullanıma sunulmasıyla birlikte, kaynağıncdn.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 andacdn.format
mülkü veyacdn.frameRate
vecdn.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ık1440p
ve1440p_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ğerler360
verectangular
değerleridir. -
liveBroadcast
kaynağınınstatistics.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
veuserBannedEvent
) 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ğerimessageDeletedEvent
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ızcasnippet.type
mülk değeriuserBannedEvent
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çin403
(Forbidden
) hatası döndürür. Hata nedeniuserRequestsExceedRateLimit
.liveBroadcasts.insert
veliveBroadcasts.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 yeni400
(Bad Request
) hatasını destekler. Aşağıdaki listede hata nedenleri ve ilişkili oldukları özellikler belirtilmiştir:
invalidFormat
:cdn.format
invalidFrameRate
:cdn.frameRate
invalidIngestionType
:cdn.ingestionType
invalidResolution
:cdn.resolution
liveStreams.insert
liveStreams.insert
yöntemi, her biri isteğin eklemeye çalıştığıliveStream
kaynağında gerekli bir değerin bulunmadığını belirten iki yeni400
(Bad Request
) hatası destekler. Aşağıdaki listede hata nedenleri ve ilişkili oldukları özellikler belirtilmiştir:
frameRateRequired
:cdn.frameRate
resolutionRequired
:cdn.resolution
liveStream
kaynağı eklediğinizdecdn.format
özelliği veyacdn.frameRate
vecdn.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 ancakcdn.frameRate
için belirtmezseniz APIframeRateRequired
hatası döndürür.cdn.frameRate
için bir değer belirtir ancakcdn.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 bir403
(Forbidden
) hatası döndürür:cdn.format
cdn.frameRate
cdn.ingestionType
cdn.resolution
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'ninfanFundingEvents.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 birfanFundingEvent
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'ninsponsors.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ünenewSponsorEvent
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ğininclosedCaptionsHttpPost
olarak ayarlanmasıyla eşdeğerdir. - Özellik değerinin
false
olarak ayarlanması,contentDetails.closedCaptionsType
özelliğininclosedCaptionsDisabled
olarak ayarlanmasıyla eşdeğerdir.
-
liveBroadcasts.list
yönteminin yenibroadcastType
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ınstatus.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ı fps veya daha düşük olarak ayarlayın.%(framerate)s
-
Ö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 Kodu forbidden (403)
Neden closedCaptionsTypeModificationNotAllowed
Açıklama contentDetails.closedCaptionsType
değeri yalnızca yayıncreated
veyaready
durumundayken değiştirilebilir.liveBroadcasts.update
HTTP Yanıt Kodu invalidValue (400)
Neden invalidEnableClosedCaptions
Açıklama canlı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.
Özelliklestatus.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 Kodu forbidden (403)
Neden liveStreamModificationNotAllowed
Açıklama API, 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ıncdn.format
mülkü, bu özellik için iki yeni değeri destekler:720p_hfr
ve1080p_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öntemininwalltime
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
veliveStream
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 deliveStreams.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 veliveBroadcasts.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ıncontentDetails.monitorStream.enableMonitorStream
mülkü, mülkün değeritrue
ise yayınınızılive
durumuna geçirebilmek için öncetesting
durumuna geçirmeniz gerektiğini açıklayacak şekilde güncellendi. (Mülkün değerifalse
ise yayınınızdatesting
aşaması olamaz. Bu nedenle yayını doğrudanlive
durumuna geçirebilirsiniz. -
liveCuepoint
kaynağınınsettings.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
veliveStream
kaynakları için tüm yöntemler artıkonBehalfOfContentOwner
veonBehalfOfContentOwnerChannel
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ırkensettings.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
veliveStreams.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önteminininvalidScheduledStartTime
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 yenistatus.recordingStatus
özelliği, yayının mevcut durumunu tanımlar. -
liveBroadcast
kaynağının yenicontentDetails.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ıntesting
veyalive
durumundayken güncellenemez. Bu özelliğitrue
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ınsnippet.scheduledEndTime
özelliği artık süresiz olarak devam edecek şekilde planlanmış yayınları destekliyor. Bu değişiklikle birlikte,liveBroadcasts.insert
veliveBroadcasts.update
isteklerinde artık mülk gerekli değildir.
Bu mülk için bir değer belirtmeyen birliveBroadcast
kaynağı alırsanız yayının süresiz olarak devam etmesi planlanır. Benzer şekilde,liveBroadcasts.insert
veyaliveBroadcasts.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
olanliveBroadcast
kaynağınıncontentDetails.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ğindefalse
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 birmodificationNotAllowed
hatası döndürür. -
liveBroadcast
kaynağı artıkcontentDetails.enableDvr
vecontentDetails.enableEmbed
mülklerinin açıklamalarında bahsedilenenableArchive
mülkünü içermiyor. -
liveBroadcast
kaynağınınstatus.lifeCycleStatus
mülkü için geçerli değerlerin listesi, her durumun açıklamasını içerecek şekilde güncellendi. -
liveCuepoint
kaynağının yenisettings.walltime
mülkü, işaret noktasının ekleneceği tarih ve saati belirtir. Bir istek, bu mülk vesettings.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 yenicontentDetails
nesnesi, akışla ilgili bilgileri içerir. Şu anda nesnenin tek özelliğicontentDetails.closedCaptionsIngestionUrl
'tür. Bu özellik, video akışıyla ilişkili altyazıların besleme URL'sini belirtir. -
liveStream
kaynağınınstatus.streamStatus
mülkü için geçerli değerlerin listesi, her durumun açıklamasını içerecek şekilde güncellendi. -
liveBroadcasts.control
yönteminin yeniwalltime
parametresi, seçenek listesi değişikliğinin gerçekleşeceği tarihi ve saati belirtmenizi sağlar. Bir istek bu parametre veoffsetTimeMs
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ğeriyoutube#liveBroadcastList
yerineyoutube#liveBroadcastListResponse
olarak değiştirildi. -
liveStreams.list
isteğine verilen API yanıtında,kind
mülkünün değeriyoutube#liveStreamList
yerineyoutube#liveStreamListResponse
olarak değiştirildi. -
eventId
özelliği hemliveBroadcastListResponse
hem deliveStreamListResponse
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
vewalltime
parametreleri için değerler belirtiyorsaliveBroadcasts.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çersizseliveBroadcasts.control
yöntemi bu hatayı döndürür.forbidden
enableClosedCaptionsModificationNotAllowed
contentDetails.enableClosedCaptions
değerini güncellemeye çalışırsanız ve yayının durumucreated
veyaready
değilseliveBroadcasts.update
yöntemi bu hatayı döndürür.invalidValue
conflictingTimeFields
İsteğiniz settings.offsetTimeMs
vesettings.walltime
özellikleri için değerler belirtiyorsaliveCuepoints.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ıkliveStreams.insert
yönteminin desteklediğine benzer bircdnRequired
hatasını desteklemiyor.
10 Mayıs 2013
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
YouTube artık deneysel API özelliklerini ve hizmetlerini tanımlamıyor. Bunun yerine, destek sonlandırma politikasına tabi olan YouTube API'lerinin listesini sunuyoruz.
2 Mayıs 2013
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
Yeni
liveBroadcasts.control
yöntemi, zaten devam eden bir yayının yayın akışında gösterilen bir seçenek listesinin görüntüleme ayarlarını değiştirmenize olanak tanır. Yayın akışınız gecikiyorsa istenen liste değişikliğinin gerçekleşeceği zaman kaydırmasını belirtmek için bu yöntemi de kullanabilirsiniz. -
Aşağıdaki özelliklerin tanımları, bir
liveBroadcast
kaynağınıncontentDetails
bölümünü güncellerseniz özellik değerlerinin ayarlanması gerektiğini açıklamak için güncellendi: -
liveStream
kaynağınınstatus.streamStatus
özelliği artık olası bir akış durumu olarakdeleted
değerini desteklemiyor. -
API'nin birçok hata mesajı için döndürdüğü bilgiler, belirli hataların neden oluştuğunu daha iyi açıklamak için düzeltildi. API, birkaç yeni hatayı da destekler.
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ınsettings.cueType
özelliği artık özellik değeri olarakslate
değerini desteklemiyor. (Yalnızcaad
değeri desteklenir. -
liveCuepoint
kaynağınınsettings.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 vecdn.multicastIngestionInfo
nesnesi ile alt mülkleri kaynağın dokümanlarından kaldırıldı. Ayrıcahttp
, desteklenencdn.ingestionType
değerleri listesinden kaldırıldı.