הסרת חסימה שמונעת ממשתמש ספציפי להשתתף בצ'אט בשידור חי, כדי לאפשר למשתמש להצטרף מחדש לצ'אט. בקשת ה-API צריכה לקבל אישור מבעלי הערוץ או ממנהל תגובות בצ'אט בשידור חי שמשויך לחסימה.
תרחישים נפוצים לדוגמה
בקשה
בקשת HTTP
DELETE https://www.googleapis.com/youtube/v3/liveChat/bans
אישור
כדי לבצע את הבקשה הזו, צריך להעניק הרשאה עם אחת מההיקפים הבאים לפחות. למידע נוסף על אימות והרשאה, קראו את המאמר הטמעת אימות OAuth 2.0.
| היקף |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
פרמטרים
בטבלה הבאה מפורטים הפרמטרים שהשאילתה הזו תומכת בהם. כל הפרמטרים שמופיעים ברשימה הם פרמטרים של שאילתה.
| פרמטרים | ||
|---|---|---|
| פרמטרים נדרשים | ||
id |
stringהפרמטר id מזהה את החסימה מהצ'אט שרוצים להסיר. הערך מזהה באופן ייחודי גם את החסימה וגם את הצ'אט. |
|
גוף הבקשה
אל תספקו גוף בקשה כשאתם קוראים ל-method הזו.
תשובה
אם הפעולה בוצעה ללא שגיאות, ה-method מחזירה קוד סטטוס 204 No Content של HTTP.
שגיאות
בטבלה הבאה מפורטות הודעות השגיאה שה-API יכול להחזיר בתגובה לקריאה ל-method הזה. פרטים נוספים זמינים בהודעת השגיאה.
| סוג השגיאה | פרטי השגיאה | תיאור |
|---|---|---|
forbidden (403) |
forbidden |
אי אפשר להסיר את ההרחקה שצוינה. השגיאה הזו יכולה להתרחש אם בקשת ההרשאה נשלחת על ידי מנהל אחד שמנסה להסיר חסימה ממנהל אחר. |
forbidden (403) |
insufficientPermissions |
אין לך את ההרשאות הדרושות כדי להסיר את החסימה שצוינה. |
invalidValue (400) |
invalidLiveChatBanId |
הפרמטר id מציין ערך לא תקין. |
notFound (404) |
liveChatBanNotFound |
לא מצאנו את החסימה שציינת. |
רוצה לנסות?
משתמשים ב-APIs Explorer כדי להפעיל את ה-API הזה ולראות את בקשת ה-API והתגובה.