Method: labels.permissions.list
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Enumera los permisos de una etiqueta.
Solicitud HTTP
GET https://drivelabels.googleapis.com/v2/{parent=labels/*}/permissions
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros |
parent |
string
Es obligatorio. Es el nombre del recurso de la etiqueta principal en el que se enumeran los permisos de la etiqueta. Formato: labels/{label} .
|
Parámetros de consulta
Parámetros |
useAdminAccess |
boolean
Se debe establecer en true para usar las credenciales de administrador del usuario. El servidor verificará que el usuario sea administrador del sello antes de permitir el acceso.
|
pageSize |
integer
Es la cantidad máxima de permisos que se devolverán por página. El valor predeterminado es 50. Máx.: 200
|
pageToken |
string
Es el token de la página que se devolverá.
|
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de ListLabelPermissionsResponse
.
Alcances de autorización
Se necesita uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/drive.labels
https://www.googleapis.com/auth/drive.labels.readonly
https://www.googleapis.com/auth/drive.admin.labels
https://www.googleapis.com/auth/drive.admin.labels.readonly
Para obtener más información, consulta la Guía de autorización.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-05 (UTC)
[null,null,["Última actualización: 2025-08-05 (UTC)"],[],[],null,["# Method: labels.permissions.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists a label's permissions.\n\n### HTTP request\n\n`GET https://drivelabels.googleapis.com/v2/{parent=labels/*}/permissions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|--------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent label resource name on which label permissions are listed. Format: `labels/{label}`. |\n\n### Query parameters\n\n| Parameters ||\n|------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `useAdminAccess` | `boolean` Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access. |\n| `pageSize` | `integer` Maximum number of permissions to return per page. Default: 50. Max: 200. |\n| `pageToken` | `string` The token of the page to return. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [ListLabelPermissionsResponse](/workspace/drive/labels/reference/rest/v2/ListLabelPermissionsResponse).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive.labels`\n- `\n https://www.googleapis.com/auth/drive.labels.readonly`\n- `\n https://www.googleapis.com/auth/drive.admin.labels`\n- `\n https://www.googleapis.com/auth/drive.admin.labels.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]