Method: users.messages.modify

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

בקשת HTTP

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

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

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

פרמטרים
userId

string

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

id

string

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

גוף הבקשה

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

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

string

רשימה של מזהי תוויות שרוצים להוסיף להודעה הזו. אפשר להוסיף עד 100 תוויות בכל עדכון.

removeLabelIds[]

string

רשימת מזהי התוויות שרוצים להסיר מההודעה הזו. בכל עדכון אפשר להסיר עד 100 תוויות.

גוף התשובה

אם הפעולה מצליחה, גוף התגובה מכיל מופע של Message.

היקפי הרשאה

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

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

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