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

変更するスレッドの ID。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ]
}
フィールド
addLabelIds[]

string

このスレッドに追加するラベルの ID のリスト。1 回の更新で最大 100 個のラベルを追加できます。
removeLabelIds[]

string

このスレッドから削除するラベルの ID のリスト。1 回の更新で最大 100 個のラベルを削除できます。

レスポンスの本文

成功した場合、レスポンスの本文には Thread のインスタンスが含まれます。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify

詳細については、OAuth 2.0 Overview をご覧ください。