Method: files.get
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[],[],null,["# Method: files.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\n\u003cbr /\u003e\n\nGets a file's metadata or content by ID.\n\nIf you provide the URL parameter `alt=media`, then the response includes the file contents in the response body. Downloading content with `alt=media` only works if the file is stored in Drive. To download Google Docs, Sheets, and Slides use [`files.export`](/workspace/drive/api/reference/rest/v2/files/export) instead. For more information, see [Download \\& export files](/workspace/drive/api/guides/manage-downloads).\n\n### HTTP request\n\n`GET https://www.googleapis.com/drive/v2/files/{fileId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------|\n| `fileId` | `string` The ID for the file in question. |\n\n### Query parameters\n\n| Parameters ||\n|---------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `acknowledgeAbuse` | `boolean` Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the `alt` parameter is set to `media` and the user is the owner of the file or an organizer of the shared drive in which the file resides. |\n| `projection` **(deprecated)** | `enum (`[Projection](/workspace/drive/api/reference/rest/v2/Projection)`)` Deprecated: This parameter has no function. |\n| `revisionId` | `string` Specifies the Revision ID that should be downloaded. Ignored unless alt=media is specified. |\n| `supportsAllDrives` | `boolean` Whether the requesting application supports both My Drives and shared drives. |\n| `supportsTeamDrives` **(deprecated)** | `boolean` Deprecated: Use `supportsAllDrives` instead. |\n| `updateViewedDate` **(deprecated)** | `boolean` Deprecated: Use `files.update` with `modifiedDateBehavior=noChange, updateViewedDate=true` and an empty request body. |\n| `includePermissionsForView` | `string` Specifies which additional view's permissions to include in the response. Only `published` is supported. |\n| `includeLabels` | `string` A comma-separated list of IDs of labels to include in the `labelInfo` part of the response. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [File](/workspace/drive/api/reference/rest/v2/files#File).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/docs`\n- `\n https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.appdata`\n- `\n https://www.googleapis.com/auth/drive.file`\n- `\n https://www.googleapis.com/auth/drive.meet.readonly`\n- `\n https://www.googleapis.com/auth/drive.metadata`\n- `\n https://www.googleapis.com/auth/drive.metadata.readonly`\n- `\n https://www.googleapis.com/auth/drive.photos.readonly`\n- `\n https://www.googleapis.com/auth/drive.readonly`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
