Method: roleAssignments.list

Recupera uma lista paginada de todas as roleAssignments.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
customer

string

O ID exclusivo da conta do Google Workspace do cliente. No caso de uma conta com vários domínios, para buscar todos os grupos de um cliente, use esse campo em vez de domain. Também é possível usar o alias my_customer para representar o customerId da sua conta. O customerId também é retornado como parte do recurso Users. Forneça o parâmetro customer ou domain.

Parâmetros de consulta

Parâmetros
maxResults

integer

Número máximo de resultados a serem retornados.

pageToken

string

Token para especificar a próxima página na lista.

roleId

string

ID imutável de uma função. Se incluído na solicitação, retorna apenas as atribuições de função que contêm esse ID de função.

userKey

string

É o endereço de e-mail principal, o endereço de e-mail de alias ou o ID exclusivo do usuário ou grupo. Se incluído na solicitação, retorna atribuições de função apenas para esse usuário ou grupo.

includeIndirectRoleAssignments

boolean

Quando definido como true, busca atribuições de função indiretas (ou seja, atribuição de função por um grupo) e diretas. O padrão é false. É necessário especificar userKey, ou as atribuições de função indiretas não serão incluídas.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se bem-sucedido, o corpo da resposta exibirá os dados com a seguinte estrutura:

Representação JSON
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (RoleAssignment)
    }
  ],
  "nextPageToken": string
}
Campos
kind

string

O tipo do recurso da API. Isso é sempre admin#directory#roleAssignments.

etag

string

ETag do recurso.

items[]

object (RoleAssignment)

Uma lista de recursos de RoleAssignment.

nextPageToken

string

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte o guia de autorização.