Method: permissions.update

Actualiza un permiso con semántica de parche. Para obtener más información, consulta Cómo compartir archivos, carpetas y unidades.

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/v3/files/{fileId}/permissions/{permissionId}

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

Parámetros de ruta de acceso

Parámetros
fileId

string

Es 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 se quitará la fecha de vencimiento.
supportsAllDrives

boolean

Indica si la aplicación solicitante admite tanto Mi unidad como las unidades compartidas.
supportsTeamDrives
(deprecated)

boolean

Obsoleto: Usa supportsAllDrives en su lugar.
transferOwnership

boolean

Indica si se debe transferir la propiedad al usuario especificado y reducir el nivel del propietario actual a escritor. Este parámetro es obligatorio como confirmación del efecto secundario. Para obtener más información, consulta Cómo transferir la propiedad de un archivo.
useDomainAdminAccess

boolean

Envía la solicitud como administrador del dominio.

Si se configura como true y se cumplen las siguientes condiciones adicionales, se le otorga acceso al solicitante:

  1. El parámetro de ID de archivo hace referencia a una unidad compartida.
  2. El solicitante es administrador del dominio al que pertenece la unidad compartida.

Para obtener más información, consulta Administra unidades compartidas como administrador de dominio.
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/drive
  • https://www.googleapis.com/auth/drive.file

Algunos alcances 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.