Method: users.messages.modify

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת 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

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