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

詳情請參閱授權指南