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 ของผู้ใช้ที่ถูกแบน