Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Cómo descargar y exportar archivos

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

Contenido del archivo Blob con el método files.get y el parámetro alt=media.

Contenido del archivo Blob en una versión anterior con el método revisions.get y el parámetro alt=media.

Contenido del archivo Blob en un navegador con el campo webContentLink

Contenido del archivo BLOB con el método files.download a través de operaciones de larga duración. Esta es la única forma de descargar archivos de Google Vids.

Exportar acciones

Contenido de documentos de Google Workspace en un formato que tu app puede controlar, con el método files.export.

Contenido de un documento de Google Workspace en un navegador con el campo exportLinks

Contenido de un documento de Google Workspace en una versión anterior en un navegador con el campo exportLinks

Contenido de documentos de Google Workspace con el método files.download a través de operaciones de larga duración.

En la API de Drive, un archivo blob hace referencia a cualquier archivo binario sin procesar almacenado en Google Drive (como imágenes, videos y archivos PDF) en lugar de un documento de Google Workspace. No hace referencia al objeto Blob de JavaScript. Para obtener descripciones detalladas de los tipos de archivos que se mencionan aquí, incluidos los archivos blob y de Google Workspace, consulta Tipos de archivos.

Antes de descargar o exportar el contenido de un archivo, verifica que los usuarios puedan descargarlo con el campo capabilities.canDownload del recurso files.

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 del sistema alt. El parámetro alt=media le indica al servidor que se solicita una descarga de contenido como formato de respuesta alternativo.

El parámetro del sistema alt está 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 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

drive/snippets/drive_v3/src/main/java/DownloadFile.java

Ver en GitHub

import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.HttpRequestInitializer;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.drive.Drive;
import com.google.api.services.drive.DriveScopes;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.util.Arrays;

/* Class to demonstrate use-case of drive's download file. */
public class DownloadFile {

  /**
   * Download a Document file in PDF format.
   *
   * @param realFileId file ID of any workspace document format file.
   * @return byte array stream if successful, {@code null} otherwise.
   * @throws IOException if service account credentials file not found.
   */
  public static ByteArrayOutputStream downloadFile(String realFileId) throws IOException {
        /* Load pre-authorized user credentials from the environment.
           TODO(developer) - See https://developers.google.com/identity for
          guides on implementing OAuth2 for your application.*/
    GoogleCredentials credentials = GoogleCredentials.getApplicationDefault()
        .createScoped(Arrays.asList(DriveScopes.DRIVE_FILE));
    HttpRequestInitializer requestInitializer = new HttpCredentialsAdapter(
        credentials);

    // Build a new authorized API client service.
    Drive service = new Drive.Builder(new NetHttpTransport(),
        GsonFactory.getDefaultInstance(),
        requestInitializer)
        .setApplicationName("Drive samples")
        .build();

    try {
      OutputStream outputStream = new ByteArrayOutputStream();

      service.files().get(realFileId)
          .executeMediaAndDownloadTo(outputStream);

      return (ByteArrayOutputStream) outputStream;
    } catch (GoogleJsonResponseException e) {
      // TODO(developer) - handle error appropriately
      System.err.println("Unable to move file: " + e.getDetails());
      throw e;
    }
  }
}

Python

drive/snippets/drive-v3/file_snippet/download_file.py

Ver en GitHub

import io

import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError
from googleapiclient.http import MediaIoBaseDownload


def download_file(real_file_id):
  """Downloads a file
  Args:
      real_file_id: ID of the file to download
  Returns : IO object with location.

  Load pre-authorized user credentials from the environment.
  TODO(developer) - See https://developers.google.com/identity
  for guides on implementing OAuth2 for the application.
  """
  creds, _ = google.auth.default()

  try:
    # create drive api client
    service = build("drive", "v3", credentials=creds)

    file_id = real_file_id

    # pylint: disable=maybe-no-member
    request = service.files().get_media(fileId=file_id)
    file = io.BytesIO()
    downloader = MediaIoBaseDownload(file, request)
    done = False
    while done is False:
      status, done = downloader.next_chunk()
      print(f"Download {int(status.progress() * 100)}.")

  except HttpError as error:
    print(f"An error occurred: {error}")
    file = None

  return file.getvalue()


if __name__ == "__main__":
  download_file(real_file_id="1KuPmvGq8yoYgbfW74OENMCB5H0n_2Jm9")

Node.js

drive/snippets/drive_v3/file_snippets/download_file.js

Ver en GitHub

import {GoogleAuth} from 'google-auth-library';
import {google} from 'googleapis';

