La API de Google Drive admite varios tipos de acciones de descarga y exportación, como se indica en la siguiente tabla:
| Acciones de descarga |
|
||||
| Acciones de exportación |
|
Antes de descargar o exportar contenido de archivos, verifica que los usuarios puedan descargar el
archivo con el capabilities.canDownload campo en el files recurso.
Para obtener descripciones de los tipos de archivos que se mencionan aquí, incluidos los archivos blob y de Google Workspace, consulta Tipos de archivos.
En el resto de esta guía, se proporcionan instrucciones detalladas para realizar estos tipos de acciones de descarga y exportación.
Descarga contenido de archivos blob
Para descargar un archivo blob almacenado en Drive, usa el método files.get con el ID del archivo que deseas 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 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 el siguiente ejemplo de código, se muestra cómo usar el método files.get para descargar un archivo con las bibliotecas cliente de la API de Drive.
Apps Script
/**
* Downloads a file from Drive.
* @param {string} fileId The ID of the file to download.
* @return {Blob} The file content as a Blob.
*/
function downloadFile(fileId) {
var url = 'https://www.googleapis.com/drive/v3/files/' + fileId + '?alt=media';
var response = UrlFetchApp.fetch(url, {
headers: {
'Authorization': 'Bearer ' + ScriptApp.getOAuthToken()
}
});
return response.getBlob();
}
Java
Python
Node.js
PHP
.NET
En este ejemplo 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 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 este ejemplo de código, se usa el alcance de archivo restringido “drive” que permite a los usuarios ver y administrar todos tus archivos de Drive. Para obtener más información sobre los alcances de
Drive, consulta Elige los alcances de la API de Google Drive
Drive.
Los usuarios con permisos owner (para mis archivos de Drive) o
organizer (para archivos de unidades compartidas) pueden restringir la descarga
a través del
DownloadRestrictionsMetadata
objeto. Para obtener más información, consulta Impide que los usuarios descarguen, impriman o
copien tu archivo.
Los archivos identificados como abusivos
(como software dañino) solo pueden descargarlos el propietario del archivo.
Además, se debe incluir el parámetro de consulta get acknowledgeAbuse=true para indicar que el usuario reconoció el riesgo de descargar software potencialmente no deseado o cualquier 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 especificada de un archivo. Puedes
especificar la parte del archivo que deseas descargar usando un rango
de bytes con el
Range encabezado. Por ejemplo:
Range: bytes=500-999
Descarga contenido de archivos blob en una versión anterior
Solo puedes descargar revisiones de contenido de archivos blob que estén marcadas como "Conservar para siempre". Si quieres descargar una revisión, primero configúrala como "Conservar para siempre". Para obtener más información, consulta Especifica las revisiones que se guardarán de la eliminación automática.
Para descargar el contenido de archivos blob en una versión anterior, usa el
revisions.get método con el ID del
archivo que deseas descargar, el ID de la revisión y el alt=media parámetro de URL. El parámetro de URL alt=media le indica al servidor que se solicita una descarga de contenido como 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, consulta Administra
operaciones de larga duración.
Aquí se muestra el protocolo de solicitud.
GET https://www.googleapis.com/drive/v3/files/{FILE_ID}/revisions/{REVISION_ID}?alt=mediaDescarga contenido de archivos blob en un navegador
Para descargar el contenido de archivos blob almacenados en Drive dentro de un
navegador, en lugar de hacerlo a través de la API, usa el webContentLink campo 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 a un usuario a esta URL o ofrecerla como un vínculo en el que se puede hacer clic.
Descarga contenido de archivos blob durante operaciones de larga duración
Para descargar el contenido de archivos blob durante operaciones de larga duración, usa el
files.download método con el ID del
archivo que deseas descargar. De manera opcional, puedes configurar el ID de la revisión.
Esta es la única forma de descargar archivos de Google Vids. Si intentas exportar
archivos de Google Vids, recibes un
fileNotExportable error.
Para obtener más información, consulta Administra operaciones de larga duración.
Exporta contenido de documentos de Google Workspace
Para exportar contenido de bytes de documentos de Google Workspace, usa el files.export método con el ID del archivo que deseas exportar y
el tipo de MIME correcto. El contenido exportado está limitado a 10 MB.
En el siguiente ejemplo de código, se muestra cómo usar el método files.export para exportar un documento de Google Workspace en formato PDF con las bibliotecas cliente de la API de Drive:
Apps Script
/**
* Exports a Google Workspace document.
* @param {string} fileId The ID of the file to export.
* @param {string} mimeType The MIME type to export to.
* @return {Blob} The exported content as a Blob.
*/
function exportPdf(fileId, mimeType) {
var url = 'https://www.googleapis.com/drive/v3/files/' + fileId + '/export?mimeType=' + encodeURIComponent(mimeType);
var response = UrlFetchApp.fetch(url, {
headers: {
'Authorization': 'Bearer ' + ScriptApp.getOAuthToken()
}
});
return response.getBlob();
}
Java
Python
Node.js
PHP
.NET
En este ejemplo de código, se usa el alcance restringido drive que permite a los usuarios ver y administrar todos tus archivos de Drive. Para obtener más información sobre los alcances de
Drive, consulta Elige los alcances de la API de Google Drive
Drive.
En el ejemplo de código, también se 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 admitidos para cada documento de Google Workspace, consulta Tipos de MIME de exportación para documentos de Google Workspace.
Exporta contenido de documentos de Google Workspace en un navegador
Para exportar contenido de documentos de Google Workspace dentro de un navegador, usa el
exportLinks campo del files recurso. 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 a un usuario a una URL o ofrecerla como un vínculo en el que se puede hacer clic.
Exporta contenido de documentos de Google Workspace en una versión anterior en un navegador
Para exportar contenido de documentos de Google Workspace en una versión anterior dentro de un
navegador, usa el revisions.get método con
el ID del archivo que deseas descargar y el ID de la revisión para generar un vínculo de exportación
desde el que puedes realizar la descarga. Si el usuario tiene acceso de descarga al archivo, se muestra un vínculo para descargar el archivo y su contenido. Puedes redireccionar a un usuario a esta URL o ofrecerla como un vínculo en el que se puede hacer clic.
Exporta contenido de documentos de Google Workspace durante operaciones de larga duración
Para exportar contenido de documentos de Google Workspace durante operaciones de larga duración,
usa el método files.download con el ID
del archivo que deseas descargar y el ID de la revisión. Para obtener más información, consulta
Administra operaciones de larga duración.
Limita cómo se comparten los archivos
- Protege el contenido de los archivos
- Tipos de MIME de exportación para documentos de Google Workspace