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

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