/**
 * Downloads a file from Google Drive.
 * @param {string} fileId The ID of the file to download.
 * @return {Promise<number>} The status of the download.
 */
async function downloadFile(fileId) {
  // Authenticate with Google and get an authorized client.
  // TODO (developer): Use an appropriate auth mechanism for your app.
  const auth = new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/drive',
  });

  // Create a new Drive API client (v3).
  const service = google.drive({version: 'v3', auth});

  // Download the file.
  const file = await service.files.get({
    fileId,
    alt: 'media',
  });

  // Print the status of the download.
  console.log(file.status);
  return file.status;
}

PHP

drive/snippets/drive_v3/src/DriveDownloadFile.php

Ver en GitHub

<?php
use Google\Client;
use Google\Service\Drive;
function downloadFile()
 {
    try {

      $client = new Client();
      $client->useApplicationDefaultCredentials();
      $client->addScope(Drive::DRIVE);
      $driveService = new Drive($client);
      $realFileId = readline("Enter File Id: ");
      $fileId = '0BwwA4oUTeiV1UVNwOHItT0xfa2M';
      $fileId = $realFileId;
      $response = $driveService->files->get($fileId, array(
          'alt' => 'media'));
      $content = $response->getBody()->getContents();
      return $content;

    } catch(Exception $e) {
      echo "Error Message: ".$e;
    }

}

.NET

drive/snippets/drive_v3/DriveV3Snippets/DownloadFile.cs

Ver en GitHub

using Google.Apis.Auth.OAuth2;
using Google.Apis.Download;
using Google.Apis.Drive.v3;
using Google.Apis.Services;

namespace DriveV3Snippets
{
    // Class to demonstrate use-case of drive's download file.
    public class DownloadFile
    {
        /// <summary>
        /// Download a Document file in PDF format.
        /// </summary>
        /// <param name="fileId">file ID of any workspace document format file.</param>
        /// <returns>byte array stream if successful, null otherwise.</returns>
        public static MemoryStream DriveDownloadFile(string fileId)
        {
            try
            {
                /* Load pre-authorized user credentials from the environment.
                 TODO(developer) - See https://developers.google.com/identity for 
                 guides on implementing OAuth2 for your application. */
                GoogleCredential credential = GoogleCredential
                    .GetApplicationDefault()
                    .CreateScoped(DriveService.Scope.Drive);

                // Create Drive API service.
                var service = new DriveService(new BaseClientService.Initializer
                {
                    HttpClientInitializer = credential,
                    ApplicationName = "Drive API Snippets"
                });

                var request = service.Files.Get(fileId);
                var stream = new MemoryStream();

                // Add a handler which will be notified on progress changes.
                // It will notify on each chunk download and when the
                // download is completed or failed.
                request.MediaDownloader.ProgressChanged +=
                    progress =>
                    {
                        switch (progress.Status)
                        {
                            case DownloadStatus.Downloading:
                            {
                                Console.WriteLine(progress.BytesDownloaded);
                                break;
                            }
                            case DownloadStatus.Completed:
                            {
                                Console.WriteLine("Download complete.");
                                break;
                            }
                            case DownloadStatus.Failed:
                            {
                                Console.WriteLine("Download failed.");
                                break;
                            }
                        }
                    };
                request.Download(stream);

                return stream;
            }
            catch (Exception e)
            {
                // TODO(developer) - handle error appropriately
                if (e is AggregateException)
                {
                    Console.WriteLine("Credential Not found");
                }
                else
                {
                    throw;
                }
            }
            return null;
        }
    }
}

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 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 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 evitar 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, el parámetro de consulta acknowledgeAbuse debe establecerse en true para indicar que el usuario reconoció el riesgo de descargar software no deseado o archivos abusivos. Tu aplicación debe advertir al usuario de forma interactiva antes de usar este parámetro de consulta.

Accede a los datos de archivos en la memoria

Si tu aplicación debe acceder a los datos del archivo directamente en la memoria (por ejemplo, como un búfer de bytes) en lugar de guardarlos en un disco local, puedes ajustar la solicitud de la biblioteca cliente o procesar el flujo devuelto:

Node.js: De forma predeterminada, la biblioteca cliente de Node.js devuelve el contenido del archivo como una transmisión de Readable. Para guardar el archivo en el disco local, haz lo siguiente:

const fs = require('fs');

const dest = fs.createWriteStream('/path/to/dest/file.ext');
const response = await service.files.get(
  { fileId, alt: 'media' },
  { responseType: 'stream' }
);
response.data
  .on('end', () => {
    console.log('Download complete.');
  })
  .on('error', (err) => {
    console.error('Error downloading file.', err);
  })
  .pipe(dest);

