API Referansı

Bu API referansında, YouTube Live Streaming API kullanılarak YouTube'da canlı yayınların ve video akışlarının nasıl planlanacağı açıklanmaktadır.

Kaynak türleri

LiveBroadcasts

liveBroadcast kaynağı, YouTube'da canlı video aracılığıyla yayınlanacak bir etkinliği temsil eder.

Bu kaynak hakkında daha fazla bilgi için kaynağın kaynak temsiline ve özelliklerinin listesine bakın.

Yöntem HTTP isteği Açıklama
https://www.googleapis.com/youtube/v3 ile göreli URI'ler
bind POST /liveBroadcasts/bind YouTube yayınını akışa bağlar veya yayın ile akış arasındaki mevcut bir bağlantıyı kaldırır. Bir yayın yalnızca bir video akışına bağlanabilir, ancak bir video akışı birden fazla yayına bağlı olabilir.
delete DELETE /liveBroadcasts Bir yayını siler.
insert POST /liveBroadcasts Yayın oluşturur.
list GET /liveBroadcasts API istek parametreleriyle eşleşen YouTube yayınlarının listesini döndürür.
transition POST /liveBroadcasts/transition YouTube canlı yayınının durumunu değiştirir ve yeni durumla ilişkili tüm işlemleri başlatır. Örneğin, bir yayının durumunu testing olarak değiştirdiğinizde YouTube, videoyu bu yayının monitör akışına iletmeye başlar. Bu yöntemi çağırmadan önce, yayınınıza bağlı akış için status.streamStatus özelliğinin değerinin active olduğunu onaylamanız gerekir.
update PUT /liveBroadcasts Bir yayını günceller. Örneğin, liveBroadcast kaynağının contentDetails nesnesinde tanımlanan yayın ayarlarını değiştirebilirsiniz.
cuepoint POST /liveBroadcasts/cuepoint Canlı yayına bir işaret noktası ekler. İşaret noktası bir reklam arasını tetikleyebilir.

LiveChatBans

liveChatBan kaynakları, bir YouTube kullanıcısını ve kullanıcının katılımının yasaklandığı bir YouTube canlı sohbetini tanımlar.

Bu kaynak hakkında daha fazla bilgi için kaynağın kaynak temsiline ve özelliklerinin listesine bakın.

Yöntem HTTP isteği Açıklama
https://www.googleapis.com/youtube/v3 ile göreli URI'lar
delete DELETE /liveChat/bans Belirli bir kullanıcının canlı sohbete katkıda bulunmasını engelleyen ve böylece kullanıcının sohbete yeniden katılmasını engelleyen yasağı kaldırır. API isteği, kanal sahibi veya yasakla ilişkili canlı sohbetin moderatörü tarafından yetkilendirilmelidir.
insert POST /liveChat/bans Belirli bir kullanıcının canlı sohbete katılmasını yasaklar. API isteği, kanal sahibi veya yasakla ilişkili canlı sohbetin moderatörü tarafından yetkilendirilmelidir.

LiveChatMessages

liveChatMessage kaynağı, YouTube canlı sohbetindeki bir sohbet mesajını temsil eder. Bu kaynakta, yeni yayınlanan kısa mesaj veya takipçi bağışları etkinliği gibi çeşitli mesaj türleriyle ilgili ayrıntılar yer alabilir.

Canlı yayınlar için varsayılan olarak etkinleştirilen canlı sohbet özelliği, canlı etkinlik devam ederken kullanılabilir. (Etkinlik sona erdikten sonra söz konusu etkinlik için canlı sohbet kullanılamaz.)

Bu kaynak hakkında daha fazla bilgi için kaynağın kaynak temsiline ve özelliklerinin listesine bakın.

Yöntem HTTP isteği Açıklama
https://www.googleapis.com/youtube/v3 ile göreli URI'lar
delete DELETE /liveChat/messages Bir sohbet mesajını siler. API isteği, kanal sahibi veya yasakla ilişkili canlı sohbetin moderatörü tarafından yetkilendirilmelidir.
insert POST /liveChat/messages Canlı sohbete mesaj ekler.
list GET /liveChat/messages Belirli bir sohbet için canlı sohbet mesajlarını listeler.

LiveChatModerators

liveChatModerator kaynağı, YouTube canlı sohbetinin moderatörünü temsil eder. Sohbet moderatörü, canlı sohbette kullanıcıları yasaklayabilir veya yasaklarını kaldırabilir, mesajları kaldırabilir ve diğer yönetim işlemlerini gerçekleştirebilir.

Bu kaynak hakkında daha fazla bilgi için kaynağın kaynak temsiline ve özelliklerinin listesine bakın.

