Method: roleAssignments.list

Recupera uma lista paginada de todos os 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, use este campo em vez de domain para buscar todos os grupos de um cliente. 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. É necessário fornecer 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 da lista.
roleId

string

ID imutável de um papel. Se incluído na solicitação, retorna somente as atribuições de função que contêm esse ID da função.
userKey

string

O endereço de e-mail principal, o endereço de e-mail do alias ou o ID único do usuário ou do grupo. Se incluída na solicitação, retorna somente as atribuições de função para este usuário ou grupo.
includeIndirectRoleAssignments

boolean

Quando definido como true, busca atribuições de funções indiretas (ou seja, atribuições de funções por meio de um grupo), bem como as diretas. O valor padrão é false. É necessário especificar userKey. Caso contrário, as atribuições de funções 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. É 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 de 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.