Die Google Drive API unterstützt verschiedene Arten von Download- und Exportaktionen, wie in der folgenden Tabelle aufgeführt:
Downloads |
|
|||
Exporte |
|
Bevor Sie Dateiinhalte herunterladen oder exportieren, prüfen Sie, ob Nutzer die Datei über das Feld capabilities.canDownload
in der Ressource files
herunterladen können.
Im weiteren Verlauf dieses Leitfadens finden Sie detaillierte Anleitungen zum Ausführen dieser Arten 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 dem URL-Parameter alt=media
. Über den URL-Parameter alt=media
wird dem Server mitgeteilt, dass ein Download von Inhalten als alternatives Antwortformat angefordert wird.
Der URL-Parameter alt=media
ist ein Systemparameter, der für alle Google REST APIs verfügbar ist. Wenn Sie eine Clientbibliothek für die Drive API verwenden, müssen Sie diesen Parameter nicht explizit festlegen.
Im folgenden Codebeispiel wird gezeigt, wie Sie mit der Methode files.get
eine Datei mit den Drive API-Clientbibliotheken herunterladen.
Java
Python
Node.js
PHP
.NET
In diesem Codebeispiel wird eine Bibliotheksmethode verwendet, mit der der URL-Parameter alt=media
der zugrunde liegenden HTTP-Anfrage hinzugefügt wird.
Dateidownloads, die von Ihrer Anwendung gestartet wurden, müssen mit einem Bereich autorisiert werden, der Lesezugriff auf den Dateiinhalt zulässt. Beispielsweise ist eine Anwendung mit dem Bereich drive.readonly.metadata
nicht berechtigt, den Dateiinhalt herunterzuladen.
In diesem Codebeispiel wird der eingeschränkte Drive-Dateibereich verwendet, mit dem Nutzer alle Ihre Drive-Dateien ansehen und verwalten können. Weitere Informationen zu Drive-Bereichen finden Sie unter Google Drive API-Bereiche auswählen.
Nutzer mit Bearbeitungsberechtigungen können das Herunterladen einschränken. Nutzer mit Lesezugriff können das Feld copyRequiresWriterPermission
auf false
setzen.
Als missbräuchlich eingestufte Dateien (z. B. schädliche Software) können nur vom Dateieigentümer heruntergeladen werden.
Darüber hinaus muss der get
-Abfrageparameter acknowledgeAbuse=true
enthalten sein, um anzugeben, dass der Nutzer das Risiko des Herunterladens potenziell unerwünschter Software oder anderer missbräuchlicher Dateien bestätigt hat. Ihre Anwendung sollte den Nutzer interaktiv warnen, bevor dieser Abfrageparameter verwendet wird.
Teilweiser Download
Bei einem teilweisen Download wird nur ein bestimmter Teil der Datei heruntergeladen. Sie können den Teil der Datei angeben, den Sie herunterladen möchten. Verwenden Sie dazu einen Bytebereich mit dem Header Range
. Beispiel:
Range: bytes=500-999
Inhalt der Blob-Datei mit einer früheren Version herunterladen
Wenn Sie den Inhalt von Blob-Dateien mit einer früheren Version herunterladen möchten, verwenden Sie die Methode revisions.get
mit der ID der herunterzuladenden Datei, der ID der Überarbeitung und dem URL-Parameter alt=media
.
Über den URL-Parameter alt=media
wird dem Server mitgeteilt, dass ein Download von Inhalten als alternatives Antwortformat angefordert wird. Ähnlich wie bei files.get
akzeptiert die Methode revisions.get
auch den optionalen Abfrageparameter acknowledgeAbuse
und den Header Range
. Weitere Informationen zum Herunterladen von Überarbeitungen finden Sie unter Dateiüberarbeitungen herunterladen und veröffentlichen.
Inhalt der Blob-Datei in einem Browser herunterladen
Wenn Sie den Inhalt von Blob-Dateien, die in Drive gespeichert sind, in einem Browser statt über die API herunterladen möchten, verwenden Sie das Feld webContentLink
der Ressource files
. Wenn der Nutzer Downloadzugriff auf die Datei hat, wird ein Link zum Herunterladen der Datei und ihres Inhalts zurückgegeben. Du kannst den Nutzer entweder zu dieser URL weiterleiten oder sie als anklickbaren Link anbieten.
Google Workspace-Dokumentinhalt exportieren
Verwenden Sie zum Exportieren von Byteinhalten von Google Workspace-Dokumenten die Methode files.export
mit der ID der zu exportierenden Datei und dem richtigen MIME-Typ. Exportierte Inhalte sind auf 10 MB begrenzt.
Das folgende Codebeispiel zeigt, wie Sie mit der Methode files.export
ein Google Workspace-Dokument mithilfe der Drive API-Clientbibliotheken im PDF-Format exportieren:
Java
Python
Node.js
PHP
.NET
In diesem Codebeispiel wird der eingeschränkte Bereich drive
verwendet, mit dem Nutzer alle Ihre Drive-Dateien ansehen und verwalten können. Weitere Informationen zu Drive-Bereichen finden Sie unter Google Drive API-Bereiche auswählen.
Im Codebeispiel wird auch der MIME-Typ für den Export als application/pdf
deklariert. Eine vollständige Liste aller Export-MIME-Typen, die für die einzelnen Google Workspace-Dokumente unterstützt werden, finden Sie unter MIME-Typen für Google Workspace-Dokumente exportieren.
Inhalte von Google Workspace-Dokumenten in einen Browser exportieren
Wenn Sie Inhalte von Google Workspace-Dokumenten in einem Browser exportieren möchten, verwenden Sie das Feld exportLinks
der Ressource files
. Je nach Dokumenttyp wird für jeden verfügbaren MIME-Typ ein Link zum Herunterladen der Datei und ihres Inhalts zurückgegeben. Du kannst einen Nutzer entweder zu einer URL weiterleiten oder diese als anklickbaren Link anbieten.
Inhalte von Google Workspace-Dokumenten mit einer früheren Version über einen Browser exportieren
Wenn Sie den Inhalt eines Google Workspace-Dokuments mit einer früheren Version in einem Browser exportieren möchten, verwenden Sie die Methode revisions.get
mit der ID der herunterzuladenden Datei und der ID der Überarbeitung. Wenn der Nutzer Downloadzugriff auf die Datei hat, wird ein Link zum Herunterladen der Datei und ihres Inhalts zurückgegeben. Du kannst den Nutzer entweder zu dieser URL weiterleiten oder sie als anklickbaren Link anbieten.