La API de Google Drive admite varios tipos de acciones de descarga y exportación, como se indica en la siguiente tabla:
Descargas |
|
|||
Exportaciones |
|
En el resto de esta guía, se proporcionan instrucciones detalladas para realizar estos tipos de acciones de descarga y exportación.
Descargar el contenido del archivo BLOB
Para descargar un archivo BLOB almacenado en Drive, usa el método files.get
con el ID del archivo que se descargará y el parámetro de URL alt=media
. El parámetro de URL alt=media
le indica al servidor que se solicita una descarga de contenido como un formato de respuesta alternativo.
El parámetro de URL alt=media
es un parámetro del sistema disponible en todas las APIs de REST de Google. Si usas una biblioteca cliente para la API de Drive, no necesitas configurar este parámetro de forma explícita.
En la siguiente muestra de código, verás cómo usar el método files.get
para descargar un archivo con las bibliotecas cliente de la API de Drive.
Java
Python
Node.js
PHP
.NET
En esta muestra de código, se usa un método de biblioteca que agrega el parámetro de URL alt=media
a la solicitud HTTP subyacente.
Las descargas de archivos iniciadas desde tu app deben autorizarse con un alcance que permita el acceso de lectura al contenido del archivo. Por ejemplo, una app que usa el alcance drive.readonly.metadata
no está autorizada para descargar el contenido del archivo.
En esta muestra de código, se usa el alcance de archivo "drive" restringido que permite a los usuarios
ver y administrar todos tus archivos de Drive. Para obtener más información sobre los permisos de Drive, consulta la información de autenticación y autorización específica de la API.
Los usuarios con permisos de edición pueden restringir la descarga para los usuarios con acceso de lectura si configuran el campo copyRequiresWriterPermission
en false
.
Solo el propietario del archivo puede descargar los archivos identificados como abusivos (como el software dañino).
Además, se debe incluir el parámetro de consulta acknowledgeAbuse=true
de get
para indicar que el usuario aceptó el riesgo de descargar posible software no deseado u otros archivos abusivos. Tu aplicación debe advertir al usuario de forma interactiva antes de usar este parámetro de consulta.
Descarga parcial
La descarga parcial implica descargar solo una parte específica de un archivo. Puedes especificar la parte del archivo que deseas descargar mediante un rango de bytes con el encabezado Range
. Por ejemplo:
Range: bytes=500-999
Descarga el contenido del archivo BLOB en una versión anterior
Para descargar el contenido de los archivos BLOB en una versión anterior, usa el método revisions.get
con el ID del archivo que deseas descargar, el ID de la revisión y el parámetro de URL alt=media
.
El parámetro de URL alt=media
indica al servidor que se solicita una descarga de contenido como un formato de respuesta alternativo. Al igual que files.get
, el método revisions.get
también acepta el parámetro de consulta opcional acknowledgeAbuse
y el encabezado Range
. Si quieres obtener más información para descargar revisiones, consulta Descarga y publica revisiones de archivos.
Descarga el contenido del archivo BLOB en un navegador
Para descargar el contenido de los archivos BLOB almacenados en Drive dentro de un navegador, en lugar de hacerlo a través de la API, usa el campo webContentLink
del recurso Files
. Si el usuario tiene acceso de descarga al archivo, se muestra un vínculo para descargar el archivo y su contenido. Puedes redireccionar al usuario a esta URL, o bien ofrecerla como un vínculo en el que se puede hacer clic.
Exporta contenido de documentos de Google Workspace
Para exportar contenido de bytes de documentos de Google Workspace, usa el método files.export
con el ID del archivo que deseas exportar y el tipo de MIME correcto. El contenido exportado tiene un límite de 10 MB.
En la siguiente muestra de código, verás cómo usar el método files.export
para exportar un documento de Google Workspace en formato PDF mediante las bibliotecas cliente de la API de Drive:
Java
Python
Node.js
PHP
.NET
En esta muestra de código, se usa el permiso restringido drive
que permite a los usuarios ver y
administrar todos tus archivos de Drive. Para obtener más información sobre los permisos de Drive, consulta la información de autorización y autenticación específica de la API.
La muestra de código también declara el tipo de MIME de exportación como application/pdf
. Para obtener una lista completa de todos los tipos de MIME de exportación compatibles con cada documento de Google Workspace, consulta Exporta tipos de MIME para documentos de Google Workspace.
Exporta contenido de documentos de Google Workspace en un navegador
Para exportar contenido de documentos de Google Workspace en un navegador, usa el campo exportLinks
del recurso Files
. Según el tipo de documento, se muestra un vínculo para descargar el archivo y su contenido para cada tipo de MIME disponible. Puedes redireccionar al usuario a una URL, o bien ofrecerla como un vínculo en el que se puede hacer clic.
Exporta contenido de documentos de Google Workspace a una versión anterior en un navegador
Para exportar el contenido del documento de Google Workspace a una versión anterior en un navegador, usa el método revisions.get
con el ID del archivo que se descargará y el ID de la revisión. Si el usuario tiene acceso de descarga al archivo, se muestra un vínculo para descargar el archivo y su contenido. Puedes redireccionar al usuario a esta URL, o bien ofrecerla como un vínculo en el que se puede hacer clic.