Method: users.threads.modify
修改套用至討論串的標籤。這項設定會套用至討論串中的所有郵件。
HTTP 要求
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}/modify
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
userId |
string
使用者的電子郵件地址。特殊值 me 可用來表示已通過驗證的使用者。
|
id |
string
要修改的執行緒 ID。
|
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
{
"addLabelIds": [
string
],
"removeLabelIds": [
string
]
} |
欄位 |
addLabelIds[] |
string
要加入這個討論串的標籤 ID 清單。每次更新時,最多可以新增 100 個標籤。
|
removeLabelIds[] |
string
要從這個討論串中移除的標籤 ID 清單。每次更新時,最多可以移除 100 個標籤。
|
回應主體
如果成功,回應主體會包含 Thread
的執行例項。
授權範圍
需要下列其中一種 OAuth 範圍:
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
詳情請參閱授權指南。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-09-05 (世界標準時間)。
[null,null,["上次更新時間:2024-09-05 (世界標準時間)。"],[[["This method modifies the labels applied to all messages within a specific thread using the thread ID and user ID."],["The request body allows adding or removing labels by specifying their IDs, with a limit of 100 labels per update."],["Upon successful execution, the API returns a detailed representation of the updated thread, including its properties and metadata."],["Authorization requires specific OAuth scopes, such as 'https://mail.google.com/' or 'https://www.googleapis.com/auth/gmail.modify', to grant access and permissions."]]],["This describes modifying thread labels in Gmail via an HTTP POST request to `https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}/modify`. The request requires `userId` (email or `me`) and `id` (thread ID) path parameters. The request body, in JSON format, includes arrays `addLabelIds` and `removeLabelIds` for adding/removing label IDs (up to 100 each). A successful response returns a Thread instance, and authorization requires specific OAuth scopes.\n"]]