Method: users.messages.modify

指定したメッセージのラベルと分類ラベルの値を変更します。組織内のユーザーのメッセージを変更する管理者の場合、リクエストには、サービス アカウントによる承認が必要です。このサービス アカウントには、ドメイン全体の委任権限があり、https://www.googleapis.com/auth/gmail.modify.restricted スコープでユーザーに成り代わることができます。

HTTP リクエスト

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

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

パスパラメータ

パラメータ
userId

string

ユーザーのメールアドレス。特別な値 me を使用して、認証済みユーザーを示すことができます。
id

string

変更するメッセージの ID。

リクエストの本文

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

JSON 表現 
{
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ],
  "addClassificationLabels": [
    {
      object (ClassificationLabelValue)
    }
  ],
  "removeClassificationLabelIds": [
    string
  ]
}
フィールド
addLabelIds[]

string

このメッセージに追加するラベルの ID のリスト。更新ごとに最大 100 個のラベルを追加できます。
removeLabelIds[]

string

このメッセージから削除するラベルの ID のリスト。更新ごとに最大 100 個のラベルを削除できます。
addClassificationLabels[]

object (ClassificationLabelValue)

追加する分類ラベル値のリスト。同じラベル ID の分類ラベルがすでにメッセージに適用されている場合、既存のフィールド ID を持つフィールドが更新され、新しいフィールド ID を持つフィールドが追加されます。リクエストごとに最大 20 個の分類ラベル値を指定できます。メッセージがすでに分類されていて、分類ラベル値の最終的な合計数がメッセージあたりの分類ラベル値の最大許容数を超えている場合、変更は失敗します。
removeClassificationLabelIds[]

string

このメッセージから削除する分類ラベル値のリスト。

レスポンスの本文

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

認可スコープ

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

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

詳細については、承認ガイドをご覧ください。