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

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