LiveChatBans: insert

Belirli bir kullanıcının canlı sohbete katılmasını engeller. API isteği, kanal sahibi veya yasakla ilişkili canlı sohbetin bir moderatörü tarafından yetkilendirilmelidir.

Yaygın kullanım örnekleri

İstek

HTTP isteği

POST https://www.googleapis.com/youtube/v3/liveChat/bans

Yetkilendirme

Bu istek için aşağıdaki kapsamlardan en az biri ile yetkilendirme gerekir. 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
part string
part parametresi bu işlemde iki amaç için kullanılır. Yazma işleminin ayarlayacağı özelliklerin yanı sıra API yanıtının döndürdüğü özellikleri tanımlar. Parametre değerini snippet olarak ayarlayın.

İstek içeriği

İstek gövdesinde bir liveChatBan kaynağı sağlayın. Söz konusu kaynak için:

  • Aşağıdaki özellikler için bir değer belirtmeniz gerekir:

    • snippet.liveChatId
    • snippet.type
    • snippet.bannedUserDetails.channelId

  • Aşağıdaki özellikler için değer ayarlayabilirsiniz:

    • snippet.banDurationSeconds

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir liveChatBan 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) insufficientPermissions Belirtilen canlı sohbette bir kullanıcıyı yasaklamak için gerekli izinlere sahip değilsiniz.
forbidden (403) liveChatBanInsertionNotAllowed Belirtilen yasak oluşturulamıyor. Bu hata, istek sohbet sahibini veya başka bir moderatörü banlamaya çalışırsa ortaya çıkabilir.
invalidValue (400) invalidChannelId Belirtilen kanal kimliği bulunamıyor.
invalidValue (400) invalidLiveChatId İstekte belirtilen snippet.liveChatId değeri geçersiz. Doğru değere sahip olduğunuzdan emin olmak için ilişkili liveBroadcast kaynağını kontrol edin.
notFound (404) liveChatNotFound Belirtilen canlı sohbet bulunamıyor. snippet.liveChatId mülkünü doğru değere ayarladığınızdan emin olmak için ilişkili liveBroadcast kaynağını kontrol edin.
notFound (404) liveChatUserNotFound Engellemeye çalıştığınız canlı sohbet kullanıcısı bulunamıyor.
required (400) bannedUserChannelIdRequired İstek gövdesinde gönderilen liveChatBan kaynağı, snippet.bannedUserDetails.channelId özelliği için bir değer belirtmelidir.
required (400) liveChatIdRequired İstek gövdesinde gönderilen liveChatBan kaynağı, snippet.liveChatId özelliği için bir değer belirtmelidir.

Deneyin!

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