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
התג של המשאב הזה.
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 של המשתמש החסום.