Method: users.threads.modify

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

בקשת HTTP

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

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

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