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