LiveChatBans: delete

นําการแบนที่ป้องกันไม่ให้ผู้ใช้บางรายมีส่วนร่วมในแชทสด เพื่ออนุญาตให้ผู้ใช้กลับมาแชทอีกครั้ง เจ้าของช่องหรือผู้ดูแลแชทสดที่เกี่ยวข้องกับการแบนต้องให้สิทธิ์คําขอ API ดังกล่าว

กรณีการใช้งานทั่วไป

ส่งคำขอ

คำขอ 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 จะระบุแบนแชทที่จะนําออก ค่านี้ระบุทั้งการแบนและแชทที่ไม่ซ้ํากัน

เนื้อหาของคำขอ

ไม่ต้องให้เนื้อหาคําขอเมื่อเรียกใช้วิธีการนี้

คำตอบ

หากสําเร็จ วิธีนี้จะแสดงผลโค้ดตอบกลับ 204 ของ HTTP (No Content)

ข้อผิดพลาด

ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API อาจแสดงเพื่อตอบสนองต่อการเรียกเมธอดนี้ โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบข้อความแสดงข้อผิดพลาด

ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
forbidden (403) forbidden นําการแบนที่ระบุออกไม่ได้ ข้อผิดพลาดนี้อาจเกิดขึ้นหากคําขอดังกล่าวได้รับอนุญาตจากผู้ดูแลคนหนึ่งที่พยายามนําการแบนผู้ดูแลรายอื่นออก
forbidden (403) insufficientPermissions คุณไม่มีสิทธิ์ที่จําเป็นในการนําการแบนที่ระบุออก
invalidValue (400) invalidLiveChatBanId พารามิเตอร์ id ระบุค่าที่ไม่ถูกต้อง
notFound (404) liveChatBanNotFound ไม่พบการแบนที่ระบุ

ลองใช้เลย

ใช้ APIs Explorer เพื่อเรียกใช้ API นี้และดูคําขอและการตอบกลับ API