LiveBroadcasts: delete

Bir yayını siler.

Yaygın kullanım örnekleri

İstek

HTTP isteği

DELETE https://www.googleapis.com/youtube/v3/liveBroadcasts

Yetkilendirme

Bu istek, aşağıdaki kapsamlardan en az birinde yetkilendirme gerektiriyor. 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
id string
id parametresi, silinmekte olan kaynağın YouTube canlı yayın kimliğini belirtir.
İ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ç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ı belirtir. 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. Bu sayede içerik sahipleri, her kanal için kimlik doğrulama kimlik bilgilerini sağlamak zorunda kalmadan tek seferde kimlik doğrulama yapabilir ve tüm video ve kanal verilerine erişebilir. Kullanıcının kimliğini doğruladığı İYS 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çindir.

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. Bu, içerik sahiplerinin her ayrı kanal için kimlik doğrulama kimlik bilgilerini sağlamaya 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 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 YouTube Live Streaming API - Errors başlıklı makaleyi inceleyin.

Hata türü Hata ayrıntısı Açıklama
forbidden (403) liveBroadcastDeletionNotAllowed Canlı yayının mevcut durumu, yayının silinmesine izin vermiyor.
insufficientPermissions insufficientLivePermissions İstekte belirtilen canlı yayını silme yetkisi yok. Daha fazla bilgi için OAuth 2.0 kimlik doğrulamasını uygulama başlıklı makaleyi inceleyin.
insufficientPermissions liveStreamingNotEnabled İsteğe yetki veren kullanıcının YouTube'da canlı video yayınlama izni yok. Kullanıcı, Özelliklere uygunluk başlıklı makalede daha fazla bilgi bulabilir.
notFound (404) liveBroadcastNotFound liveBroadcast kaynağında belirtilen id mülkü bir yayın tanımlamadı.

Deneyin!

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