ยกเลิกการแบนที่ป้องกันไม่ให้ผู้ใช้บางรายมีส่วนร่วมในแชทสด และทำให้ผู้ใช้กลับมาแชทได้อีกครั้ง คำขอ API ต้องได้รับอนุญาตจากเจ้าของช่องหรือผู้ดูแลแชทสดที่เชื่อมโยงกับการแบน
Use Case ทั่วไป
ส่งคำขอ
คำขอ HTTP
DELETE https://www.googleapis.com/youtube/v3/liveChat/bans
การให้สิทธิ์
คำขอนี้ต้องได้รับการให้สิทธิ์อย่างน้อย 1 ขอบเขตต่อไปนี้ (อ่านเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์)
ขอบเขต |
---|
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