API Referansı

Bu API referansında, YouTube Live Streaming API'yi kullanarak YouTube'da canlı yayın ve video yayını planlama hakkında bilgi verilmektedir.

Kaynak türleri

LiveBroadcasts

liveBroadcast kaynağı, YouTube'da canlı video üzerinden yayınlanacak bir etkinliği temsil eder.

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

Yöntem HTTP isteği Açıklama
https://www.googleapis.com/youtube/v3 ile ilgili URI'ler
bind POST /liveBroadcasts/bind Bir YouTube yayınını bir akışa bağlar veya yayın ile akış arasındaki mevcut bağlamayı kaldırır. Bir yayın yalnızca bir video akışına bağlanabilir ancak bir video akışı birden fazla yayına bağlanabilir.
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 söz konusu yayının monitör yayınına aktarmaya başlar. Bu yöntemi çağırmadan önce, yayınınıza bağlı akış için status.streamStatus mülkünün 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 işaret noktası ekler. İşaretçi noktası bir reklam arasını tetikleyebilir.

LiveChatBans

liveChatBan kaynağı, bir YouTube kullanıcısını ve kullanıcının katılmasının yasaklandığı bir YouTube canlı sohbetini tanımlar.

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

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

LiveChatMessages

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

Canlı sohbet özelliği, canlı yayınlar için varsayılan olarak etkindir ve canlı etkinlik etkinken kullanılabilir. (Etkinlik sona erdikten sonra canlı sohbet özelliği kullanılamaz.)

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

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

LiveChatModerators

liveChatModerator kaynağı, YouTube canlı sohbet moderatörünü temsil eder. Sohbet moderatörleri, kullanıcıları sohbetten engelleyebilir veya sohbetten engellemeyi kaldırabilir, mesajları kaldırabilir ve canlı sohbet için diğer yönetim işlemlerini gerçekleştirebilir.

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

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

LiveStreams

liveStream kaynağı, YouTube'a aktardığınız video akışıyla ilgili bilgileri içerir. Akış, YouTube kullanıcılarına yayınlanacak içeriği sağlar. Oluşturulan bir liveStream kaynağı, bir veya daha fazla liveBroadcast kaynağına bağlanabilir.

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

Yöntem HTTP isteği Açıklama
https://www.googleapis.com/youtube/v3 ile ilgili URI'ler
delete DELETE /liveStreams Bir video akışını siler.
insert POST /liveStreams Video akışı oluşturur. Akış, videonuzu YouTube'a göndermenize olanak tanır. YouTube, videonuzu kitlenize yayınlayabilir.
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 özellikler güncellenemiyorsa doğru ayarlarla yeni bir akış oluşturmanız gerekir.

SuperChatEvents

superChatEvent kaynağı, bir YouTube canlı yayını sırasında bir takipçi tarafından satın alınan Süper Chat mesajını temsil eder. YouTube canlı sohbet akışında Süper Chat, diğer mesajlar arasından iki şekilde öne çıkar:

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

Süper Chat'in rengi, sohbet şeridinde sabit kalacağı süre ve maksimum mesaj uzunluğu, satın alma tutarına göre belirlenir. Süper Chat'ler hakkında daha fazla bilgi için YouTube Yardım Merkezi'ni ziyaret edin.

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

Yöntem HTTP isteği Açıklama
https://www.googleapis.com/youtube/v3 ile ilgili URI'ler
list GET /superChatEvents Bir kanalın son 30 gün içindeki canlı yayınlarında gerçekleşen Süper Chat etkinliklerini listeler.

Desteği sonlandırılan kaynak türleri

FanFundingEvents

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

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

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

LiveCuepoints

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

Not: İşaretçi noktalarını kontrol etmeye yönelik 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 koşullarına sahiptir.

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

Yöntem HTTP isteği Açıklama
https://www.googleapis.com/ ile ilgili URI'ler
insert POST /liveCuepoints Canlı yayına işaret noktası ekler. Şu anda bu yöntemle yapılan istekler, YouTube içerik sahibiyle ilişkili bir hesap tarafından yetkilendirilmelidir.

Sponsorlar

sponsor kaynağı, bir YouTube kanalının sponsorunu temsil eder. Sponsorlar, içerik üreticilere abonelik veya üyelik ücreti gibi düzenli olarak parasal destek sağlar ve özel avantajlardan yararlanır. Örneğin, içerik üretici bir sohbet için yalnızca sponsorlara özel modu etkinleştirdiğinde sponsorlar sohbet edebilir.

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

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