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