นำการแบนออกเพื่อไม่ให้ผู้ใช้ที่เฉพาะเจาะจงมีส่วนร่วมในแชทสด ซึ่งจะทำให้ผู้ใช้เข้าร่วมแชทได้อีกครั้ง เจ้าของช่องหรือผู้ดูแลแชทสดที่เกี่ยวข้องกับการแบนต้องให้สิทธิ์คำขอ API
กรณีการใช้งานทั่วไป
ส่งคำขอ
คำขอ HTTP
DELETE https://www.googleapis.com/youtube/v3/liveChat/bans
การให้สิทธิ์
คำขอนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตอย่างน้อย 1 รายการต่อไปนี้ ดูข้อมูลเพิ่มเติม เกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์ได้ที่หัวข้อการตรวจสอบสิทธิ์ OAuth 2.0
| ขอบเขต |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
พารามิเตอร์
ตารางต่อไปนี้แสดงรายการพารามิเตอร์ที่การค้นหานี้รองรับ พารามิเตอร์ทั้งหมดที่แสดงเป็นพารามิเตอร์การค้นหา
| พารามิเตอร์ | ||
|---|---|---|
| พารามิเตอร์ที่จำเป็น | ||
id |
stringพารามิเตอร์ id จะระบุการแบนแชทที่จะนำออก ค่านี้จะระบุทั้งการแบนและแชทอย่างไม่ซ้ำกัน |
|
เนื้อความของคำขอ
อย่าระบุเนื้อความของคำขอเมื่อเรียกใช้เมธอดนี้
คำตอบ
หากสำเร็จ เมธอดนี้จะแสดงรหัสสถานะ HTTP 204 No Content
ข้อผิดพลาด
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API อาจแสดงผลเพื่อตอบสนองต่อการเรียกใช้ เมธอดนี้ ดูรายละเอียดเพิ่มเติมได้ที่ ข้อความแสดงข้อผิดพลาด
| ประเภทข้อผิดพลาด | รายละเอียดข้อผิดพลาด | คำอธิบาย |
|---|---|---|
forbidden (403) |
forbidden |
นำการแบนที่ระบุออกไม่ได้ ข้อผิดพลาดนี้อาจเกิดขึ้นได้หากคำขอได้รับอนุญาตจากผู้ดูแลคนหนึ่งที่พยายามนำการแบนผู้ดูแลอีกคนออก |
forbidden (403) |
insufficientPermissions |
คุณไม่มีสิทธิ์ที่จำเป็นในการนำการแบนที่ระบุออก |
invalidValue (400) |
invalidLiveChatBanId |
พารามิเตอร์ id ระบุค่าที่ไม่ถูกต้อง |
notFound (404) |
liveChatBanNotFound |
ไม่พบการแบนที่ระบุ |
ลองใช้งาน
ใช้ APIs Explorer เพื่อเรียกใช้ API นี้และดูคำขอและการตอบกลับของ API