הסרת חסימה שמונעת ממשתמש מסוים להוסיף תוכן לצ'אט בשידור חי, וכך מאפשרת למשתמש להצטרף מחדש לצ'אט. בקשת ה-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 הזה.
תשובה
אם הפעולה בוצעה ללא שגיאות, השיטה הזו תחזיר את קוד הסטטוס 204 No Content של HTTP.
שגיאות
הטבלה הבאה מזהה את הודעות השגיאה שה-API יכול להחזיר בתגובה לקריאה ל-method הזה. פרטים נוספים זמינים במאמר הודעת שגיאה.
| סוג השגיאה | פרטי השגיאה | תיאור |
|---|---|---|
forbidden (403) |
forbidden |
אי אפשר להסיר את החסימה שצוינה. השגיאה הזו יכולה לקרות אם הבקשה אושרה על ידי מנהל אחד שמנסה להסיר חסימה של מנהל אחר. |
forbidden (403) |
insufficientPermissions |
אין לך את ההרשאות הדרושות להסרת החסימה שצוינה. |
invalidValue (400) |
invalidLiveChatBanId |
הפרמטר id מציין ערך לא חוקי. |
notFound (404) |
liveChatBanNotFound |
לא ניתן למצוא את החסימה שצוינה. |
רוצה לנסות?
אפשר להשתמש ב-APIs Explorer כדי לשלוח קריאה ל-API הזה ולראות את בקשת ה-API ואת התגובה לבקשה.