Dateien herunterladen und exportieren

Die Google Drive API unterstützt verschiedene Arten von Download- und Exportaktionen, darunter: in der folgenden Tabelle aufgeführt:

Downloads
Inhalt der Blob-Datei, der die Methode files.get mit dem URL-Parameter alt=media verwendet.
Blob-Dateiinhalte in einer früheren Version mithilfe der Methode revisions.get und dem URL-Parameter alt=media.
Blob-Dateiinhalte in einem Browser mit dem Feld webContentLink.
Exporte
Inhalte von Google Workspace-Dokumenten in einem Format, das Ihre App mit files.export verarbeiten kann.
Inhalt eines Google Workspace-Dokuments in einem Browser mit dem Feld exportLinks.
Google Workspace-Dokumentinhalt in einer früheren Version in einem Browser mit dem Feld exportLinks.

Stellen Sie vor dem Herunterladen oder Exportieren von Dateiinhalten sicher, dass Nutzer die mit dem Feld capabilities.canDownload auf der Ressource files.

Der Rest dieses Handbuchs enthält detaillierte Anweisungen für diese Arten von Aufgaben. von Download- und Exportaktionen.

Inhalt der Blob-Datei herunterladen

Wenn Sie eine in Drive gespeicherte Blob-Datei herunterladen möchten, verwenden Sie die Methode files.get mit der ID der herunterzuladenden Datei und den URL-Parameter alt=media. Der URL-Parameter alt=media teilt dem Server, dass als alternative Antwort ein Inhalts-Download angefordert wird Format.

Der URL-Parameter alt=media ist ein System Parameter in allen Google REST APIs verfügbar. Wenn Sie eine Clientbibliothek für den Drive API verwenden, müssen Sie diesen Parameter nicht explizit festlegen.

Das folgende Codebeispiel zeigt, wie Sie mit der Methode files.get eine mit den Drive API-Clientbibliotheken.

Java

drive/snippets/drive_v3/src/main/java/DownloadFile.java
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
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
/**
 * Downloads a file
 * @param{string} realFileId file ID
 * @return{obj} file status
 * */
async function downloadFile(realFileId) {
  // Get credentials and build service
  // TODO (developer) - Use appropriate auth mechanism for your app

  const {GoogleAuth} = require('google-auth-library');
  const {google} = require('googleapis');

  const auth = new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/drive',
  });
  const service = google.drive({version: 'v3', auth});

  fileId = realFileId;
  try {
    const file = await service.files.get({
      fileId: fileId,
      alt: 'media',
    });
    console.log(file.status);
    return file.status;
  } catch (err) {
    // TODO(developer) - Handle error
    throw err;
  }
}

PHP

drive/snippets/drive_v3/src/DriveDownloadFile.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
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;
        }
    }
}

In diesem Codebeispiel wird eine Bibliotheksmethode verwendet, mit der der URL-Parameter alt=media hinzugefügt wird. an die zugrunde liegende HTTP-Anfrage an.

Dateidownloads, die über Ihre App gestartet wurden, müssen mit einem Bereich autorisiert werden, der Folgendes zulässt: Lesezugriff auf den Dateiinhalt haben. Beispiel: Eine App, die das Der Bereich drive.readonly.metadata ist nicht berechtigt, den Dateiinhalt herunterzuladen. In diesem Codebeispiel wird der eingeschränkte Dateibereich „Drive“ verwendet, mit dem Nutzer Drive-Dateien ansehen und verwalten. Weitere Informationen über Drive-Bereiche, siehe Google Drive API auswählen Bereiche.

Nutzer mit Bearbeitungsberechtigung können das Herunterladen auf Nutzer mit Lesezugriff beschränken über copyRequiresWriterPermission festlegen auf false.

Folgende Dateien wurden identifiziert: missbräuchlich (z. B. schädliche Software) können nur vom Eigentümer der Datei heruntergeladen werden. Außerdem muss der get-Abfrageparameter acknowledgeAbuse=true enthalten sein um anzuzeigen, dass der Nutzer das Risiko des Downloads potenziell unerwünschte Software oder andere missbräuchliche Dateien. Ihre Anwendung sollte interaktiv Nutzer warnen, bevor dieser Suchparameter verwendet wird.

Teildownload

