- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
Gets a file's metadata or content by ID.
If 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
instead. For more information, see Download & export files.
HTTP request
GET https://www.googleapis.com/drive/v3/files/{fileId}
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
fileId |
The ID of the file. |
Query parameters
Parameters | |
---|---|
acknowledgeAbuse |
Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the |
supportsAllDrives |
Whether the requesting application supports both My Drives and shared drives. |
supportsTeamDrives |
Deprecated: Use |
includePermissionsForView |
Specifies which additional view's permissions to include in the response. Only 'published' is supported. |
includeLabels |
A comma-separated list of IDs of labels to include in the |
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance of File
.
Authorization scopes
Requires one of the following OAuth scopes:
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
Some scopes are restricted and require a security assessment for your app to use them. For more information, see the Authorization guide.