Method: users.messages.batchModify

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

בקשת HTTP

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

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

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

פרמטרים
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

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