google-api-python-client 2.194.0__py3-none-any.whl → 2.196.0__py3-none-any.whl

googleapiclient/discovery_cache/documents/drive.v3.json

@@ -267,8 +267,152 @@
 },
 "approvals": {
 "methods": {
+"approve": {
+"description": "Approves an approval. For more information, see [Manage approvals](https://developers.google.com/workspace/drive/api/guides/approvals). This is used to update the ReviewerResponse of the requesting user with a Response of `APPROVED`. If this is the last required reviewer response, this also completes the approval and sets the approval Status to `APPROVED`.",
+"flatPath": "files/{fileId}/approvals/{approvalId}:approve",
+"httpMethod": "POST",
+"id": "drive.approvals.approve",
+"parameterOrder": [
+"fileId",
+"approvalId"
+],
+"parameters": {
+"approvalId": {
+"description": "Required. The ID of the approval to approve.",
+"location": "path",
+"required": true,
+"type": "string"
+},
+"fileId": {
+"description": "Required. The ID of the file that the approval is on.",
+"location": "path",
+"required": true,
+"type": "string"
+}
+},
+"path": "files/{fileId}/approvals/{approvalId}:approve",
+"request": {
+"$ref": "ApproveApprovalRequest"
+},
+"response": {
+"$ref": "Approval"
+},
+"scopes": [
+"https://www.googleapis.com/auth/drive",
+"https://www.googleapis.com/auth/drive.file",
+"https://www.googleapis.com/auth/drive.metadata"
+]
+},
+"cancel": {
+"description": "Cancels an approval. For more information, see [Manage approvals](https://developers.google.com/workspace/drive/api/guides/approvals). Updates the approval Status to `CANCELLED`. This can be called by any user with the `writer` permission on the file while the approval Status is `IN_PROGRESS`.",
+"flatPath": "files/{fileId}/approvals/{approvalId}:cancel",
+"httpMethod": "POST",
+"id": "drive.approvals.cancel",
+"parameterOrder": [
+"fileId",
+"approvalId"
+],
+"parameters": {
+"approvalId": {
+"description": "Required. The ID of the approval to cancel.",
+"location": "path",
+"required": true,
+"type": "string"
+},
+"fileId": {
+"description": "Required. The ID of the file that the approval is on.",
+"location": "path",
+"required": true,
+"type": "string"
+}
+},
+"path": "files/{fileId}/approvals/{approvalId}:cancel",
+"request": {
+"$ref": "CancelApprovalRequest"
+},
+"response": {
+"$ref": "Approval"
+},
+"scopes": [
+"https://www.googleapis.com/auth/drive",
+"https://www.googleapis.com/auth/drive.file",
+"https://www.googleapis.com/auth/drive.metadata"
+]
+},
+"comment": {
+"description": "Comments on an approval. For more information, see [Manage approvals](https://developers.google.com/workspace/drive/api/guides/approvals). This sends a notification to both the initiator and the reviewers. Additionally, a message is also added to the approval activity log.",
+"flatPath": "files/{fileId}/approvals/{approvalId}:comment",
+"httpMethod": "POST",
+"id": "drive.approvals.comment",
+"parameterOrder": [
+"fileId",
+"approvalId"
+],
+"parameters": {
+"approvalId": {
+"description": "Required. The ID of the approval to comment on.",
+"location": "path",
+"required": true,
+"type": "string"
+},
+"fileId": {
+"description": "Required. The ID of the file that the approval is on.",
+"location": "path",
+"required": true,
+"type": "string"
+}
+},
+"path": "files/{fileId}/approvals/{approvalId}:comment",
+"request": {
+"$ref": "CommentApprovalRequest"
+},
+"response": {
+"$ref": "Approval"
+},
+"scopes": [
+"https://www.googleapis.com/auth/drive",
+"https://www.googleapis.com/auth/drive.file",
+"https://www.googleapis.com/auth/drive.metadata"
+]
+},
+"decline": {
+"description": "Declines an approval. For more information, see [Manage approvals](https://developers.google.com/workspace/drive/api/guides/approvals). This is used to update the ReviewerResponse of the requesting user with a Response of `DECLINED`. This also completes the approval and sets the approval Status to `DECLINED`.",
+"flatPath": "files/{fileId}/approvals/{approvalId}:decline",
+"httpMethod": "POST",
+"id": "drive.approvals.decline",
+"parameterOrder": [
+"fileId",
+"approvalId"
+],
+"parameters": {
+"approvalId": {
+"description": "Required. The ID of the approval to decline.",
+"location": "path",
+"required": true,
+"type": "string"
+},
+"fileId": {
+"description": "Required. The ID of the file that the approval is on.",
+"location": "path",
+"required": true,
+"type": "string"
+}
+},
+"path": "files/{fileId}/approvals/{approvalId}:decline",
+"request": {
+"$ref": "DeclineApprovalRequest"
+},
+"response": {
+"$ref": "Approval"
+},
+"scopes": [
+"https://www.googleapis.com/auth/drive",
+"https://www.googleapis.com/auth/drive.file",
+"https://www.googleapis.com/auth/drive.metadata"
+]
+},
 "get": {
-"description": "Gets an Approval by ID.",
+"description": "Gets an approval by ID. For more information, see [Manage approvals](https://developers.google.com/workspace/drive/api/guides/approvals).",
 "flatPath": "files/{fileId}/approvals/{approvalId}",
 "httpMethod": "GET",
 "id": "drive.approvals.get",
@@ -278,13 +422,13 @@
 ],
 "parameters": {
 "approvalId": {
-"description": "Required. The ID of the Approval.",
+"description": "Required. The ID of the approval.",
 "location": "path",
 "required": true,
 "type": "string"
 },
 "fileId": {
-"description": "Required. The ID of the file the Approval is on.",
+"description": "Required. The ID of the file that the approval is on.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -304,7 +448,7 @@
 ]
 },
 "list": {
-"description": "Lists the Approvals on a file.",
+"description": "Lists the approvals on a file. For more information, see [Manage approvals](https://developers.google.com/workspace/drive/api/guides/approvals).",
 "flatPath": "files/{fileId}/approvals",
 "httpMethod": "GET",
 "id": "drive.approvals.list",
@@ -313,19 +457,19 @@
 ],
 "parameters": {
 "fileId": {
-"description": "Required. The ID of the file the Approval is on.",
+"description": "Required. The ID of the file that the approval is on.",
 "location": "path",
 "required": true,
 "type": "string"
 },
 "pageSize": {
-"description": "The maximum number of Approvals to return. When not set, at most 100 Approvals will be returned.",
+"description": "The maximum number of approvals to return. When not set, at most 100 approvals are returned.",
 "format": "int32",
 "location": "query",
 "type": "integer"
 },
 "pageToken": {
-"description": "The token for continuing a previous list request on the next page. This should be set to the value of nextPageToken from a previous response.",
+"description": "The token for continuing a previous list request on the next page. This should be set to the value of `nextPageToken` from a previous response.",
 "location": "query",
 "type": "string"
 }
@@ -342,6 +486,71 @@
 "https://www.googleapis.com/auth/drive.metadata.readonly",
 "https://www.googleapis.com/auth/drive.readonly"
 ]
+},
+"reassign": {
+"description": "Reassigns the reviewers on an approval. For more information, see [Manage approvals](https://developers.google.com/workspace/drive/api/guides/approvals). Adds or replaces reviewers in the ReviewerResponse of the approval. This can be called by any user with the `writer` permission on the file while the approval Status is `IN_PROGRESS` and the Response for the reviewer being reassigned is `NO_RESPONSE`. A user with the `reader` permission can only reassign an approval that's assigned to themselves. Removing a reviewer isn't allowed.",
+"flatPath": "files/{fileId}/approvals/{approvalId}:reassign",
+"httpMethod": "POST",
+"id": "drive.approvals.reassign",
+"parameterOrder": [
+"fileId",
+"approvalId"
+],
+"parameters": {
+"approvalId": {
+"description": "Required. The ID of the approval to reassign.",
+"location": "path",
+"required": true,
+"type": "string"
+},
+"fileId": {
+"description": "Required. The ID of the file that the approval is on.",
+"location": "path",
+"required": true,
+"type": "string"
+}
+},
+"path": "files/{fileId}/approvals/{approvalId}:reassign",
+"request": {
+"$ref": "ReassignApprovalRequest"
+},
+"response": {
+"$ref": "Approval"
+},
+"scopes": [
+"https://www.googleapis.com/auth/drive",
+"https://www.googleapis.com/auth/drive.file",
+"https://www.googleapis.com/auth/drive.metadata"
+]
+},
+"start": {
+"description": "Starts an approval on a file. For more information, see [Manage approvals](https://developers.google.com/workspace/drive/api/guides/approvals).",
+"flatPath": "files/{fileId}/approvals:start",
+"httpMethod": "POST",
+"id": "drive.approvals.start",
+"parameterOrder": [
+"fileId"
+],
+"parameters": {
+"fileId": {
+"description": "Required. The ID of the file that the approval is created on.",
+"location": "path",
+"required": true,
+"type": "string"
+}
+},
+"path": "files/{fileId}/approvals:start",
+"request": {
+"$ref": "StartApprovalRequest"
+},
+"response": {
+"$ref": "Approval"
+},
+"scopes": [
+"https://www.googleapis.com/auth/drive",
+"https://www.googleapis.com/auth/drive.file",
+"https://www.googleapis.com/auth/drive.metadata"
+]
 }
 }
 },
