- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de autorización
- Pruébalo
Crea un permiso para un archivo o una unidad compartida.
Advertencia: No se admiten operaciones de permisos simultáneos 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 la unidad compartida. |
Parámetros de consulta
| Parámetros | |
|---|---|
emailMessage |
Es un mensaje personalizado de texto sin formato 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 del elemento. Si se establece en |
sendNotificationEmail |
Si quieres enviar un correo electrónico de notificación cuando compartas contenido con usuarios o grupos. De forma predeterminada, es verdadero para los usuarios y los grupos, y no se permite para otras solicitudes. No debe estar inhabilitada para las transferencias de propiedad. |
supportsAllDrives |
Indica si la aplicación solicitante admite Mi unidad y unidades compartidas. |
supportsTeamDrives |
Obsoleto: Usa |
transferOwnership |
Si se debe transferir la propiedad al usuario especificado y cambiar el nivel del propietario actual a escritor. Este parámetro es obligatorio como confirmación del efecto secundario. |
useDomainAdminAccess |
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. |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene 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 permisos 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.