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.

Yaygın kullanım örnekleri

İstek

HTTP isteği

POST https://www.googleapis.com/youtube/v3/liveBroadcasts/transition

Yetkilendirme

Bu istek için aşağıdaki kapsamlardan en az biri ile yetkilendirme gerekir. 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 string
broadcastStatus parametresi, yayının değiştiği durumu tanımlar. Bir yayının testing veya live durumuna geçmesi için yayının bağlı olduğu akışta status.streamStatus değerinin active olması gerektiğini unutmayın.

Kabul edilen değerler şunlardır:
  • complete: Yayın sona erdi. YouTube videoyu aktarmayı durdurur.
  • live: Yayın, kitlesine gösterilir. YouTube, videoyu yayının monitör akışına ve yayın akışına aktarır.
  • testing – Yayını test etmeye başlayın. YouTube, videoyu yayının monitör akışına aktarır. Bir yayını yalnızca contentDetails.monitorStream.enableMonitorStream özelliği true olarak ayarlanmışsa testing durumuna geçirebileceğinizi unutmayın.
id string
id parametresi, başka bir duruma geçen yayının benzersiz kimliğini belirtir.
part string
part 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 dahil edebileceğiniz part adları id, snippet, contentDetails ve status'dir.
İsteğe bağlı parametreler
onBehalfOfContentOwner string
Bu 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.

onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin, parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube içerik yönetim sistemi kullanıcısını tanımladığını gösterir. Bu parametre, birçok farklı YouTube kanalına sahip ve bu kanalları yöneten YouTube içerik iş ortakları için tasarlanmıştır. Bu sayede içerik sahipleri, her kanal için kimlik doğrulama kimlik bilgilerini sağlamak zorunda kalmadan tek seferde kimlik doğrulaması yapabilir ve tüm video ve kanal verilerine erişebilir. Kullanıcının kimliğini doğruladığı içerik yönetim sistemi hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.
onBehalfOfContentOwnerChannel string
Bu 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, videonun eklendiği kanalın YouTube kanal kimliğini belirtir. Bir istek onBehalfOfContentOwner parametresi için bir değer belirttiğinde bu parametre gereklidir ve yalnızca bu parametreyle birlikte kullanılabilir. Ayrıca, istek için onBehalfOfContentOwner parametresinin belirttiği içerik sahibine bağlı bir İYS hesabı kullanılarak yetkilendirme yapılmalıdır. 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ına sahip olan ve bu kanalları yöneten YouTube içerik iş ortakları için tasarlanmıştır. İçerik sahiplerinin, her bir kanal için kimlik doğrulama kimlik bilgilerini sağlamalarına gerek kalmadan bir kez kimlik doğrulaması yapmalarına ve parametre değerinde belirtilen kanal adına işlem yapmalarına olanak tanır.

İstek içeriği

Bu yöntemi çağırırken istek gövdesi sağlamaz.

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir canlı yayın 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 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ına bağlı 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çiriliyor.
insufficientPermissions insufficientLivePermissions İstekte, canlı yayın geçişi için yetki bulunmuyor.
insufficientPermissions livePermissionBlocked İsteğe yetki veren kullanıcı şu anda YouTube'da canlı video yayınlayamıyor. Kullanıcının canlı video yayınlayamamasının nedenlerini öğrenmek için Özellik uygunluğu bölümündeki kullanıcının kanal ayarlarına bakın.
insufficientPermissions liveStreamingNotEnabled İsteğe yetki veren kullanıcının YouTube'da canlı video yayınlama izni yok. Daha fazla bilgi için Özellik uygunluğu başlıklı makaleyi inceleyin.
notFound (404) liveBroadcastNotFound id parametresi tarafından belirtilen yayın mevcut değil.
rateLimitExceeded (403) userRequestsExceedRateLimit Kullanıcı belirli bir zaman diliminde çok fazla istek göndermiştir.
required (400) idRequired Zorunlu id parametresi, durumunu değiştirmek istediğiniz yayını tanımlamalıdır.
required (400) statusRequired API isteğinde status parametresi için bir değer belirtilmelidir.

Deneyin!

Bu API'yi çağırmak ve API isteğini ve yanıtını görmek için APIs Explorer simgesini kullanın.