Method: roleAssignments.list

すべての rolesAssignments のページ分けされたリストを取得します。

HTTP リクエスト

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

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

パスパラメータ

パラメータ
customer

string

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

クエリ パラメータ

パラメータ
maxResults

integer

返される結果の最大数。

pageToken

string

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

roleId

string

ロールの不変の ID。リクエストに含まれている場合、このロール ID を含むロールの割り当てのみを返します。

userKey

string

メインのメールアドレス、エイリアスのメールアドレス、または一意のユーザー ID またはグループ ID。リクエストに指定されている場合、このユーザーまたはグループのみのロール割り当てが返されます。

includeIndirectRoleAssignments

boolean

true に設定すると、直接のロールに加えて、間接的なロール割り当て(つまり、グループによるロールの割り当て)を取得します。デフォルトは false です。userKey を指定する必要があります。指定する必要があります。そうしないと、間接的なロールの割り当ては含まれません。

リクエスト本文

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

レスポンスの本文

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

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

string

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

etag

string

リソースの ETag。

items[]

object (RoleAssignment)

RoleAssignment リソースのリスト。

nextPageToken

string

認可スコープ

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

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

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