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