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 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 | ||
part |
string Bu işlemde part parametresi iki amaca hizmet eder. Yazma işleminin ayarlanacağı ö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:
-
Şu özellikler için bir değer belirtmelisiniz:
snippet.liveChatId
snippet.type
snippet.bannedUserDetails.channelId
-
Şu ö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 ç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 |
---|---|---|
forbidden (403) |
insufficientPermissions |
Belirtilen canlı sohbette kullanıcı yasaklamak için gerekli izinlere sahip değilsiniz. |
forbidden (403) |
liveChatBanInsertionNotAllowed |
Belirtilen yasak oluşturulamıyor. İstek, sohbet sahibini veya başka bir moderatörü yasaklamaya çalışırsa bu hata oluşabilir. |
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 özelliğini doğru değere ayarladığınızdan emin olmak için ilişkili liveBroadcast kaynağını kontrol edin. |
notFound (404) |
liveChatUserNotFound |
Yasaklamaya ç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 kullanın.