id | string | The ID of the file. This is generated by the server for new files. A pre-generated ID from files.generateIds may be supplied on create. |
name | string | The name of the file. This isn’t necessarily unique within a folder. Note that for immutable items such as the top-level folders of shared drives, the My Drive root folder, and the Application Data folder, the name is constant. |
mimeType | string | The MIME type of the file. Google Drive attempts to automatically detect an appropriate value from uploaded content, if no value is provided. The value cannot be changed unless a new revision is uploaded. If a file is created with a Google Doc MIME type, the uploaded content is imported, if possible. The supported import formats are published in the about resource. For a folder, use application/vnd.google-apps.folder. For a shortcut, use application/vnd.google-apps.shortcut. |
description | string | A short description of the file. |
parents | string[] | The ID of the parent folder containing the file. A file can only have one parent folder; specifying multiple parents isn’t supported. If not specified as part of a create request, the file is placed directly in the user’s My Drive folder. If not specified as part of a copy request, the file inherits any discoverable parent of the source file. Update requests must use the addParents and removeParents parameters to modify the parents list. |
starred | boolean | Whether the user has starred the file. |
trashed | boolean | Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner may trash a file, but other users can still access the file in the owner’s trash until it’s permanently deleted. |
folderColorRgb | string | The color for a folder or a shortcut to a folder as an RGB hex string. The supported colors are published in the folderColorPalette field of the about resource. If an unsupported color is specified, the closest color in the palette is used instead. |
originalFilename | string | The original filename of the uploaded content if available, or else the original value of the name field. This is only available for files with binary content in Google Drive. |
writersCanShare | boolean | Whether users with only writer permission can modify the file’s permissions. Not populated for items in shared drives. |
copyRequiresWriterPermission | boolean | Whether the options to copy, print, or download this file should be disabled for readers and commenters. |
createdTime | string | The time at which the file was created (RFC 3339 date-time). |
modifiedTime | string | The last time the file was modified by anyone (RFC 3339 date-time). Note that setting modifiedTime also updates modifiedByMeTime for the user. |
viewedByMeTime | string | The last time the file was viewed by the user (RFC 3339 date-time). |
properties | map of string | A collection of arbitrary key-value pairs which are visible to all apps. Entries with null values are cleared in update and copy requests. |
appProperties | map of string | A collection of arbitrary key-value pairs which are private to the requesting app. Entries with null values are cleared in update and copy requests. These properties can only be retrieved using an authenticated request. An authenticated request uses an access token obtained with an OAuth 2.0 client ID. You cannot use an API key to retrieve private properties. |
contentHints | ContentHints | Additional information about the content of the file. These fields are never populated in responses. |
shortcutDetails | ShortcutDetails | Information about a shortcut file. |
contentRestrictions | ContentRestriction[] | Restrictions for accessing the content of the file. Only populated if such a restriction exists. |
inheritedPermissionsDisabled | boolean | Whether this file has inherited permissions disabled. Inherited permissions are enabled by default. |
downloadRestrictions | DownloadRestrictionsMetadata | Download restrictions applied on the file. |
clientEncryptionDetails | ClientEncryptionDetails | Client Side Encryption related details. Contains details about the encryption state of the file and details regarding the encryption mechanism that clients need to use when decrypting the contents of this item. This will only be present on files and not on folders or shortcuts. |