LiveChatBans

משאב liveChatBan מזהה משתמש ב-YouTube וצ'אט בשידור חי ב-YouTube שהמשתמש נאסר עליו להשתתף בו.

Methods

ה-API תומך בשיטות הבאות למשאבי liveChatBans:

insert
החרגת משתמש ספציפי מהצ'אט בשידור חי. בקשת ה-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 של המשתמש שנחסם.