delete(fileId, enforceSingleParent=None, supportsAllDrives=None, supportsTeamDrives=None)
Permanently deletes a file by ID. Skips the trash. The currently authenticated user must own the file or be an organizer on the parent for shared drive files.
- emptyTrash(enforceSingleParent=None)
Permanently deletes all of the user's trashed files.
+emptyTrash(driveId=None, enforceSingleParent=None)
+Permanently deletes all trashed files of a user or shared drive.
Exports a Google Workspace document to the requested MIME type and returns exported byte content. Note that the exported content is limited to 10MB.
@@ -136,10 +136,10 @@Updates a file's metadata and/or content. When calling this method, only populate fields in the request that you want to modify. When updating fields, some fields might be changed automatically, such as modifiedDate. This method supports patch semantics.
-Subscribes to changes to a file. While you can establish a channel for changes to a file on a shared drive, a change to a shared drive file won't create a notification.
+Subscribe to changes on a file.
-Subscribes to changes to a file. While you can establish a channel for changes to a file on a shared drive, a change to a shared drive file won't create a notification.
+Subscribe to changes on a file.
close()
@@ -1036,10 +1036,11 @@ emptyTrash(enforceSingleParent=None)
- Permanently deletes all of the user's trashed files. +emptyTrash(driveId=None, enforceSingleParent=None)+Permanently deletes all trashed files of a user or shared drive. Args: + driveId: string, If set, empties the trash of the provided shared drive. enforceSingleParent: boolean, Deprecated. If an item is not in a shared drive and its last parent is deleted but the item itself is not, the item will be placed under its owner's root.
watch(fileId, acknowledgeAbuse=None, body=None, includeLabels=None, includePermissionsForView=None, projection=None, revisionId=None, supportsAllDrives=None, supportsTeamDrives=None, updateViewedDate=None)
- Subscribes to changes to a file. While you can establish a channel for changes to a file on a shared drive, a change to a shared drive file won't create a notification. +Subscribe to changes on a file. Args: fileId: string, The ID for the file in question. (required) @@ -6233,7 +6234,7 @@Method Details
watch_media(fileId, acknowledgeAbuse=None, body=None, includeLabels=None, includePermissionsForView=None, projection=None, revisionId=None, supportsAllDrives=None, supportsTeamDrives=None, updateViewedDate=None)-Subscribes to changes to a file. While you can establish a channel for changes to a file on a shared drive, a change to a shared drive file won't create a notification. +Subscribe to changes on a file. Args: fileId: string, The ID for the file in question. (required) diff --git a/docs/dyn/drive_v3.changes.html b/docs/dyn/drive_v3.changes.html index e17afead4e2..2178fd603a1 100644 --- a/docs/dyn/drive_v3.changes.html +++ b/docs/dyn/drive_v3.changes.html @@ -189,52 +189,52 @@Method Details
}, "driveId": "A String", # The ID of the shared drive associated with this change. "file": { # The metadata for a file. # The updated state of the file. Present if the type is file and the file has not been removed from this list of changes. - "appProperties": { # 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 a OAuth 2 client ID. You cannot use an API key to retrieve private properties. + "appProperties": { # A collection of arbitrary key-value pairs that 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 client ID. You cannot use an API key to retrieve private properties. "a_key": "A String", }, - "capabilities": { # Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user may take. + "capabilities": { # Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user can take. "canAcceptOwnership": True or False, # Whether the current user is the pending owner of the file. Not populated for shared drive files. - "canAddChildren": True or False, # Whether the current user can add children to this folder. This is always false when the item is not a folder. - "canAddFolderFromAnotherDrive": True or False, # Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canAddChildren": True or False, # Whether the current user can add children to this folder. This is always false when the item isn't a folder. + "canAddFolderFromAnotherDrive": True or False, # Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canAddMyDriveParent": True or False, # Whether the current user can add a parent for the item without removing an existing parent in the same request. Not populated for shared drive files. "canChangeCopyRequiresWriterPermission": True or False, # Whether the current user can change the copyRequiresWriterPermission restriction of this file. "canChangeSecurityUpdateEnabled": True or False, # Whether the current user can change the securityUpdateEnabled field on link share metadata. "canChangeViewersCanCopyContent": True or False, # Deprecated "canComment": True or False, # Whether the current user can comment on this file. - "canCopy": True or False, # Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it is not a folder. + "canCopy": True or False, # Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it's not a folder. "canDelete": True or False, # Whether the current user can delete this file. - "canDeleteChildren": True or False, # Whether the current user can delete children of this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canDeleteChildren": True or False, # Whether the current user can delete children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canDownload": True or False, # Whether the current user can download this file. - "canEdit": True or False, # Whether the current user can edit this file. Other factors may limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or canModifyContent. - "canListChildren": True or False, # Whether the current user can list the children of this folder. This is always false when the item is not a folder. + "canEdit": True or False, # Whether the current user can edit this file. Other factors might limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or canModifyContent. + "canListChildren": True or False, # Whether the current user can list the children of this folder. This is always false when the item isn't a folder. "canModifyContent": True or False, # Whether the current user can modify the content of this file. "canModifyContentRestriction": True or False, # Whether the current user can modify restrictions on content of this file. "canModifyLabels": True or False, # Whether the current user can modify the labels on this file. - "canMoveChildrenOutOfDrive": True or False, # Whether the current user can move children of this folder outside of the shared drive. This is false when the item is not a folder. Only populated for items in shared drives. + "canMoveChildrenOutOfDrive": True or False, # Whether the current user can move children of this folder outside of the shared drive. This is false when the item isn't a folder. Only populated for items in shared drives. "canMoveChildrenOutOfTeamDrive": True or False, # Deprecated - use canMoveChildrenOutOfDrive instead. - "canMoveChildrenWithinDrive": True or False, # Whether the current user can move children of this folder within this drive. This is false when the item is not a folder. Note that a request to move the child may still fail depending on the current user's access to the child and to the destination folder. + "canMoveChildrenWithinDrive": True or False, # Whether the current user can move children of this folder within this shared drive or My Drive. This is false when the item isn't a folder. Note that a request to move the child might still fail depending on the current user's access to the child and to the destination folder. "canMoveChildrenWithinTeamDrive": True or False, # Deprecated - use canMoveChildrenWithinDrive instead. "canMoveItemIntoTeamDrive": True or False, # Deprecated - use canMoveItemOutOfDrive instead. - "canMoveItemOutOfDrive": True or False, # Whether the current user can move this item outside of this drive by changing its parent. Note that a request to change the parent of the item may still fail depending on the new parent that is being added. + "canMoveItemOutOfDrive": True or False, # Whether the current user can move this item outside of this shared drive or My Drive by changing its parent. Note that a request to change the parent of the item might still fail depending on the new parent that's being added. "canMoveItemOutOfTeamDrive": True or False, # Deprecated - use canMoveItemOutOfDrive instead. - "canMoveItemWithinDrive": True or False, # Whether the current user can move this item within this drive. Note that a request to change the parent of the item may still fail depending on the new parent that is being added and the parent that is being removed. + "canMoveItemWithinDrive": True or False, # Whether the current user can move this item within this shared drive or My Drive. Note that a request to change the parent of the item might still fail depending on the new parent that's being added and the parent that's being removed. "canMoveItemWithinTeamDrive": True or False, # Deprecated - use canMoveItemWithinDrive instead. "canMoveTeamDriveItem": True or False, # Deprecated - use canMoveItemWithinDrive or canMoveItemOutOfDrive instead. "canReadDrive": True or False, # Whether the current user can read the shared drive to which this file belongs. Only populated for items in shared drives. "canReadLabels": True or False, # Whether the current user can read the labels on this file. - "canReadRevisions": True or False, # Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it isn't a folder, can be read. + "canReadRevisions": True or False, # Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it's not a folder, can be read. "canReadTeamDrive": True or False, # Deprecated - use canReadDrive instead. - "canRemoveChildren": True or False, # Whether the current user can remove children from this folder. This is always false when the item is not a folder. For a folder in a shared drive, use canDeleteChildren or canTrashChildren instead. + "canRemoveChildren": True or False, # Whether the current user can remove children from this folder. This is always false when the item isn't a folder. For a folder in a shared drive, use canDeleteChildren or canTrashChildren instead. "canRemoveMyDriveParent": True or False, # Whether the current user can remove a parent from the item without adding another parent in the same request. Not populated for shared drive files. "canRename": True or False, # Whether the current user can rename this file. "canShare": True or False, # Whether the current user can modify the sharing settings for this file. "canTrash": True or False, # Whether the current user can move this file to trash. - "canTrashChildren": True or False, # Whether the current user can trash children of this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canTrashChildren": True or False, # Whether the current user can trash children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canUntrash": True or False, # Whether the current user can restore this file from trash. }, "contentHints": { # Additional information about the content of the file. These fields are never populated in responses. - "indexableText": "A String", # Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and may contain HTML elements. For more information, see Manage file metadata. + "indexableText": "A String", # Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and might contain HTML elements. For more information, see Manage file metadata. "thumbnail": { # A thumbnail for the file. This will only be used if Google Drive cannot generate a standard thumbnail. "image": "A String", # The thumbnail data encoded with URL-safe Base64 (RFC 4648 section 5). "mimeType": "A String", # The MIME type of the thumbnail. @@ -267,11 +267,11 @@Method Details
"fileExtension": "A String", # The final component of fullFileExtension. This is only available for files with binary content in Google Drive. "folderColorRgb": "A String", # The color for a folder or 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 will be used instead. - "fullFileExtension": "A String", # The full file extension extracted from the name field. May contain multiple concatenated extensions, such as "tar.gz". This is only available for files with binary content in Google Drive. - # This is automatically updated when the name field changes, however it isn't cleared if the new name does not contain a valid extension. + "fullFileExtension": "A String", # The full file extension extracted from the name field. Can contain multiple concatenated extensions, such as "tar.gz". This is only available for files with binary content in Google Drive. + # This is automatically updated when the name field changes, however it's not cleared if the new name does not contain a valid extension. "hasAugmentedPermissions": True or False, # Whether there are permissions directly on this file. This field is only populated for items in shared drives. "hasThumbnail": True or False, # Whether this file has a thumbnail. This does not indicate whether the requesting app has access to the thumbnail. To check access, look for the presence of the thumbnailLink field. - "headRevisionId": "A String", # The ID of the file's head revision. This is currently only available for files with binary content in Google Drive. + "headRevisionId": "A String", # The ID of the file's head revision. This is only available for files with binary content in Google Drive. "iconLink": "A String", # A static, unauthenticated link to the file's icon. "id": "A String", # The ID of the file. "imageMediaMetadata": { # Additional metadata about image media, if available. @@ -294,14 +294,14 @@Method Details
}, "maxApertureValue": 3.14, # The smallest f-number of the lens at the focal length used to create the photo (APEX value). "meteringMode": "A String", # The metering mode used to create the photo. - "rotation": 42, # The number of clockwise 90 degree rotations applied from the image's original orientation. + "rotation": 42, # The number of clockwise 90-degree rotations applied from the image's original orientation. "sensor": "A String", # The type of sensor used to create the photo. "subjectDistance": 42, # The distance to the subject of the photo, in meters. "time": "A String", # The date and time the photo was taken (EXIF DateTime). "whiteBalance": "A String", # The white balance mode used to create the photo. "width": 42, # The width of the image in pixels. }, - "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app. + "isAppAuthorized": True or False, # Whether the requesting app created or opened the file. "kind": "drive#file", # Identifies what kind of resource this is. Value: the fixed string "drive#file". "labelInfo": { # An overview of the labels on the file. "labels": [ # The set of labels on the file as requested by the label IDs in the includeLabels parameter. By default, no labels are returned. @@ -362,14 +362,14 @@Method Details
"mimeType": "A String", # The MIME type of the file. # Google Drive will attempt 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 will be imported if possible. The supported import formats are published in the About resource. - "modifiedByMe": True or False, # Whether the file has been modified by this user. - "modifiedByMeTime": "A String", # The last time the file was modified by the user (RFC 3339 date-time). - "modifiedTime": "A String", # The last time the file was modified by anyone (RFC 3339 date-time). + "modifiedByMe": True or False, # Whether this user has modified the file. + "modifiedByMeTime": "A String", # The last time the user modified the file (RFC 3339 date-time). + "modifiedTime": "A String", # The last time anyone modified the file (RFC 3339 date-time). # Note that setting modifiedTime will also update modifiedByMeTime for the user. - "name": "A String", # The name of the file. This is not necessarily unique within a folder. Note that for immutable items such as the top level folders of shared drives, My Drive root folder, and Application Data folder the name is constant. + "name": "A 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, My Drive root folder, and Application Data folder the name is constant. "originalFilename": "A 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. "ownedByMe": True or False, # Whether the user owns the file. Not populated for items in shared drives. - "owners": [ # The owner of this file. Only certain legacy files may have more than one owner. This field isn't populated for items in shared drives. + "owners": [ # The owner of this file. Only certain legacy files might have more than one owner. This field isn't populated for items in shared drives. { # Information about a Drive user. "displayName": "A String", # A plain text displayable name for this user. "emailAddress": "A String", # The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester. @@ -379,7 +379,7 @@Method Details
"photoLink": "A String", # A link to the user's profile photo, if available. }, ], - "parents": [ # The IDs of the parent folders which contain the file. + "parents": [ # The IDs of the parent folders that contain the file. # If not specified as part of a create request, the file will be placed directly in the user's My Drive folder. If not specified as part of a copy request, the file will inherit any discoverable parents of the source file. Update requests must use the addParents and removeParents parameters to modify the parents list. "A String", ], @@ -446,14 +446,14 @@Method Details
"view": "A String", # Indicates the view for this permission. Only populated for permissions that belong to a view. published is the only supported value. }, ], - "properties": { # A collection of arbitrary key-value pairs which are visible to all apps. + "properties": { # A collection of arbitrary key-value pairs that are visible to all apps. # Entries with null values are cleared in update and copy requests. "a_key": "A String", }, "quotaBytesUsed": "A String", # The number of storage quota bytes used by the file. This includes the head revision as well as previous revisions with keepForever enabled. "resourceKey": "A String", # A key needed to access the item via a shared link. - "sha1Checksum": "A String", # The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or shortcut files. - "sha256Checksum": "A String", # The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or shortcut files. + "sha1Checksum": "A String", # The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or shortcut files. + "sha256Checksum": "A String", # The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or shortcut files. "shared": True or False, # Whether the file has been shared. Not populated for items in shared drives. "sharedWithMeTime": "A String", # The time at which the file was shared with the user, if applicable (RFC 3339 date-time). "sharingUser": { # Information about a Drive user. # The user who shared the file with the requesting user, if applicable. @@ -469,15 +469,15 @@Method Details
"targetMimeType": "A String", # The MIME type of the file that this shortcut points to. The value of this field is a snapshot of the target's MIME type, captured when the shortcut is created. "targetResourceKey": "A String", # The ResourceKey for the target file. }, - "size": "A String", # The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it is not populated for shortcuts or folders. - "spaces": [ # The list of spaces which contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'. + "size": "A String", # The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it's not populated for shortcuts or folders. + "spaces": [ # The list of spaces that contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'. "A String", ], "starred": True or False, # Whether the user has starred the file. "teamDriveId": "A String", # Deprecated - use driveId instead. "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in Files.thumbnailLink must be fetched using a credentialed request. "thumbnailVersion": "A String", # The thumbnail version for use in thumbnail cache invalidation. - "trashed": True or False, # Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner may trash a file. The trashed item is excluded from all files.list responses returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file. + "trashed": True or False, # Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner can trash a file. The trashed item is excluded from all files.list responses returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file. "trashedTime": "A String", # The time that the item was trashed (RFC 3339 date-time). Only populated for items in shared drives. "trashingUser": { # Information about a Drive user. # If the file has been explicitly trashed, the user who trashed it. Only populated for items in shared drives. "displayName": "A String", # A plain text displayable name for this user. @@ -488,13 +488,13 @@Method Details
"photoLink": "A String", # A link to the user's profile photo, if available. }, "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the user. - "videoMediaMetadata": { # Additional metadata about video media. This may not be available immediately upon upload. + "videoMediaMetadata": { # Additional metadata about video media. This might not be available immediately upon upload. "durationMillis": "A String", # The duration of the video in milliseconds. "height": 42, # The height of the video in pixels. "width": 42, # The width of the video in pixels. }, - "viewedByMe": True or False, # Whether the file has been viewed by this user. - "viewedByMeTime": "A String", # The last time the file was viewed by the user (RFC 3339 date-time). + "viewedByMe": True or False, # Whether this user has viewed the file. + "viewedByMeTime": "A String", # The last time the user viewed the file (RFC 3339 date-time). "viewersCanCopyContent": True or False, # Deprecated - use copyRequiresWriterPermission instead. "webContentLink": "A String", # A link for downloading the content of the file in a browser. This is only available for files with binary content in Google Drive. "webViewLink": "A String", # A link for opening the file in a relevant Google editor or viewer in a browser. diff --git a/docs/dyn/drive_v3.files.html b/docs/dyn/drive_v3.files.html index 9fae0b91804..5d9e40ae864 100644 --- a/docs/dyn/drive_v3.files.html +++ b/docs/dyn/drive_v3.files.html @@ -87,8 +87,8 @@Instance Methods
delete(fileId, enforceSingleParent=None, supportsAllDrives=None, supportsTeamDrives=None)Permanently deletes a file owned by the user without moving it to the trash. If the file belongs to a shared drive the user must be an organizer on the parent. If the target is a folder, all descendants owned by the user are also deleted.
-
-emptyTrash(enforceSingleParent=None)Permanently deletes all of the user's trashed files.
+emptyTrash(driveId=None, enforceSingleParent=None)+Permanently deletes all trashed files of a user or shared drive.
Exports a Google Workspace document to the requested MIME type and returns exported byte content. Note that the exported content is limited to 10MB.
@@ -124,10 +124,10 @@Instance Methods
Updates a file's metadata and/or content. When calling this method, only populate fields in the request that you want to modify. When updating fields, some fields might change automatically, such as modifiedDate. This method supports patch semantics.
-Subscribes to changes to a file. While you can establish a channel for changes to a file on a shared drive, a change to a shared drive file won't create a notification.
+Subscribe to changes on a file.
-Subscribes to changes to a file. While you can establish a channel for changes to a file on a shared drive, a change to a shared drive file won't create a notification.
+Subscribe to changes on a file.
Method Details
close()@@ -144,52 +144,52 @@Method Details
The object takes the form of: { # The metadata for a file. - "appProperties": { # 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 a OAuth 2 client ID. You cannot use an API key to retrieve private properties. + "appProperties": { # A collection of arbitrary key-value pairs that 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 client ID. You cannot use an API key to retrieve private properties. "a_key": "A String", }, - "capabilities": { # Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user may take. + "capabilities": { # Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user can take. "canAcceptOwnership": True or False, # Whether the current user is the pending owner of the file. Not populated for shared drive files. - "canAddChildren": True or False, # Whether the current user can add children to this folder. This is always false when the item is not a folder. - "canAddFolderFromAnotherDrive": True or False, # Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canAddChildren": True or False, # Whether the current user can add children to this folder. This is always false when the item isn't a folder. + "canAddFolderFromAnotherDrive": True or False, # Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canAddMyDriveParent": True or False, # Whether the current user can add a parent for the item without removing an existing parent in the same request. Not populated for shared drive files. "canChangeCopyRequiresWriterPermission": True or False, # Whether the current user can change the copyRequiresWriterPermission restriction of this file. "canChangeSecurityUpdateEnabled": True or False, # Whether the current user can change the securityUpdateEnabled field on link share metadata. "canChangeViewersCanCopyContent": True or False, # Deprecated "canComment": True or False, # Whether the current user can comment on this file. - "canCopy": True or False, # Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it is not a folder. + "canCopy": True or False, # Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it's not a folder. "canDelete": True or False, # Whether the current user can delete this file. - "canDeleteChildren": True or False, # Whether the current user can delete children of this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canDeleteChildren": True or False, # Whether the current user can delete children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canDownload": True or False, # Whether the current user can download this file. - "canEdit": True or False, # Whether the current user can edit this file. Other factors may limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or canModifyContent. - "canListChildren": True or False, # Whether the current user can list the children of this folder. This is always false when the item is not a folder. + "canEdit": True or False, # Whether the current user can edit this file. Other factors might limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or canModifyContent. + "canListChildren": True or False, # Whether the current user can list the children of this folder. This is always false when the item isn't a folder. "canModifyContent": True or False, # Whether the current user can modify the content of this file. "canModifyContentRestriction": True or False, # Whether the current user can modify restrictions on content of this file. "canModifyLabels": True or False, # Whether the current user can modify the labels on this file. - "canMoveChildrenOutOfDrive": True or False, # Whether the current user can move children of this folder outside of the shared drive. This is false when the item is not a folder. Only populated for items in shared drives. + "canMoveChildrenOutOfDrive": True or False, # Whether the current user can move children of this folder outside of the shared drive. This is false when the item isn't a folder. Only populated for items in shared drives. "canMoveChildrenOutOfTeamDrive": True or False, # Deprecated - use canMoveChildrenOutOfDrive instead. - "canMoveChildrenWithinDrive": True or False, # Whether the current user can move children of this folder within this drive. This is false when the item is not a folder. Note that a request to move the child may still fail depending on the current user's access to the child and to the destination folder. + "canMoveChildrenWithinDrive": True or False, # Whether the current user can move children of this folder within this shared drive or My Drive. This is false when the item isn't a folder. Note that a request to move the child might still fail depending on the current user's access to the child and to the destination folder. "canMoveChildrenWithinTeamDrive": True or False, # Deprecated - use canMoveChildrenWithinDrive instead. "canMoveItemIntoTeamDrive": True or False, # Deprecated - use canMoveItemOutOfDrive instead. - "canMoveItemOutOfDrive": True or False, # Whether the current user can move this item outside of this drive by changing its parent. Note that a request to change the parent of the item may still fail depending on the new parent that is being added. + "canMoveItemOutOfDrive": True or False, # Whether the current user can move this item outside of this shared drive or My Drive by changing its parent. Note that a request to change the parent of the item might still fail depending on the new parent that's being added. "canMoveItemOutOfTeamDrive": True or False, # Deprecated - use canMoveItemOutOfDrive instead. - "canMoveItemWithinDrive": True or False, # Whether the current user can move this item within this drive. Note that a request to change the parent of the item may still fail depending on the new parent that is being added and the parent that is being removed. + "canMoveItemWithinDrive": True or False, # Whether the current user can move this item within this shared drive or My Drive. Note that a request to change the parent of the item might still fail depending on the new parent that's being added and the parent that's being removed. "canMoveItemWithinTeamDrive": True or False, # Deprecated - use canMoveItemWithinDrive instead. "canMoveTeamDriveItem": True or False, # Deprecated - use canMoveItemWithinDrive or canMoveItemOutOfDrive instead. "canReadDrive": True or False, # Whether the current user can read the shared drive to which this file belongs. Only populated for items in shared drives. "canReadLabels": True or False, # Whether the current user can read the labels on this file. - "canReadRevisions": True or False, # Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it isn't a folder, can be read. + "canReadRevisions": True or False, # Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it's not a folder, can be read. "canReadTeamDrive": True or False, # Deprecated - use canReadDrive instead. - "canRemoveChildren": True or False, # Whether the current user can remove children from this folder. This is always false when the item is not a folder. For a folder in a shared drive, use canDeleteChildren or canTrashChildren instead. + "canRemoveChildren": True or False, # Whether the current user can remove children from this folder. This is always false when the item isn't a folder. For a folder in a shared drive, use canDeleteChildren or canTrashChildren instead. "canRemoveMyDriveParent": True or False, # Whether the current user can remove a parent from the item without adding another parent in the same request. Not populated for shared drive files. "canRename": True or False, # Whether the current user can rename this file. "canShare": True or False, # Whether the current user can modify the sharing settings for this file. "canTrash": True or False, # Whether the current user can move this file to trash. - "canTrashChildren": True or False, # Whether the current user can trash children of this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canTrashChildren": True or False, # Whether the current user can trash children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canUntrash": True or False, # Whether the current user can restore this file from trash. }, "contentHints": { # Additional information about the content of the file. These fields are never populated in responses. - "indexableText": "A String", # Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and may contain HTML elements. For more information, see Manage file metadata. + "indexableText": "A String", # Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and might contain HTML elements. For more information, see Manage file metadata. "thumbnail": { # A thumbnail for the file. This will only be used if Google Drive cannot generate a standard thumbnail. "image": "A String", # The thumbnail data encoded with URL-safe Base64 (RFC 4648 section 5). "mimeType": "A String", # The MIME type of the thumbnail. @@ -222,11 +222,11 @@Method Details
"fileExtension": "A String", # The final component of fullFileExtension. This is only available for files with binary content in Google Drive. "folderColorRgb": "A String", # The color for a folder or 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 will be used instead. - "fullFileExtension": "A String", # The full file extension extracted from the name field. May contain multiple concatenated extensions, such as "tar.gz". This is only available for files with binary content in Google Drive. - # This is automatically updated when the name field changes, however it isn't cleared if the new name does not contain a valid extension. + "fullFileExtension": "A String", # The full file extension extracted from the name field. Can contain multiple concatenated extensions, such as "tar.gz". This is only available for files with binary content in Google Drive. + # This is automatically updated when the name field changes, however it's not cleared if the new name does not contain a valid extension. "hasAugmentedPermissions": True or False, # Whether there are permissions directly on this file. This field is only populated for items in shared drives. "hasThumbnail": True or False, # Whether this file has a thumbnail. This does not indicate whether the requesting app has access to the thumbnail. To check access, look for the presence of the thumbnailLink field. - "headRevisionId": "A String", # The ID of the file's head revision. This is currently only available for files with binary content in Google Drive. + "headRevisionId": "A String", # The ID of the file's head revision. This is only available for files with binary content in Google Drive. "iconLink": "A String", # A static, unauthenticated link to the file's icon. "id": "A String", # The ID of the file. "imageMediaMetadata": { # Additional metadata about image media, if available. @@ -249,14 +249,14 @@Method Details
}, "maxApertureValue": 3.14, # The smallest f-number of the lens at the focal length used to create the photo (APEX value). "meteringMode": "A String", # The metering mode used to create the photo. - "rotation": 42, # The number of clockwise 90 degree rotations applied from the image's original orientation. + "rotation": 42, # The number of clockwise 90-degree rotations applied from the image's original orientation. "sensor": "A String", # The type of sensor used to create the photo. "subjectDistance": 42, # The distance to the subject of the photo, in meters. "time": "A String", # The date and time the photo was taken (EXIF DateTime). "whiteBalance": "A String", # The white balance mode used to create the photo. "width": 42, # The width of the image in pixels. }, - "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app. + "isAppAuthorized": True or False, # Whether the requesting app created or opened the file. "kind": "drive#file", # Identifies what kind of resource this is. Value: the fixed string "drive#file". "labelInfo": { # An overview of the labels on the file. "labels": [ # The set of labels on the file as requested by the label IDs in the includeLabels parameter. By default, no labels are returned. @@ -317,14 +317,14 @@Method Details
"mimeType": "A String", # The MIME type of the file. # Google Drive will attempt 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 will be imported if possible. The supported import formats are published in the About resource. - "modifiedByMe": True or False, # Whether the file has been modified by this user. - "modifiedByMeTime": "A String", # The last time the file was modified by the user (RFC 3339 date-time). - "modifiedTime": "A String", # The last time the file was modified by anyone (RFC 3339 date-time). + "modifiedByMe": True or False, # Whether this user has modified the file. + "modifiedByMeTime": "A String", # The last time the user modified the file (RFC 3339 date-time). + "modifiedTime": "A String", # The last time anyone modified the file (RFC 3339 date-time). # Note that setting modifiedTime will also update modifiedByMeTime for the user. - "name": "A String", # The name of the file. This is not necessarily unique within a folder. Note that for immutable items such as the top level folders of shared drives, My Drive root folder, and Application Data folder the name is constant. + "name": "A 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, My Drive root folder, and Application Data folder the name is constant. "originalFilename": "A 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. "ownedByMe": True or False, # Whether the user owns the file. Not populated for items in shared drives. - "owners": [ # The owner of this file. Only certain legacy files may have more than one owner. This field isn't populated for items in shared drives. + "owners": [ # The owner of this file. Only certain legacy files might have more than one owner. This field isn't populated for items in shared drives. { # Information about a Drive user. "displayName": "A String", # A plain text displayable name for this user. "emailAddress": "A String", # The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester. @@ -334,7 +334,7 @@Method Details
"photoLink": "A String", # A link to the user's profile photo, if available. }, ], - "parents": [ # The IDs of the parent folders which contain the file. + "parents": [ # The IDs of the parent folders that contain the file. # If not specified as part of a create request, the file will be placed directly in the user's My Drive folder. If not specified as part of a copy request, the file will inherit any discoverable parents of the source file. Update requests must use the addParents and removeParents parameters to modify the parents list. "A String", ], @@ -401,14 +401,14 @@Method Details
"view": "A String", # Indicates the view for this permission. Only populated for permissions that belong to a view. published is the only supported value. }, ], - "properties": { # A collection of arbitrary key-value pairs which are visible to all apps. + "properties": { # A collection of arbitrary key-value pairs that are visible to all apps. # Entries with null values are cleared in update and copy requests. "a_key": "A String", }, "quotaBytesUsed": "A String", # The number of storage quota bytes used by the file. This includes the head revision as well as previous revisions with keepForever enabled. "resourceKey": "A String", # A key needed to access the item via a shared link. - "sha1Checksum": "A String", # The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or shortcut files. - "sha256Checksum": "A String", # The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or shortcut files. + "sha1Checksum": "A String", # The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or shortcut files. + "sha256Checksum": "A String", # The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or shortcut files. "shared": True or False, # Whether the file has been shared. Not populated for items in shared drives. "sharedWithMeTime": "A String", # The time at which the file was shared with the user, if applicable (RFC 3339 date-time). "sharingUser": { # Information about a Drive user. # The user who shared the file with the requesting user, if applicable. @@ -424,15 +424,15 @@Method Details
"targetMimeType": "A String", # The MIME type of the file that this shortcut points to. The value of this field is a snapshot of the target's MIME type, captured when the shortcut is created. "targetResourceKey": "A String", # The ResourceKey for the target file. }, - "size": "A String", # The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it is not populated for shortcuts or folders. - "spaces": [ # The list of spaces which contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'. + "size": "A String", # The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it's not populated for shortcuts or folders. + "spaces": [ # The list of spaces that contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'. "A String", ], "starred": True or False, # Whether the user has starred the file. "teamDriveId": "A String", # Deprecated - use driveId instead. "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in Files.thumbnailLink must be fetched using a credentialed request. "thumbnailVersion": "A String", # The thumbnail version for use in thumbnail cache invalidation. - "trashed": True or False, # Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner may trash a file. The trashed item is excluded from all files.list responses returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file. + "trashed": True or False, # Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner can trash a file. The trashed item is excluded from all files.list responses returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file. "trashedTime": "A String", # The time that the item was trashed (RFC 3339 date-time). Only populated for items in shared drives. "trashingUser": { # Information about a Drive user. # If the file has been explicitly trashed, the user who trashed it. Only populated for items in shared drives. "displayName": "A String", # A plain text displayable name for this user. @@ -443,13 +443,13 @@Method Details
"photoLink": "A String", # A link to the user's profile photo, if available. }, "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the user. - "videoMediaMetadata": { # Additional metadata about video media. This may not be available immediately upon upload. + "videoMediaMetadata": { # Additional metadata about video media. This might not be available immediately upon upload. "durationMillis": "A String", # The duration of the video in milliseconds. "height": 42, # The height of the video in pixels. "width": 42, # The width of the video in pixels. }, - "viewedByMe": True or False, # Whether the file has been viewed by this user. - "viewedByMeTime": "A String", # The last time the file was viewed by the user (RFC 3339 date-time). + "viewedByMe": True or False, # Whether this user has viewed the file. + "viewedByMeTime": "A String", # The last time the user viewed the file (RFC 3339 date-time). "viewersCanCopyContent": True or False, # Deprecated - use copyRequiresWriterPermission instead. "webContentLink": "A String", # A link for downloading the content of the file in a browser. This is only available for files with binary content in Google Drive. "webViewLink": "A String", # A link for opening the file in a relevant Google editor or viewer in a browser. @@ -469,52 +469,52 @@Method Details
An object of the form: { # The metadata for a file. - "appProperties": { # 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 a OAuth 2 client ID. You cannot use an API key to retrieve private properties. + "appProperties": { # A collection of arbitrary key-value pairs that 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 client ID. You cannot use an API key to retrieve private properties. "a_key": "A String", }, - "capabilities": { # Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user may take. + "capabilities": { # Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user can take. "canAcceptOwnership": True or False, # Whether the current user is the pending owner of the file. Not populated for shared drive files. - "canAddChildren": True or False, # Whether the current user can add children to this folder. This is always false when the item is not a folder. - "canAddFolderFromAnotherDrive": True or False, # Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canAddChildren": True or False, # Whether the current user can add children to this folder. This is always false when the item isn't a folder. + "canAddFolderFromAnotherDrive": True or False, # Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canAddMyDriveParent": True or False, # Whether the current user can add a parent for the item without removing an existing parent in the same request. Not populated for shared drive files. "canChangeCopyRequiresWriterPermission": True or False, # Whether the current user can change the copyRequiresWriterPermission restriction of this file. "canChangeSecurityUpdateEnabled": True or False, # Whether the current user can change the securityUpdateEnabled field on link share metadata. "canChangeViewersCanCopyContent": True or False, # Deprecated "canComment": True or False, # Whether the current user can comment on this file. - "canCopy": True or False, # Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it is not a folder. + "canCopy": True or False, # Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it's not a folder. "canDelete": True or False, # Whether the current user can delete this file. - "canDeleteChildren": True or False, # Whether the current user can delete children of this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canDeleteChildren": True or False, # Whether the current user can delete children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canDownload": True or False, # Whether the current user can download this file. - "canEdit": True or False, # Whether the current user can edit this file. Other factors may limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or canModifyContent. - "canListChildren": True or False, # Whether the current user can list the children of this folder. This is always false when the item is not a folder. + "canEdit": True or False, # Whether the current user can edit this file. Other factors might limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or canModifyContent. + "canListChildren": True or False, # Whether the current user can list the children of this folder. This is always false when the item isn't a folder. "canModifyContent": True or False, # Whether the current user can modify the content of this file. "canModifyContentRestriction": True or False, # Whether the current user can modify restrictions on content of this file. "canModifyLabels": True or False, # Whether the current user can modify the labels on this file. - "canMoveChildrenOutOfDrive": True or False, # Whether the current user can move children of this folder outside of the shared drive. This is false when the item is not a folder. Only populated for items in shared drives. + "canMoveChildrenOutOfDrive": True or False, # Whether the current user can move children of this folder outside of the shared drive. This is false when the item isn't a folder. Only populated for items in shared drives. "canMoveChildrenOutOfTeamDrive": True or False, # Deprecated - use canMoveChildrenOutOfDrive instead. - "canMoveChildrenWithinDrive": True or False, # Whether the current user can move children of this folder within this drive. This is false when the item is not a folder. Note that a request to move the child may still fail depending on the current user's access to the child and to the destination folder. + "canMoveChildrenWithinDrive": True or False, # Whether the current user can move children of this folder within this shared drive or My Drive. This is false when the item isn't a folder. Note that a request to move the child might still fail depending on the current user's access to the child and to the destination folder. "canMoveChildrenWithinTeamDrive": True or False, # Deprecated - use canMoveChildrenWithinDrive instead. "canMoveItemIntoTeamDrive": True or False, # Deprecated - use canMoveItemOutOfDrive instead. - "canMoveItemOutOfDrive": True or False, # Whether the current user can move this item outside of this drive by changing its parent. Note that a request to change the parent of the item may still fail depending on the new parent that is being added. + "canMoveItemOutOfDrive": True or False, # Whether the current user can move this item outside of this shared drive or My Drive by changing its parent. Note that a request to change the parent of the item might still fail depending on the new parent that's being added. "canMoveItemOutOfTeamDrive": True or False, # Deprecated - use canMoveItemOutOfDrive instead. - "canMoveItemWithinDrive": True or False, # Whether the current user can move this item within this drive. Note that a request to change the parent of the item may still fail depending on the new parent that is being added and the parent that is being removed. + "canMoveItemWithinDrive": True or False, # Whether the current user can move this item within this shared drive or My Drive. Note that a request to change the parent of the item might still fail depending on the new parent that's being added and the parent that's being removed. "canMoveItemWithinTeamDrive": True or False, # Deprecated - use canMoveItemWithinDrive instead. "canMoveTeamDriveItem": True or False, # Deprecated - use canMoveItemWithinDrive or canMoveItemOutOfDrive instead. "canReadDrive": True or False, # Whether the current user can read the shared drive to which this file belongs. Only populated for items in shared drives. "canReadLabels": True or False, # Whether the current user can read the labels on this file. - "canReadRevisions": True or False, # Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it isn't a folder, can be read. + "canReadRevisions": True or False, # Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it's not a folder, can be read. "canReadTeamDrive": True or False, # Deprecated - use canReadDrive instead. - "canRemoveChildren": True or False, # Whether the current user can remove children from this folder. This is always false when the item is not a folder. For a folder in a shared drive, use canDeleteChildren or canTrashChildren instead. + "canRemoveChildren": True or False, # Whether the current user can remove children from this folder. This is always false when the item isn't a folder. For a folder in a shared drive, use canDeleteChildren or canTrashChildren instead. "canRemoveMyDriveParent": True or False, # Whether the current user can remove a parent from the item without adding another parent in the same request. Not populated for shared drive files. "canRename": True or False, # Whether the current user can rename this file. "canShare": True or False, # Whether the current user can modify the sharing settings for this file. "canTrash": True or False, # Whether the current user can move this file to trash. - "canTrashChildren": True or False, # Whether the current user can trash children of this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canTrashChildren": True or False, # Whether the current user can trash children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canUntrash": True or False, # Whether the current user can restore this file from trash. }, "contentHints": { # Additional information about the content of the file. These fields are never populated in responses. - "indexableText": "A String", # Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and may contain HTML elements. For more information, see Manage file metadata. + "indexableText": "A String", # Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and might contain HTML elements. For more information, see Manage file metadata. "thumbnail": { # A thumbnail for the file. This will only be used if Google Drive cannot generate a standard thumbnail. "image": "A String", # The thumbnail data encoded with URL-safe Base64 (RFC 4648 section 5). "mimeType": "A String", # The MIME type of the thumbnail. @@ -547,11 +547,11 @@Method Details
"fileExtension": "A String", # The final component of fullFileExtension. This is only available for files with binary content in Google Drive. "folderColorRgb": "A String", # The color for a folder or 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 will be used instead. - "fullFileExtension": "A String", # The full file extension extracted from the name field. May contain multiple concatenated extensions, such as "tar.gz". This is only available for files with binary content in Google Drive. - # This is automatically updated when the name field changes, however it isn't cleared if the new name does not contain a valid extension. + "fullFileExtension": "A String", # The full file extension extracted from the name field. Can contain multiple concatenated extensions, such as "tar.gz". This is only available for files with binary content in Google Drive. + # This is automatically updated when the name field changes, however it's not cleared if the new name does not contain a valid extension. "hasAugmentedPermissions": True or False, # Whether there are permissions directly on this file. This field is only populated for items in shared drives. "hasThumbnail": True or False, # Whether this file has a thumbnail. This does not indicate whether the requesting app has access to the thumbnail. To check access, look for the presence of the thumbnailLink field. - "headRevisionId": "A String", # The ID of the file's head revision. This is currently only available for files with binary content in Google Drive. + "headRevisionId": "A String", # The ID of the file's head revision. This is only available for files with binary content in Google Drive. "iconLink": "A String", # A static, unauthenticated link to the file's icon. "id": "A String", # The ID of the file. "imageMediaMetadata": { # Additional metadata about image media, if available. @@ -574,14 +574,14 @@Method Details
}, "maxApertureValue": 3.14, # The smallest f-number of the lens at the focal length used to create the photo (APEX value). "meteringMode": "A String", # The metering mode used to create the photo. - "rotation": 42, # The number of clockwise 90 degree rotations applied from the image's original orientation. + "rotation": 42, # The number of clockwise 90-degree rotations applied from the image's original orientation. "sensor": "A String", # The type of sensor used to create the photo. "subjectDistance": 42, # The distance to the subject of the photo, in meters. "time": "A String", # The date and time the photo was taken (EXIF DateTime). "whiteBalance": "A String", # The white balance mode used to create the photo. "width": 42, # The width of the image in pixels. }, - "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app. + "isAppAuthorized": True or False, # Whether the requesting app created or opened the file. "kind": "drive#file", # Identifies what kind of resource this is. Value: the fixed string "drive#file". "labelInfo": { # An overview of the labels on the file. "labels": [ # The set of labels on the file as requested by the label IDs in the includeLabels parameter. By default, no labels are returned. @@ -642,14 +642,14 @@Method Details
"mimeType": "A String", # The MIME type of the file. # Google Drive will attempt 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 will be imported if possible. The supported import formats are published in the About resource. - "modifiedByMe": True or False, # Whether the file has been modified by this user. - "modifiedByMeTime": "A String", # The last time the file was modified by the user (RFC 3339 date-time). - "modifiedTime": "A String", # The last time the file was modified by anyone (RFC 3339 date-time). + "modifiedByMe": True or False, # Whether this user has modified the file. + "modifiedByMeTime": "A String", # The last time the user modified the file (RFC 3339 date-time). + "modifiedTime": "A String", # The last time anyone modified the file (RFC 3339 date-time). # Note that setting modifiedTime will also update modifiedByMeTime for the user. - "name": "A String", # The name of the file. This is not necessarily unique within a folder. Note that for immutable items such as the top level folders of shared drives, My Drive root folder, and Application Data folder the name is constant. + "name": "A 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, My Drive root folder, and Application Data folder the name is constant. "originalFilename": "A 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. "ownedByMe": True or False, # Whether the user owns the file. Not populated for items in shared drives. - "owners": [ # The owner of this file. Only certain legacy files may have more than one owner. This field isn't populated for items in shared drives. + "owners": [ # The owner of this file. Only certain legacy files might have more than one owner. This field isn't populated for items in shared drives. { # Information about a Drive user. "displayName": "A String", # A plain text displayable name for this user. "emailAddress": "A String", # The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester. @@ -659,7 +659,7 @@Method Details
"photoLink": "A String", # A link to the user's profile photo, if available. }, ], - "parents": [ # The IDs of the parent folders which contain the file. + "parents": [ # The IDs of the parent folders that contain the file. # If not specified as part of a create request, the file will be placed directly in the user's My Drive folder. If not specified as part of a copy request, the file will inherit any discoverable parents of the source file. Update requests must use the addParents and removeParents parameters to modify the parents list. "A String", ], @@ -726,14 +726,14 @@Method Details
"view": "A String", # Indicates the view for this permission. Only populated for permissions that belong to a view. published is the only supported value. }, ], - "properties": { # A collection of arbitrary key-value pairs which are visible to all apps. + "properties": { # A collection of arbitrary key-value pairs that are visible to all apps. # Entries with null values are cleared in update and copy requests. "a_key": "A String", }, "quotaBytesUsed": "A String", # The number of storage quota bytes used by the file. This includes the head revision as well as previous revisions with keepForever enabled. "resourceKey": "A String", # A key needed to access the item via a shared link. - "sha1Checksum": "A String", # The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or shortcut files. - "sha256Checksum": "A String", # The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or shortcut files. + "sha1Checksum": "A String", # The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or shortcut files. + "sha256Checksum": "A String", # The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or shortcut files. "shared": True or False, # Whether the file has been shared. Not populated for items in shared drives. "sharedWithMeTime": "A String", # The time at which the file was shared with the user, if applicable (RFC 3339 date-time). "sharingUser": { # Information about a Drive user. # The user who shared the file with the requesting user, if applicable. @@ -749,15 +749,15 @@Method Details
"targetMimeType": "A String", # The MIME type of the file that this shortcut points to. The value of this field is a snapshot of the target's MIME type, captured when the shortcut is created. "targetResourceKey": "A String", # The ResourceKey for the target file. }, - "size": "A String", # The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it is not populated for shortcuts or folders. - "spaces": [ # The list of spaces which contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'. + "size": "A String", # The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it's not populated for shortcuts or folders. + "spaces": [ # The list of spaces that contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'. "A String", ], "starred": True or False, # Whether the user has starred the file. "teamDriveId": "A String", # Deprecated - use driveId instead. "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in Files.thumbnailLink must be fetched using a credentialed request. "thumbnailVersion": "A String", # The thumbnail version for use in thumbnail cache invalidation. - "trashed": True or False, # Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner may trash a file. The trashed item is excluded from all files.list responses returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file. + "trashed": True or False, # Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner can trash a file. The trashed item is excluded from all files.list responses returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file. "trashedTime": "A String", # The time that the item was trashed (RFC 3339 date-time). Only populated for items in shared drives. "trashingUser": { # Information about a Drive user. # If the file has been explicitly trashed, the user who trashed it. Only populated for items in shared drives. "displayName": "A String", # A plain text displayable name for this user. @@ -768,13 +768,13 @@Method Details
"photoLink": "A String", # A link to the user's profile photo, if available. }, "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the user. - "videoMediaMetadata": { # Additional metadata about video media. This may not be available immediately upon upload. + "videoMediaMetadata": { # Additional metadata about video media. This might not be available immediately upon upload. "durationMillis": "A String", # The duration of the video in milliseconds. "height": 42, # The height of the video in pixels. "width": 42, # The width of the video in pixels. }, - "viewedByMe": True or False, # Whether the file has been viewed by this user. - "viewedByMeTime": "A String", # The last time the file was viewed by the user (RFC 3339 date-time). + "viewedByMe": True or False, # Whether this user has viewed the file. + "viewedByMeTime": "A String", # The last time the user viewed the file (RFC 3339 date-time). "viewersCanCopyContent": True or False, # Deprecated - use copyRequiresWriterPermission instead. "webContentLink": "A String", # A link for downloading the content of the file in a browser. This is only available for files with binary content in Google Drive. "webViewLink": "A String", # A link for opening the file in a relevant Google editor or viewer in a browser. @@ -791,52 +791,52 @@Method Details
The object takes the form of: { # The metadata for a file. - "appProperties": { # 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 a OAuth 2 client ID. You cannot use an API key to retrieve private properties. + "appProperties": { # A collection of arbitrary key-value pairs that 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 client ID. You cannot use an API key to retrieve private properties. "a_key": "A String", }, - "capabilities": { # Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user may take. + "capabilities": { # Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user can take. "canAcceptOwnership": True or False, # Whether the current user is the pending owner of the file. Not populated for shared drive files. - "canAddChildren": True or False, # Whether the current user can add children to this folder. This is always false when the item is not a folder. - "canAddFolderFromAnotherDrive": True or False, # Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canAddChildren": True or False, # Whether the current user can add children to this folder. This is always false when the item isn't a folder. + "canAddFolderFromAnotherDrive": True or False, # Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canAddMyDriveParent": True or False, # Whether the current user can add a parent for the item without removing an existing parent in the same request. Not populated for shared drive files. "canChangeCopyRequiresWriterPermission": True or False, # Whether the current user can change the copyRequiresWriterPermission restriction of this file. "canChangeSecurityUpdateEnabled": True or False, # Whether the current user can change the securityUpdateEnabled field on link share metadata. "canChangeViewersCanCopyContent": True or False, # Deprecated "canComment": True or False, # Whether the current user can comment on this file. - "canCopy": True or False, # Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it is not a folder. + "canCopy": True or False, # Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it's not a folder. "canDelete": True or False, # Whether the current user can delete this file. - "canDeleteChildren": True or False, # Whether the current user can delete children of this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canDeleteChildren": True or False, # Whether the current user can delete children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canDownload": True or False, # Whether the current user can download this file. - "canEdit": True or False, # Whether the current user can edit this file. Other factors may limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or canModifyContent. - "canListChildren": True or False, # Whether the current user can list the children of this folder. This is always false when the item is not a folder. + "canEdit": True or False, # Whether the current user can edit this file. Other factors might limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or canModifyContent. + "canListChildren": True or False, # Whether the current user can list the children of this folder. This is always false when the item isn't a folder. "canModifyContent": True or False, # Whether the current user can modify the content of this file. "canModifyContentRestriction": True or False, # Whether the current user can modify restrictions on content of this file. "canModifyLabels": True or False, # Whether the current user can modify the labels on this file. - "canMoveChildrenOutOfDrive": True or False, # Whether the current user can move children of this folder outside of the shared drive. This is false when the item is not a folder. Only populated for items in shared drives. + "canMoveChildrenOutOfDrive": True or False, # Whether the current user can move children of this folder outside of the shared drive. This is false when the item isn't a folder. Only populated for items in shared drives. "canMoveChildrenOutOfTeamDrive": True or False, # Deprecated - use canMoveChildrenOutOfDrive instead. - "canMoveChildrenWithinDrive": True or False, # Whether the current user can move children of this folder within this drive. This is false when the item is not a folder. Note that a request to move the child may still fail depending on the current user's access to the child and to the destination folder. + "canMoveChildrenWithinDrive": True or False, # Whether the current user can move children of this folder within this shared drive or My Drive. This is false when the item isn't a folder. Note that a request to move the child might still fail depending on the current user's access to the child and to the destination folder. "canMoveChildrenWithinTeamDrive": True or False, # Deprecated - use canMoveChildrenWithinDrive instead. "canMoveItemIntoTeamDrive": True or False, # Deprecated - use canMoveItemOutOfDrive instead. - "canMoveItemOutOfDrive": True or False, # Whether the current user can move this item outside of this drive by changing its parent. Note that a request to change the parent of the item may still fail depending on the new parent that is being added. + "canMoveItemOutOfDrive": True or False, # Whether the current user can move this item outside of this shared drive or My Drive by changing its parent. Note that a request to change the parent of the item might still fail depending on the new parent that's being added. "canMoveItemOutOfTeamDrive": True or False, # Deprecated - use canMoveItemOutOfDrive instead. - "canMoveItemWithinDrive": True or False, # Whether the current user can move this item within this drive. Note that a request to change the parent of the item may still fail depending on the new parent that is being added and the parent that is being removed. + "canMoveItemWithinDrive": True or False, # Whether the current user can move this item within this shared drive or My Drive. Note that a request to change the parent of the item might still fail depending on the new parent that's being added and the parent that's being removed. "canMoveItemWithinTeamDrive": True or False, # Deprecated - use canMoveItemWithinDrive instead. "canMoveTeamDriveItem": True or False, # Deprecated - use canMoveItemWithinDrive or canMoveItemOutOfDrive instead. "canReadDrive": True or False, # Whether the current user can read the shared drive to which this file belongs. Only populated for items in shared drives. "canReadLabels": True or False, # Whether the current user can read the labels on this file. - "canReadRevisions": True or False, # Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it isn't a folder, can be read. + "canReadRevisions": True or False, # Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it's not a folder, can be read. "canReadTeamDrive": True or False, # Deprecated - use canReadDrive instead. - "canRemoveChildren": True or False, # Whether the current user can remove children from this folder. This is always false when the item is not a folder. For a folder in a shared drive, use canDeleteChildren or canTrashChildren instead. + "canRemoveChildren": True or False, # Whether the current user can remove children from this folder. This is always false when the item isn't a folder. For a folder in a shared drive, use canDeleteChildren or canTrashChildren instead. "canRemoveMyDriveParent": True or False, # Whether the current user can remove a parent from the item without adding another parent in the same request. Not populated for shared drive files. "canRename": True or False, # Whether the current user can rename this file. "canShare": True or False, # Whether the current user can modify the sharing settings for this file. "canTrash": True or False, # Whether the current user can move this file to trash. - "canTrashChildren": True or False, # Whether the current user can trash children of this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canTrashChildren": True or False, # Whether the current user can trash children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canUntrash": True or False, # Whether the current user can restore this file from trash. }, "contentHints": { # Additional information about the content of the file. These fields are never populated in responses. - "indexableText": "A String", # Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and may contain HTML elements. For more information, see Manage file metadata. + "indexableText": "A String", # Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and might contain HTML elements. For more information, see Manage file metadata. "thumbnail": { # A thumbnail for the file. This will only be used if Google Drive cannot generate a standard thumbnail. "image": "A String", # The thumbnail data encoded with URL-safe Base64 (RFC 4648 section 5). "mimeType": "A String", # The MIME type of the thumbnail. @@ -869,11 +869,11 @@Method Details
"fileExtension": "A String", # The final component of fullFileExtension. This is only available for files with binary content in Google Drive. "folderColorRgb": "A String", # The color for a folder or 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 will be used instead. - "fullFileExtension": "A String", # The full file extension extracted from the name field. May contain multiple concatenated extensions, such as "tar.gz". This is only available for files with binary content in Google Drive. - # This is automatically updated when the name field changes, however it isn't cleared if the new name does not contain a valid extension. + "fullFileExtension": "A String", # The full file extension extracted from the name field. Can contain multiple concatenated extensions, such as "tar.gz". This is only available for files with binary content in Google Drive. + # This is automatically updated when the name field changes, however it's not cleared if the new name does not contain a valid extension. "hasAugmentedPermissions": True or False, # Whether there are permissions directly on this file. This field is only populated for items in shared drives. "hasThumbnail": True or False, # Whether this file has a thumbnail. This does not indicate whether the requesting app has access to the thumbnail. To check access, look for the presence of the thumbnailLink field. - "headRevisionId": "A String", # The ID of the file's head revision. This is currently only available for files with binary content in Google Drive. + "headRevisionId": "A String", # The ID of the file's head revision. This is only available for files with binary content in Google Drive. "iconLink": "A String", # A static, unauthenticated link to the file's icon. "id": "A String", # The ID of the file. "imageMediaMetadata": { # Additional metadata about image media, if available. @@ -896,14 +896,14 @@Method Details
}, "maxApertureValue": 3.14, # The smallest f-number of the lens at the focal length used to create the photo (APEX value). "meteringMode": "A String", # The metering mode used to create the photo. - "rotation": 42, # The number of clockwise 90 degree rotations applied from the image's original orientation. + "rotation": 42, # The number of clockwise 90-degree rotations applied from the image's original orientation. "sensor": "A String", # The type of sensor used to create the photo. "subjectDistance": 42, # The distance to the subject of the photo, in meters. "time": "A String", # The date and time the photo was taken (EXIF DateTime). "whiteBalance": "A String", # The white balance mode used to create the photo. "width": 42, # The width of the image in pixels. }, - "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app. + "isAppAuthorized": True or False, # Whether the requesting app created or opened the file. "kind": "drive#file", # Identifies what kind of resource this is. Value: the fixed string "drive#file". "labelInfo": { # An overview of the labels on the file. "labels": [ # The set of labels on the file as requested by the label IDs in the includeLabels parameter. By default, no labels are returned. @@ -964,14 +964,14 @@Method Details
"mimeType": "A String", # The MIME type of the file. # Google Drive will attempt 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 will be imported if possible. The supported import formats are published in the About resource. - "modifiedByMe": True or False, # Whether the file has been modified by this user. - "modifiedByMeTime": "A String", # The last time the file was modified by the user (RFC 3339 date-time). - "modifiedTime": "A String", # The last time the file was modified by anyone (RFC 3339 date-time). + "modifiedByMe": True or False, # Whether this user has modified the file. + "modifiedByMeTime": "A String", # The last time the user modified the file (RFC 3339 date-time). + "modifiedTime": "A String", # The last time anyone modified the file (RFC 3339 date-time). # Note that setting modifiedTime will also update modifiedByMeTime for the user. - "name": "A String", # The name of the file. This is not necessarily unique within a folder. Note that for immutable items such as the top level folders of shared drives, My Drive root folder, and Application Data folder the name is constant. + "name": "A 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, My Drive root folder, and Application Data folder the name is constant. "originalFilename": "A 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. "ownedByMe": True or False, # Whether the user owns the file. Not populated for items in shared drives. - "owners": [ # The owner of this file. Only certain legacy files may have more than one owner. This field isn't populated for items in shared drives. + "owners": [ # The owner of this file. Only certain legacy files might have more than one owner. This field isn't populated for items in shared drives. { # Information about a Drive user. "displayName": "A String", # A plain text displayable name for this user. "emailAddress": "A String", # The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester. @@ -981,7 +981,7 @@Method Details
"photoLink": "A String", # A link to the user's profile photo, if available. }, ], - "parents": [ # The IDs of the parent folders which contain the file. + "parents": [ # The IDs of the parent folders that contain the file. # If not specified as part of a create request, the file will be placed directly in the user's My Drive folder. If not specified as part of a copy request, the file will inherit any discoverable parents of the source file. Update requests must use the addParents and removeParents parameters to modify the parents list. "A String", ], @@ -1048,14 +1048,14 @@Method Details
"view": "A String", # Indicates the view for this permission. Only populated for permissions that belong to a view. published is the only supported value. }, ], - "properties": { # A collection of arbitrary key-value pairs which are visible to all apps. + "properties": { # A collection of arbitrary key-value pairs that are visible to all apps. # Entries with null values are cleared in update and copy requests. "a_key": "A String", }, "quotaBytesUsed": "A String", # The number of storage quota bytes used by the file. This includes the head revision as well as previous revisions with keepForever enabled. "resourceKey": "A String", # A key needed to access the item via a shared link. - "sha1Checksum": "A String", # The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or shortcut files. - "sha256Checksum": "A String", # The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or shortcut files. + "sha1Checksum": "A String", # The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or shortcut files. + "sha256Checksum": "A String", # The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or shortcut files. "shared": True or False, # Whether the file has been shared. Not populated for items in shared drives. "sharedWithMeTime": "A String", # The time at which the file was shared with the user, if applicable (RFC 3339 date-time). "sharingUser": { # Information about a Drive user. # The user who shared the file with the requesting user, if applicable. @@ -1071,15 +1071,15 @@Method Details
"targetMimeType": "A String", # The MIME type of the file that this shortcut points to. The value of this field is a snapshot of the target's MIME type, captured when the shortcut is created. "targetResourceKey": "A String", # The ResourceKey for the target file. }, - "size": "A String", # The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it is not populated for shortcuts or folders. - "spaces": [ # The list of spaces which contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'. + "size": "A String", # The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it's not populated for shortcuts or folders. + "spaces": [ # The list of spaces that contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'. "A String", ], "starred": True or False, # Whether the user has starred the file. "teamDriveId": "A String", # Deprecated - use driveId instead. "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in Files.thumbnailLink must be fetched using a credentialed request. "thumbnailVersion": "A String", # The thumbnail version for use in thumbnail cache invalidation. - "trashed": True or False, # Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner may trash a file. The trashed item is excluded from all files.list responses returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file. + "trashed": True or False, # Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner can trash a file. The trashed item is excluded from all files.list responses returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file. "trashedTime": "A String", # The time that the item was trashed (RFC 3339 date-time). Only populated for items in shared drives. "trashingUser": { # Information about a Drive user. # If the file has been explicitly trashed, the user who trashed it. Only populated for items in shared drives. "displayName": "A String", # A plain text displayable name for this user. @@ -1090,13 +1090,13 @@Method Details
"photoLink": "A String", # A link to the user's profile photo, if available. }, "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the user. - "videoMediaMetadata": { # Additional metadata about video media. This may not be available immediately upon upload. + "videoMediaMetadata": { # Additional metadata about video media. This might not be available immediately upon upload. "durationMillis": "A String", # The duration of the video in milliseconds. "height": 42, # The height of the video in pixels. "width": 42, # The width of the video in pixels. }, - "viewedByMe": True or False, # Whether the file has been viewed by this user. - "viewedByMeTime": "A String", # The last time the file was viewed by the user (RFC 3339 date-time). + "viewedByMe": True or False, # Whether this user has viewed the file. + "viewedByMeTime": "A String", # The last time the user viewed the file (RFC 3339 date-time). "viewersCanCopyContent": True or False, # Deprecated - use copyRequiresWriterPermission instead. "webContentLink": "A String", # A link for downloading the content of the file in a browser. This is only available for files with binary content in Google Drive. "webViewLink": "A String", # A link for opening the file in a relevant Google editor or viewer in a browser. @@ -1119,52 +1119,52 @@Method Details
An object of the form: { # The metadata for a file. - "appProperties": { # 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 a OAuth 2 client ID. You cannot use an API key to retrieve private properties. + "appProperties": { # A collection of arbitrary key-value pairs that 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 client ID. You cannot use an API key to retrieve private properties. "a_key": "A String", }, - "capabilities": { # Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user may take. + "capabilities": { # Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user can take. "canAcceptOwnership": True or False, # Whether the current user is the pending owner of the file. Not populated for shared drive files. - "canAddChildren": True or False, # Whether the current user can add children to this folder. This is always false when the item is not a folder. - "canAddFolderFromAnotherDrive": True or False, # Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canAddChildren": True or False, # Whether the current user can add children to this folder. This is always false when the item isn't a folder. + "canAddFolderFromAnotherDrive": True or False, # Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canAddMyDriveParent": True or False, # Whether the current user can add a parent for the item without removing an existing parent in the same request. Not populated for shared drive files. "canChangeCopyRequiresWriterPermission": True or False, # Whether the current user can change the copyRequiresWriterPermission restriction of this file. "canChangeSecurityUpdateEnabled": True or False, # Whether the current user can change the securityUpdateEnabled field on link share metadata. "canChangeViewersCanCopyContent": True or False, # Deprecated "canComment": True or False, # Whether the current user can comment on this file. - "canCopy": True or False, # Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it is not a folder. + "canCopy": True or False, # Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it's not a folder. "canDelete": True or False, # Whether the current user can delete this file. - "canDeleteChildren": True or False, # Whether the current user can delete children of this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canDeleteChildren": True or False, # Whether the current user can delete children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canDownload": True or False, # Whether the current user can download this file. - "canEdit": True or False, # Whether the current user can edit this file. Other factors may limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or canModifyContent. - "canListChildren": True or False, # Whether the current user can list the children of this folder. This is always false when the item is not a folder. + "canEdit": True or False, # Whether the current user can edit this file. Other factors might limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or canModifyContent. + "canListChildren": True or False, # Whether the current user can list the children of this folder. This is always false when the item isn't a folder. "canModifyContent": True or False, # Whether the current user can modify the content of this file. "canModifyContentRestriction": True or False, # Whether the current user can modify restrictions on content of this file. "canModifyLabels": True or False, # Whether the current user can modify the labels on this file. - "canMoveChildrenOutOfDrive": True or False, # Whether the current user can move children of this folder outside of the shared drive. This is false when the item is not a folder. Only populated for items in shared drives. + "canMoveChildrenOutOfDrive": True or False, # Whether the current user can move children of this folder outside of the shared drive. This is false when the item isn't a folder. Only populated for items in shared drives. "canMoveChildrenOutOfTeamDrive": True or False, # Deprecated - use canMoveChildrenOutOfDrive instead. - "canMoveChildrenWithinDrive": True or False, # Whether the current user can move children of this folder within this drive. This is false when the item is not a folder. Note that a request to move the child may still fail depending on the current user's access to the child and to the destination folder. + "canMoveChildrenWithinDrive": True or False, # Whether the current user can move children of this folder within this shared drive or My Drive. This is false when the item isn't a folder. Note that a request to move the child might still fail depending on the current user's access to the child and to the destination folder. "canMoveChildrenWithinTeamDrive": True or False, # Deprecated - use canMoveChildrenWithinDrive instead. "canMoveItemIntoTeamDrive": True or False, # Deprecated - use canMoveItemOutOfDrive instead. - "canMoveItemOutOfDrive": True or False, # Whether the current user can move this item outside of this drive by changing its parent. Note that a request to change the parent of the item may still fail depending on the new parent that is being added. + "canMoveItemOutOfDrive": True or False, # Whether the current user can move this item outside of this shared drive or My Drive by changing its parent. Note that a request to change the parent of the item might still fail depending on the new parent that's being added. "canMoveItemOutOfTeamDrive": True or False, # Deprecated - use canMoveItemOutOfDrive instead. - "canMoveItemWithinDrive": True or False, # Whether the current user can move this item within this drive. Note that a request to change the parent of the item may still fail depending on the new parent that is being added and the parent that is being removed. + "canMoveItemWithinDrive": True or False, # Whether the current user can move this item within this shared drive or My Drive. Note that a request to change the parent of the item might still fail depending on the new parent that's being added and the parent that's being removed. "canMoveItemWithinTeamDrive": True or False, # Deprecated - use canMoveItemWithinDrive instead. "canMoveTeamDriveItem": True or False, # Deprecated - use canMoveItemWithinDrive or canMoveItemOutOfDrive instead. "canReadDrive": True or False, # Whether the current user can read the shared drive to which this file belongs. Only populated for items in shared drives. "canReadLabels": True or False, # Whether the current user can read the labels on this file. - "canReadRevisions": True or False, # Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it isn't a folder, can be read. + "canReadRevisions": True or False, # Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it's not a folder, can be read. "canReadTeamDrive": True or False, # Deprecated - use canReadDrive instead. - "canRemoveChildren": True or False, # Whether the current user can remove children from this folder. This is always false when the item is not a folder. For a folder in a shared drive, use canDeleteChildren or canTrashChildren instead. + "canRemoveChildren": True or False, # Whether the current user can remove children from this folder. This is always false when the item isn't a folder. For a folder in a shared drive, use canDeleteChildren or canTrashChildren instead. "canRemoveMyDriveParent": True or False, # Whether the current user can remove a parent from the item without adding another parent in the same request. Not populated for shared drive files. "canRename": True or False, # Whether the current user can rename this file. "canShare": True or False, # Whether the current user can modify the sharing settings for this file. "canTrash": True or False, # Whether the current user can move this file to trash. - "canTrashChildren": True or False, # Whether the current user can trash children of this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canTrashChildren": True or False, # Whether the current user can trash children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canUntrash": True or False, # Whether the current user can restore this file from trash. }, "contentHints": { # Additional information about the content of the file. These fields are never populated in responses. - "indexableText": "A String", # Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and may contain HTML elements. For more information, see Manage file metadata. + "indexableText": "A String", # Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and might contain HTML elements. For more information, see Manage file metadata. "thumbnail": { # A thumbnail for the file. This will only be used if Google Drive cannot generate a standard thumbnail. "image": "A String", # The thumbnail data encoded with URL-safe Base64 (RFC 4648 section 5). "mimeType": "A String", # The MIME type of the thumbnail. @@ -1197,11 +1197,11 @@Method Details
"fileExtension": "A String", # The final component of fullFileExtension. This is only available for files with binary content in Google Drive. "folderColorRgb": "A String", # The color for a folder or 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 will be used instead. - "fullFileExtension": "A String", # The full file extension extracted from the name field. May contain multiple concatenated extensions, such as "tar.gz". This is only available for files with binary content in Google Drive. - # This is automatically updated when the name field changes, however it isn't cleared if the new name does not contain a valid extension. + "fullFileExtension": "A String", # The full file extension extracted from the name field. Can contain multiple concatenated extensions, such as "tar.gz". This is only available for files with binary content in Google Drive. + # This is automatically updated when the name field changes, however it's not cleared if the new name does not contain a valid extension. "hasAugmentedPermissions": True or False, # Whether there are permissions directly on this file. This field is only populated for items in shared drives. "hasThumbnail": True or False, # Whether this file has a thumbnail. This does not indicate whether the requesting app has access to the thumbnail. To check access, look for the presence of the thumbnailLink field. - "headRevisionId": "A String", # The ID of the file's head revision. This is currently only available for files with binary content in Google Drive. + "headRevisionId": "A String", # The ID of the file's head revision. This is only available for files with binary content in Google Drive. "iconLink": "A String", # A static, unauthenticated link to the file's icon. "id": "A String", # The ID of the file. "imageMediaMetadata": { # Additional metadata about image media, if available. @@ -1224,14 +1224,14 @@Method Details
}, "maxApertureValue": 3.14, # The smallest f-number of the lens at the focal length used to create the photo (APEX value). "meteringMode": "A String", # The metering mode used to create the photo. - "rotation": 42, # The number of clockwise 90 degree rotations applied from the image's original orientation. + "rotation": 42, # The number of clockwise 90-degree rotations applied from the image's original orientation. "sensor": "A String", # The type of sensor used to create the photo. "subjectDistance": 42, # The distance to the subject of the photo, in meters. "time": "A String", # The date and time the photo was taken (EXIF DateTime). "whiteBalance": "A String", # The white balance mode used to create the photo. "width": 42, # The width of the image in pixels. }, - "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app. + "isAppAuthorized": True or False, # Whether the requesting app created or opened the file. "kind": "drive#file", # Identifies what kind of resource this is. Value: the fixed string "drive#file". "labelInfo": { # An overview of the labels on the file. "labels": [ # The set of labels on the file as requested by the label IDs in the includeLabels parameter. By default, no labels are returned. @@ -1292,14 +1292,14 @@Method Details
"mimeType": "A String", # The MIME type of the file. # Google Drive will attempt 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 will be imported if possible. The supported import formats are published in the About resource. - "modifiedByMe": True or False, # Whether the file has been modified by this user. - "modifiedByMeTime": "A String", # The last time the file was modified by the user (RFC 3339 date-time). - "modifiedTime": "A String", # The last time the file was modified by anyone (RFC 3339 date-time). + "modifiedByMe": True or False, # Whether this user has modified the file. + "modifiedByMeTime": "A String", # The last time the user modified the file (RFC 3339 date-time). + "modifiedTime": "A String", # The last time anyone modified the file (RFC 3339 date-time). # Note that setting modifiedTime will also update modifiedByMeTime for the user. - "name": "A String", # The name of the file. This is not necessarily unique within a folder. Note that for immutable items such as the top level folders of shared drives, My Drive root folder, and Application Data folder the name is constant. + "name": "A 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, My Drive root folder, and Application Data folder the name is constant. "originalFilename": "A 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. "ownedByMe": True or False, # Whether the user owns the file. Not populated for items in shared drives. - "owners": [ # The owner of this file. Only certain legacy files may have more than one owner. This field isn't populated for items in shared drives. + "owners": [ # The owner of this file. Only certain legacy files might have more than one owner. This field isn't populated for items in shared drives. { # Information about a Drive user. "displayName": "A String", # A plain text displayable name for this user. "emailAddress": "A String", # The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester. @@ -1309,7 +1309,7 @@Method Details
"photoLink": "A String", # A link to the user's profile photo, if available. }, ], - "parents": [ # The IDs of the parent folders which contain the file. + "parents": [ # The IDs of the parent folders that contain the file. # If not specified as part of a create request, the file will be placed directly in the user's My Drive folder. If not specified as part of a copy request, the file will inherit any discoverable parents of the source file. Update requests must use the addParents and removeParents parameters to modify the parents list. "A String", ], @@ -1376,14 +1376,14 @@Method Details
"view": "A String", # Indicates the view for this permission. Only populated for permissions that belong to a view. published is the only supported value. }, ], - "properties": { # A collection of arbitrary key-value pairs which are visible to all apps. + "properties": { # A collection of arbitrary key-value pairs that are visible to all apps. # Entries with null values are cleared in update and copy requests. "a_key": "A String", }, "quotaBytesUsed": "A String", # The number of storage quota bytes used by the file. This includes the head revision as well as previous revisions with keepForever enabled. "resourceKey": "A String", # A key needed to access the item via a shared link. - "sha1Checksum": "A String", # The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or shortcut files. - "sha256Checksum": "A String", # The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or shortcut files. + "sha1Checksum": "A String", # The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or shortcut files. + "sha256Checksum": "A String", # The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or shortcut files. "shared": True or False, # Whether the file has been shared. Not populated for items in shared drives. "sharedWithMeTime": "A String", # The time at which the file was shared with the user, if applicable (RFC 3339 date-time). "sharingUser": { # Information about a Drive user. # The user who shared the file with the requesting user, if applicable. @@ -1399,15 +1399,15 @@Method Details
"targetMimeType": "A String", # The MIME type of the file that this shortcut points to. The value of this field is a snapshot of the target's MIME type, captured when the shortcut is created. "targetResourceKey": "A String", # The ResourceKey for the target file. }, - "size": "A String", # The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it is not populated for shortcuts or folders. - "spaces": [ # The list of spaces which contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'. + "size": "A String", # The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it's not populated for shortcuts or folders. + "spaces": [ # The list of spaces that contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'. "A String", ], "starred": True or False, # Whether the user has starred the file. "teamDriveId": "A String", # Deprecated - use driveId instead. "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in Files.thumbnailLink must be fetched using a credentialed request. "thumbnailVersion": "A String", # The thumbnail version for use in thumbnail cache invalidation. - "trashed": True or False, # Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner may trash a file. The trashed item is excluded from all files.list responses returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file. + "trashed": True or False, # Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner can trash a file. The trashed item is excluded from all files.list responses returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file. "trashedTime": "A String", # The time that the item was trashed (RFC 3339 date-time). Only populated for items in shared drives. "trashingUser": { # Information about a Drive user. # If the file has been explicitly trashed, the user who trashed it. Only populated for items in shared drives. "displayName": "A String", # A plain text displayable name for this user. @@ -1418,13 +1418,13 @@Method Details
"photoLink": "A String", # A link to the user's profile photo, if available. }, "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the user. - "videoMediaMetadata": { # Additional metadata about video media. This may not be available immediately upon upload. + "videoMediaMetadata": { # Additional metadata about video media. This might not be available immediately upon upload. "durationMillis": "A String", # The duration of the video in milliseconds. "height": 42, # The height of the video in pixels. "width": 42, # The width of the video in pixels. }, - "viewedByMe": True or False, # Whether the file has been viewed by this user. - "viewedByMeTime": "A String", # The last time the file was viewed by the user (RFC 3339 date-time). + "viewedByMe": True or False, # Whether this user has viewed the file. + "viewedByMeTime": "A String", # The last time the user viewed the file (RFC 3339 date-time). "viewersCanCopyContent": True or False, # Deprecated - use copyRequiresWriterPermission instead. "webContentLink": "A String", # A link for downloading the content of the file in a browser. This is only available for files with binary content in Google Drive. "webViewLink": "A String", # A link for opening the file in a relevant Google editor or viewer in a browser. @@ -1445,10 +1445,11 @@Method Details
-@@ -1510,52 +1511,52 @@emptyTrash(enforceSingleParent=None)-Permanently deletes all of the user's trashed files. +emptyTrash(driveId=None, enforceSingleParent=None)+Permanently deletes all trashed files of a user or shared drive. Args: + driveId: string, If set, empties the trash of the provided shared drive. enforceSingleParent: boolean, Deprecated. If an item is not in a shared drive and its last parent is deleted but the item itself is not, the item will be placed under its owner's root.Method Details
An object of the form: { # The metadata for a file. - "appProperties": { # 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 a OAuth 2 client ID. You cannot use an API key to retrieve private properties. + "appProperties": { # A collection of arbitrary key-value pairs that 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 client ID. You cannot use an API key to retrieve private properties. "a_key": "A String", }, - "capabilities": { # Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user may take. + "capabilities": { # Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user can take. "canAcceptOwnership": True or False, # Whether the current user is the pending owner of the file. Not populated for shared drive files. - "canAddChildren": True or False, # Whether the current user can add children to this folder. This is always false when the item is not a folder. - "canAddFolderFromAnotherDrive": True or False, # Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canAddChildren": True or False, # Whether the current user can add children to this folder. This is always false when the item isn't a folder. + "canAddFolderFromAnotherDrive": True or False, # Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canAddMyDriveParent": True or False, # Whether the current user can add a parent for the item without removing an existing parent in the same request. Not populated for shared drive files. "canChangeCopyRequiresWriterPermission": True or False, # Whether the current user can change the copyRequiresWriterPermission restriction of this file. "canChangeSecurityUpdateEnabled": True or False, # Whether the current user can change the securityUpdateEnabled field on link share metadata. "canChangeViewersCanCopyContent": True or False, # Deprecated "canComment": True or False, # Whether the current user can comment on this file. - "canCopy": True or False, # Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it is not a folder. + "canCopy": True or False, # Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it's not a folder. "canDelete": True or False, # Whether the current user can delete this file. - "canDeleteChildren": True or False, # Whether the current user can delete children of this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canDeleteChildren": True or False, # Whether the current user can delete children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canDownload": True or False, # Whether the current user can download this file. - "canEdit": True or False, # Whether the current user can edit this file. Other factors may limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or canModifyContent. - "canListChildren": True or False, # Whether the current user can list the children of this folder. This is always false when the item is not a folder. + "canEdit": True or False, # Whether the current user can edit this file. Other factors might limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or canModifyContent. + "canListChildren": True or False, # Whether the current user can list the children of this folder. This is always false when the item isn't a folder. "canModifyContent": True or False, # Whether the current user can modify the content of this file. "canModifyContentRestriction": True or False, # Whether the current user can modify restrictions on content of this file. "canModifyLabels": True or False, # Whether the current user can modify the labels on this file. - "canMoveChildrenOutOfDrive": True or False, # Whether the current user can move children of this folder outside of the shared drive. This is false when the item is not a folder. Only populated for items in shared drives. + "canMoveChildrenOutOfDrive": True or False, # Whether the current user can move children of this folder outside of the shared drive. This is false when the item isn't a folder. Only populated for items in shared drives. "canMoveChildrenOutOfTeamDrive": True or False, # Deprecated - use canMoveChildrenOutOfDrive instead. - "canMoveChildrenWithinDrive": True or False, # Whether the current user can move children of this folder within this drive. This is false when the item is not a folder. Note that a request to move the child may still fail depending on the current user's access to the child and to the destination folder. + "canMoveChildrenWithinDrive": True or False, # Whether the current user can move children of this folder within this shared drive or My Drive. This is false when the item isn't a folder. Note that a request to move the child might still fail depending on the current user's access to the child and to the destination folder. "canMoveChildrenWithinTeamDrive": True or False, # Deprecated - use canMoveChildrenWithinDrive instead. "canMoveItemIntoTeamDrive": True or False, # Deprecated - use canMoveItemOutOfDrive instead. - "canMoveItemOutOfDrive": True or False, # Whether the current user can move this item outside of this drive by changing its parent. Note that a request to change the parent of the item may still fail depending on the new parent that is being added. + "canMoveItemOutOfDrive": True or False, # Whether the current user can move this item outside of this shared drive or My Drive by changing its parent. Note that a request to change the parent of the item might still fail depending on the new parent that's being added. "canMoveItemOutOfTeamDrive": True or False, # Deprecated - use canMoveItemOutOfDrive instead. - "canMoveItemWithinDrive": True or False, # Whether the current user can move this item within this drive. Note that a request to change the parent of the item may still fail depending on the new parent that is being added and the parent that is being removed. + "canMoveItemWithinDrive": True or False, # Whether the current user can move this item within this shared drive or My Drive. Note that a request to change the parent of the item might still fail depending on the new parent that's being added and the parent that's being removed. "canMoveItemWithinTeamDrive": True or False, # Deprecated - use canMoveItemWithinDrive instead. "canMoveTeamDriveItem": True or False, # Deprecated - use canMoveItemWithinDrive or canMoveItemOutOfDrive instead. "canReadDrive": True or False, # Whether the current user can read the shared drive to which this file belongs. Only populated for items in shared drives. "canReadLabels": True or False, # Whether the current user can read the labels on this file. - "canReadRevisions": True or False, # Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it isn't a folder, can be read. + "canReadRevisions": True or False, # Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it's not a folder, can be read. "canReadTeamDrive": True or False, # Deprecated - use canReadDrive instead. - "canRemoveChildren": True or False, # Whether the current user can remove children from this folder. This is always false when the item is not a folder. For a folder in a shared drive, use canDeleteChildren or canTrashChildren instead. + "canRemoveChildren": True or False, # Whether the current user can remove children from this folder. This is always false when the item isn't a folder. For a folder in a shared drive, use canDeleteChildren or canTrashChildren instead. "canRemoveMyDriveParent": True or False, # Whether the current user can remove a parent from the item without adding another parent in the same request. Not populated for shared drive files. "canRename": True or False, # Whether the current user can rename this file. "canShare": True or False, # Whether the current user can modify the sharing settings for this file. "canTrash": True or False, # Whether the current user can move this file to trash. - "canTrashChildren": True or False, # Whether the current user can trash children of this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canTrashChildren": True or False, # Whether the current user can trash children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canUntrash": True or False, # Whether the current user can restore this file from trash. }, "contentHints": { # Additional information about the content of the file. These fields are never populated in responses. - "indexableText": "A String", # Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and may contain HTML elements. For more information, see Manage file metadata. + "indexableText": "A String", # Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and might contain HTML elements. For more information, see Manage file metadata. "thumbnail": { # A thumbnail for the file. This will only be used if Google Drive cannot generate a standard thumbnail. "image": "A String", # The thumbnail data encoded with URL-safe Base64 (RFC 4648 section 5). "mimeType": "A String", # The MIME type of the thumbnail. @@ -1588,11 +1589,11 @@Method Details
"fileExtension": "A String", # The final component of fullFileExtension. This is only available for files with binary content in Google Drive. "folderColorRgb": "A String", # The color for a folder or 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 will be used instead. - "fullFileExtension": "A String", # The full file extension extracted from the name field. May contain multiple concatenated extensions, such as "tar.gz". This is only available for files with binary content in Google Drive. - # This is automatically updated when the name field changes, however it isn't cleared if the new name does not contain a valid extension. + "fullFileExtension": "A String", # The full file extension extracted from the name field. Can contain multiple concatenated extensions, such as "tar.gz". This is only available for files with binary content in Google Drive. + # This is automatically updated when the name field changes, however it's not cleared if the new name does not contain a valid extension. "hasAugmentedPermissions": True or False, # Whether there are permissions directly on this file. This field is only populated for items in shared drives. "hasThumbnail": True or False, # Whether this file has a thumbnail. This does not indicate whether the requesting app has access to the thumbnail. To check access, look for the presence of the thumbnailLink field. - "headRevisionId": "A String", # The ID of the file's head revision. This is currently only available for files with binary content in Google Drive. + "headRevisionId": "A String", # The ID of the file's head revision. This is only available for files with binary content in Google Drive. "iconLink": "A String", # A static, unauthenticated link to the file's icon. "id": "A String", # The ID of the file. "imageMediaMetadata": { # Additional metadata about image media, if available. @@ -1615,14 +1616,14 @@Method Details
}, "maxApertureValue": 3.14, # The smallest f-number of the lens at the focal length used to create the photo (APEX value). "meteringMode": "A String", # The metering mode used to create the photo. - "rotation": 42, # The number of clockwise 90 degree rotations applied from the image's original orientation. + "rotation": 42, # The number of clockwise 90-degree rotations applied from the image's original orientation. "sensor": "A String", # The type of sensor used to create the photo. "subjectDistance": 42, # The distance to the subject of the photo, in meters. "time": "A String", # The date and time the photo was taken (EXIF DateTime). "whiteBalance": "A String", # The white balance mode used to create the photo. "width": 42, # The width of the image in pixels. }, - "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app. + "isAppAuthorized": True or False, # Whether the requesting app created or opened the file. "kind": "drive#file", # Identifies what kind of resource this is. Value: the fixed string "drive#file". "labelInfo": { # An overview of the labels on the file. "labels": [ # The set of labels on the file as requested by the label IDs in the includeLabels parameter. By default, no labels are returned. @@ -1683,14 +1684,14 @@Method Details
"mimeType": "A String", # The MIME type of the file. # Google Drive will attempt 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 will be imported if possible. The supported import formats are published in the About resource. - "modifiedByMe": True or False, # Whether the file has been modified by this user. - "modifiedByMeTime": "A String", # The last time the file was modified by the user (RFC 3339 date-time). - "modifiedTime": "A String", # The last time the file was modified by anyone (RFC 3339 date-time). + "modifiedByMe": True or False, # Whether this user has modified the file. + "modifiedByMeTime": "A String", # The last time the user modified the file (RFC 3339 date-time). + "modifiedTime": "A String", # The last time anyone modified the file (RFC 3339 date-time). # Note that setting modifiedTime will also update modifiedByMeTime for the user. - "name": "A String", # The name of the file. This is not necessarily unique within a folder. Note that for immutable items such as the top level folders of shared drives, My Drive root folder, and Application Data folder the name is constant. + "name": "A 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, My Drive root folder, and Application Data folder the name is constant. "originalFilename": "A 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. "ownedByMe": True or False, # Whether the user owns the file. Not populated for items in shared drives. - "owners": [ # The owner of this file. Only certain legacy files may have more than one owner. This field isn't populated for items in shared drives. + "owners": [ # The owner of this file. Only certain legacy files might have more than one owner. This field isn't populated for items in shared drives. { # Information about a Drive user. "displayName": "A String", # A plain text displayable name for this user. "emailAddress": "A String", # The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester. @@ -1700,7 +1701,7 @@Method Details
"photoLink": "A String", # A link to the user's profile photo, if available. }, ], - "parents": [ # The IDs of the parent folders which contain the file. + "parents": [ # The IDs of the parent folders that contain the file. # If not specified as part of a create request, the file will be placed directly in the user's My Drive folder. If not specified as part of a copy request, the file will inherit any discoverable parents of the source file. Update requests must use the addParents and removeParents parameters to modify the parents list. "A String", ], @@ -1767,14 +1768,14 @@Method Details
"view": "A String", # Indicates the view for this permission. Only populated for permissions that belong to a view. published is the only supported value. }, ], - "properties": { # A collection of arbitrary key-value pairs which are visible to all apps. + "properties": { # A collection of arbitrary key-value pairs that are visible to all apps. # Entries with null values are cleared in update and copy requests. "a_key": "A String", }, "quotaBytesUsed": "A String", # The number of storage quota bytes used by the file. This includes the head revision as well as previous revisions with keepForever enabled. "resourceKey": "A String", # A key needed to access the item via a shared link. - "sha1Checksum": "A String", # The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or shortcut files. - "sha256Checksum": "A String", # The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or shortcut files. + "sha1Checksum": "A String", # The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or shortcut files. + "sha256Checksum": "A String", # The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or shortcut files. "shared": True or False, # Whether the file has been shared. Not populated for items in shared drives. "sharedWithMeTime": "A String", # The time at which the file was shared with the user, if applicable (RFC 3339 date-time). "sharingUser": { # Information about a Drive user. # The user who shared the file with the requesting user, if applicable. @@ -1790,15 +1791,15 @@Method Details
"targetMimeType": "A String", # The MIME type of the file that this shortcut points to. The value of this field is a snapshot of the target's MIME type, captured when the shortcut is created. "targetResourceKey": "A String", # The ResourceKey for the target file. }, - "size": "A String", # The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it is not populated for shortcuts or folders. - "spaces": [ # The list of spaces which contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'. + "size": "A String", # The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it's not populated for shortcuts or folders. + "spaces": [ # The list of spaces that contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'. "A String", ], "starred": True or False, # Whether the user has starred the file. "teamDriveId": "A String", # Deprecated - use driveId instead. "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in Files.thumbnailLink must be fetched using a credentialed request. "thumbnailVersion": "A String", # The thumbnail version for use in thumbnail cache invalidation. - "trashed": True or False, # Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner may trash a file. The trashed item is excluded from all files.list responses returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file. + "trashed": True or False, # Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner can trash a file. The trashed item is excluded from all files.list responses returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file. "trashedTime": "A String", # The time that the item was trashed (RFC 3339 date-time). Only populated for items in shared drives. "trashingUser": { # Information about a Drive user. # If the file has been explicitly trashed, the user who trashed it. Only populated for items in shared drives. "displayName": "A String", # A plain text displayable name for this user. @@ -1809,13 +1810,13 @@Method Details
"photoLink": "A String", # A link to the user's profile photo, if available. }, "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the user. - "videoMediaMetadata": { # Additional metadata about video media. This may not be available immediately upon upload. + "videoMediaMetadata": { # Additional metadata about video media. This might not be available immediately upon upload. "durationMillis": "A String", # The duration of the video in milliseconds. "height": 42, # The height of the video in pixels. "width": 42, # The width of the video in pixels. }, - "viewedByMe": True or False, # Whether the file has been viewed by this user. - "viewedByMeTime": "A String", # The last time the file was viewed by the user (RFC 3339 date-time). + "viewedByMe": True or False, # Whether this user has viewed the file. + "viewedByMeTime": "A String", # The last time the user viewed the file (RFC 3339 date-time). "viewersCanCopyContent": True or False, # Deprecated - use copyRequiresWriterPermission instead. "webContentLink": "A String", # A link for downloading the content of the file in a browser. This is only available for files with binary content in Google Drive. "webViewLink": "A String", # A link for opening the file in a relevant Google editor or viewer in a browser. @@ -1871,52 +1872,52 @@Method Details
{ # A list of files. "files": [ # The list of files. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched. { # The metadata for a file. - "appProperties": { # 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 a OAuth 2 client ID. You cannot use an API key to retrieve private properties. + "appProperties": { # A collection of arbitrary key-value pairs that 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 client ID. You cannot use an API key to retrieve private properties. "a_key": "A String", }, - "capabilities": { # Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user may take. + "capabilities": { # Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user can take. "canAcceptOwnership": True or False, # Whether the current user is the pending owner of the file. Not populated for shared drive files. - "canAddChildren": True or False, # Whether the current user can add children to this folder. This is always false when the item is not a folder. - "canAddFolderFromAnotherDrive": True or False, # Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canAddChildren": True or False, # Whether the current user can add children to this folder. This is always false when the item isn't a folder. + "canAddFolderFromAnotherDrive": True or False, # Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canAddMyDriveParent": True or False, # Whether the current user can add a parent for the item without removing an existing parent in the same request. Not populated for shared drive files. "canChangeCopyRequiresWriterPermission": True or False, # Whether the current user can change the copyRequiresWriterPermission restriction of this file. "canChangeSecurityUpdateEnabled": True or False, # Whether the current user can change the securityUpdateEnabled field on link share metadata. "canChangeViewersCanCopyContent": True or False, # Deprecated "canComment": True or False, # Whether the current user can comment on this file. - "canCopy": True or False, # Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it is not a folder. + "canCopy": True or False, # Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it's not a folder. "canDelete": True or False, # Whether the current user can delete this file. - "canDeleteChildren": True or False, # Whether the current user can delete children of this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canDeleteChildren": True or False, # Whether the current user can delete children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canDownload": True or False, # Whether the current user can download this file. - "canEdit": True or False, # Whether the current user can edit this file. Other factors may limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or canModifyContent. - "canListChildren": True or False, # Whether the current user can list the children of this folder. This is always false when the item is not a folder. + "canEdit": True or False, # Whether the current user can edit this file. Other factors might limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or canModifyContent. + "canListChildren": True or False, # Whether the current user can list the children of this folder. This is always false when the item isn't a folder. "canModifyContent": True or False, # Whether the current user can modify the content of this file. "canModifyContentRestriction": True or False, # Whether the current user can modify restrictions on content of this file. "canModifyLabels": True or False, # Whether the current user can modify the labels on this file. - "canMoveChildrenOutOfDrive": True or False, # Whether the current user can move children of this folder outside of the shared drive. This is false when the item is not a folder. Only populated for items in shared drives. + "canMoveChildrenOutOfDrive": True or False, # Whether the current user can move children of this folder outside of the shared drive. This is false when the item isn't a folder. Only populated for items in shared drives. "canMoveChildrenOutOfTeamDrive": True or False, # Deprecated - use canMoveChildrenOutOfDrive instead. - "canMoveChildrenWithinDrive": True or False, # Whether the current user can move children of this folder within this drive. This is false when the item is not a folder. Note that a request to move the child may still fail depending on the current user's access to the child and to the destination folder. + "canMoveChildrenWithinDrive": True or False, # Whether the current user can move children of this folder within this shared drive or My Drive. This is false when the item isn't a folder. Note that a request to move the child might still fail depending on the current user's access to the child and to the destination folder. "canMoveChildrenWithinTeamDrive": True or False, # Deprecated - use canMoveChildrenWithinDrive instead. "canMoveItemIntoTeamDrive": True or False, # Deprecated - use canMoveItemOutOfDrive instead. - "canMoveItemOutOfDrive": True or False, # Whether the current user can move this item outside of this drive by changing its parent. Note that a request to change the parent of the item may still fail depending on the new parent that is being added. + "canMoveItemOutOfDrive": True or False, # Whether the current user can move this item outside of this shared drive or My Drive by changing its parent. Note that a request to change the parent of the item might still fail depending on the new parent that's being added. "canMoveItemOutOfTeamDrive": True or False, # Deprecated - use canMoveItemOutOfDrive instead. - "canMoveItemWithinDrive": True or False, # Whether the current user can move this item within this drive. Note that a request to change the parent of the item may still fail depending on the new parent that is being added and the parent that is being removed. + "canMoveItemWithinDrive": True or False, # Whether the current user can move this item within this shared drive or My Drive. Note that a request to change the parent of the item might still fail depending on the new parent that's being added and the parent that's being removed. "canMoveItemWithinTeamDrive": True or False, # Deprecated - use canMoveItemWithinDrive instead. "canMoveTeamDriveItem": True or False, # Deprecated - use canMoveItemWithinDrive or canMoveItemOutOfDrive instead. "canReadDrive": True or False, # Whether the current user can read the shared drive to which this file belongs. Only populated for items in shared drives. "canReadLabels": True or False, # Whether the current user can read the labels on this file. - "canReadRevisions": True or False, # Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it isn't a folder, can be read. + "canReadRevisions": True or False, # Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it's not a folder, can be read. "canReadTeamDrive": True or False, # Deprecated - use canReadDrive instead. - "canRemoveChildren": True or False, # Whether the current user can remove children from this folder. This is always false when the item is not a folder. For a folder in a shared drive, use canDeleteChildren or canTrashChildren instead. + "canRemoveChildren": True or False, # Whether the current user can remove children from this folder. This is always false when the item isn't a folder. For a folder in a shared drive, use canDeleteChildren or canTrashChildren instead. "canRemoveMyDriveParent": True or False, # Whether the current user can remove a parent from the item without adding another parent in the same request. Not populated for shared drive files. "canRename": True or False, # Whether the current user can rename this file. "canShare": True or False, # Whether the current user can modify the sharing settings for this file. "canTrash": True or False, # Whether the current user can move this file to trash. - "canTrashChildren": True or False, # Whether the current user can trash children of this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canTrashChildren": True or False, # Whether the current user can trash children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canUntrash": True or False, # Whether the current user can restore this file from trash. }, "contentHints": { # Additional information about the content of the file. These fields are never populated in responses. - "indexableText": "A String", # Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and may contain HTML elements. For more information, see Manage file metadata. + "indexableText": "A String", # Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and might contain HTML elements. For more information, see Manage file metadata. "thumbnail": { # A thumbnail for the file. This will only be used if Google Drive cannot generate a standard thumbnail. "image": "A String", # The thumbnail data encoded with URL-safe Base64 (RFC 4648 section 5). "mimeType": "A String", # The MIME type of the thumbnail. @@ -1949,11 +1950,11 @@Method Details
"fileExtension": "A String", # The final component of fullFileExtension. This is only available for files with binary content in Google Drive. "folderColorRgb": "A String", # The color for a folder or 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 will be used instead. - "fullFileExtension": "A String", # The full file extension extracted from the name field. May contain multiple concatenated extensions, such as "tar.gz". This is only available for files with binary content in Google Drive. - # This is automatically updated when the name field changes, however it isn't cleared if the new name does not contain a valid extension. + "fullFileExtension": "A String", # The full file extension extracted from the name field. Can contain multiple concatenated extensions, such as "tar.gz". This is only available for files with binary content in Google Drive. + # This is automatically updated when the name field changes, however it's not cleared if the new name does not contain a valid extension. "hasAugmentedPermissions": True or False, # Whether there are permissions directly on this file. This field is only populated for items in shared drives. "hasThumbnail": True or False, # Whether this file has a thumbnail. This does not indicate whether the requesting app has access to the thumbnail. To check access, look for the presence of the thumbnailLink field. - "headRevisionId": "A String", # The ID of the file's head revision. This is currently only available for files with binary content in Google Drive. + "headRevisionId": "A String", # The ID of the file's head revision. This is only available for files with binary content in Google Drive. "iconLink": "A String", # A static, unauthenticated link to the file's icon. "id": "A String", # The ID of the file. "imageMediaMetadata": { # Additional metadata about image media, if available. @@ -1976,14 +1977,14 @@Method Details
}, "maxApertureValue": 3.14, # The smallest f-number of the lens at the focal length used to create the photo (APEX value). "meteringMode": "A String", # The metering mode used to create the photo. - "rotation": 42, # The number of clockwise 90 degree rotations applied from the image's original orientation. + "rotation": 42, # The number of clockwise 90-degree rotations applied from the image's original orientation. "sensor": "A String", # The type of sensor used to create the photo. "subjectDistance": 42, # The distance to the subject of the photo, in meters. "time": "A String", # The date and time the photo was taken (EXIF DateTime). "whiteBalance": "A String", # The white balance mode used to create the photo. "width": 42, # The width of the image in pixels. }, - "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app. + "isAppAuthorized": True or False, # Whether the requesting app created or opened the file. "kind": "drive#file", # Identifies what kind of resource this is. Value: the fixed string "drive#file". "labelInfo": { # An overview of the labels on the file. "labels": [ # The set of labels on the file as requested by the label IDs in the includeLabels parameter. By default, no labels are returned. @@ -2044,14 +2045,14 @@Method Details
"mimeType": "A String", # The MIME type of the file. # Google Drive will attempt 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 will be imported if possible. The supported import formats are published in the About resource. - "modifiedByMe": True or False, # Whether the file has been modified by this user. - "modifiedByMeTime": "A String", # The last time the file was modified by the user (RFC 3339 date-time). - "modifiedTime": "A String", # The last time the file was modified by anyone (RFC 3339 date-time). + "modifiedByMe": True or False, # Whether this user has modified the file. + "modifiedByMeTime": "A String", # The last time the user modified the file (RFC 3339 date-time). + "modifiedTime": "A String", # The last time anyone modified the file (RFC 3339 date-time). # Note that setting modifiedTime will also update modifiedByMeTime for the user. - "name": "A String", # The name of the file. This is not necessarily unique within a folder. Note that for immutable items such as the top level folders of shared drives, My Drive root folder, and Application Data folder the name is constant. + "name": "A 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, My Drive root folder, and Application Data folder the name is constant. "originalFilename": "A 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. "ownedByMe": True or False, # Whether the user owns the file. Not populated for items in shared drives. - "owners": [ # The owner of this file. Only certain legacy files may have more than one owner. This field isn't populated for items in shared drives. + "owners": [ # The owner of this file. Only certain legacy files might have more than one owner. This field isn't populated for items in shared drives. { # Information about a Drive user. "displayName": "A String", # A plain text displayable name for this user. "emailAddress": "A String", # The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester. @@ -2061,7 +2062,7 @@Method Details
"photoLink": "A String", # A link to the user's profile photo, if available. }, ], - "parents": [ # The IDs of the parent folders which contain the file. + "parents": [ # The IDs of the parent folders that contain the file. # If not specified as part of a create request, the file will be placed directly in the user's My Drive folder. If not specified as part of a copy request, the file will inherit any discoverable parents of the source file. Update requests must use the addParents and removeParents parameters to modify the parents list. "A String", ], @@ -2128,14 +2129,14 @@Method Details
"view": "A String", # Indicates the view for this permission. Only populated for permissions that belong to a view. published is the only supported value. }, ], - "properties": { # A collection of arbitrary key-value pairs which are visible to all apps. + "properties": { # A collection of arbitrary key-value pairs that are visible to all apps. # Entries with null values are cleared in update and copy requests. "a_key": "A String", }, "quotaBytesUsed": "A String", # The number of storage quota bytes used by the file. This includes the head revision as well as previous revisions with keepForever enabled. "resourceKey": "A String", # A key needed to access the item via a shared link. - "sha1Checksum": "A String", # The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or shortcut files. - "sha256Checksum": "A String", # The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or shortcut files. + "sha1Checksum": "A String", # The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or shortcut files. + "sha256Checksum": "A String", # The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or shortcut files. "shared": True or False, # Whether the file has been shared. Not populated for items in shared drives. "sharedWithMeTime": "A String", # The time at which the file was shared with the user, if applicable (RFC 3339 date-time). "sharingUser": { # Information about a Drive user. # The user who shared the file with the requesting user, if applicable. @@ -2151,15 +2152,15 @@Method Details
"targetMimeType": "A String", # The MIME type of the file that this shortcut points to. The value of this field is a snapshot of the target's MIME type, captured when the shortcut is created. "targetResourceKey": "A String", # The ResourceKey for the target file. }, - "size": "A String", # The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it is not populated for shortcuts or folders. - "spaces": [ # The list of spaces which contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'. + "size": "A String", # The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it's not populated for shortcuts or folders. + "spaces": [ # The list of spaces that contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'. "A String", ], "starred": True or False, # Whether the user has starred the file. "teamDriveId": "A String", # Deprecated - use driveId instead. "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in Files.thumbnailLink must be fetched using a credentialed request. "thumbnailVersion": "A String", # The thumbnail version for use in thumbnail cache invalidation. - "trashed": True or False, # Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner may trash a file. The trashed item is excluded from all files.list responses returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file. + "trashed": True or False, # Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner can trash a file. The trashed item is excluded from all files.list responses returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file. "trashedTime": "A String", # The time that the item was trashed (RFC 3339 date-time). Only populated for items in shared drives. "trashingUser": { # Information about a Drive user. # If the file has been explicitly trashed, the user who trashed it. Only populated for items in shared drives. "displayName": "A String", # A plain text displayable name for this user. @@ -2170,13 +2171,13 @@Method Details
"photoLink": "A String", # A link to the user's profile photo, if available. }, "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the user. - "videoMediaMetadata": { # Additional metadata about video media. This may not be available immediately upon upload. + "videoMediaMetadata": { # Additional metadata about video media. This might not be available immediately upon upload. "durationMillis": "A String", # The duration of the video in milliseconds. "height": 42, # The height of the video in pixels. "width": 42, # The width of the video in pixels. }, - "viewedByMe": True or False, # Whether the file has been viewed by this user. - "viewedByMeTime": "A String", # The last time the file was viewed by the user (RFC 3339 date-time). + "viewedByMe": True or False, # Whether this user has viewed the file. + "viewedByMeTime": "A String", # The last time the user viewed the file (RFC 3339 date-time). "viewersCanCopyContent": True or False, # Deprecated - use copyRequiresWriterPermission instead. "webContentLink": "A String", # A link for downloading the content of the file in a browser. This is only available for files with binary content in Google Drive. "webViewLink": "A String", # A link for opening the file in a relevant Google editor or viewer in a browser. @@ -2378,52 +2379,52 @@Method Details
The object takes the form of: { # The metadata for a file. - "appProperties": { # 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 a OAuth 2 client ID. You cannot use an API key to retrieve private properties. + "appProperties": { # A collection of arbitrary key-value pairs that 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 client ID. You cannot use an API key to retrieve private properties. "a_key": "A String", }, - "capabilities": { # Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user may take. + "capabilities": { # Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user can take. "canAcceptOwnership": True or False, # Whether the current user is the pending owner of the file. Not populated for shared drive files. - "canAddChildren": True or False, # Whether the current user can add children to this folder. This is always false when the item is not a folder. - "canAddFolderFromAnotherDrive": True or False, # Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canAddChildren": True or False, # Whether the current user can add children to this folder. This is always false when the item isn't a folder. + "canAddFolderFromAnotherDrive": True or False, # Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canAddMyDriveParent": True or False, # Whether the current user can add a parent for the item without removing an existing parent in the same request. Not populated for shared drive files. "canChangeCopyRequiresWriterPermission": True or False, # Whether the current user can change the copyRequiresWriterPermission restriction of this file. "canChangeSecurityUpdateEnabled": True or False, # Whether the current user can change the securityUpdateEnabled field on link share metadata. "canChangeViewersCanCopyContent": True or False, # Deprecated "canComment": True or False, # Whether the current user can comment on this file. - "canCopy": True or False, # Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it is not a folder. + "canCopy": True or False, # Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it's not a folder. "canDelete": True or False, # Whether the current user can delete this file. - "canDeleteChildren": True or False, # Whether the current user can delete children of this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canDeleteChildren": True or False, # Whether the current user can delete children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canDownload": True or False, # Whether the current user can download this file. - "canEdit": True or False, # Whether the current user can edit this file. Other factors may limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or canModifyContent. - "canListChildren": True or False, # Whether the current user can list the children of this folder. This is always false when the item is not a folder. + "canEdit": True or False, # Whether the current user can edit this file. Other factors might limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or canModifyContent. + "canListChildren": True or False, # Whether the current user can list the children of this folder. This is always false when the item isn't a folder. "canModifyContent": True or False, # Whether the current user can modify the content of this file. "canModifyContentRestriction": True or False, # Whether the current user can modify restrictions on content of this file. "canModifyLabels": True or False, # Whether the current user can modify the labels on this file. - "canMoveChildrenOutOfDrive": True or False, # Whether the current user can move children of this folder outside of the shared drive. This is false when the item is not a folder. Only populated for items in shared drives. + "canMoveChildrenOutOfDrive": True or False, # Whether the current user can move children of this folder outside of the shared drive. This is false when the item isn't a folder. Only populated for items in shared drives. "canMoveChildrenOutOfTeamDrive": True or False, # Deprecated - use canMoveChildrenOutOfDrive instead. - "canMoveChildrenWithinDrive": True or False, # Whether the current user can move children of this folder within this drive. This is false when the item is not a folder. Note that a request to move the child may still fail depending on the current user's access to the child and to the destination folder. + "canMoveChildrenWithinDrive": True or False, # Whether the current user can move children of this folder within this shared drive or My Drive. This is false when the item isn't a folder. Note that a request to move the child might still fail depending on the current user's access to the child and to the destination folder. "canMoveChildrenWithinTeamDrive": True or False, # Deprecated - use canMoveChildrenWithinDrive instead. "canMoveItemIntoTeamDrive": True or False, # Deprecated - use canMoveItemOutOfDrive instead. - "canMoveItemOutOfDrive": True or False, # Whether the current user can move this item outside of this drive by changing its parent. Note that a request to change the parent of the item may still fail depending on the new parent that is being added. + "canMoveItemOutOfDrive": True or False, # Whether the current user can move this item outside of this shared drive or My Drive by changing its parent. Note that a request to change the parent of the item might still fail depending on the new parent that's being added. "canMoveItemOutOfTeamDrive": True or False, # Deprecated - use canMoveItemOutOfDrive instead. - "canMoveItemWithinDrive": True or False, # Whether the current user can move this item within this drive. Note that a request to change the parent of the item may still fail depending on the new parent that is being added and the parent that is being removed. + "canMoveItemWithinDrive": True or False, # Whether the current user can move this item within this shared drive or My Drive. Note that a request to change the parent of the item might still fail depending on the new parent that's being added and the parent that's being removed. "canMoveItemWithinTeamDrive": True or False, # Deprecated - use canMoveItemWithinDrive instead. "canMoveTeamDriveItem": True or False, # Deprecated - use canMoveItemWithinDrive or canMoveItemOutOfDrive instead. "canReadDrive": True or False, # Whether the current user can read the shared drive to which this file belongs. Only populated for items in shared drives. "canReadLabels": True or False, # Whether the current user can read the labels on this file. - "canReadRevisions": True or False, # Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it isn't a folder, can be read. + "canReadRevisions": True or False, # Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it's not a folder, can be read. "canReadTeamDrive": True or False, # Deprecated - use canReadDrive instead. - "canRemoveChildren": True or False, # Whether the current user can remove children from this folder. This is always false when the item is not a folder. For a folder in a shared drive, use canDeleteChildren or canTrashChildren instead. + "canRemoveChildren": True or False, # Whether the current user can remove children from this folder. This is always false when the item isn't a folder. For a folder in a shared drive, use canDeleteChildren or canTrashChildren instead. "canRemoveMyDriveParent": True or False, # Whether the current user can remove a parent from the item without adding another parent in the same request. Not populated for shared drive files. "canRename": True or False, # Whether the current user can rename this file. "canShare": True or False, # Whether the current user can modify the sharing settings for this file. "canTrash": True or False, # Whether the current user can move this file to trash. - "canTrashChildren": True or False, # Whether the current user can trash children of this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canTrashChildren": True or False, # Whether the current user can trash children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canUntrash": True or False, # Whether the current user can restore this file from trash. }, "contentHints": { # Additional information about the content of the file. These fields are never populated in responses. - "indexableText": "A String", # Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and may contain HTML elements. For more information, see Manage file metadata. + "indexableText": "A String", # Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and might contain HTML elements. For more information, see Manage file metadata. "thumbnail": { # A thumbnail for the file. This will only be used if Google Drive cannot generate a standard thumbnail. "image": "A String", # The thumbnail data encoded with URL-safe Base64 (RFC 4648 section 5). "mimeType": "A String", # The MIME type of the thumbnail. @@ -2456,11 +2457,11 @@Method Details
"fileExtension": "A String", # The final component of fullFileExtension. This is only available for files with binary content in Google Drive. "folderColorRgb": "A String", # The color for a folder or 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 will be used instead. - "fullFileExtension": "A String", # The full file extension extracted from the name field. May contain multiple concatenated extensions, such as "tar.gz". This is only available for files with binary content in Google Drive. - # This is automatically updated when the name field changes, however it isn't cleared if the new name does not contain a valid extension. + "fullFileExtension": "A String", # The full file extension extracted from the name field. Can contain multiple concatenated extensions, such as "tar.gz". This is only available for files with binary content in Google Drive. + # This is automatically updated when the name field changes, however it's not cleared if the new name does not contain a valid extension. "hasAugmentedPermissions": True or False, # Whether there are permissions directly on this file. This field is only populated for items in shared drives. "hasThumbnail": True or False, # Whether this file has a thumbnail. This does not indicate whether the requesting app has access to the thumbnail. To check access, look for the presence of the thumbnailLink field. - "headRevisionId": "A String", # The ID of the file's head revision. This is currently only available for files with binary content in Google Drive. + "headRevisionId": "A String", # The ID of the file's head revision. This is only available for files with binary content in Google Drive. "iconLink": "A String", # A static, unauthenticated link to the file's icon. "id": "A String", # The ID of the file. "imageMediaMetadata": { # Additional metadata about image media, if available. @@ -2483,14 +2484,14 @@Method Details
}, "maxApertureValue": 3.14, # The smallest f-number of the lens at the focal length used to create the photo (APEX value). "meteringMode": "A String", # The metering mode used to create the photo. - "rotation": 42, # The number of clockwise 90 degree rotations applied from the image's original orientation. + "rotation": 42, # The number of clockwise 90-degree rotations applied from the image's original orientation. "sensor": "A String", # The type of sensor used to create the photo. "subjectDistance": 42, # The distance to the subject of the photo, in meters. "time": "A String", # The date and time the photo was taken (EXIF DateTime). "whiteBalance": "A String", # The white balance mode used to create the photo. "width": 42, # The width of the image in pixels. }, - "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app. + "isAppAuthorized": True or False, # Whether the requesting app created or opened the file. "kind": "drive#file", # Identifies what kind of resource this is. Value: the fixed string "drive#file". "labelInfo": { # An overview of the labels on the file. "labels": [ # The set of labels on the file as requested by the label IDs in the includeLabels parameter. By default, no labels are returned. @@ -2551,14 +2552,14 @@Method Details
"mimeType": "A String", # The MIME type of the file. # Google Drive will attempt 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 will be imported if possible. The supported import formats are published in the About resource. - "modifiedByMe": True or False, # Whether the file has been modified by this user. - "modifiedByMeTime": "A String", # The last time the file was modified by the user (RFC 3339 date-time). - "modifiedTime": "A String", # The last time the file was modified by anyone (RFC 3339 date-time). + "modifiedByMe": True or False, # Whether this user has modified the file. + "modifiedByMeTime": "A String", # The last time the user modified the file (RFC 3339 date-time). + "modifiedTime": "A String", # The last time anyone modified the file (RFC 3339 date-time). # Note that setting modifiedTime will also update modifiedByMeTime for the user. - "name": "A String", # The name of the file. This is not necessarily unique within a folder. Note that for immutable items such as the top level folders of shared drives, My Drive root folder, and Application Data folder the name is constant. + "name": "A 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, My Drive root folder, and Application Data folder the name is constant. "originalFilename": "A 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. "ownedByMe": True or False, # Whether the user owns the file. Not populated for items in shared drives. - "owners": [ # The owner of this file. Only certain legacy files may have more than one owner. This field isn't populated for items in shared drives. + "owners": [ # The owner of this file. Only certain legacy files might have more than one owner. This field isn't populated for items in shared drives. { # Information about a Drive user. "displayName": "A String", # A plain text displayable name for this user. "emailAddress": "A String", # The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester. @@ -2568,7 +2569,7 @@Method Details
"photoLink": "A String", # A link to the user's profile photo, if available. }, ], - "parents": [ # The IDs of the parent folders which contain the file. + "parents": [ # The IDs of the parent folders that contain the file. # If not specified as part of a create request, the file will be placed directly in the user's My Drive folder. If not specified as part of a copy request, the file will inherit any discoverable parents of the source file. Update requests must use the addParents and removeParents parameters to modify the parents list. "A String", ], @@ -2635,14 +2636,14 @@Method Details
"view": "A String", # Indicates the view for this permission. Only populated for permissions that belong to a view. published is the only supported value. }, ], - "properties": { # A collection of arbitrary key-value pairs which are visible to all apps. + "properties": { # A collection of arbitrary key-value pairs that are visible to all apps. # Entries with null values are cleared in update and copy requests. "a_key": "A String", }, "quotaBytesUsed": "A String", # The number of storage quota bytes used by the file. This includes the head revision as well as previous revisions with keepForever enabled. "resourceKey": "A String", # A key needed to access the item via a shared link. - "sha1Checksum": "A String", # The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or shortcut files. - "sha256Checksum": "A String", # The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or shortcut files. + "sha1Checksum": "A String", # The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or shortcut files. + "sha256Checksum": "A String", # The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or shortcut files. "shared": True or False, # Whether the file has been shared. Not populated for items in shared drives. "sharedWithMeTime": "A String", # The time at which the file was shared with the user, if applicable (RFC 3339 date-time). "sharingUser": { # Information about a Drive user. # The user who shared the file with the requesting user, if applicable. @@ -2658,15 +2659,15 @@Method Details
"targetMimeType": "A String", # The MIME type of the file that this shortcut points to. The value of this field is a snapshot of the target's MIME type, captured when the shortcut is created. "targetResourceKey": "A String", # The ResourceKey for the target file. }, - "size": "A String", # The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it is not populated for shortcuts or folders. - "spaces": [ # The list of spaces which contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'. + "size": "A String", # The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it's not populated for shortcuts or folders. + "spaces": [ # The list of spaces that contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'. "A String", ], "starred": True or False, # Whether the user has starred the file. "teamDriveId": "A String", # Deprecated - use driveId instead. "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in Files.thumbnailLink must be fetched using a credentialed request. "thumbnailVersion": "A String", # The thumbnail version for use in thumbnail cache invalidation. - "trashed": True or False, # Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner may trash a file. The trashed item is excluded from all files.list responses returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file. + "trashed": True or False, # Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner can trash a file. The trashed item is excluded from all files.list responses returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file. "trashedTime": "A String", # The time that the item was trashed (RFC 3339 date-time). Only populated for items in shared drives. "trashingUser": { # Information about a Drive user. # If the file has been explicitly trashed, the user who trashed it. Only populated for items in shared drives. "displayName": "A String", # A plain text displayable name for this user. @@ -2677,13 +2678,13 @@Method Details
"photoLink": "A String", # A link to the user's profile photo, if available. }, "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the user. - "videoMediaMetadata": { # Additional metadata about video media. This may not be available immediately upon upload. + "videoMediaMetadata": { # Additional metadata about video media. This might not be available immediately upon upload. "durationMillis": "A String", # The duration of the video in milliseconds. "height": 42, # The height of the video in pixels. "width": 42, # The width of the video in pixels. }, - "viewedByMe": True or False, # Whether the file has been viewed by this user. - "viewedByMeTime": "A String", # The last time the file was viewed by the user (RFC 3339 date-time). + "viewedByMe": True or False, # Whether this user has viewed the file. + "viewedByMeTime": "A String", # The last time the user viewed the file (RFC 3339 date-time). "viewersCanCopyContent": True or False, # Deprecated - use copyRequiresWriterPermission instead. "webContentLink": "A String", # A link for downloading the content of the file in a browser. This is only available for files with binary content in Google Drive. "webViewLink": "A String", # A link for opening the file in a relevant Google editor or viewer in a browser. @@ -2707,52 +2708,52 @@Method Details
An object of the form: { # The metadata for a file. - "appProperties": { # 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 a OAuth 2 client ID. You cannot use an API key to retrieve private properties. + "appProperties": { # A collection of arbitrary key-value pairs that 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 client ID. You cannot use an API key to retrieve private properties. "a_key": "A String", }, - "capabilities": { # Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user may take. + "capabilities": { # Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user can take. "canAcceptOwnership": True or False, # Whether the current user is the pending owner of the file. Not populated for shared drive files. - "canAddChildren": True or False, # Whether the current user can add children to this folder. This is always false when the item is not a folder. - "canAddFolderFromAnotherDrive": True or False, # Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canAddChildren": True or False, # Whether the current user can add children to this folder. This is always false when the item isn't a folder. + "canAddFolderFromAnotherDrive": True or False, # Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canAddMyDriveParent": True or False, # Whether the current user can add a parent for the item without removing an existing parent in the same request. Not populated for shared drive files. "canChangeCopyRequiresWriterPermission": True or False, # Whether the current user can change the copyRequiresWriterPermission restriction of this file. "canChangeSecurityUpdateEnabled": True or False, # Whether the current user can change the securityUpdateEnabled field on link share metadata. "canChangeViewersCanCopyContent": True or False, # Deprecated "canComment": True or False, # Whether the current user can comment on this file. - "canCopy": True or False, # Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it is not a folder. + "canCopy": True or False, # Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it's not a folder. "canDelete": True or False, # Whether the current user can delete this file. - "canDeleteChildren": True or False, # Whether the current user can delete children of this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canDeleteChildren": True or False, # Whether the current user can delete children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canDownload": True or False, # Whether the current user can download this file. - "canEdit": True or False, # Whether the current user can edit this file. Other factors may limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or canModifyContent. - "canListChildren": True or False, # Whether the current user can list the children of this folder. This is always false when the item is not a folder. + "canEdit": True or False, # Whether the current user can edit this file. Other factors might limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or canModifyContent. + "canListChildren": True or False, # Whether the current user can list the children of this folder. This is always false when the item isn't a folder. "canModifyContent": True or False, # Whether the current user can modify the content of this file. "canModifyContentRestriction": True or False, # Whether the current user can modify restrictions on content of this file. "canModifyLabels": True or False, # Whether the current user can modify the labels on this file. - "canMoveChildrenOutOfDrive": True or False, # Whether the current user can move children of this folder outside of the shared drive. This is false when the item is not a folder. Only populated for items in shared drives. + "canMoveChildrenOutOfDrive": True or False, # Whether the current user can move children of this folder outside of the shared drive. This is false when the item isn't a folder. Only populated for items in shared drives. "canMoveChildrenOutOfTeamDrive": True or False, # Deprecated - use canMoveChildrenOutOfDrive instead. - "canMoveChildrenWithinDrive": True or False, # Whether the current user can move children of this folder within this drive. This is false when the item is not a folder. Note that a request to move the child may still fail depending on the current user's access to the child and to the destination folder. + "canMoveChildrenWithinDrive": True or False, # Whether the current user can move children of this folder within this shared drive or My Drive. This is false when the item isn't a folder. Note that a request to move the child might still fail depending on the current user's access to the child and to the destination folder. "canMoveChildrenWithinTeamDrive": True or False, # Deprecated - use canMoveChildrenWithinDrive instead. "canMoveItemIntoTeamDrive": True or False, # Deprecated - use canMoveItemOutOfDrive instead. - "canMoveItemOutOfDrive": True or False, # Whether the current user can move this item outside of this drive by changing its parent. Note that a request to change the parent of the item may still fail depending on the new parent that is being added. + "canMoveItemOutOfDrive": True or False, # Whether the current user can move this item outside of this shared drive or My Drive by changing its parent. Note that a request to change the parent of the item might still fail depending on the new parent that's being added. "canMoveItemOutOfTeamDrive": True or False, # Deprecated - use canMoveItemOutOfDrive instead. - "canMoveItemWithinDrive": True or False, # Whether the current user can move this item within this drive. Note that a request to change the parent of the item may still fail depending on the new parent that is being added and the parent that is being removed. + "canMoveItemWithinDrive": True or False, # Whether the current user can move this item within this shared drive or My Drive. Note that a request to change the parent of the item might still fail depending on the new parent that's being added and the parent that's being removed. "canMoveItemWithinTeamDrive": True or False, # Deprecated - use canMoveItemWithinDrive instead. "canMoveTeamDriveItem": True or False, # Deprecated - use canMoveItemWithinDrive or canMoveItemOutOfDrive instead. "canReadDrive": True or False, # Whether the current user can read the shared drive to which this file belongs. Only populated for items in shared drives. "canReadLabels": True or False, # Whether the current user can read the labels on this file. - "canReadRevisions": True or False, # Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it isn't a folder, can be read. + "canReadRevisions": True or False, # Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it's not a folder, can be read. "canReadTeamDrive": True or False, # Deprecated - use canReadDrive instead. - "canRemoveChildren": True or False, # Whether the current user can remove children from this folder. This is always false when the item is not a folder. For a folder in a shared drive, use canDeleteChildren or canTrashChildren instead. + "canRemoveChildren": True or False, # Whether the current user can remove children from this folder. This is always false when the item isn't a folder. For a folder in a shared drive, use canDeleteChildren or canTrashChildren instead. "canRemoveMyDriveParent": True or False, # Whether the current user can remove a parent from the item without adding another parent in the same request. Not populated for shared drive files. "canRename": True or False, # Whether the current user can rename this file. "canShare": True or False, # Whether the current user can modify the sharing settings for this file. "canTrash": True or False, # Whether the current user can move this file to trash. - "canTrashChildren": True or False, # Whether the current user can trash children of this folder. This is false when the item is not a folder. Only populated for items in shared drives. + "canTrashChildren": True or False, # Whether the current user can trash children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives. "canUntrash": True or False, # Whether the current user can restore this file from trash. }, "contentHints": { # Additional information about the content of the file. These fields are never populated in responses. - "indexableText": "A String", # Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and may contain HTML elements. For more information, see Manage file metadata. + "indexableText": "A String", # Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and might contain HTML elements. For more information, see Manage file metadata. "thumbnail": { # A thumbnail for the file. This will only be used if Google Drive cannot generate a standard thumbnail. "image": "A String", # The thumbnail data encoded with URL-safe Base64 (RFC 4648 section 5). "mimeType": "A String", # The MIME type of the thumbnail. @@ -2785,11 +2786,11 @@Method Details
"fileExtension": "A String", # The final component of fullFileExtension. This is only available for files with binary content in Google Drive. "folderColorRgb": "A String", # The color for a folder or 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 will be used instead. - "fullFileExtension": "A String", # The full file extension extracted from the name field. May contain multiple concatenated extensions, such as "tar.gz". This is only available for files with binary content in Google Drive. - # This is automatically updated when the name field changes, however it isn't cleared if the new name does not contain a valid extension. + "fullFileExtension": "A String", # The full file extension extracted from the name field. Can contain multiple concatenated extensions, such as "tar.gz". This is only available for files with binary content in Google Drive. + # This is automatically updated when the name field changes, however it's not cleared if the new name does not contain a valid extension. "hasAugmentedPermissions": True or False, # Whether there are permissions directly on this file. This field is only populated for items in shared drives. "hasThumbnail": True or False, # Whether this file has a thumbnail. This does not indicate whether the requesting app has access to the thumbnail. To check access, look for the presence of the thumbnailLink field. - "headRevisionId": "A String", # The ID of the file's head revision. This is currently only available for files with binary content in Google Drive. + "headRevisionId": "A String", # The ID of the file's head revision. This is only available for files with binary content in Google Drive. "iconLink": "A String", # A static, unauthenticated link to the file's icon. "id": "A String", # The ID of the file. "imageMediaMetadata": { # Additional metadata about image media, if available. @@ -2812,14 +2813,14 @@Method Details
}, "maxApertureValue": 3.14, # The smallest f-number of the lens at the focal length used to create the photo (APEX value). "meteringMode": "A String", # The metering mode used to create the photo. - "rotation": 42, # The number of clockwise 90 degree rotations applied from the image's original orientation. + "rotation": 42, # The number of clockwise 90-degree rotations applied from the image's original orientation. "sensor": "A String", # The type of sensor used to create the photo. "subjectDistance": 42, # The distance to the subject of the photo, in meters. "time": "A String", # The date and time the photo was taken (EXIF DateTime). "whiteBalance": "A String", # The white balance mode used to create the photo. "width": 42, # The width of the image in pixels. }, - "isAppAuthorized": True or False, # Whether the file was created or opened by the requesting app. + "isAppAuthorized": True or False, # Whether the requesting app created or opened the file. "kind": "drive#file", # Identifies what kind of resource this is. Value: the fixed string "drive#file". "labelInfo": { # An overview of the labels on the file. "labels": [ # The set of labels on the file as requested by the label IDs in the includeLabels parameter. By default, no labels are returned. @@ -2880,14 +2881,14 @@Method Details
"mimeType": "A String", # The MIME type of the file. # Google Drive will attempt 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 will be imported if possible. The supported import formats are published in the About resource. - "modifiedByMe": True or False, # Whether the file has been modified by this user. - "modifiedByMeTime": "A String", # The last time the file was modified by the user (RFC 3339 date-time). - "modifiedTime": "A String", # The last time the file was modified by anyone (RFC 3339 date-time). + "modifiedByMe": True or False, # Whether this user has modified the file. + "modifiedByMeTime": "A String", # The last time the user modified the file (RFC 3339 date-time). + "modifiedTime": "A String", # The last time anyone modified the file (RFC 3339 date-time). # Note that setting modifiedTime will also update modifiedByMeTime for the user. - "name": "A String", # The name of the file. This is not necessarily unique within a folder. Note that for immutable items such as the top level folders of shared drives, My Drive root folder, and Application Data folder the name is constant. + "name": "A 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, My Drive root folder, and Application Data folder the name is constant. "originalFilename": "A 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. "ownedByMe": True or False, # Whether the user owns the file. Not populated for items in shared drives. - "owners": [ # The owner of this file. Only certain legacy files may have more than one owner. This field isn't populated for items in shared drives. + "owners": [ # The owner of this file. Only certain legacy files might have more than one owner. This field isn't populated for items in shared drives. { # Information about a Drive user. "displayName": "A String", # A plain text displayable name for this user. "emailAddress": "A String", # The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester. @@ -2897,7 +2898,7 @@Method Details
"photoLink": "A String", # A link to the user's profile photo, if available. }, ], - "parents": [ # The IDs of the parent folders which contain the file. + "parents": [ # The IDs of the parent folders that contain the file. # If not specified as part of a create request, the file will be placed directly in the user's My Drive folder. If not specified as part of a copy request, the file will inherit any discoverable parents of the source file. Update requests must use the addParents and removeParents parameters to modify the parents list. "A String", ], @@ -2964,14 +2965,14 @@Method Details
"view": "A String", # Indicates the view for this permission. Only populated for permissions that belong to a view. published is the only supported value. }, ], - "properties": { # A collection of arbitrary key-value pairs which are visible to all apps. + "properties": { # A collection of arbitrary key-value pairs that are visible to all apps. # Entries with null values are cleared in update and copy requests. "a_key": "A String", }, "quotaBytesUsed": "A String", # The number of storage quota bytes used by the file. This includes the head revision as well as previous revisions with keepForever enabled. "resourceKey": "A String", # A key needed to access the item via a shared link. - "sha1Checksum": "A String", # The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or shortcut files. - "sha256Checksum": "A String", # The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or shortcut files. + "sha1Checksum": "A String", # The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or shortcut files. + "sha256Checksum": "A String", # The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or shortcut files. "shared": True or False, # Whether the file has been shared. Not populated for items in shared drives. "sharedWithMeTime": "A String", # The time at which the file was shared with the user, if applicable (RFC 3339 date-time). "sharingUser": { # Information about a Drive user. # The user who shared the file with the requesting user, if applicable. @@ -2987,15 +2988,15 @@Method Details
"targetMimeType": "A String", # The MIME type of the file that this shortcut points to. The value of this field is a snapshot of the target's MIME type, captured when the shortcut is created. "targetResourceKey": "A String", # The ResourceKey for the target file. }, - "size": "A String", # The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it is not populated for shortcuts or folders. - "spaces": [ # The list of spaces which contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'. + "size": "A String", # The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it's not populated for shortcuts or folders. + "spaces": [ # The list of spaces that contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'. "A String", ], "starred": True or False, # Whether the user has starred the file. "teamDriveId": "A String", # Deprecated - use driveId instead. "thumbnailLink": "A String", # A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in Files.thumbnailLink must be fetched using a credentialed request. "thumbnailVersion": "A String", # The thumbnail version for use in thumbnail cache invalidation. - "trashed": True or False, # Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner may trash a file. The trashed item is excluded from all files.list responses returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file. + "trashed": True or False, # Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner can trash a file. The trashed item is excluded from all files.list responses returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file. "trashedTime": "A String", # The time that the item was trashed (RFC 3339 date-time). Only populated for items in shared drives. "trashingUser": { # Information about a Drive user. # If the file has been explicitly trashed, the user who trashed it. Only populated for items in shared drives. "displayName": "A String", # A plain text displayable name for this user. @@ -3006,13 +3007,13 @@Method Details
"photoLink": "A String", # A link to the user's profile photo, if available. }, "version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the user. - "videoMediaMetadata": { # Additional metadata about video media. This may not be available immediately upon upload. + "videoMediaMetadata": { # Additional metadata about video media. This might not be available immediately upon upload. "durationMillis": "A String", # The duration of the video in milliseconds. "height": 42, # The height of the video in pixels. "width": 42, # The width of the video in pixels. }, - "viewedByMe": True or False, # Whether the file has been viewed by this user. - "viewedByMeTime": "A String", # The last time the file was viewed by the user (RFC 3339 date-time). + "viewedByMe": True or False, # Whether this user has viewed the file. + "viewedByMeTime": "A String", # The last time the user viewed the file (RFC 3339 date-time). "viewersCanCopyContent": True or False, # Deprecated - use copyRequiresWriterPermission instead. "webContentLink": "A String", # A link for downloading the content of the file in a browser. This is only available for files with binary content in Google Drive. "webViewLink": "A String", # A link for opening the file in a relevant Google editor or viewer in a browser. @@ -3022,7 +3023,7 @@Method Details
watch(fileId, acknowledgeAbuse=None, body=None, includeLabels=None, includePermissionsForView=None, supportsAllDrives=None, supportsTeamDrives=None)-Subscribes to changes to a file. While you can establish a channel for changes to a file on a shared drive, a change to a shared drive file won't create a notification. +Subscribe to changes on a file. Args: fileId: string, The ID of the file. (required) @@ -3071,7 +3072,7 @@Method Details
watch_media(fileId, acknowledgeAbuse=None, body=None, includeLabels=None, includePermissionsForView=None, supportsAllDrives=None, supportsTeamDrives=None)-Subscribes to changes to a file. While you can establish a channel for changes to a file on a shared drive, a change to a shared drive file won't create a notification. +Subscribe to changes on a file. Args: fileId: string, The ID of the file. (required) diff --git a/googleapiclient/discovery_cache/documents/drive.v2.json b/googleapiclient/discovery_cache/documents/drive.v2.json index 5cc21a39878..082b017e07f 100644 --- a/googleapiclient/discovery_cache/documents/drive.v2.json +++ b/googleapiclient/discovery_cache/documents/drive.v2.json @@ -38,7 +38,7 @@ "description": "Manages files in Drive including uploading, downloading, searching, detecting changes, and updating sharing permissions.", "discoveryVersion": "v1", "documentationLink": "https://developers.google.com/drive/", - "etag": "\"VYc8DWo_6wRTElVugbtvWfkARsc/dOQGKrTwRgBUrvlq11qcfi6tIQ8\"", + "etag": "\"VYc8DWo_6wRTElVugbtvWfkARsc/to8W0Xrp55yNHhg4FqPjePP3FcY\"", "icons": { "x16": "https://ssl.gstatic.com/docs/doclist/images/drive_icon_16.png", "x32": "https://ssl.gstatic.com/docs/doclist/images/drive_icon_32.png" @@ -1290,10 +1290,15 @@ ] }, "emptyTrash": { - "description": "Permanently deletes all of the user's trashed files.", + "description": "Permanently deletes all trashed files of a user or shared drive.", "httpMethod": "DELETE", "id": "drive.files.emptyTrash", "parameters": { + "driveId": { + "description": "If set, empties the trash of the provided shared drive.", + "location": "query", + "type": "string" + }, "enforceSingleParent": { "default": "false", "description": "Deprecated. If an item is not in a shared drive and its last parent is deleted but the item itself is not, the item will be placed under its owner's root.", @@ -2226,7 +2231,7 @@ "supportsMediaUpload": true }, "watch": { - "description": "Subscribes to changes to a file. While you can establish a channel for changes to a file on a shared drive, a change to a shared drive file won't create a notification.", + "description": "Subscribe to changes on a file.", "httpMethod": "POST", "id": "drive.files.watch", "parameterOrder": [ @@ -3668,7 +3673,7 @@ } } }, - "revision": "20230402", + "revision": "20230514", "rootUrl": "https://www.googleapis.com/", "schemas": { "About": { diff --git a/googleapiclient/discovery_cache/documents/drive.v3.json b/googleapiclient/discovery_cache/documents/drive.v3.json index d96949e4691..e952bfe3669 100644 --- a/googleapiclient/discovery_cache/documents/drive.v3.json +++ b/googleapiclient/discovery_cache/documents/drive.v3.json @@ -35,7 +35,7 @@ "description": "Manages files in Drive including uploading, downloading, searching, detecting changes, and updating sharing permissions.", "discoveryVersion": "v1", "documentationLink": "https://developers.google.com/drive/", - "etag": "\"VYc8DWo_6wRTElVugbtvWfkARsc/WQriJjubUMs4u0mQvFtbZ9iWxEc\"", + "etag": "\"VYc8DWo_6wRTElVugbtvWfkARsc/Rbg-qVi5IMtZXkfgFBOCN9uNluk\"", "icons": { "x16": "https://ssl.gstatic.com/docs/doclist/images/drive_icon_16.png", "x32": "https://ssl.gstatic.com/docs/doclist/images/drive_icon_32.png" @@ -997,10 +997,15 @@ ] }, "emptyTrash": { - "description": "Permanently deletes all of the user's trashed files.", + "description": "Permanently deletes all trashed files of a user or shared drive.", "httpMethod": "DELETE", "id": "drive.files.emptyTrash", "parameters": { + "driveId": { + "description": "If set, empties the trash of the provided shared drive.", + "location": "query", + "type": "string" + }, "enforceSingleParent": { "default": "false", "description": "Deprecated. If an item is not in a shared drive and its last parent is deleted but the item itself is not, the item will be placed under its owner's root.", @@ -1424,7 +1429,7 @@ "supportsMediaUpload": true }, "watch": { - "description": "Subscribes to changes to a file. While you can establish a channel for changes to a file on a shared drive, a change to a shared drive file won't create a notification.", + "description": "Subscribe to changes on a file.", "httpMethod": "POST", "id": "drive.files.watch", "parameterOrder": [ @@ -2312,7 +2317,7 @@ } } }, - "revision": "20230402", + "revision": "20230514", "rootUrl": "https://www.googleapis.com/", "schemas": { "About": { @@ -2930,22 +2935,22 @@ "additionalProperties": { "type": "string" }, - "description": "A collection of arbitrary key-value pairs which are private to the requesting app.\nEntries 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 a OAuth 2 client ID. You cannot use an API key to retrieve private properties.", + "description": "A collection of arbitrary key-value pairs that are private to the requesting app.\nEntries 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 client ID. You cannot use an API key to retrieve private properties.", "type": "object" }, "capabilities": { - "description": "Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user may take.", + "description": "Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user can take.", "properties": { "canAcceptOwnership": { "description": "Whether the current user is the pending owner of the file. Not populated for shared drive files.", "type": "boolean" }, "canAddChildren": { - "description": "Whether the current user can add children to this folder. This is always false when the item is not a folder.", + "description": "Whether the current user can add children to this folder. This is always false when the item isn't a folder.", "type": "boolean" }, "canAddFolderFromAnotherDrive": { - "description": "Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for items in shared drives.", + "description": "Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item isn't a folder. Only populated for items in shared drives.", "type": "boolean" }, "canAddMyDriveParent": { @@ -2969,7 +2974,7 @@ "type": "boolean" }, "canCopy": { - "description": "Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it is not a folder.", + "description": "Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it's not a folder.", "type": "boolean" }, "canDelete": { @@ -2977,7 +2982,7 @@ "type": "boolean" }, "canDeleteChildren": { - "description": "Whether the current user can delete children of this folder. This is false when the item is not a folder. Only populated for items in shared drives.", + "description": "Whether the current user can delete children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives.", "type": "boolean" }, "canDownload": { @@ -2985,11 +2990,11 @@ "type": "boolean" }, "canEdit": { - "description": "Whether the current user can edit this file. Other factors may limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or canModifyContent.", + "description": "Whether the current user can edit this file. Other factors might limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or canModifyContent.", "type": "boolean" }, "canListChildren": { - "description": "Whether the current user can list the children of this folder. This is always false when the item is not a folder.", + "description": "Whether the current user can list the children of this folder. This is always false when the item isn't a folder.", "type": "boolean" }, "canModifyContent": { @@ -3005,7 +3010,7 @@ "type": "boolean" }, "canMoveChildrenOutOfDrive": { - "description": "Whether the current user can move children of this folder outside of the shared drive. This is false when the item is not a folder. Only populated for items in shared drives.", + "description": "Whether the current user can move children of this folder outside of the shared drive. This is false when the item isn't a folder. Only populated for items in shared drives.", "type": "boolean" }, "canMoveChildrenOutOfTeamDrive": { @@ -3013,7 +3018,7 @@ "type": "boolean" }, "canMoveChildrenWithinDrive": { - "description": "Whether the current user can move children of this folder within this drive. This is false when the item is not a folder. Note that a request to move the child may still fail depending on the current user's access to the child and to the destination folder.", + "description": "Whether the current user can move children of this folder within this shared drive or My Drive. This is false when the item isn't a folder. Note that a request to move the child might still fail depending on the current user's access to the child and to the destination folder.", "type": "boolean" }, "canMoveChildrenWithinTeamDrive": { @@ -3025,7 +3030,7 @@ "type": "boolean" }, "canMoveItemOutOfDrive": { - "description": "Whether the current user can move this item outside of this drive by changing its parent. Note that a request to change the parent of the item may still fail depending on the new parent that is being added.", + "description": "Whether the current user can move this item outside of this shared drive or My Drive by changing its parent. Note that a request to change the parent of the item might still fail depending on the new parent that's being added.", "type": "boolean" }, "canMoveItemOutOfTeamDrive": { @@ -3033,7 +3038,7 @@ "type": "boolean" }, "canMoveItemWithinDrive": { - "description": "Whether the current user can move this item within this drive. Note that a request to change the parent of the item may still fail depending on the new parent that is being added and the parent that is being removed.", + "description": "Whether the current user can move this item within this shared drive or My Drive. Note that a request to change the parent of the item might still fail depending on the new parent that's being added and the parent that's being removed.", "type": "boolean" }, "canMoveItemWithinTeamDrive": { @@ -3053,7 +3058,7 @@ "type": "boolean" }, "canReadRevisions": { - "description": "Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it isn't a folder, can be read.", + "description": "Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it's not a folder, can be read.", "type": "boolean" }, "canReadTeamDrive": { @@ -3061,7 +3066,7 @@ "type": "boolean" }, "canRemoveChildren": { - "description": "Whether the current user can remove children from this folder. This is always false when the item is not a folder. For a folder in a shared drive, use canDeleteChildren or canTrashChildren instead.", + "description": "Whether the current user can remove children from this folder. This is always false when the item isn't a folder. For a folder in a shared drive, use canDeleteChildren or canTrashChildren instead.", "type": "boolean" }, "canRemoveMyDriveParent": { @@ -3081,7 +3086,7 @@ "type": "boolean" }, "canTrashChildren": { - "description": "Whether the current user can trash children of this folder. This is false when the item is not a folder. Only populated for items in shared drives.", + "description": "Whether the current user can trash children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives.", "type": "boolean" }, "canUntrash": { @@ -3095,7 +3100,7 @@ "description": "Additional information about the content of the file. These fields are never populated in responses.", "properties": { "indexableText": { - "description": "Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and may contain HTML elements. For more information, see Manage file metadata.", + "description": "Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and might contain HTML elements. For more information, see Manage file metadata.", "type": "string" }, "thumbnail": { @@ -3162,7 +3167,7 @@ "type": "string" }, "fullFileExtension": { - "description": "The full file extension extracted from the name field. May contain multiple concatenated extensions, such as \"tar.gz\". This is only available for files with binary content in Google Drive.\nThis is automatically updated when the name field changes, however it isn't cleared if the new name does not contain a valid extension.", + "description": "The full file extension extracted from the name field. Can contain multiple concatenated extensions, such as \"tar.gz\". This is only available for files with binary content in Google Drive.\nThis is automatically updated when the name field changes, however it's not cleared if the new name does not contain a valid extension.", "type": "string" }, "hasAugmentedPermissions": { @@ -3174,7 +3179,7 @@ "type": "boolean" }, "headRevisionId": { - "description": "The ID of the file's head revision. This is currently only available for files with binary content in Google Drive.", + "description": "The ID of the file's head revision. This is only available for files with binary content in Google Drive.", "type": "string" }, "iconLink": { @@ -3273,7 +3278,7 @@ "type": "string" }, "rotation": { - "description": "The number of clockwise 90 degree rotations applied from the image's original orientation.", + "description": "The number of clockwise 90-degree rotations applied from the image's original orientation.", "format": "int32", "type": "integer" }, @@ -3303,7 +3308,7 @@ "type": "object" }, "isAppAuthorized": { - "description": "Whether the file was created or opened by the requesting app.", + "description": "Whether the requesting app created or opened the file.", "type": "boolean" }, "kind": { @@ -3351,21 +3356,21 @@ "type": "string" }, "modifiedByMe": { - "description": "Whether the file has been modified by this user.", + "description": "Whether this user has modified the file.", "type": "boolean" }, "modifiedByMeTime": { - "description": "The last time the file was modified by the user (RFC 3339 date-time).", + "description": "The last time the user modified the file (RFC 3339 date-time).", "format": "date-time", "type": "string" }, "modifiedTime": { - "description": "The last time the file was modified by anyone (RFC 3339 date-time).\nNote that setting modifiedTime will also update modifiedByMeTime for the user.", + "description": "The last time anyone modified the file (RFC 3339 date-time).\nNote that setting modifiedTime will also update modifiedByMeTime for the user.", "format": "date-time", "type": "string" }, "name": { - "description": "The name of the file. This is not necessarily unique within a folder. Note that for immutable items such as the top level folders of shared drives, My Drive root folder, and Application Data folder the name is constant.", + "description": "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, My Drive root folder, and Application Data folder the name is constant.", "type": "string" }, "originalFilename": { @@ -3377,14 +3382,14 @@ "type": "boolean" }, "owners": { - "description": "The owner of this file. Only certain legacy files may have more than one owner. This field isn't populated for items in shared drives.", + "description": "The owner of this file. Only certain legacy files might have more than one owner. This field isn't populated for items in shared drives.", "items": { "$ref": "User" }, "type": "array" }, "parents": { - "description": "The IDs of the parent folders which contain the file.\nIf not specified as part of a create request, the file will be placed directly in the user's My Drive folder. If not specified as part of a copy request, the file will inherit any discoverable parents of the source file. Update requests must use the addParents and removeParents parameters to modify the parents list.", + "description": "The IDs of the parent folders that contain the file.\nIf not specified as part of a create request, the file will be placed directly in the user's My Drive folder. If not specified as part of a copy request, the file will inherit any discoverable parents of the source file. Update requests must use the addParents and removeParents parameters to modify the parents list.", "items": { "type": "string" }, @@ -3408,7 +3413,7 @@ "additionalProperties": { "type": "string" }, - "description": "A collection of arbitrary key-value pairs which are visible to all apps.\nEntries with null values are cleared in update and copy requests.", + "description": "A collection of arbitrary key-value pairs that are visible to all apps.\nEntries with null values are cleared in update and copy requests.", "type": "object" }, "quotaBytesUsed": { @@ -3421,11 +3426,11 @@ "type": "string" }, "sha1Checksum": { - "description": "The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or shortcut files.", + "description": "The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or shortcut files.", "type": "string" }, "sha256Checksum": { - "description": "The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or shortcut files.", + "description": "The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or shortcut files.", "type": "string" }, "shared": { @@ -3460,12 +3465,12 @@ "type": "object" }, "size": { - "description": "The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it is not populated for shortcuts or folders.", + "description": "The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it's not populated for shortcuts or folders.", "format": "int64", "type": "string" }, "spaces": { - "description": "The list of spaces which contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'.", + "description": "The list of spaces that contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'.", "items": { "type": "string" }, @@ -3489,7 +3494,7 @@ "type": "string" }, "trashed": { - "description": "Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner may trash a file. The trashed item is excluded from all files.list responses returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file.", + "description": "Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner can trash a file. The trashed item is excluded from all files.list responses returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file.", "type": "boolean" }, "trashedTime": { @@ -3507,7 +3512,7 @@ "type": "string" }, "videoMediaMetadata": { - "description": "Additional metadata about video media. This may not be available immediately upon upload.", + "description": "Additional metadata about video media. This might not be available immediately upon upload.", "properties": { "durationMillis": { "description": "The duration of the video in milliseconds.", @@ -3528,11 +3533,11 @@ "type": "object" }, "viewedByMe": { - "description": "Whether the file has been viewed by this user.", + "description": "Whether this user has viewed the file.", "type": "boolean" }, "viewedByMeTime": { - "description": "The last time the file was viewed by the user (RFC 3339 date-time).", + "description": "The last time the user viewed the file (RFC 3339 date-time).", "format": "date-time", "type": "string" },