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, yayının izleme akışına video aktarmaya başlar. Bu yöntemi çağırmadan önce, yayınınızla ilişkili akışın status.streamStatus özelliğinin değerinin active olduğunu doğrulamanız gerekir.
Yaygın kullanım alanları
İstek
HTTP isteği
POST https://www.googleapis.com/youtube/v3/liveBroadcasts/transition
Yetkilendirme
Bu istek için aşağıdaki kapsamların en az biriyle yetkilendirme yapılması gerekiyor. Kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinmek için OAuth 2.0 kimlik doğrulamasını uygulama başlıklı makaleyi inceleyin.
| Kapsam |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Parametreler
Aşağıdaki tabloda, bu sorgunun desteklediği parametreler listelenmiştir. Listelenen tüm parametreler sorgu parametreleridir.
| Parametreler | ||
|---|---|---|
| Gerekli parametreler | ||
broadcastStatus |
stringbroadcastStatus parametresi, yayının değiştiği durumu tanımlar. Bir yayını testing veya live durumuna geçirmek için yayının bağlı olduğu yayının status.streamStatus değerinin active olması gerekir.Kabul edilebilir değerler şunlardır:
|
|
id |
stringid parametresi, başka bir duruma geçiş yapan yayının benzersiz kimliğini belirtir. |
|
part |
stringpart parametresi, API yanıtının içereceği bir veya daha fazla liveBroadcast kaynak özelliğinin virgülle ayrılmış listesini belirtir. Parametre değerine ekleyebileceğiniz part adları id, snippet, contentDetails ve status'dir. |
|
| İsteğe bağlı parametreler | ||
onBehalfOfContentOwner |
stringBu parametre yalnızca düzgün şekilde yetkilendirilmiş bir istekte kullanılabilir. Not: Bu parametre yalnızca YouTube içerik iş ortakları için tasarlanmıştır. onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin, parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube İYS kullanıcısını tanımladığını gösterir. Bu parametre, birçok farklı YouTube kanalının sahibi olan ve bunları yöneten YouTube içerik iş ortakları için tasarlanmıştır. Bu sayede içerik sahipleri, her kanal için ayrı ayrı kimlik doğrulama bilgileri girmek zorunda kalmadan tek bir kimlik doğrulama işlemiyle tüm video ve kanal verilerine erişebilir. Kullanıcının kimlik doğrulaması için kullandığı CMS hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır. |
|
onBehalfOfContentOwnerChannel |
stringBu parametre yalnızca uygun şekilde yetkilendirilmiş bir istekte kullanılabilir. Not: Bu parametre yalnızca YouTube içerik iş ortakları için tasarlanmıştır. onBehalfOfContentOwnerChannel parametresi, bir videonun eklendiği kanalın YouTube kanal kimliğini belirtir. Bu parametre, bir istekte onBehalfOfContentOwner parametresi için değer belirtildiğinde gereklidir ve yalnızca bu parametreyle birlikte kullanılabilir. Ayrıca, isteğin onBehalfOfContentOwner parametresinin belirttiği içerik sahibine bağlı bir İYS hesabı kullanılarak yetkilendirilmesi gerekir. Son olarak, onBehalfOfContentOwnerChannel parametre değerinin belirttiği kanal, onBehalfOfContentOwner parametresinin belirttiği içerik sahibine bağlı olmalıdır.Bu parametre, birçok farklı YouTube kanalının sahibi olan ve bunları yöneten YouTube içerik iş ortakları için tasarlanmıştır. İçerik sahiplerinin bir kez kimlik doğrulaması yapmasına ve her bir kanal için kimlik doğrulama bilgileri sağlamak zorunda kalmadan, parametre değerinde belirtilen kanal adına işlem yapmasına olanak tanır. |
|
İstek metni
Bu yöntemi çağırırken istek gövdesi sağlamayın.
Yanıt
Başarılı olursa bu yöntem, yanıt gövdesinde bir liveBroadcast kaynağı döndürür.
Hatalar
Aşağıdaki tabloda, API'nin bu yönteme yapılan bir çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmaktadır. Daha fazla bilgi için YouTube Live Streaming API - Errors (YouTube Canlı Akış API'si - Hatalar) başlıklı makaleyi inceleyin.
| Hata türü | Hata ayrıntısı | Açıklama |
|---|---|---|
backendError |
errorExecutingTransition |
Yayın durumu değiştirilirken bir hata oluştu. |
forbidden (403) |
errorStreamInactive |
Yayınla ilişkili akış etkin olmadığında istenen geçişe izin verilmez. |
forbidden (403) |
invalidTransition |
Canlı yayın, mevcut durumundan istenen duruma geçemiyor. |
forbidden (403) |
redundantTransition |
Canlı yayın zaten istenen durumda veya istenen duruma geçiş için işleniyor. |
insufficientPermissions |
insufficientLivePermissions |
İstek, canlı yayını geçiş durumuna getirme yetkisine sahip değil. |
insufficientPermissions |
livePermissionBlocked |
İsteği yetkilendiren kullanıcı şu anda YouTube'da canlı video yayınlayamıyor. Kullanıcının neden canlı video yayınlayamadığını açıklayan ayrıntılar için Özellik uygunluğu bölümündeki kullanıcı kanal ayarlarını inceleyin. |
insufficientPermissions |
liveStreamingNotEnabled |
İsteği yetkilendiren kullanıcının YouTube'da canlı video yayını yapmasına izin verilmiyor. Daha fazla bilgi için Özellik uygunluğu başlıklı makaleyi inceleyin. |
notFound (404) |
liveBroadcastNotFound |
id parametresiyle belirtilen yayın mevcut değil. |
rateLimitExceeded (403) |
userRequestsExceedRateLimit |
Kullanıcı, belirli bir zaman aralığında çok fazla istek gönderdi. |
rateLimitExceeded (403) |
concurrentBroadcastsExceedLimit |
Kanalda aynı anda yapılabilecek maksimum canlı yayın sayısına ulaşıldı. Kanalda başka bir yayının başlayabilmesi için canlı olan bir veya daha fazla yayının durdurulması gerekir. |
rateLimitExceeded (403) |
sharedIngestionBroadcastsExceedLimit |
Kanalda, besleme kaynağını paylaşan maksimum sayıda canlı yayın var. İstenen yayını başlatmak için bu yayınlardan birinin veya daha fazlasının durdurulması gerekir. |
required (400) |
idRequired |
Zorunlu id parametresi, durumunu değiştirmek istediğiniz yayını tanımlamalıdır. |
required (400) |
statusRequired |
API isteği, status parametresi için bir değer belirtmelidir. |
Deneyin.
Bu API'yi çağırmak ve API isteğini ve yanıtını görmek için APIs Explorer simgesini kullanın.