LiveChatBans: insert

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

Yaygın kullanım alanları

İstek

HTTP isteği

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

Yetkilendirme

Bu istek, aşağıdaki kapsamlardan en az biriyle yetkilendirme gerektirir. 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 amaca hizmet eder. 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 metni

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

  • Şu özellikler için bir değer belirtmeniz gerekir:

    • snippet.liveChatId
    • snippet.type - Aşağıdaki seçeneklerden birini belirleyin: permanent veya temporary
    • snippet.bannedUserDetails.channelId

  • Bu özellikler için değerler 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ı belirtilmektedir. Daha fazla bilgi için YouTube Live Streaming API - Hatalar 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, istekte sohbet sahibinin veya başka bir moderatörün yasaklanması denenirse oluşabilir.
invalidValue (400) invalidChannelId Belirtilen kanal kimliği bulunamadı.
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 özelliğini 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ı bulunamadı.
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ği ile yanıtını görmek için APIs Explorer kullanın.