Method: users.messages.batchDelete

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

בקשת HTTP

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

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

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

פרמטרים
userId

string

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

גוף הבקשה

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

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

string

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

גוף התשובה

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

היקפי הרשאות

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

  • https://mail.google.com/

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.