Como alternativa, para devolver los datos directamente en la memoria como un ArrayBuffer en lugar de una transmisión, establece el parámetro responseType en las opciones de la solicitud:

const file = await service.files.get({
  fileId,
  alt: 'media',
}, { responseType: 'arraybuffer' });

// Convert the ArrayBuffer to a Node.js Buffer object.
const buffer = Buffer.from(file.data);

Python: La muestra de código de Python para descargar un archivo de BLOB ya escribe los fragmentos de descarga en un objeto io.BytesIO() en memoria. Para acceder a los bytes sin procesar, llama a file.getvalue().
Java: La muestra de código Java para descargar un archivo BLOB usa un java.io.ByteArrayOutputStream para capturar los bytes descargados en la memoria. Usa outputStream.toByteArray() para acceder al array de bytes sin procesar.
.NET: La muestra de código en C# para descargar un archivo Blob usa un System.IO.MemoryStream. Usa stream.ToArray() para acceder al array de bytes subyacente.
Apps Script: La muestra de código de Apps Script para descargar un archivo Blob usa un método response.getBlob() para devolver un objeto Blob. Convierte esto en un array de bytes con el método getBytes().

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

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 alt parámetro del sistema. El parámetro 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 acknowledgeAbuse y el encabezado Range.

Solo puedes descargar las 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 Cómo especificar las revisiones que se deben guardar para evitar el borrado automático.

Para obtener más información sobre cómo descargar una revisió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 manera 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

drive/snippets/drive_v3/src/main/java/ExportPdf.java

Ver en GitHub

import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.HttpRequestInitializer;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.drive.Drive;
import com.google.api.services.drive.DriveScopes;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.util.Arrays;

/* Class to demonstrate use-case of drive's export pdf. */
public class ExportPdf {

  /**
   * Download a Document file in PDF format.
   *
   * @param realFileId file ID of any workspace document format file.
   * @return byte array stream if successful, {@code null} otherwise.
   * @throws IOException if service account credentials file not found.
   */
  public static ByteArrayOutputStream exportPdf(String realFileId) throws IOException {
    // Load pre-authorized user credentials from the environment.
    // TODO(developer) - See https://developers.google.com/identity for
    // guides on implementing OAuth2 for your application.
    GoogleCredentials credentials = GoogleCredentials.getApplicationDefault()
        .createScoped(Arrays.asList(DriveScopes.DRIVE_FILE));
    HttpRequestInitializer requestInitializer = new HttpCredentialsAdapter(
        credentials);

    // Build a new authorized API client service.
    Drive service = new Drive.Builder(new NetHttpTransport(),
        GsonFactory.getDefaultInstance(),
        requestInitializer)
        .setApplicationName("Drive samples")
        .build();

    OutputStream outputStream = new ByteArrayOutputStream();
    try {
      service.files().export(realFileId, "application/pdf")
          .executeMediaAndDownloadTo(outputStream);

      return (ByteArrayOutputStream) outputStream;
    } catch (GoogleJsonResponseException e) {
      // TODO(developer) - handle error appropriately
      System.err.println("Unable to export file: " + e.getDetails());
      throw e;
    }
  }
}

Python

drive/snippets/drive-v3/file_snippet/export_pdf.py

Ver en GitHub

import io

import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError
from googleapiclient.http import MediaIoBaseDownload


def export_pdf(real_file_id):
  """Download a Document file in PDF format.
  Args:
      real_file_id : file ID of any workspace document format file
  Returns : IO object with location

  Load pre-authorized user credentials from the environment.
  TODO(developer) - See https://developers.google.com/identity
  for guides on implementing OAuth2 for the application.
  """
  creds, _ = google.auth.default()

  try:
    # create drive api client
    service = build("drive", "v3", credentials=creds)

    file_id = real_file_id

    # pylint: disable=maybe-no-member
    request = service.files().export_media(
        fileId=file_id, mimeType="application/pdf"
    )
    file = io.BytesIO()
    downloader = MediaIoBaseDownload(file, request)
    done = False
    while done is False:
      status, done = downloader.next_chunk()
      print(f"Download {int(status.progress() * 100)}.")

  except HttpError as error:
    print(f"An error occurred: {error}")
    file = None

  return file.getvalue()


if __name__ == "__main__":
  export_pdf(real_file_id="1zbp8wAyuImX91Jt9mI-CAX_1TqkBLDEDcr2WeXBbKUY")

Node.js

drive/snippets/drive_v3/file_snippets/export_pdf.js

Ver en GitHub

