Die Google Drive API unterstützt verschiedene Arten von Download- und Exportaktionen, darunter: in der folgenden Tabelle aufgeführt:
Downloads |
|
|||
Exporte |
|
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 Typen. 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
Python
Node.js
PHP
.NET
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
Python
Node.js
PHP
.NET
In diesem Codebeispiel wird der eingeschränkte drive
-Bereich verwendet, mit dem Nutzer Folgendes aufrufen und bearbeiten können:
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-Konten
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 Überarbeitung. 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
.