Method: permissions.create

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

string

El ID del archivo o unidad compartida

Parámetros de consulta

Parámetros
emailMessage

string

Un mensaje personalizado de texto sin formato para incluir en la notificación por correo electrónico

enforceSingleParent
(deprecated)

boolean

Obsoleto: Consulta moveToNewOwnersRoot para obtener más información.

moveToNewOwnersRoot

boolean

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 true, el elemento se moverá a la carpeta raíz Mi unidad del nuevo propietario y se quitarán todos los elementos superiores anteriores. Si se configura como false, no se cambian los elementos superiores.

sendNotificationEmail

boolean

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

boolean

Indica si la aplicación solicitante admite Mi unidad y 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 cambiar al propietario actual a un escritor inferior. Este parámetro es obligatorio como confirmación del efecto secundario.

useDomainAdminAccess

boolean

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.