Method: users.threads.modify

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

בקשת HTTP

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

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

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

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

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