ยกเลิกการแบนที่ป้องกันไม่ให้ผู้ใช้บางรายมีส่วนร่วมในแชทสด ซึ่งจะทำให้ผู้ใช้กลับมาเข้าร่วมแชทได้ คำขอ 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 และการตอบกลับ