LiveChatBans

ทรัพยากร liveChatBan จะระบุผู้ใช้ YouTube และแชทสดของ YouTube ที่ผู้ใช้ถูกห้ามไม่ให้เข้าร่วม

เมธอด

API รองรับวิธีการต่อไปนี้สำหรับทรัพยากร liveChatBans

แทรก
ห้ามผู้ใช้บางรายไม่ให้เข้าร่วมแชทสด คำขอ API ต้องได้รับอนุญาตจากเจ้าของช่องหรือผู้ดูแลแชทสดที่เชื่อมโยงกับการแบน ลองใช้เลย
ลบ
นำการแบนที่ป้องกันไม่ให้ผู้ใช้รายใดรายหนึ่งมีส่วนร่วมในแชทสดออก ซึ่งจะทำให้ผู้ใช้รายนั้นกลับมาเข้าร่วมแชทได้ คำขอ API ต้องได้รับอนุญาตจากเจ้าของช่องหรือผู้ดูแลแชทสดที่เชื่อมโยงกับการแบน ลองใช้เลย

การนําเสนอทรัพยากร

โครงสร้าง JSON ต่อไปนี้แสดงรูปแบบของทรัพยากร liveChatBans

{
  "kind": "youtube#liveChatBan",
  "etag": etag,
  "id": string,
  "snippet": {
    "liveChatId": string,
    "type": string,
    "banDurationSeconds": unsigned long,
    "bannedUserDetails": {
      "channelId": string
    }
  }
}

พร็อพเพอร์ตี้

ตารางต่อไปนี้จะกำหนดพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้

พร็อพเพอร์ตี้
kind string
ระบุประเภทของทรัพยากร API ค่าจะเป็น youtube#liveChatBan
etag etag
Etag ของทรัพยากรนี้
id string
รหัสที่ YouTube กำหนดเพื่อระบุการแบนโดยไม่ซ้ำกัน
snippet object
ออบเจ็กต์ snippet จะระบุผู้ใช้ที่ถูกแบนและแสดงรายละเอียดเกี่ยวกับการแบน
snippet.liveChatId string
แชทสดที่มีการแบน ระบบจะแสดงรหัสแชทสดที่เชื่อมโยงกับการออกอากาศในพร็อพเพอร์ตี้ snippet.liveChatId ของliveBroadcast ทรัพยากร
snippet.type string
ประเภทการห้าม

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • permanent
  • temporary
snippet.banDurationSeconds unsigned long
ระยะเวลาของการระงับ ตั้งค่าพร็อพเพอร์ตี้นี้เฉพาะในกรณีที่ประเภทของการแบนคือ temporary ค่าเริ่มต้นคือ 300 (5 นาที)
snippet.bannedUserDetails object
ออบเจ็กต์นี้มีข้อมูลที่ระบุตัวผู้ใช้ที่ถูกแบน
snippet.bannedUserDetails.channelId string
รหัสช่อง YouTube ของผู้ใช้ที่ถูกแบน