מוחקת באופן מיידי ולצמיתות את התווית שצוינה ומסירה אותה מכל ההודעות והשרשורים שעליהם היא חלה.
בקשת HTTP
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/labels/{id}
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
userId |
זוהי כתובת האימייל של המשתמש. ניתן להשתמש בערך המיוחד |
id |
מזהה התווית למחיקה. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
אם הביצוע יהיה תקין, גוף התגובה יהיה ריק.
היקפי הרשאות
כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.labels
למידע נוסף, ניתן לעיין במדריך ההרשאות.