Get a file's metadata or content by ID
GET {{baseUrl}}/files/:fileId?key={{key}}&oauth_token={{oauthToken}}
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.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
acknowledgeAbuse | string | Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when alt=media. | |
includeLabels | string | A comma-separated list of IDs of labels to include in the labelInfo part of the response. | |
includePermissionsForView | string | Specifies which additional view's permissions to include in the response. Only 'published' is supported. | |
supportsAllDrives | string | Whether the requesting application supports both My Drives and shared drives. | |
supportsTeamDrives | string | Deprecated use supportsAllDrives instead. | |
alt | string | Data format for the response. | |
fields | string | Selector specifying which fields to include in a partial response. | |
key | string | API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. | |
oauth_token | string | OAuth 2.0 token for the current user. | |
prettyPrint | string | Returns response with indentations and line breaks. | |
quotaUser | string | An opaque string that represents a user for quota purposes. Must not exceed 40 characters. | |
userIp | string | Deprecated. Please use quotaUser instead. |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"appProperties":{"essef3a":"\u003cstring\u003e","magna9e":"\u003cstring\u003e"},"capabilities":{"canAcceptOwnership":"\u003cboolean\u003e","canAddChildren":"\u003cboolean\u003e","canAddFolderFromAnotherDrive":"\u003cboolean\u003e","canAddMyDriveParent":"\u003cboolean\u003e","canChangeCopyRequiresWriterPermission":"\u003cboolean\u003e","canChangeSecurityUpdateEnabled":"\u003cboolean\u003e","canChangeViewersCanCopyContent":"\u003cboolean\u003e","canComment":"\u003cboolean\u003e","canCopy":"\u003cboolean\u003e","canDelete":"\u003cboolean\u003e","canDeleteChildren":"\u003cboolean\u003e","canDownload":"\u003cboolean\u003e","canEdit":"\u003cboolean\u003e","canListChildren":"\u003cboolean\u003e","canModifyContent":"\u003cboolean\u003e","canModifyContentRestriction":"\u003cboolean\u003e","canModifyLabels":"\u003cboolean\u003e","canMoveChildrenOutOfDrive":"\u003cboolean\u003e","canMoveChildrenOutOfTeamDrive":"\u003cboolean\u003e","canMoveChildrenWithinDrive":"\u003cboolean\u003e","canMoveChildrenWithinTeamDrive":"\u003cboolean\u003e","canMoveItemIntoTeamDrive":"\u003cboolean\u003e","canMoveItemOutOfDrive":"\u003cboolean\u003e","canMoveItemOutOfTeamDrive":"\u003cboolean\u003e","canMoveItemWithinDrive":"\u003cboolean\u003e","canMoveItemWithinTeamDrive":"\u003cboolean\u003e","canMoveTeamDriveItem":"\u003cboolean\u003e","canReadDrive":"\u003cboolean\u003e","canReadLabels":"\u003cboolean\u003e","canReadRevisions":"\u003cboolean\u003e","canReadTeamDrive":"\u003cboolean\u003e","canRemoveChildren":"\u003cboolean\u003e","canRemoveMyDriveParent":"\u003cboolean\u003e","canRename":"\u003cboolean\u003e","canShare":"\u003cboolean\u003e","canTrash":"\u003cboolean\u003e","canTrashChildren":"\u003cboolean\u003e","canUntrash":"\u003cboolean\u003e"},"contentHints":{"indexableText":"\u003cstring\u003e","thumbnail":{"image":"\u003cstring\u003e","mimeType":"\u003cstring\u003e"}},"contentRestrictions":[{"readOnly":"\u003cboolean\u003e","reason":"\u003cstring\u003e","restrictingUser":{"displayName":"\u003cstring\u003e","emailAddress":"\u003cstring\u003e","kind":"drive#user","me":"\u003cboolean\u003e","permissionId":"\u003cstring\u003e","photoLink":"\u003cstring\u003e"},"restrictionTime":"\u003cdateTime\u003e","type":"\u003cstring\u003e"},{"readOnly":"\u003cboolean\u003e","reason":"\u003cstring\u003e","restrictingUser":{"displayName":"\u003cstring\u003e","emailAddress":"\u003cstring\u003e","kind":"drive#user","me":"\u003cboolean\u003e","permissionId":"\u003cstring\u003e","photoLink":"\u003cstring\u003e"},"restrictionTime":"\u003cdateTime\u003e","type":"\u003cstring\u003e"}],"copyRequiresWriterPermission":"\u003cboolean\u003e","createdTime":"\u003cdateTime\u003e","description":"\u003cstring\u003e","driveId":"\u003cstring\u003e","explicitlyTrashed":"\u003cboolean\u003e","exportLinks":{"ea2eb":"\u003cstring\u003e"},"fileExtension":"\u003cstring\u003e","folderColorRgb":"\u003cstring\u003e","fullFileExtension":"\u003cstring\u003e","hasAugmentedPermissions":"\u003cboolean\u003e","hasThumbnail":"\u003cboolean\u003e","headRevisionId":"\u003cstring\u003e","iconLink":"\u003cstring\u003e","id":"\u003cstring\u003e","imageMediaMetadata":{"aperture":"\u003cfloat\u003e","cameraMake":"\u003cstring\u003e","cameraModel":"\u003cstring\u003e","colorSpace":"\u003cstring\u003e","exposureBias":"\u003cfloat\u003e","exposureMode":"\u003cstring\u003e","exposureTime":"\u003cfloat\u003e","flashUsed":"\u003cboolean\u003e","focalLength":"\u003cfloat\u003e","height":"\u003cinteger\u003e","isoSpeed":"\u003cinteger\u003e","lens":"\u003cstring\u003e","location":{"altitude":"\u003cdouble\u003e","latitude":"\u003cdouble\u003e","longitude":"\u003cdouble\u003e"},"maxApertureValue":"\u003cfloat\u003e","meteringMode":"\u003cstring\u003e","rotation":"\u003cinteger\u003e","sensor":"\u003cstring\u003e","subjectDistance":"\u003cinteger\u003e","time":"\u003cstring\u003e","whiteBalance":"\u003cstring\u003e","width":"\u003cinteger\u003e"},"isAppAuthorized":"\u003cboolean\u003e","kind":"drive#file","labelInfo":{"labels":[{"fields":{"eu_9c":{"dateString":["\u003cdate\u003e","\u003cdate\u003e"],"id":"\u003cstring\u003e","integer":["\u003cint64\u003e","\u003cint64\u003e"],"kind":"drive#labelField","selection":["\u003cstring\u003e","\u003cstring\u003e"],"text":["\u003cstring\u003e","\u003cstring\u003e"],"user":[{"displayName":"\u003cstring\u003e","emailAddress":"\u003cstring\u003e","kind":"drive#user","me":"\u003cboolean\u003e","permissionId":"\u003cstring\u003e","photoLink":"\u003cstring\u003e"},{"displayName":"\u003cstring\u003e","emailAddress":"\u003cstring\u003e","kind":"drive#user","me":"\u003cboolean\u003e","permissionId":"\u003cstring\u003e","photoLink":"\u003cstring\u003e"}],"valueType":"\u003cstring\u003e"}},"id":"\u003cstring\u003e","kind":"drive#label","revisionId":"\u003cstring\u003e"},{"fields":{"dolor65":{"dateString":["\u003cdate\u003e","\u003cdate\u003e"],"id":"\u003cstring\u003e","integer":["\u003cint64\u003e","\u003cint64\u003e"],"kind":"drive#labelField","selection":["\u003cstring\u003e","\u003cstring\u003e"],"text":["\u003cstring\u003e","\u003cstring\u003e"],"user":[{"displayName":"\u003cstring\u003e","emailAddress":"\u003cstring\u003e","kind":"drive#user","me":"\u003cboolean\u003e","permissionId":"\u003cstring\u003e","photoLink":"\u003cstring\u003e"},{"displayName":"\u003cstring\u003e","emailAddress":"\u003cstring\u003e","kind":"drive#user","me":"\u003cboolean\u003e","permissionId":"\u003cstring\u003e","photoLink":"\u003cstring\u003e"}],"valueType":"\u003cstring\u003e"}},"id":"\u003cstring\u003e","kind":"drive#label","revisionId":"\u003cstring\u003e"}]},"lastModifyingUser":{"displayName":"\u003cstring\u003e","emailAddress":"\u003cstring\u003e","kind":"drive#user","me":"\u003cboolean\u003e","permissionId":"\u003cstring\u003e","photoLink":"\u003cstring\u003e"},"linkShareMetadata":{"securityUpdateEligible":"\u003cboolean\u003e","securityUpdateEnabled":"\u003cboolean\u003e"},"md5Checksum":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","modifiedByMe":"\u003cboolean\u003e","modifiedByMeTime":"\u003cdateTime\u003e","modifiedTime":"\u003cdateTime\u003e","name":"\u003cstring\u003e","originalFilename":"\u003cstring\u003e","ownedByMe":"\u003cboolean\u003e","owners":[{"displayName":"\u003cstring\u003e","emailAddress":"\u003cstring\u003e","kind":"drive#user","me":"\u003cboolean\u003e","permissionId":"\u003cstring\u003e","photoLink":"\u003cstring\u003e"},{"displayName":"\u003cstring\u003e","emailAddress":"\u003cstring\u003e","kind":"drive#user","me":"\u003cboolean\u003e","permissionId":"\u003cstring\u003e","photoLink":"\u003cstring\u003e"}],"parents":["\u003cstring\u003e","\u003cstring\u003e"],"permissionIds":["\u003cstring\u003e","\u003cstring\u003e"],"permissions":[{"allowFileDiscovery":"\u003cboolean\u003e","deleted":"\u003cboolean\u003e","displayName":"\u003cstring\u003e","domain":"\u003cstring\u003e","emailAddress":"\u003cstring\u003e","expirationTime":"\u003cdateTime\u003e","id":"\u003cstring\u003e","kind":"drive#permission","pendingOwner":"\u003cboolean\u003e","permissionDetails":[{"inherited":"\u003cboolean\u003e","inheritedFrom":"\u003cstring\u003e","permissionType":"\u003cstring\u003e","role":"\u003cstring\u003e"},{"inherited":"\u003cboolean\u003e","inheritedFrom":"\u003cstring\u003e","permissionType":"\u003cstring\u003e","role":"\u003cstring\u003e"}],"photoLink":"\u003cstring\u003e","role":"\u003cstring\u003e","teamDrivePermissionDetails":[{"inherited":"\u003cboolean\u003e","inheritedFrom":"\u003cstring\u003e","role":"\u003cstring\u003e","teamDrivePermissionType":"\u003cstring\u003e"},{"inherited":"\u003cboolean\u003e","inheritedFrom":"\u003cstring\u003e","role":"\u003cstring\u003e","teamDrivePermissionType":"\u003cstring\u003e"}],"type":"\u003cstring\u003e","view":"\u003cstring\u003e"},{"allowFileDiscovery":"\u003cboolean\u003e","deleted":"\u003cboolean\u003e","displayName":"\u003cstring\u003e","domain":"\u003cstring\u003e","emailAddress":"\u003cstring\u003e","expirationTime":"\u003cdateTime\u003e","id":"\u003cstring\u003e","kind":"drive#permission","pendingOwner":"\u003cboolean\u003e","permissionDetails":[{"inherited":"\u003cboolean\u003e","inheritedFrom":"\u003cstring\u003e","permissionType":"\u003cstring\u003e","role":"\u003cstring\u003e"},{"inherited":"\u003cboolean\u003e","inheritedFrom":"\u003cstring\u003e","permissionType":"\u003cstring\u003e","role":"\u003cstring\u003e"}],"photoLink":"\u003cstring\u003e","role":"\u003cstring\u003e","teamDrivePermissionDetails":[{"inherited":"\u003cboolean\u003e","inheritedFrom":"\u003cstring\u003e","role":"\u003cstring\u003e","teamDrivePermissionType":"\u003cstring\u003e"},{"inherited":"\u003cboolean\u003e","inheritedFrom":"\u003cstring\u003e","role":"\u003cstring\u003e","teamDrivePermissionType":"\u003cstring\u003e"}],"type":"\u003cstring\u003e","view":"\u003cstring\u003e"}],"properties":{"eiusmod_21":"\u003cstring\u003e","non3c":"\u003cstring\u003e"},"quotaBytesUsed":"\u003cint64\u003e","resourceKey":"\u003cstring\u003e","sha1Checksum":"\u003cstring\u003e","sha256Checksum":"\u003cstring\u003e","shared":"\u003cboolean\u003e","sharedWithMeTime":"\u003cdateTime\u003e","sharingUser":{"displayName":"\u003cstring\u003e","emailAddress":"\u003cstring\u003e","kind":"drive#user","me":"\u003cboolean\u003e","permissionId":"\u003cstring\u003e","photoLink":"\u003cstring\u003e"},"shortcutDetails":{"targetId":"\u003cstring\u003e","targetMimeType":"\u003cstring\u003e","targetResourceKey":"\u003cstring\u003e"},"size":"\u003cint64\u003e","spaces":["\u003cstring\u003e","\u003cstring\u003e"],"starred":"\u003cboolean\u003e","teamDriveId":"\u003cstring\u003e","thumbnailLink":"\u003cstring\u003e","thumbnailVersion":"\u003cint64\u003e","trashed":"\u003cboolean\u003e","trashedTime":"\u003cdateTime\u003e","trashingUser":{"displayName":"\u003cstring\u003e","emailAddress":"\u003cstring\u003e","kind":"drive#user","me":"\u003cboolean\u003e","permissionId":"\u003cstring\u003e","photoLink":"\u003cstring\u003e"},"version":"\u003cint64\u003e","videoMediaMetadata":{"durationMillis":"\u003cint64\u003e","height":"\u003cinteger\u003e","width":"\u003cinteger\u003e"},"viewedByMe":"\u003cboolean\u003e","viewedByMeTime":"\u003cdateTime\u003e","viewersCanCopyContent":"\u003cboolean\u003e","webContentLink":"\u003cstring\u003e","webViewLink":"\u003cstring\u003e","writersCanShare":"\u003cboolean\u003e"}