Method: users.messages.batchModify

משנה את התוויות של ההודעות שצוינו.

בקשת HTTP

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

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

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

פרמטרים
userId

string

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

גוף הבקשה

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

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

string

המזהים של ההודעות שרוצים לשנות. יש מגבלה של 1,000 מזהים לכל בקשה.
addLabelIds[]

string

רשימה של מזהי תוויות להוספה להודעות.
removeLabelIds[]

string

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

גוף התשובה

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

היקפי הרשאות

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

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify

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