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 para descargar y el parámetro de URL alt=media
. El parámetro de URL alt=media
le indica al servidor que se solicita la 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 establecer este parámetro de forma explícita.
En la siguiente muestra de código, se indica 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 que se inician desde la app deben estar autorizadas con un permiso que permita
el acceso de lectura al contenido del archivo. Por ejemplo, una app que usa el permiso drive.readonly.metadata
no está autorizada para descargar el contenido del archivo.
En esta muestra de código, se usa el permiso restringido para archivos de 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 autenticación y autorización específica de la API.
Los usuarios con permisos de edición pueden restringir la descarga por parte de usuarios de solo lectura mediante la configuración del campo copyRequiresWriterPermission
en false
.
Solo el propietario del archivo puede descargar los archivos identificados como abusivos (como los software dañinos).
Además, se debe incluir el parámetro de búsqueda get
acknowledgeAbuse=true
para indicar que el usuario reconoció el riesgo de descargar software potencialmente no deseado o algún otro archivo abusivo. 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
Descargar el contenido del archivo BLOB en una versión anterior
Para descargar el contenido de archivos BLOB en una versión anterior, usa el método revisions.get
con el ID del archivo que se descargará, el ID de la revisión y el parámetro de URL alt=media
.
El parámetro de URL alt=media
le indica al servidor que se solicita la 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
. Para obtener más información sobre la descarga de 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 mostrará un vínculo para descargarlo y su contenido. Puedes redireccionar a un usuario a esta URL, o bien ofrecerle un vínculo en el que se pueda 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 se exportará y el tipo de MIME correcto. El contenido exportado tiene un límite de 10 MB.
En la siguiente muestra de código, se indica 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 autenticación y autorización específica de la API.
En la muestra de código, también se declara el tipo de MIME de exportación como application/pdf
. Si quieres obtener una lista completa de todos los tipos de MIME de exportación que se admiten en cada documento de Google Workspace, consulta Exporta tipos de MIME para documentos de Google Workspace.
Exporte el 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 por cada tipo de MIME disponible. Puedes redireccionar a un usuario a una URL, o bien ofrecerle un vínculo en el que se pueda hacer clic.
Exporte el contenido de un documento de Google Workspace a una versión anterior desde un navegador
Para exportar el contenido de documentos de Google Workspace en una versión anterior dentro de 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 mostrará un vínculo para descargarlo y su contenido. Puedes redireccionar a un usuario a esta URL, o bien ofrecerle un vínculo en el que se pueda hacer clic.