LiveBroadcasts: bind

Bir YouTube yayınını bir canlı yayına bağlar veya bir yayın ile canlı yayın arasındaki mevcut bağlantıyı kaldırır. Bir yayın yalnızca bir video yayınına bağlanabilir ancak bir video yayını birden fazla yayına bağlanabilir.

Yaygın kullanım alanları

İstek

HTTP isteği

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

Yetkilendirme

Bu istek, aşağıdaki kapsamlardan en az biriyle yetkilendirme gerektirir (kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinin).

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
id string
id parametresi, bir video akışına bağlanan 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 ekleyebileceğiniz part adları şunlardır: id, snippet, contentDetails ve status.
İsteğe bağlı parametreler
onBehalfOfContentOwner string
Bu parametre yalnızca doğru ş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 işlem yapan bir YouTube İYS kullanıcısını tanımladığını gösterir. Bu parametre, birçok farklı YouTube kanalına sahip 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 string
Bu parametre yalnızca doğru şekilde yetkilendirilmiş bir istekte kullanılabilir. Bu parametre yalnızca doğru ş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. Bu parametre, bir istekte onBehalfOfContentOwner parametresi için bir değer belirtildiğinde zorunludur 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. Bu sayede içerik sahipleri, her bir kanal için ayrı ayrı kimlik doğrulama bilgileri sağlamak zorunda kalmadan bir kez kimlik doğrulayabilir ve parametre değerinde belirtilen kanal adına işlemler gerçekleştirebilir.
streamId string
streamId parametresi, bir yayına bağlanan video akışının benzersiz kimliğini belirtir. Bu parametre atlanırsa API, yayın ile video akışı arasındaki mevcut tüm bağları kaldırı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 lütfen hata mesajı belgelerine bakın.

Hata türü Hata ayrıntısı Açıklama
backendError internalError Bağlama sırasında dahili bir hata oluştu.
forbidden (403) liveBroadcastBindingNotAllowed Canlı yayının mevcut durumu, yayına bağlanmasına izin vermiyor.
insufficientPermissions insufficientLivePermissions İstek, belirtilen canlı yayını almak için yetkilendirilmemiş. Daha fazla bilgi için OAuth2 kimlik doğrulamasını uygulama başlıklı makaleyi inceleyin.
insufficientPermissions liveStreamingNotEnabled İsteği yetkilendiren kullanıcının YouTube'da canlı video yayını yapmasına izin verilmiyor. Kullanıcı, https://www.youtube.com/features adresinden daha fazla bilgi edinebilir.
notFound (404) liveBroadcastNotFound id parametresiyle belirtilen yayın mevcut değil.
notFound (404) liveStreamNotFound streamId parametresiyle belirtilen akış mevcut değil.
rateLimitExceeded userRequestsExceedRateLimit Kullanıcı, belirli bir zaman aralığında çok fazla istek gönderdi.
required (400) idRequired Zorunlu id parametresi, bağlanacak yayını tanımlamalıdır.

Deneyin.

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