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 |
|
||||
| Exportar acciones |
|
Antes de descargar o exportar el contenido de un archivo, verifica que los usuarios puedan descargarlo con el campo capabilities.canDownload del recurso files.
Para obtener descripciones de los tipos de archivo que se mencionan aquí, incluidos los archivos blob y de Google Workspace, consulta Tipos de archivo.
En el resto de este documento, se proporcionan instrucciones detalladas para realizar estos tipos de acciones de descarga y exportación.
Descarga 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 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 de la API de Drive, no es necesario que establezcas este parámetro de forma explícita, ya que el método de la biblioteca cliente agrega el parámetro de URL alt=media a la solicitud HTTP subyacente.
En las siguientes muestras de código, se muestra cómo usar el método files.get para descargar un archivo:
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
curl
curl -L "https://www.googleapis.com/drive/v3/files/FILE_ID?alt=media" \
--header "Authorization: Bearer ACCESS_TOKEN" \
--output "FILE_NAME"
Reemplaza lo siguiente:
- FILE_ID: Es el ID del archivo que se descargará.
- ACCESS_TOKEN: Es el token de acceso que otorga acceso a la API.
- FILE_NAME: Es el nombre del archivo de salida.
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 permiso de drive.readonly.metadata no está autorizada para descargar el contenido del archivo.
Las muestras de código de la biblioteca cliente usan 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 permisos de Drive, consulta Elige permisos para la API de Google Drive.
Los usuarios con permisos de owner (para los archivos de Mi unidad) o organizer (para los archivos de unidades compartidas) pueden restringir la descarga a través del objeto DownloadRestrictionsMetadata. Para obtener más información, consulta Cómo impedir que los usuarios descarguen, impriman o copien tu archivo.
Solo el propietario del archivo puede descargar los archivos identificados como abusivos (como software dañino).
Además, se debe incluir el parámetro de consulta get acknowledgeAbuse=true para indicar que el usuario reconoce el riesgo de descargar software no deseado o archivos abusivos. Tu aplicación debe advertirle 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 con 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
Solo puedes descargar las revisiones del contenido de los 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 Cómo especificar las revisiones que se deben guardar del borrado automático.
Para descargar el contenido de los archivos de 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 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.
curl
curl -L "https://www.googleapis.com/drive/v3/files/FILE_ID/revisions/REVISION_ID?alt=media" \
--header "Authorization: Bearer ACCESS_TOKEN" \
--output "FILE_NAME"
Reemplaza lo siguiente:
- FILE_ID: Es el ID del archivo que se descargará.
- REVISION_ID: Es el ID de la revisión que se descargará.
- ACCESS_TOKEN: Es el token de acceso que otorga acceso a la API.
- FILE_NAME: Es el nombre del archivo de salida.
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 devuelve 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.
curl
curl "https://www.googleapis.com/drive/v3/files/FILE_ID?fields=webContentLink" \
--header "Authorization: Bearer ACCESS_TOKEN" \
--header "Accept: application/json"
Reemplaza lo siguiente:
- FILE_ID: Es el ID del archivo para el que se obtendrá el vínculo de descarga.
- ACCESS_TOKEN: Es el token de acceso que otorga acceso a la API.
Descarga el contenido de archivos BLOB con operaciones de larga duración
Para descargar el contenido de los archivos de BLOB con operaciones de larga duración (LRO), usa el método files.download con el ID del archivo que se descargará. De forma opcional, puedes establecer el ID de la revisión.
Esta es la única forma de descargar archivos de Google Vids. Si intentas exportar archivos de Google Vids, recibirás un error fileNotExportable.
Para obtener más información, consulta Administra operaciones de larga duración.
curl
El siguiente comando curl inicia una LRO y devuelve una respuesta JSON. Para descargar el archivo o sondear este LRO, debes realizar otra solicitud con el ID devuelto para obtener la URL del contenido. Luego, puedes realizar una solicitud curl final a esa URL para descargar el archivo. Para obtener más información, consulta Administra operaciones de larga duración.
curl --request POST "https://www.googleapis.com/drive/v3/files/FILE_ID/download?mimeType=video/mp4" \
--header "Authorization: Bearer ACCESS_TOKEN" \
--header "Content-Length: 0" \
--header "Accept: application/json"
Reemplaza lo siguiente:
- FILE_ID: Es el ID del archivo que se descargará.
- ACCESS_TOKEN: Es el token de acceso que otorga acceso a la API.
Cómo exportar contenido de documentos de Google Workspace
Para exportar el contenido de bytes de un documento 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 las siguientes muestras de código, se muestra cómo usar el método files.export para exportar un documento de Google Workspace en formato PDF:
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
curl
curl -L "https://www.googleapis.com/drive/v3/files/FILE_ID/export?mimeType=application/pdf" \
--header "Authorization: Bearer ACCESS_TOKEN" \
--output "FILE_NAME.pdf"
Reemplaza lo siguiente:
- FILE_ID: Es el ID del archivo que se descargará.
- ACCESS_TOKEN: Es el token de acceso que otorga acceso a la API.
- FILE_NAME: Es el nombre del archivo de salida.
Las muestras de código de la biblioteca cliente usan 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 permisos de Drive, consulta Elige permisos para la API de Google Drive.
Las muestras de código también declaran 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.
Cómo exportar 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 devuelve 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.
curl
curl "https://www.googleapis.com/drive/v3/files/FILE_ID?fields=id,name,exportLinks" \
--header "Authorization: Bearer ACCESS_TOKEN" \
--header "Accept: application/json"
Reemplaza lo siguiente:
- FILE_ID: Es el ID del archivo para el que se obtendrá el vínculo de descarga.
- ACCESS_TOKEN: Es el token de acceso que otorga acceso a la API.
Cómo exportar contenido de un documento de Google Workspace en una versión anterior en un navegador
Para exportar el contenido de un documento 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 para generar un vínculo de exportación desde el que podrás 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.
curl
curl "https://www.googleapis.com/drive/v3/files/FILE_ID/revisions/REVISION_ID?fields=id,name,exportLinks" \
--header "Authorization: Bearer ACCESS_TOKEN" \
--header "Accept: application/json"
Reemplaza lo siguiente:
- FILE_ID: Es el ID del archivo que se descargará.
- REVISION_ID: Es el ID de la revisión que se descargará.
- ACCESS_TOKEN: Es el token de acceso que otorga acceso a la API.
Exporta contenido de documentos de Google Workspace con operaciones de larga duración
Para exportar contenido de documentos de Google Workspace con operaciones de larga duración (LRO), usa el método files.download con el ID del archivo que se descargará y el ID de la revisión. Para obtener más información, consulta Administra operaciones de larga duración.
curl
El siguiente comando curl inicia una LRO y devuelve una respuesta JSON. Para descargar el archivo o sondear este LRO, debes realizar otra solicitud con el ID devuelto para obtener la URL del contenido. Luego, puedes realizar una solicitud curl final a esa URL para descargar el archivo. Para obtener más información, consulta Administra operaciones de larga duración.
curl --request POST "https://www.googleapis.com/drive/v3/files/FILE_ID/download?mimeType=MIME_TYPE&revisionId=REVISION_ID" \
--header "Authorization: Bearer ACCESS_TOKEN" \
--header "Content-Length: 0" \
--header "Accept: application/json"
Reemplaza lo siguiente:
- FILE_ID: Es el ID del archivo que se descargará.
- MIME_TYPE: Es el tipo de MIME al que se exportará.
- REVISION_ID: Es el ID de la revisión que se descargará.
- ACCESS_TOKEN: Es el token de acceso que otorga acceso a la API.
Limita la forma en que se comparten los archivos
- Protege el contenido de los archivos
- Tipos de MIME de exportación para documentos de Google Workspace