@@ -1431,6 +1640,32 @@
 "supportsMediaDownload": true,
 "useMediaDownloadService": true
 },
+"generateCseToken": {
+"description": "Generates a CSE token which can be used to create or update CSE files.",
+"flatPath": "files/generateCseToken",
+"httpMethod": "GET",
+"id": "drive.files.generateCseToken",
+"parameterOrder": [],
+"parameters": {
+"fileId": {
+"description": "The ID of the file for which the JWT should be generated. If not provided, an id will be generated.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "The ID of the expected parent of the file. Used when generating a JWT for a new CSE file. If specified, the parent will be fetched, and if the parent is a shared drive item, the shared drive's policy will be used to determine the KACLS that should be used. It is invalid to specify both file_id and parent in a single request.",
+"location": "query",
+"type": "string"
+}
+},
+"path": "files/generateCseToken",
+"response": {
+"$ref": "GenerateCseTokenResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/drive"
+]
+},
 "generateIds": {
 "description": "Generates a set of file IDs which can be provided in create or copy requests. For more information, see [Create and manage files](https://developers.google.com/workspace/drive/api/guides/create-file).",
 "flatPath": "files/generateIds",
@@ -1588,13 +1823,13 @@
 "type": "boolean"
 },
 "orderBy": {
-"description": "A comma-separated list of sort keys. Valid keys are: * `createdTime`: When the file was created. Avoid using this key for queries on large item collections as it might result in timeouts or other issues. For time-related sorting on large item collections, use `modifiedTime` instead. * `folder`: The folder ID. This field is sorted using alphabetical ordering. * `modifiedByMeTime`: The last time the file was modified by the user. * `modifiedTime`: The last time the file was modified by anyone. * `name`: The name of the file. This field is sorted using alphabetical ordering, so 1, 12, 2, 22. * `name_natural`: The name of the file. This field is sorted using natural sort ordering, so 1, 2, 12, 22. * `quotaBytesUsed`: The number of storage quota bytes used by the file. * `recency`: The most recent timestamp from the file's date-time fields. * `sharedWithMeTime`: When the file was shared with the user, if applicable. * `starred`: Whether the user has starred the file. * `viewedByMeTime`: The last time the file was viewed by the user. Each key sorts ascending by default, but can be reversed with the `desc` modifier. Example usage: `?orderBy=folder,modifiedTime desc,name`.",
+"description": "A comma-separated list of sort keys. Valid keys are: * `createdTime`: When the file was created. Avoid using this key for queries on large item collections as it might result in timeouts or other issues. For time-related sorting on large item collections, use `modifiedTime desc` instead. * `folder`: The folder ID. This field is sorted using alphabetical ordering. * `modifiedByMeTime`: The last time the file was modified by the user. * `modifiedTime`: The last time the file was modified by anyone. * `name`: The name of the file. This field is sorted using alphabetical ordering, so 1, 12, 2, 22. * `name_natural`: The name of the file. This field is sorted using natural sort ordering, so 1, 2, 12, 22. * `quotaBytesUsed`: The number of storage quota bytes used by the file. * `recency`: The most recent timestamp from the file's date-time fields. * `sharedWithMeTime`: When the file was shared with the user, if applicable. * `starred`: Whether the user has starred the file. * `viewedByMeTime`: The last time the file was viewed by the user. Each key sorts ascending by default, but can be reversed with the `desc` modifier. Example usage: `?orderBy=folder,modifiedTime desc,name`.",
 "location": "query",
 "type": "string"
 },
 "pageSize": {
 "default": "100",
-"description": "The maximum number of files to return per page. Partial or empty result pages are possible even before the end of the files list has been reached.",
+"description": "The maximum number of files to return per page. Pages may be partial or empty even before reaching the end of the file list. If unspecified, at most 100 files are returned for shared drives, and the entire list of files for non-shared drives. The maximum value is 100; values above 100 are changed to 100.",
 "format": "int32",
 "location": "query",
 "maximum": "1000",
@@ -2803,7 +3038,7 @@
 }
 }
 },
