- 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 |
Es el ID del archivo o la unidad compartida. |
Parámetros de consulta
| Parámetros | |
|---|---|
emailMessage |
Un mensaje de texto sin formato personalizado para incluir en el correo electrónico de notificación. |
enforceSingleParent |
Obsoleto: Consulta |
moveToNewOwnersRoot |
Este parámetro solo se aplicará si el elemento no está en una unidad compartida y la solicitud intenta transferir la propiedad. Si se configura como |
sendNotificationEmail |
Indica si se debe enviar una notificación por correo electrónico cuando se comparte con usuarios o grupos. El valor predeterminado es verdadero para usuarios y grupos, y no se permite en otras solicitudes. No se debe inhabilitar para las transferencias de propiedad. |
supportsAllDrives |
Si la aplicación que realiza la solicitud admite tanto mis unidades como unidades compartidas. |
supportsTeamDrives |
Obsoleto: Usa |
transferOwnership |
Indica si se debe transferir la propiedad al usuario especificado y cambiar el propietario actual a un escritor. Este parámetro es obligatorio como una confirmación del efecto secundario. |
useDomainAdminAccess |
Emitir la solicitud como un 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/drivehttps://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.