Method: admin.contacts.v1.users.delegates.list

指定されたユーザーの代理人を一覧表示します。

HTTP リクエスト

GET https://admin.googleapis.com/admin/contacts/v1/{parent=users/*}/delegates

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

パスパラメータ

パラメータ
parent

string

この代理人のコレクションを所有する親。形式は users/{userId}。userId はユーザーのメールアドレスです。

クエリ パラメータ

パラメータ
pageSize

integer

各レスポンスで返されるデリゲートの数を指定します。たとえば、リクエストで

pageSize=1

この例のユーザーに 2 人の代理人がいる場合、レスポンスには 2 つのページがあります。レスポンスの

nextPageToken

2 ページ目へのトークンが含まれています。未設定のままにした場合、デフォルトのページサイズが使用されます。

pageToken

string

次のページを指定するページトークン。ユーザーに複数の代理人がいる場合、

nextPageToken

プロパティを使用します。次の代理人を取得するフォローアップ リクエストで、

nextPageToken

の値

pageToken

指定する必要があります。

リクエスト本文

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

レスポンスの本文

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

指定されたユーザーの代理人を一覧表示するための、管理者に対するレスポンス メッセージのタイプ。

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

object (Delegate)

指定されたユーザーの代理人のリスト。

nextPageToken

string

指定されたユーザーの後続の代理人を取得するためのトークン。

nextPageToken

値がリクエストの

pageToken

指定する必要があります。

認可スコープ

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

  • https://www.googleapis.com/auth/admin.contact.delegation
  • https://www.googleapis.com/auth/admin.contact.delegation.readonly

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