Method: files.get

Ruft die Metadaten oder den Inhalt einer Datei anhand der ID ab.

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 Google Drive gespeichert ist. Verwenden Sie stattdessen files.export, um Google Docs, Google Tabellen und Google Präsentationen herunterzuladen. Weitere Informationen finden Sie unter Dateien herunterladen und exportieren.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
fileId

string

Die ID der betreffenden Datei.

Abfrageparameter

Parameter
acknowledgeAbuse

boolean

Ob der Nutzer das Risiko des Herunterladens bekannter Malware oder anderer schädlicher Dateien akzeptiert. Dies gilt nur, wenn der Parameter alt auf media festgelegt ist und der Nutzer der Eigentümer der Datei oder ein Organisator der geteilten Ablage ist, in der sich die Datei befindet.
projection
(deprecated)

enum (Projection)

Eingestellt: Dieser Parameter hat keine Funktion.
revisionId

string

Gibt die Versions-ID an, die heruntergeladen werden soll. Wird ignoriert, sofern nicht „alt=media“ angegeben ist.
supportsAllDrives

boolean

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

boolean

Verworfen. Verwenden Sie stattdessen supportsAllDrives.
updateViewedDate
(deprecated)

boolean

Verworfen. Verwenden Sie files.update mit modifiedDateBehavior=noChange, updateViewedDate=true und einem leeren Anfragetext.
includePermissionsForView

string

Gibt an, welche Berechtigungen der zusätzlichen Ansicht in der Antwort enthalten sein sollen. Nur published wird unterstützt.
includeLabels

string

Eine durch Kommas getrennte Liste von IDs von Labels, die in den Teil labelInfo der Antwort aufgenommen werden 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/docs
  • 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, damit Ihre App sie verwenden kann. Weitere Informationen finden Sie im Leitfaden zur Autorisierung.