-"revision": "20260322",
+"revision": "20260428",
 "rootUrl": "https://www.googleapis.com/",
 "schemas": {
 "About": {
@@ -3001,6 +3236,17 @@
 },
 "type": "object"
 },
+"AddReviewer": {
+"description": "Representation of a reviewer addition.",
+"id": "AddReviewer",
+"properties": {
+"addedReviewerEmail": {
+"description": "Required. The email of the reviewer to add.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "App": {
 "description": "The `apps` resource provides a list of apps that a user has installed, with information about each app's supported MIME types, file extensions, and other details. Some resource methods (such as `apps.get`) require an `appId`. Use the `apps.list` method to retrieve the ID for an installed application.",
 "id": "App",
@@ -3170,11 +3416,11 @@
 "type": "object"
 },
 "Approval": {
-"description": "Metadata for an approval. An approval is a review/approve process for a Drive item.",
+"description": "Metadata for an approval. An approval is a review or approve process for a Drive item.",
 "id": "Approval",
 "properties": {
 "approvalId": {
-"description": "The Approval ID.",
+"description": "The approval ID.",
 "type": "string"
 },
 "completeTime": {
@@ -3196,7 +3442,7 @@
 },
 "initiator": {
 "$ref": "User",
-"description": "The user that requested the Approval."
+"description": "The user that requested the approval."
 },
 "kind": {
 "description": "This is always drive#approval.",
@@ -3209,7 +3455,7 @@
 "type": "string"
 },
 "reviewerResponses": {
-"description": "The responses made on the Approval by reviewers.",
+"description": "The responses made on the approval by reviewers.",
 "items": {
 "$ref": "ReviewerResponse"
 },
@@ -3225,7 +3471,7 @@
 "DECLINED"
 ],
 "enumDescriptions": [
-"Approval status has not been set or was set to an invalid value.",
+"The approval status has not been set or was set to an invalid value.",
 "The approval process has started and not finished.",
 "The approval process is finished and the target was approved.",
 "The approval process was cancelled before it finished.",
@@ -3242,11 +3488,11 @@
 "type": "object"
 },
 "ApprovalList": {
-"description": "The response of an Approvals list request.",
+"description": "The response of an approvals list request.",
 "id": "ApprovalList",
 "properties": {
 "items": {
-"description": "The list of Approvals. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.",
+"description": "The list of approvals. If `nextPageToken` is populated, then this list may be incomplete and an additional page of results should be fetched.",
 "items": {
 "$ref": "Approval"
 },
@@ -3257,7 +3503,29 @@
 "type": "string"
 },
 "nextPageToken": {
-"description": "The page token for the next page of Approvals. This will be absent if the end of the Approvals list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results.",
+"description": "The page token for the next page of approvals. This is absent if the end of the approvals list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ApproveApprovalRequest": {
+"description": "Request for approving an approval as a reviewer.",
+"id": "ApproveApprovalRequest",
+"properties": {
+"message": {
+"description": "Optional. A message to accompany the reviewer response on the approval. This message is included in notifications for the action and in the approval activity log.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"CancelApprovalRequest": {
+"description": "Request for cancelling an approval as an initiator.",
+"id": "CancelApprovalRequest",
+"properties": {
+"message": {
+"description": "Optional. A message to accompany the cancellation of the approval. This message is included in notifications for the action and in the approval activity log.",
 "type": "string"
 }
 },
@@ -3398,6 +3666,21 @@
 },
 "type": "object"
 },
+"ClientEncryptionDetails": {
+"description": "Details about the client-side encryption applied to the file.",
+"id": "ClientEncryptionDetails",
+"properties": {
+"decryptionMetadata": {
+"$ref": "DecryptionMetadata",
+"description": "The metadata used for client-side operations."
+},
+"encryptionState": {
+"description": "The encryption state of the file. The values expected here are: - encrypted - unencrypted ",
+"type": "string"
+}
+},
+"type": "object"
+},
 "Comment": {
 "description": "A comment on a file. Some resource methods (such as `comments.update`) require a `commentId`. Use the `comments.list` method to retrieve the ID for a comment in a file.",
 "id": "Comment",
@@ -3488,6 +3771,17 @@
 },
 "type": "object"
 },
+"CommentApprovalRequest": {
+"description": "Request for commenting on an approval.",
+"id": "CommentApprovalRequest",
+"properties": {
+"message": {
+"description": "Required. A message to comment on the approval. This message is included in notifications for the action and in the approval activity log.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "CommentList": {
 "description": "A list of comments on a file.",
 "id": "CommentList",
@@ -3547,6 +3841,53 @@
 },
 "type": "object"
 },
+"DeclineApprovalRequest": {
+"description": "Request for declining an approval as a reviewer.",
+"id": "DeclineApprovalRequest",
+"properties": {
+"message": {
+"description": "Optional. A message to accompany the reviewer response on the approval. This message is included in notifications for the action and in the approval activity log.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"DecryptionMetadata": {
+"description": "Representation of the CSE DecryptionMetadata.",
+"id": "DecryptionMetadata",
+"properties": {
+"aes256GcmChunkSize": {
+"description": "Chunk size used if content was encrypted with the AES 256 GCM Cipher. Possible values are: - default - small ",
+"type": "string"
+},
+"encryptionResourceKeyHash": {
+"description": "The URL-safe Base64 encoded HMAC-SHA256 digest of the resource metadata with its DEK (Data Encryption Key); see https://developers.google.com/workspace/cse/reference",
+"type": "string"
+},
+"jwt": {
+"description": "The signed JSON Web Token (JWT) which can be used to authorize the requesting user with the Key ACL Service (KACLS). The JWT asserts that the requesting user has at least read permissions on the file.",
+"type": "string"
+},
+"kaclsId": {
+"description": "The ID of the KACLS (Key ACL Service) used to encrypt the file.",
+"format": "int64",
+"type": "string"
+},
+"kaclsName": {
+"description": "The name of the KACLS (Key ACL Service) used to encrypt the file.",
+"type": "string"
+},
+"keyFormat": {
+"description": "Key format for the unwrapped key. Must be `tinkAesGcmKey`.",
+"type": "string"
+},
+"wrappedKey": {
+"description": "The URL-safe Base64 encoded wrapped key used to encrypt the contents of the file.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "DownloadRestriction": {
 "description": "A restriction for copy and download of the file.",
 "id": "DownloadRestriction",
@@ -3556,7 +3897,7 @@
 "type": "boolean"
 },
 "restrictedForWriters": {
-"description": "Whether download and copy is restricted for writers. If `true`, download is also restricted for readers.",
+"description": "Whether download and copy is restricted for writers. If true, download is also restricted for readers.",
 "type": "boolean"
 }
 },
@@ -3977,6 +4318,10 @@
 "description": "Output only. Whether the current user can modify the sharing settings for this file.",
 "type": "boolean"
 },
+"canStartApproval": {
+"description": "Whether the current user can start an approval on the file.",
+"type": "boolean"
+},
 "canTrash": {
 "description": "Output only. Whether the current user can move this file to trash.",
 "type": "boolean"
@@ -3992,6 +4337,10 @@
 },
 "type": "object"
 },
+"clientEncryptionDetails": {
+"$ref": "ClientEncryptionDetails",
+"description": "Client Side Encryption related details. Contains details about the encryption state of the file and details regarding the encryption mechanism that clients need to use when decrypting the contents of this item. This will only be present on files and not on folders or shortcuts."
+},
 "contentHints": {
 "description": "Additional information about the content of the file. These fields are never populated in responses.",
 "properties": {
@@ -4220,7 +4569,7 @@
 "type": "string"
 },
 "labelInfo": {
-"description": "Output only. An overview of the labels on the file.",
+"description": "Label information on the file.",
 "properties": {
 "labels": {
 "description": "Output only. The set of labels on the file as requested by the label IDs in the `includeLabels` parameter. By default, no labels are returned.",
@@ -4350,7 +4699,7 @@
 "description": "Output only. The user who shared the file with the requesting user, if applicable."
 },
 "shortcutDetails": {
-"description": "Shortcut file details. Only populated for shortcut files, which have the mimeType field set to `application/vnd.google-apps.shortcut`. Can only be set on `files.create` requests.",
+"description": "Information about a shortcut file.",
 "properties": {
 "targetId": {
 "description": "The ID of the file that this shortcut points to. Can only be set on `files.create` requests.",
@@ -4398,7 +4747,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, and other users cannot see files in the owner's trash.",
+"description": "Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner may trash a file, but other users can still access the file in the owner's trash until it's permanently deleted.",
 "type": "boolean"
 },
 "trashedTime": {
@@ -4492,6 +4841,34 @@
 },
 "type": "object"
 },
+"GenerateCseTokenResponse": {
+"description": "JWT and associated metadata used to generate CSE files.",
+"id": "GenerateCseTokenResponse",
+"properties": {
+"currentKaclsId": {
+"description": "The current Key ACL Service (KACLS) ID associated with the JWT.",
+"format": "int64",
+"type": "string"
+},
+"currentKaclsName": {
+"description": "Name of the KACLs that the returned KACLs ID points to.",
+"type": "string"
+},
+"fileId": {
+"description": "The fileId for which the JWT was generated.",
+"type": "string"
+},
+"jwt": {
+"description": "The signed JSON Web Token (JWT) for the file.",
+"type": "string"
+},
+"kind": {
+"description": "Output only. Identifies what kind of resource this is. Value: the fixed string `\"drive#generateCseTokenResponse\"`.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GeneratedIds": {
 "description": "A list of generated file IDs which can be provided in create requests.",
 "id": "GeneratedIds",
@@ -4812,11 +5189,13 @@
 "type": "string"
 },
 "domain": {
-"description": "The domain to which this permission refers.",
+"description": "Output only. The domain to which this permission refers.",
+"readOnly": true,
 "type": "string"
 },
 "emailAddress": {
-"description": "The email address of the user or group to which this permission refers.",
+"description": "Output only. The email address of the user or group to which this permission refers.",
+"readOnly": true,
 "type": "string"
 },
 "expirationTime": {
@@ -4851,6 +5230,7 @@
 },
 "inheritedFrom": {
 "description": "Output only. The ID of the item from which this permission is inherited. This is only populated for items in shared drives.",
+"readOnly": true,
 "type": "string"
 },
 "permissionType": {
@@ -4950,6 +5330,46 @@
 },
 "type": "object"
 },
+"ReassignApprovalRequest": {
+"description": "Request for reassigning an approval. Reviewers can be added or replaced, but not removed.",
+"id": "ReassignApprovalRequest",
+"properties": {
+"addReviewers": {
+"description": "Optional. The list of reviewers to add.",
+"items": {
+"$ref": "AddReviewer"
+},
+"type": "array"
+},
+"message": {
+"description": "Optional. A message to send to the new reviewers. This message is included in notifications for the action and in the approval activity log.",
+"type": "string"
+},
+"replaceReviewers": {
+"description": "Optional. The list of reviewer replacements.",
+"items": {
+"$ref": "ReplaceReviewer"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"ReplaceReviewer": {
+"description": "Representation of a reviewer replacement.",
+"id": "ReplaceReviewer",
+"properties": {
+"addedReviewerEmail": {
+"description": "Required. The email of the reviewer to add.",
+"type": "string"
+},
+"removedReviewerEmail": {
+"description": "Required. The email of the reviewer to remove.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "Reply": {
 "description": "A reply to a comment on a file. Some resource methods (such as `replies.update`) require a `replyId`. Use the `replies.list` method to retrieve the ID for a reply.",
 "id": "Reply",
@@ -5074,7 +5494,7 @@
 "type": "object"
 },
 "ReviewerResponse": {
-"description": "A response on an Approval made by a specific Reviewer.",
+"description": "A response on an approval made by a specific reviewer.",
 "id": "ReviewerResponse",
 "properties": {
 "kind": {
@@ -5082,7 +5502,7 @@
 "type": "string"
 },
 "response": {
-"description": "A Reviewer\u2019s Response for the Approval.",
+"description": "A reviewer\u2019s response for the approval.",
 "enum": [
 "RESPONSE_UNSPECIFIED",
 "NO_RESPONSE",
@@ -5090,16 +5510,16 @@
 "DECLINED"
 ],
 "enumDescriptions": [
-"Response was set to an unrecognized value.",
-"The reviewer has not yet responded",
-"The Reviewer has approved the item.",
-"The Reviewer has declined the item."
+"The response was set to an unrecognized value.",
+"The reviewer hasn't responded.",
+"The reviewer has approved the item.",
+"The reviewer has declined the item."
 ],
 "type": "string"
 },
 "reviewer": {
 "$ref": "User",
-"description": "The user that is responsible for this response."
+"description": "The user that's responsible for this response."
 }
 },
 "type": "object"
@@ -5196,6 +5616,33 @@
 },
 "type": "object"
 },
+"StartApprovalRequest": {
+"description": "Allows creating an approval on a file.",
+"id": "StartApprovalRequest",
+"properties": {
+"dueTime": {
+"description": "Optional. The time that the approval is due.",
+"format": "google-datetime",
+"type": "string"
+},
+"lockFile": {
+"description": "Optional. Whether to lock the file when starting the approval.",
+"type": "boolean"
+},
+"message": {
+"description": "Optional. A message to send to reviewers when notifying them of the approval request.",
+"type": "string"
+},
+"reviewerEmails": {
+"description": "Required. The emails of the users who are set to review the approval.",
+"items": {
+"type": "string"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "StartPageToken": {
 "id": "StartPageToken",
 "properties": {
@@ -5239,11 +5686,11 @@
 "type": "object"
 },
 "TeamDrive": {
-"description": "Deprecated: use the drive collection instead.",
+"description": "Deprecated: use the drive collection instead. Next ID: 33",
 "id": "TeamDrive",
 "properties": {
 "backgroundImageFile": {
-"description": "An image file and cropping parameters from which a background image for this Team Drive is set. This is a write only field; it can only be set on `drive.teamdrives.update` requests that don't set `themeId`. When specified, all fields of the `backgroundImageFile` must be set.",
+"description": "The background image file for a Team Drive.",
 "properties": {
 "id": {
 "description": "The ID of an image file in Drive to use for the background image.",
@@ -5287,7 +5734,8 @@
 "type": "boolean"
 },
 "canChangeDownloadRestriction": {
-"description": "Whether the current user can change organizer-applied download restrictions of this shared drive.",
+"description": "Output only. Whether the current user can change organizer-applied download restrictions of this shared drive.",
+"readOnly": true,
 "type": "boolean"
 },
 "canChangeSharingFoldersRequiresOrganizerPermissionRestriction": {