Method: files.get

Ruft Metadaten oder Inhalte einer Datei anhand der ID ab. Weitere Informationen finden Sie unter Nach Dateien und Ordnern suchen.

Wenn Sie den URL-Parameter alt=media angeben, enthält die Antwort den Dateiinhalt im Antworttext. Das Herunterladen von Inhalten mit alt=media funktioniert nur, wenn die Datei in Drive gespeichert ist. Verwenden Sie stattdessen files.export, um Google Docs, Google Sheets und Google Präsentationen herunterzuladen. Weitere Informationen finden Sie unter Dateien herunterladen und exportieren.

HTTP-Anfrage

GET https://www.googleapis.com/drive/v3/files/{fileId}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
fileId

string

Die ID der Datei.

Abfrageparameter

Parameter
acknowledgeAbuse

boolean

Ob der Nutzer das Risiko des Herunterladens bekannter Malware oder anderer missbräuchlicher Dateien zur Kenntnis nimmt. Dies gilt nur, wenn der Parameter alt auf media gesetzt ist und der Nutzer der Eigentümer der Datei oder ein Organisator der geteilten Ablage ist, in der sich die Datei befindet.
supportsAllDrives

boolean

Ob die anfragende Anwendung sowohl „Meine Ablage“ als auch geteilte Ablagen unterstützt.
supportsTeamDrives
(deprecated)

boolean

Verworfen: Verwenden Sie stattdessen supportsAllDrives.
includePermissionsForView

string

Gibt an, welche Berechtigungen für zusätzliche Ansichten in die Antwort aufgenommen werden sollen. Nur published wird unterstützt.
includeLabels

string

Eine durch Kommas getrennte Liste mit IDs von Labels, die im labelInfo-Teil der Antwort enthalten sein sollen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von File.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

Einige Bereiche sind eingeschränkt und erfordern eine Sicherheitsprüfung für Ihre App, damit sie verwendet werden können. Weitere Informationen finden Sie im Autorisierungsleitfaden.