Yöntem HTTP isteği Açıklama
https://www.googleapis.com/youtube/v3 ile göreli URI'lar
delete DELETE /liveChat/moderators Bir sohbet moderatörünü kaldırır. İstek, canlı yayın kanalının sahibi tarafından yetkilendirilmelidir.
insert POST /liveChat/moderators Sohbet için yeni bir moderatör ekler. İstek, canlı yayın kanalının sahibi tarafından yetkilendirilmelidir.
list GET /liveChat/moderators Canlı sohbet moderatörlerini listeler. İstek, canlı yayın kanalının sahibi tarafından yetkilendirilmelidir.

LiveStreams

liveStream kaynağı, YouTube'a ilettiğiniz video akışıyla ilgili bilgileri içerir. Akış, YouTube kullanıcılarına yayınlanacak içeriği sağlar. Bir liveStream kaynağı oluşturulduktan sonra bir veya daha fazla liveBroadcast kaynağına bağlanabilir.

Bu kaynak hakkında daha fazla bilgi için kaynağın kaynak temsiline ve özelliklerinin listesine bakın.

Yöntem HTTP isteği Açıklama
https://www.googleapis.com/youtube/v3 ile göreli URI'lar
delete DELETE /liveStreams Video akışını siler.
insert POST /liveStreams Video akışı oluşturur. Akış, videonuzu YouTube'a göndermenizi ve ardından videoyu kitlenize yayınlayabilmenizi sağlar.
list GET /liveStreams API istek parametreleriyle eşleşen video akışlarının listesini döndürür.
update PUT /liveStreams Video akışını günceller. Değiştirmek istediğiniz mülkler güncellenemiyorsa uygun ayarlarla yeni bir akış oluşturmanız gerekir.

SuperChatEvents

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

  • Super Chat'ler belirli bir renkle vurgulanır.
  • Super 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. Super Chat'ler hakkında daha fazla bilgi edinmek için YouTube Yardım Merkezi'ni ziyaret edin.

Bu kaynak hakkında daha fazla bilgi için kaynağın kaynak temsiline ve özelliklerinin listesine bakın.

Yöntem HTTP isteği Açıklama
https://www.googleapis.com/youtube/v3 ile göreli URI'ler
list GET /superChatEvents Son 30 gün içinde kanalın canlı yayınlarındaki Super Chat etkinliklerini listeleyin.

Kullanımdan kaldırılan kaynak türleri

FanFundingEvents

fanFundingEvent kaynağı, YouTube kanalındaki bir Hayran Bağışları etkinliğini temsil eder. Hayran Bağışları, YouTube içerik üreticilerini maddi olarak desteklemenin bir yoludur. Hayran Bağışları etkinliği, bir kullanıcı kanala tek seferlik gönüllü bir ödeme yaptığında gerçekleşir. Hayran Bağışları hakkında daha fazla bilgi edinmek için YouTube Yardım Merkezi'ne göz atın.

Bu kaynak hakkında daha fazla bilgi için kaynağın kaynak temsiline ve özelliklerinin listesine bakın.

Yöntem HTTP isteği Açıklama
https://www.googleapis.com/youtube/v3 ile göreli URI'ler
list GET /fanFundingEvents Kanalın takipçi bağışları etkinliklerini listeler. API isteği, kanal sahibi tarafından yetkilendirilmelidir.

LiveCuepoints

liveCuepoint kaynağı, yayın video akışında bir reklam arası başlatır.

Not: İşaret noktalarını kontrol etmek için kullanılan API komutu aslında YouTube Content ID API'nin bir parçasıdır ve liveBroadcast ile liveStream kaynaklarını yönetme isteklerinden farklı yetkilendirme gereksinimleri vardır.

Bu kaynak hakkında daha fazla bilgi için kaynağın kaynak temsiline ve özelliklerinin listesine bakın.

Yöntem HTTP isteği Açıklama
https://www.googleapis.com/ ile göreli URI'lar
insert POST /liveCuepoints Canlı yayına bir işaret noktası ekler. Şu anda, bu yönteme yapılan isteklerin YouTube İçerik Sahibi ile ilişkili bir hesap tarafından yetkilendirilmesi gerekir.

Sponsorlar

sponsor kaynağı, bir YouTube kanalının sponsorunu temsil eder. Sponsor, içerik üreticilere düzenli olarak maddi destek (ör. abonelik veya üyelik ücreti) sunar ve özel avantajlardan yararlanır. Örneğin, içerik üretici sohbet için yalnızca sponsorlar modunu açtığında sponsorlar sohbet edebilir.

Bu kaynak hakkında daha fazla bilgi için kaynağın kaynak temsiline ve özelliklerinin listesine bakın.

Yöntem HTTP isteği Açıklama
https://www.googleapis.com/youtube/v3 ile göreli URI'ler
list GET /sponsors Bir kanalın sponsorlarını listeler. API isteği, kanal sahibi tarafından yetkilendirilmelidir.