Method: users.messages.modify

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

בקשת HTTP

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

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

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

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

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