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