Method: users.messages.batchDelete

מוחק הודעות רבות לפי מזהה ההודעה. הפעולה לא מבטיחה שהודעות לא נמחקו בכלל או אפילו לא היו קיימות בכלל.

בקשת HTTP

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/batchDelete

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

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

פרמטרים
userId

string

זוהי כתובת האימייל של המשתמש. ניתן להשתמש בערך המיוחד me כדי לציין את המשתמש המאומת.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON
{
  "ids": [
    string
  ]
}
שדות
ids[]

string

המזהים של ההודעות שיש למחוק.

גוף התגובה

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

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://mail.google.com/

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