LiveBroadcasts: control

Not: liveBroadcasts.control yöntemi kullanımdan kaldırıldı ve 1 Ekim 2020'de veya bu tarihten sonra çalışmayacak. Bu tarihten sonra, bu yönteme yapılan tüm çağrılar yasak (403) hatası döndürecek ve yöntem tamamen kaldırılacaktır.

İstemciler yine de YouTube'un besleme sunucularına gönderilen videoya bir yer paylaşımı ekleyerek kendi seçimlerini uygulayabilirler. Kullanımdan kaldırma duyurusuna bakın.

Yayın akışında görüntülenebilecek seçenek listesi ayarlarını kontrol eder.

Yaygın kullanım alanları

İstek

HTTP isteği

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

Yetkilendirme

Bu istek için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir (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, seçenek listesinin güncellendiği yayını benzersiz şekilde tanımlayan YouTube canlı yayın 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ı id, snippet, contentDetails ve status'tir.
İsteğe bağlı parametreler
displaySlate boolean
displaySlate parametresi, seçenek listesinin etkinleştirilip etkinleştirilmediğini belirtir.
offsetTimeMs unsigned long
offsetTimeMs parametresi, belirtilen seçenek listesi değişikliğinin gerçekleşeceği pozitif zaman farkını belirtir. Değer, yayının izleme akışının başladığı zaman olan yayın izleme süresinin başlangıcından itibaren milisaniye olarak ölçülür. Milisaniye olarak belirtilmiş olsa da değer yaklaşık bir değerdir ve YouTube, istenen işlemi bu süreye kadar mümkün olan en yakın şekilde tamamlar.

Bu parametre için bir değer belirtmezseniz YouTube işlemi en kısa sürede gerçekleştirir. Daha ayrıntılı bilgi için Başlangıç kılavuzuna bakın.

Önemli: Bu parametre için değer yalnızca yayın yayınınız gecikmişse belirtilmelidir.
onBehalfOfContentOwner string
Bu parametre yalnızca uygun bir yetkili istekte kullanılabilir. Not: Bu parametre yalnızca YouTube içerik iş ortakları içindir.

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 ve yöneticisi olan YouTube içerik iş ortakları için tasarlanmıştır. Bu sayede içerik sahipleri, her kanal için kimlik doğrulama bilgileri sağlamak zorunda kalmadan bir kez kimlik doğrulaması yapabilir ve tüm video ve kanal verilerine erişebilir. Kullanıcının kimlik doğrulaması yaptığı İYS hesabı, belirtilen YouTube içerik sahibine bağlanmalıdır.
onBehalfOfContentOwnerChannel string
Bu parametre yalnızca uygun bir yetkili istekte kullanılabilir. Bu parametre yalnızca uygun bir yetkili istekte kullanılabilir. Not: Bu parametre yalnızca YouTube içerik iş ortakları içindir.

onBehalfOfContentOwnerChannel parametresi, bir videonun eklendiği kanalın YouTube kanal kimliğini belirtir. Bu parametre, bir istek onBehalfOfContentOwner parametresi için bir değer belirttiğinde gereklidir ve yalnızca bu parametreyle birlikte kullanılabilir. Buna ek olarak, 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ğlanmalıdır.

Bu parametre, birçok farklı YouTube kanalının sahibi ve yöneticisi olan YouTube içerik iş ortakları için tasarlanmıştır. Bu özellik, içerik sahiplerinin her bir kanal için kimlik doğrulama bilgileri sağlamak zorunda kalmadan, parametre değerinde belirtilen kanal adına bir kez kimlik doğrulaması yapmasını ve işlem gerçekleştirmesini sağlar.
walltime datetime
walltime parametresi, belirtilen seçenek listesi değişikliğinin gerçekleşeceği duvar saati saatini belirtir. Değer ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) biçiminde belirtilir.

İstek metni

Bu yöntemi çağırırken bir 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 çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmaktadır. Daha fazla ayrıntı için lütfen hata mesajı dokümanlarını inceleyin.

Hata türü Hata ayrıntısı Açıklama
backendError errorDisplaySlate İstenen işlem yürütülürken bir hata oluştu.
forbidden (403) liveBroadcastControlNotAllowed İstenen işleme yalnızca yayının durumu live ise izin verilir.
insufficientPermissions insufficientLivePermissions Kullanıcının istenen işlem için yetkili olmamasının nedeni, büyük olasılıkla kullanıcının canlı yayın yapma izninin olmamasıdır.
insufficientPermissions liveStreamingNotEnabled İsteği yetkilendiren kullanıcı, YouTube'da canlı video akışı gerçekleştiremez. Kullanıcı, https://www.youtube.com/features adresinde daha fazla bilgi bulabilir.
invalidValue (400) conflictingTimeFields Yalnızca offsetTimeMs ve walltime belirtilebilir.
invalidValue (400) invalidOffsetTimeMs offsetTimeMs parametresinin değeri geçersiz. Parametre değeri pozitif olmalıdır, ancak parametre yalnızca yayının izleme akışı etkinse belirtilebilir.
invalidValue (400) invalidWalltime walltime parametresinin değeri geçersiz.
notFound (404) liveBroadcastNotFound id parametresi tarafından belirtilen yayın mevcut değil.
required (400) actionRequired API isteğinin en az bir işlem belirtmesi gerekiyor. Şu anda tek seçenek, seçenek listesini etkinleştirme veya devre dışı bırakmaktır.
required (400) idRequired Zorunlu id parametresi, güncellenen yayını tanımlamalıdır.

Deneyin.

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