Method: spaces.messages.delete

מחיקת הודעה. למשל, איך מוחקים הודעות?

נדרש אימות. יש תמיכה באימות אפליקציות ובאימות משתמשים. כשמשתמשים באימות אפליקציות, הבקשות יכולות למחוק רק הודעות שנוצרו על ידי אפליקציית Chat לשיחות.

בקשת HTTP

DELETE https://chat.googleapis.com/v1/{name=spaces/*/messages/*}

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

פרמטרים של נתיב

פרמטרים
name

string

חובה. שם המשאב של ההודעה.

פורמט: spaces/{space}/messages/{message}

אם הגדרתם מזהה מותאם אישית להודעה, אתם יכולים להשתמש בערך מהשדה clientAssignedMessageId עבור {message}. לפרטים נוספים אפשר לעיין במאמר הוספת שם להודעה.

פרמטרים של שאילתה

פרמטרים
force

boolean

כשמוחקים הודעה באמצעות true, גם התשובות המשורשרות נמחקות. אם false כולל תשובות בשרשור, המחיקה תיכשל.

רלוונטי רק לאימות כמשתמש. אין לו השפעה באימות כאפליקציית Chat.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

אם הביצוע יהיה תקין, גוף התגובה יהיה ריק.

היקפי הרשאות

כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages

למידע נוסף, ניתן לעיין במדריך ההרשאות.