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. Você também pode usar o alias my_customer para representar o customerId da sua conta. O customerId também é retornado como parte do recurso Users. Informe 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 contendo esse ID do papel.
userKey

string

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

boolean

Quando definido como true, busca as atribuições de função indiretas (ou seja, atribuição de função por meio de um grupo), bem como as diretas. O padrão é false. É preciso 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. É sempre admin#directory#roleAssignments.
etag

string

ETag do recurso.
items[]

object (RoleAssignment)

Uma lista de recursos 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.