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.