Method: roleAssignments.list

Recupera una lista paginada de todos los rolesAssignments.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
customer

string

El ID único de la cuenta de Google Workspace del cliente. En el caso de una cuenta de varios dominios, usa este campo en lugar de domain para recuperar todos los grupos de un cliente. También puedes usar el alias my_customer para representar el customerId de tu cuenta. También se muestra customerId como parte del recurso Users. Debes proporcionar el parámetro customer o domain.

Parámetros de consulta

Parámetros
maxResults

integer

Cantidad máxima de resultados que se mostrarán

pageToken

string

Es el token para especificar la página siguiente de la lista.

roleId

string

Es el ID inmutable de un rol. Si se incluye en la solicitud, solo muestra las asignaciones de funciones que contienen este ID de función.

userKey

string

La dirección de correo electrónico principal, el alias de la dirección de correo electrónico, o el ID de usuario o grupo único. Si se incluye en la solicitud, muestra asignaciones de roles solo para este usuario o grupo.

includeIndirectRoleAssignments

boolean

Cuando se establece en true, recupera las asignaciones de roles indirectas (es decir, la asignación de roles a través de un grupo) y las directas. La configuración predeterminada es false. Debes especificar userKey; de lo contrario, no se incluirán las asignaciones de roles indirectas.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si el proceso es satisfactorio, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (RoleAssignment)
    }
  ],
  "nextPageToken": string
}
Campos
kind

string

Tipo de recurso de la API. Siempre es admin#directory#roleAssignments.

etag

string

ETag del recurso.

items[]

object (RoleAssignment)

Una lista de recursos de RoleAssignment

nextPageToken

string

Permisos de autorización

Se necesita uno de los siguientes alcances de OAuth:

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

Para obtener más información, consulta la guía de autorización.