מוחק הודעות רבות לפי מזהה ההודעה. הפעולה לא מבטיחה שהודעות לא נמחקו בכלל או אפילו לא היו קיימות בכלל.
בקשת HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/batchDelete
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
userId |
זוהי כתובת האימייל של המשתמש. ניתן להשתמש בערך המיוחד |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "ids": [ string ] } |
שדות | |
---|---|
ids[] |
המזהים של ההודעות שיש למחוק. |
גוף התגובה
אם הביצוע יהיה תקין, גוף התגובה יהיה ריק.
היקפי הרשאות
נדרש היקף OAuth הבא:
https://mail.google.com/
למידע נוסף, ניתן לעיין במדריך ההרשאות.