Method: roles.list

ドメイン内のすべてのロールのパージネーション リストを取得します。

HTTP リクエスト

GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/roles

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

パスパラメータ

パラメータ
customer

string

お客様の Google Workspace アカウントの一意の ID。複数ドメインのアカウントで、お客様のすべてのグループを取得するには、domain ではなくこのフィールドを使用します。my_customer エイリアスを使用してアカウントの customerId を表すこともできます。customerId は、Users リソースの一部として返されます。customer パラメータまたは domain パラメータのいずれかを指定する必要があります。

クエリ パラメータ

パラメータ
maxResults

integer

返される結果の最大数。
pageToken

string

リストの次のページを指定するトークン。

リクエストの本文

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

レスポンスの本文

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現 
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (Role)
    }
  ],
  "nextPageToken": string
}
フィールド
kind

string

API リソースのタイプ。これは常に admin#directory#roles です。
etag

string

リソースの ETag。
items[]

object (Role)

Role リソースのリスト。
nextPageToken

string

認可スコープ

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

  • https://www.googleapis.com/auth/admin.directory.rolemanagement
  • https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly

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