- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Pruébala
Crea un permiso para un archivo o una unidad compartida.
Advertencia: No se admiten operaciones de permisos simultáneas en el mismo archivo; solo se aplica la última actualización.
Solicitud HTTP
POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
fileId |
El ID del archivo o unidad compartida |
Parámetros de consulta
Parámetros | |
---|---|
emailMessage |
Un mensaje personalizado de texto sin formato para incluir en la notificación por correo electrónico |
enforceSingleParent |
Obsoleto: Consulta |
moveToNewOwnersRoot |
Este parámetro solo tendrá efecto si el elemento no está en una unidad compartida y la solicitud intenta transferir su propiedad. Si se configura como |
sendNotificationEmail |
Indica si se debe enviar una notificación por correo electrónico cuando se comparte contenido con usuarios o grupos. El valor predeterminado es verdadero para usuarios y grupos, y no se permite para otras solicitudes. No se debe inhabilitar para las transferencias de propiedad. |
supportsAllDrives |
Indica si la aplicación solicitante admite Mi unidad y las unidades compartidas. |
supportsTeamDrives |
Obsoleto: usa |
transferOwnership |
Indica si se debe transferir la propiedad al usuario especificado y cambiar al propietario actual a un escritor inferior. Este parámetro es obligatorio como confirmación del efecto secundario. |
useDomainAdminAccess |
Emite la solicitud como administrador de dominio. Si se establece como verdadera, el solicitante tendrá acceso si el parámetro de ID de archivo hace referencia a una unidad compartida y el solicitante es un administrador del dominio al que pertenece la unidad compartida. |
Cuerpo de la solicitud
El cuerpo de la solicitud incluye una instancia de Permission
.
Cuerpo de la respuesta
Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Permission
.
Permisos de autorización
Se necesita uno de los siguientes alcances de OAuth:
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.