Method: permissions.create

Crea un permiso para un archivo o una unidad compartida. Para obtener más información, consulta Cómo compartir archivos, carpetas y unidades.

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

Es 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 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 tiene efecto 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 mueve a la carpeta raíz de Mi unidad del nuevo propietario y se quitan todos los elementos principales anteriores. Si se establece en false, no se cambiarán los padres.
sendNotificationEmail

boolean

Indica si se debe enviar un correo electrónico de notificación cuando se comparte contenido con usuarios o grupos. El valor predeterminado es true para los usuarios y grupos, y no se permite para otras solicitudes. No debe estar inhabilitada para las transferencias de propiedad.
supportsAllDrives

boolean

Indica si la aplicación solicitante admite tanto Mi unidad como 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 reducir el nivel del propietario actual a escritor. Este parámetro es obligatorio como confirmación del efecto secundario. Para obtener más información, consulta Cómo transferir la propiedad de un archivo.
useDomainAdminAccess

boolean

Envía la solicitud como administrador del dominio.

Si se configura como true y se cumplen las siguientes condiciones adicionales, se le otorga acceso al solicitante:

  1. El parámetro de ID de archivo hace referencia a una unidad compartida.
  2. El solicitante es administrador del dominio al que pertenece la unidad compartida.

Para obtener más información, consulta Administra unidades compartidas como administrador de dominio.
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/drive
  • https://www.googleapis.com/auth/drive.file

Algunos alcances 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.