Method: users.messages.batchModify

指定したメッセージのラベルを変更します。

HTTP リクエスト

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/batchModify

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
userId

string

ユーザーのメールアドレスです。認証されたユーザーを示すには、特別な値 me を使用できます。

リクエストの本文

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

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

string

変更するメッセージの ID。リクエストあたりの ID の上限は 1,000 個です。
addLabelIds[]

string

メッセージに追加するラベル ID のリスト。
removeLabelIds[]

string

メッセージから削除するラベル ID のリスト。

レスポンスの本文

成功すると、レスポンスの本文は空になります。

認可スコープ

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

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

詳しくは、認可ガイドをご覧ください。