LiveBroadcasts: control

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

İstemciler, YouTube'un besleme sunucularına gönderilen videoya yer paylaşımı ekleyerek kendi seçenek listelerini uygulamaya devam edebilir. Desteği sonlandırma duyurusunu inceleyin.

Yayın akışında görüntülenebilecek bir seçenek listesinin 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 biriyle yetkilendirme 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 parametrelerin tümü sorgu parametreleridir.

Parametreler
Gerekli parametreler
id string
id parametresi, seçenek listesinin güncellenmekte olduğu 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'dir.
İ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ği gerçekleştiğinde pozitif bir zaman farkı belirtir. Değer, yayının izleme akışının başlangıcından itibaren milisaniye cinsinden ölçülür. Bu, yayının test aşamasının başladığı zamandır. Milisaniye cinsinden belirtilse de, değer aslında yaklaşık bir değerdir ve YouTube, istenen işlemi o zamana kadar mümkün olan en yakın zamanda tamamlar.

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

Önemli: Bu parametre için yalnızca yayın akışınız gecikiyorsa belirtmelisiniz.
onBehalfOfContentOwner string
Bu parametre yalnızca doğru şekilde yetkilendirilmiş bir istekte kullanılabilir. Not: Bu parametre yalnızca YouTube içerik iş ortaklarına yöneliktir.

onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube CMS 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. İçerik sahiplerinin, her kanal için kimlik doğrulama bilgileri sağlamak zorunda kalmadan bir kez kimlik doğrulaması yaparak tüm video ve kanal verilerine erişmelerine olanak tanır. Kullanıcının kimlik doğrulaması yaptığı CMS hesabı, belirtilen YouTube içerik sahibine bağlanmalıdır.
onBehalfOfContentOwnerChannel string
Bu parametre yalnızca doğru şekilde yetkilendirilmiş bir istekte kullanılabilir. Bu parametre yalnızca uygun şekilde yetkilendirilen 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 istek onBehalfOfContentOwner parametresi için bir değer belirttiğinde zorunludur ve yalnızca bu parametreyle birlikte kullanılabilir. Ayrıca istek, onBehalfOfContentOwner parametresinin belirttiği içerik sahibine bağlı bir İYS hesabı kullanılarak yetkilendirilmelidir. 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ına sahip olan ve bunları yöneten YouTube içerik iş ortakları içindir. İçerik sahiplerinin, bir kez kimlik doğrulaması yaparak parametre değerinde belirtilen kanal adına her ayrı kanal için kimlik doğrulama bilgileri sağlamak zorunda kalmadan işlem gerçekleştirmesine olanak tanır.
walltime datetime
walltime parametresi, belirtilen seçenek listesi değişikliğinin gerçekleşeceği gerçek zamanı belirtir. Değer, ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) biçiminde belirtilir.

İstek içeriği

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 çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmaktadır. Daha fazla bilgi için lütfen hata mesajı dokümanlarına bakın.

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 canlı yayın yapma izni olmayabilir. Bu nedenle, istenen işlem için kullanıcıya yetki verilmemiş olabilir.
insufficientPermissions liveStreamingNotEnabled İsteği yetkilendiren kullanıcı, YouTube'da canlı video akışı gerçekleştiremez. Kullanıcılar, https://www.youtube.com/features adresinde daha fazla bilgiye ulaşabilir.
invalidValue (400) conflictingTimeFields Yalnızca bir 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 parametresiyle belirtilen yayın mevcut değil.
required (400) actionRequired API isteğinin en az bir işlem belirtmesi gerekir. Şu anda desteklenen tek işlem seçenek listesini etkinleştirme veya devre dışı bırakma özelliğidir.
required (400) idRequired Zorunlu id parametresi, güncellenmekte olan 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 kullanın.