Beim teilweisen Download wird nur ein bestimmter Teil einer Datei heruntergeladen. Ich können Sie angeben, welchen Teil der Datei Sie herunterladen möchten, indem Sie ein byte Bereich durch die Kopfzeile Range. Beispiel:

Range: bytes=500-999

Inhalt der Blob-Datei in einer früheren Version herunterladen

Um den Inhalt von Blob-Dateien mit einer früheren Version herunterzuladen, verwenden Sie die Methode Methode revisions.get mit der ID die heruntergeladene Datei, die ID der Version und den URL-Parameter alt=media. Der URL-Parameter alt=media teilt dem Server mit, dass ein Inhaltsdownload als alternatives Antwortformat angefordert werden. Ähnlich wie bei files.get wird das Die Methode revisions.get akzeptiert auch den optionalen Suchparameter acknowledgeAbuse und den Header Range. Weitere Informationen zum Herunterladen finden Sie unter Datei herunterladen und veröffentlichen Überarbeitungen.

Inhalt der Blob-Datei in einem Browser herunterladen

Um den Inhalt von Blob-Dateien herunterzuladen, die in Drive in einem Browser statt über die API, verwenden Sie webContentLink des files-Ressource. Wenn der Nutzer Zugriff auf die Datei hat, wird ein Link zum Herunterladen der Datei und ihrer Inhalte angezeigt. zurückgegeben. Sie können einen Nutzer entweder an diese URL weiterleiten oder sie als anklickbare .

Inhalte von Google Workspace-Dokumenten exportieren

Verwenden Sie zum Exportieren von Byte-Inhalten aus Google Workspace-Dokumenten die Methode files.export mit der ID der zu exportierenden Datei und den richtigen MIME-Typ aus. Exportiert Content auf eine Größe von 10 MB begrenzt ist.

Das folgende Codebeispiel zeigt, wie Sie mit der Methode files.export ein Google Workspace-Dokumente im PDF-Format mit dem Drive API-Client Bibliotheken:

Java

drive/snippets/drive_v3/src/main/java/ExportPdf.java
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
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
/**
 * Download a Document file in PDF format
 * @param{string} fileId file ID
 * @return{obj} file status
 * */
async function exportPdf(fileId) {
  const {GoogleAuth} = require('google-auth-library');
  const {google} = require('googleapis');

  // Get credentials and build service
  // TODO (developer) - Use appropriate auth mechanism for your app
  const auth = new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/drive',
  });
  const service = google.drive({version: 'v3', auth});

  try {
    const result = await service.files.export({
      fileId: fileId,
      mimeType: 'application/pdf',
    });
    console.log(result.status);
    return result;
  } catch (err) {
    // TODO(developer) - Handle error
    throw err;
  }
}

PHP

drive/snippets/drive_v3/src/DriveExportPdf.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
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;
        }
    }
}

In diesem Codebeispiel wird der eingeschränkte drive-Bereich verwendet, mit dem Nutzer alle Ihre Drive-Dateien verwalten. Weitere Informationen über Drive-Bereiche, siehe Google Drive API auswählen Bereiche.

Im Codebeispiel wird auch der Export-MIME-Typ als application/pdf deklariert. Für eine Vollständige Liste aller unterstützten Export-MIME-Typen für die einzelnen Google Workspace-Dienste Weitere Informationen zum Exportieren von MIME-Typen für Google Workspace Dokumente.

Inhalte von Google Workspace-Dokumenten in einen Browser exportieren

Wenn Sie Inhalte von Google Workspace-Dokumenten in einem Browser exportieren möchten, verwenden Sie die exportLinks des files-Ressource. Je nach Dokument -Typ gesetzt ist, wird für jede MIME-Nachricht ein Link zum Herunterladen der Datei und ihr Inhalt zurückgegeben. Typ verfügbar. Sie können einen Nutzer entweder an eine URL weiterleiten oder diese als anklickbarer Link.

Inhalte von Google Workspace-Dokumenten in einer früheren Version in einen Browser exportieren

Um den Inhalt eines Google Workspace-Dokuments in einer früheren Version innerhalb eines Browser verwenden, verwenden Sie die Methode revisions.get durch die ID der herunterzuladenden Datei und die ID der Version. Wenn der Nutzer Zugriff auf die Datei haben, wird ein Link zum Herunterladen der Datei und ihrer Inhalte angezeigt. zurückgegeben. Sie können einen Nutzer entweder an diese URL weiterleiten oder sie als anklickbare .