Method: users.settings.delegates.list

指定したアカウントの代理人を一覧表示します。

このメソッドは、ドメイン全体の権限が委任されたサービス アカウント クライアントでのみ使用できます。

HTTP リクエスト

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates

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

パスパラメータ

パラメータ
userId

string

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

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

delegates.list メソッドのレスポンス。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "delegates": [
    {
      object (Delegate)
    }
  ]
}
フィールド
delegates[]

object (Delegate)

ユーザーの代理人のリスト（確認ステータスは任意）。アカウントに代理人がいない場合、このフィールドは表示されません。

認可スコープ

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

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

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