Method: permissions.patch
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Actualiza un permiso con semántica de parche.
Advertencia: No se admiten operaciones de permisos simultáneas en el mismo archivo. Solo se aplica la última actualización.
Solicitud HTTP
PATCH https://www.googleapis.com/drive/v2/files/{fileId}/permissions/{permissionId}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
fileId |
string
El ID del archivo o la unidad compartida.
|
permissionId |
string
Es el ID del permiso.
|
Parámetros de consulta
| Parámetros |
removeExpiration |
boolean
Indica si quieres quitar la fecha de vencimiento.
|
supportsAllDrives |
boolean
Si la aplicación solicitante admite Mi unidad y unidades compartidas
|
supportsTeamDrives
(deprecated) |
boolean
Obsoleto: Usa supportsAllDrives en su lugar.
|
transferOwnership |
boolean
Indica si cambiar un rol a owner cambia los propietarios actuales a escritores. No hace nada si el rol especificado no es owner.
|
useDomainAdminAccess |
boolean
Emite la solicitud como administrador de dominio. Si se establece como verdadero, se le otorgará acceso al solicitante si el parámetro de ID de archivo hace referencia a una unidad compartida y el solicitante es administrador del dominio al que pertenece la unidad compartida.
|
enforceExpansiveAccess |
boolean
Indica si la solicitud debe aplicar reglas de acceso expansivas.
|
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de Permission.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Permission.
Alcances de autorización
Se necesita uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/docs
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
Algunos permisos están restringidos y requieren una evaluación de seguridad para que tu app los use. 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-07-25 (UTC)
[null,null,["Última actualización: 2025-07-25 (UTC)"],[],[],null,["# Method: permissions.patch\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\nUpdates a permission using patch semantics.\n\n**Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.\n\n### HTTP request\n\n`PATCH https://www.googleapis.com/drive/v2/files/{fileId}/permissions/{permissionId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|-----------------------------------------------|\n| `fileId` | `string` The ID for the file or shared drive. |\n| `permissionId` | `string` The ID for the permission. |\n\n### Query parameters\n\n| Parameters ||\n|---------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `removeExpiration` | `boolean` Whether to remove the expiration date. |\n| `supportsAllDrives` | `boolean` Whether the requesting application supports both My Drives and shared drives. |\n| `supportsTeamDrives` **(deprecated)** | `boolean` Deprecated: Use `supportsAllDrives` instead. |\n| `transferOwnership` | `boolean` Whether changing a role to `owner` downgrades the current owners to writers. Does nothing if the specified role is not `owner`. |\n| `useDomainAdminAccess` | `boolean` Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs. |\n| `enforceExpansiveAccess` | `boolean` Whether the request should enforce expansive access rules. |\n\n### Request body\n\nThe request body contains an instance of [Permission](/workspace/drive/api/reference/rest/v2/permissions#Permission).\n\n### Response body\n\nIf successful, the response body contains an instance of [Permission](/workspace/drive/api/reference/rest/v2/permissions#Permission).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/docs`\n- `\n https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.file`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
