Method: users.messages.batchDelete

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
userId

string

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

גוף הבקשה

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

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

string

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

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יהיה ריק.

היקפי הרשאה

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

  • https://mail.google.com/

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