Method: users.threads.modify

שינוי התוויות שהוחלו על השרשור. הכלל הזה חל על כל ההודעות בשרשור.

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

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

פרמטרים
userId

string

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

string

מזהה השרשור שיש לשנות.

גוף הבקשה

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

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

string

רשימת מזהים של תוויות שצריך להוסיף לשרשור הזה. ניתן להוסיף עד 100 תוויות בכל עדכון.
removeLabelIds[]

string

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

גוף התגובה

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

היקפי הרשאות

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

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

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