import {GoogleAuth} from 'google-auth-library';
import {google} from 'googleapis';

/**
 * Exports a Google Doc as a PDF.
 * @param {string} fileId The ID of the file to export.
 * @return {Promise<number>} The status of the export request.
 */
async function exportPdf(fileId) {
  // Authenticate with Google and get an authorized client.
  // TODO (developer): Use an appropriate auth mechanism for your app.
  const auth = new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/drive',
  });

  // Create a new Drive API client (v3).
  const service = google.drive({version: 'v3', auth});

  // Export the file as a PDF.
  const result = await service.files.export({
    fileId,
    mimeType: 'application/pdf',
  });

  // Print the status of the export.
  console.log(result.status);
  return result.status;
}

PHP

drive/snippets/drive_v3/src/DriveExportPdf.php

Ver en GitHub

<?php
use Google\Client;
use Google\Service\Drive;
function exportPdf()
{
    try {
        $client = new Client();
        $client->useApplicationDefaultCredentials();
        $client->addScope(Drive::DRIVE);
        $driveService = new Drive($client);
        $realFileId = readline("Enter File Id: ");
        $fileId = '1ZdR3L3qP4Bkq8noWLJHSr_iBau0DNT4Kli4SxNc2YEo';
        $fileId = $realFileId;
        $response = $driveService->files->export($fileId, 'application/pdf', array(
            'alt' => 'media'));
        $content = $response->getBody()->getContents();
        return $content;

    }  catch(Exception $e) {
         echo "Error Message: ".$e;
    }

}

.NET

drive/snippets/drive_v3/DriveV3Snippets/ExportPdf.cs

Ver en GitHub

using Google.Apis.Auth.OAuth2;
using Google.Apis.Download;
using Google.Apis.Drive.v3;
using Google.Apis.Services;

namespace DriveV3Snippets
{
    // Class to demonstrate use of Drive export pdf
    public class ExportPdf
    {
        /// <summary>
        /// Download a Document file in PDF format.
        /// </summary>
        /// <param name="fileId">Id of the file.</param>
        /// <returns>Byte array stream if successful, null otherwise</returns>
        public static MemoryStream DriveExportPdf(string fileId)
        {
            try
            {
                /* Load pre-authorized user credentials from the environment.
                 TODO(developer) - See https://developers.google.com/identity for 
                 guides on implementing OAuth2 for your application. */
                GoogleCredential credential = GoogleCredential.GetApplicationDefault()
                    .CreateScoped(DriveService.Scope.Drive);

                // Create Drive API service.
                var service = new DriveService(new BaseClientService.Initializer
                {
                    HttpClientInitializer = credential,
                    ApplicationName = "Drive API Snippets"
                });

                var request = service.Files.Export(fileId, "application/pdf");
                var stream = new MemoryStream();
                // Add a handler which will be notified on progress changes.
                // It will notify on each chunk download and when the
                // download is completed or failed.
                request.MediaDownloader.ProgressChanged +=
                    progress =>
                    {
                        switch (progress.Status)
                        {
                            case DownloadStatus.Downloading:
                            {
                                Console.WriteLine(progress.BytesDownloaded);
                                break;
                            }
                            case DownloadStatus.Completed:
                            {
                                Console.WriteLine("Download complete.");
                                break;
                            }
                            case DownloadStatus.Failed:
                            {
                                Console.WriteLine("Download failed.");
                                break;
                            }
                        }
                    };
                request.Download(stream);
                return stream;
            }
            catch (Exception e)
            {
                // TODO(developer) - handle error appropriately
                if (e is AggregateException)
                {
                    Console.WriteLine("Credential Not found");
                }
                else
                {
                    throw;
                }
            }
            return null;
        }
    }
}

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.

En las muestras 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.

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 documentos 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

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.

Cómo descargar y exportar archivos Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Descarga el contenido del archivo BLOB

Apps Script

Java

Python

Node.js

PHP

.NET

curl

Accede a los datos de archivos en la memoria

Descarga parcial

Descarga el contenido del archivo BLOB en una versión anterior

curl

Descarga el contenido del archivo blob en un navegador

curl

Descarga el contenido de archivos BLOB con operaciones de larga duración

curl

Cómo exportar contenido de documentos de Google Workspace

Apps Script

Java

Python

Node.js

PHP

.NET

curl

Cómo exportar contenido de documentos de Google Workspace en un navegador

curl

Cómo exportar contenido de documentos de Google Workspace en una versión anterior en un navegador

curl

Exporta contenido de documentos de Google Workspace con operaciones de larga duración

curl

Temas relacionados

Cómo descargar y exportar archivos