Method: permissions.insert

Inserta 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/v2/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 la unidad compartida.

Parámetros de consulta

Parámetros
emailMessage

string

Es un mensaje personalizado de texto sin formato para incluir en los correos electrónicos de notificación.

enforceSingleParent
(deprecated)

boolean

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

moveToNewOwnersRoot

boolean

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

sendNotificationEmails

boolean

Si quieres enviar correos electrónicos de notificación cuando compartas contenido con usuarios o grupos. Este parámetro se ignora y se envía un correo electrónico si role es owner.

supportsAllDrives

boolean

Si la aplicación solicitante admite Mi unidad y unidades compartidas

supportsTeamDrives
(deprecated)

boolean

Obsoleto: Usa supportsAllDrives en su lugar.

useDomainAdminAccess

boolean

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.

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 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/docs
  • 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.