google-api-python-client 2.187.0__py3-none-any.whl → 2.188.0__py3-none-any.whl

googleapiclient/discovery_cache/documents/drive.v2.json

@@ -3616,7 +3616,7 @@
 ]
 },
 "list": {
-"description": "Lists a file's revisions.",
+"description": "Lists a file's revisions. **Important:** The list of revisions returned by this method might be incomplete for files with a large revision history, including frequently edited Google Docs, Sheets, and Slides. Older revisions might be omitted from the response, meaning the first revision returned may not be the oldest existing revision. The revision history visible in the Workspace editor user interface might be more complete than the list returned by the API.",
 "flatPath": "files/{fileId}/revisions",
 "httpMethod": "GET",
 "id": "drive.revisions.list",
@@ -3893,7 +3893,7 @@
 }
 }
 },
-"revision": "20250829",
+"revision": "20251114",
 "rootUrl": "https://www.googleapis.com/",
 "schemas": {
 "About": {

googleapiclient/discovery_cache/documents/drive.v3.json

@@ -265,6 +265,86 @@
 }
 }
 },
+"approvals": {
+"methods": {
+"get": {
+"description": "Gets an Approval by ID.",
+"flatPath": "files/{fileId}/approvals/{approvalId}",
+"httpMethod": "GET",
+"id": "drive.approvals.get",
+"parameterOrder": [
+"fileId",
+"approvalId"
+],
+"parameters": {
+"approvalId": {
+"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.",
+"location": "path",
+"required": true,
+"type": "string"
+}
+},
+"path": "files/{fileId}/approvals/{approvalId}",
+"response": {
+"$ref": "Approval"
+},
+"scopes": [
+"https://www.googleapis.com/auth/drive",
+"https://www.googleapis.com/auth/drive.appdata",
+"https://www.googleapis.com/auth/drive.file",
+"https://www.googleapis.com/auth/drive.metadata",
+"https://www.googleapis.com/auth/drive.metadata.readonly",
+"https://www.googleapis.com/auth/drive.readonly"
+]
+},
+"list": {
+"description": "Lists the Approvals on a file.",
+"flatPath": "files/{fileId}/approvals",
+"httpMethod": "GET",
+"id": "drive.approvals.list",
+"parameterOrder": [
+"fileId"
+],
+"parameters": {
+"fileId": {
+"description": "Required. The ID of the file 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.",
+"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.",
+"location": "query",
+"type": "string"
+}
+},
+"path": "files/{fileId}/approvals",
+"response": {
+"$ref": "ApprovalList"
+},
+"scopes": [
+"https://www.googleapis.com/auth/drive",
+"https://www.googleapis.com/auth/drive.appdata",
+"https://www.googleapis.com/auth/drive.file",
+"https://www.googleapis.com/auth/drive.metadata",
+"https://www.googleapis.com/auth/drive.metadata.readonly",
+"https://www.googleapis.com/auth/drive.readonly"
+]
+}
+}
+},
 "apps": {
 "methods": {
 "get": {
@@ -2185,7 +2265,7 @@
 "replies": {
 "methods": {
 "create": {
-"description": "Creates a reply to a comment.",
+"description": "Creates a reply to a comment. For more information, see [Manage comments and replies](https://developers.google.com/workspace/drive/api/guides/manage-comments).",
 "flatPath": "files/{fileId}/comments/{commentId}/replies",
 "httpMethod": "POST",
 "id": "drive.replies.create",
@@ -2220,7 +2300,7 @@
 ]
 },
 "delete": {
-"description": "Deletes a reply.",
+"description": "Deletes a reply. For more information, see [Manage comments and replies](https://developers.google.com/workspace/drive/api/guides/manage-comments).",
 "flatPath": "files/{fileId}/comments/{commentId}/replies/{replyId}",
 "httpMethod": "DELETE",
 "id": "drive.replies.delete",
@@ -2256,7 +2336,7 @@
 ]
 },
 "get": {
-"description": "Gets a reply by ID.",
+"description": "Gets a reply by ID. For more information, see [Manage comments and replies](https://developers.google.com/workspace/drive/api/guides/manage-comments).",
 "flatPath": "files/{fileId}/comments/{commentId}/replies/{replyId}",
 "httpMethod": "GET",
 "id": "drive.replies.get",
@@ -2280,7 +2360,7 @@
 },
 "includeDeleted": {
 "default": "false",
-"description": "Whether to return deleted replies. Deleted replies will not include their original content.",
+"description": "Whether to return deleted replies. Deleted replies don't include their original content.",
 "location": "query",
 "type": "boolean"
 },
@@ -2303,7 +2383,7 @@
 ]
 },
 "list": {
-"description": "Lists a comment's replies.",
+"description": "Lists a comment's replies. For more information, see [Manage comments and replies](https://developers.google.com/workspace/drive/api/guides/manage-comments).",
 "flatPath": "files/{fileId}/comments/{commentId}/replies",
 "httpMethod": "GET",
 "id": "drive.replies.list",
@@ -2326,7 +2406,7 @@
 },
 "includeDeleted": {
 "default": "false",
-"description": "Whether to include deleted replies. Deleted replies will not include their original content.",
+"description": "Whether to include deleted replies. Deleted replies don't include their original content.",
 "location": "query",
 "type": "boolean"
 },
@@ -2340,7 +2420,7 @@
 "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 the 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 the previous response.",
 "location": "query",
 "type": "string"
 }
@@ -2357,7 +2437,7 @@
 ]
 },
 "update": {
-"description": "Updates a reply with patch semantics.",
+"description": "Updates a reply with patch semantics. For more information, see [Manage comments and replies](https://developers.google.com/workspace/drive/api/guides/manage-comments).",
 "flatPath": "files/{fileId}/comments/{commentId}/replies/{replyId}",
 "httpMethod": "PATCH",
 "id": "drive.replies.update",
@@ -2479,7 +2559,7 @@
 "useMediaDownloadService": true
 },
 "list": {
-"description": "Lists a file's revisions. For more information, see [Manage file revisions](https://developers.google.com/workspace/drive/api/guides/manage-revisions).",
+"description": "Lists a file's revisions. For more information, see [Manage file revisions](https://developers.google.com/workspace/drive/api/guides/manage-revisions). **Important:** The list of revisions returned by this method might be incomplete for files with a large revision history, including frequently edited Google Docs, Sheets, and Slides. Older revisions might be omitted from the response, meaning the first revision returned may not be the oldest existing revision. The revision history visible in the Workspace editor user interface might be more complete than the list returned by the API.",
 "flatPath": "files/{fileId}/revisions",
 "httpMethod": "GET",
 "id": "drive.revisions.list",
@@ -2720,7 +2800,7 @@
 }
 }
 },
-"revision": "20251019",
+"revision": "20251210",
 "rootUrl": "https://www.googleapis.com/",
 "schemas": {
 "About": {
@@ -3086,6 +3166,100 @@
 },
 "type": "object"
 },
+"Approval": {
+"description": "Metadata for an approval. An approval is a review/approve process for a Drive item.",
+"id": "Approval",
+"properties": {
+"approvalId": {
+"description": "The Approval ID.",
+"type": "string"
+},
+"completeTime": {
+"description": "Output only. The time time the approval was completed.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"createTime": {
+"description": "Output only. The time the approval was created.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"dueTime": {
+"description": "The time that the approval is due.",
+"format": "google-datetime",
+"type": "string"
+},
+"initiator": {
+"$ref": "User",
+"description": "The user that requested the Approval."
+},
+"kind": {
+"description": "This is always drive#approval.",
+"type": "string"
+},
+"modifyTime": {
+"description": "Output only. The most recent time the approval was modified.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"reviewerResponses": {
+"description": "The responses made on the Approval by reviewers.",
+"items": {
+"$ref": "ReviewerResponse"
+},
+"type": "array"
+},
+"status": {
+"description": "Output only. The status of the approval at the time this resource was requested.",
+"enum": [
+"STATUS_UNSPECIFIED",
+"IN_PROGRESS",
+"APPROVED",
+"CANCELLED",
+"DECLINED"
+],
+"enumDescriptions": [
+"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.",
+"The approval process is finished and the target was declined."
+],
+"readOnly": true,
+"type": "string"
+},
+"targetFileId": {
+"description": "Target file id of the approval.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ApprovalList": {
+"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.",
+"items": {
+"$ref": "Approval"
+},
+"type": "array"
+},
+"kind": {
+"description": "This is always drive#approvalList",
+"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.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "Change": {
 "description": "A change to a file or shared drive.",
 "id": "Change",
@@ -3230,7 +3404,7 @@
 "type": "string"
 },
 "assigneeEmailAddress": {
-"description": "Output only. The email of the user who is assigned to this comment, if none is assigned this will be unset.",
+"description": "Output only. The email address of the user assigned to this comment. If no user is assigned, the field is unset.",
 "readOnly": true,
 "type": "string"
 },
@@ -3271,7 +3445,7 @@
 "type": "string"
 },
 "mentionedEmailAddresses": {
-"description": "Output only. The emails of the users who were mentioned in this comment, if none were mentioned this will be an empty list.",
+"description": "Output only. A list of email addresses for users mentioned in this comment. If no users are mentioned, the list is empty.",
 "items": {
 "type": "string"
 },
@@ -4778,17 +4952,17 @@
 "id": "Reply",
 "properties": {
 "action": {
-"description": "The action the reply performed to the parent comment. Valid values are: * `resolve` * `reopen`",
+"description": "The action the reply performed to the parent comment. The supported values are: * `resolve` * `reopen`",
 "type": "string"
 },
 "assigneeEmailAddress": {
-"description": "Output only. The email of the user who is assigned to this reply, if none is assigned this will be unset.",
+"description": "Output only. The email address of the user assigned to this comment. If no user is assigned, the field is unset.",
 "readOnly": true,
 "type": "string"
 },
 "author": {
 "$ref": "User",
-"description": "Output only. The author of the reply. The author's email address and permission ID will not be populated."
+"description": "Output only. The author of the reply. The author's email address and permission ID won't be populated."
 },
 "content": {
 "annotations": {
@@ -4796,7 +4970,7 @@
 "drive.replies.update"
 ]
 },
-"description": "The plain text content of the reply. This field is used for setting the content, while `htmlContent` should be displayed. This is required on creates if no `action` is specified.",
+"description": "The plain text content of the reply. This field is used for setting the content, while `htmlContent` should be displayed. This field is required by the `create` method if no `action` value is specified.",
 "type": "string"
 },
 "createdTime": {
@@ -4822,7 +4996,7 @@
 "type": "string"
 },
 "mentionedEmailAddresses": {
-"description": "Output only. The emails of the users who were mentioned in this reply, if none were mentioned this will be an empty list.",
+"description": "Output only. A list of email addresses for users mentioned in this comment. If no users are mentioned, the list is empty.",
 "items": {
 "type": "string"
 },
@@ -4851,7 +5025,7 @@
 "type": "string"
 },
 "replies": {
-"description": "The list of replies. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.",
+"description": "The list of replies. If `nextPageToken` is populated, then this list may be incomplete and an additional page of results should be fetched.",
 "items": {
 "$ref": "Reply"
 },
@@ -4896,6 +5070,37 @@
 },
 "type": "object"
 },
+"ReviewerResponse": {
+"description": "A response on an Approval made by a specific Reviewer.",
+"id": "ReviewerResponse",
+"properties": {
+"kind": {
+"description": "This is always drive#reviewerResponse.",
+"type": "string"
+},
+"response": {
+"description": "A Reviewer\u2019s Response for the Approval.",
+"enum": [
+"RESPONSE_UNSPECIFIED",
+"NO_RESPONSE",
+"APPROVED",
+"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."
+],
+"type": "string"
+},
+"reviewer": {
+"$ref": "User",
+"description": "The user that is responsible for this response."
+}
+},
+"type": "object"
+},
 "Revision": {
 "description": "The metadata for a revision to a file. Some resource methods (such as `revisions.update`) require a `revisionId`. Use the `revisions.list` method to retrieve the ID for a revision.",
 "id": "Revision",

googleapiclient/discovery_cache/documents/eventarc.v1.json

@@ -1284,97 +1284,6 @@
 }
 }
 },
-"kafkaSources": {
-"methods": {
-"getIamPolicy": {
-"description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.",
-"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/kafkaSources/{kafkaSourcesId}:getIamPolicy",
-"httpMethod": "GET",
-"id": "eventarc.projects.locations.kafkaSources.getIamPolicy",
-"parameterOrder": [
-"resource"
-],
-"parameters": {
-"options.requestedPolicyVersion": {
-"description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).",
-"format": "int32",
-"location": "query",
-"type": "integer"
-},
-"resource": {
-"description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.",
-"location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/kafkaSources/[^/]+$",
-"required": true,
-"type": "string"
-}
-},
-"path": "v1/{+resource}:getIamPolicy",
-"response": {
-"$ref": "Policy"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform"
-]
-},
-"setIamPolicy": {
-"description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.",
-"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/kafkaSources/{kafkaSourcesId}:setIamPolicy",
-"httpMethod": "POST",
-"id": "eventarc.projects.locations.kafkaSources.setIamPolicy",
-"parameterOrder": [
-"resource"
-],
-"parameters": {
-"resource": {
-"description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.",
-"location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/kafkaSources/[^/]+$",
-"required": true,
-"type": "string"
-}
-},
-"path": "v1/{+resource}:setIamPolicy",
-"request": {
-"$ref": "SetIamPolicyRequest"
-},
-"response": {
-"$ref": "Policy"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform"
-]
-},
-"testIamPermissions": {
-"description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.",
-"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/kafkaSources/{kafkaSourcesId}:testIamPermissions",
-"httpMethod": "POST",
-"id": "eventarc.projects.locations.kafkaSources.testIamPermissions",
-"parameterOrder": [
-"resource"
-],
-"parameters": {
-"resource": {
-"description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.",
-"location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/kafkaSources/[^/]+$",
-"required": true,
-"type": "string"
-}
-},
-"path": "v1/{+resource}:testIamPermissions",
-"request": {
-"$ref": "TestIamPermissionsRequest"
-},
-"response": {
-"$ref": "TestIamPermissionsResponse"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform"
-]
-}
-}
-},
 "messageBuses": {
 "methods": {
 "create": {
@@ -1808,7 +1717,7 @@
 "type": "string"
 },
 "returnPartialSuccess": {
-"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the [ListOperationsResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `\"projects/example/locations/-\"`. This field is not by default supported and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
+"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
 "location": "query",
 "type": "boolean"
 }
@@ -2471,7 +2380,7 @@
 }
 }
 },
-"revision": "20251024",
+"revision": "20251219",
 "rootUrl": "https://eventarc.googleapis.com/",
 "schemas": {
 "AuditConfig": {
@@ -3225,7 +3134,7 @@
 "type": "array"
 },
 "unreachable": {
-"description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections e.g. when attempting to list all resources across all supported locations.",
+"description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations.",
 "items": {
 "type": "string"
 },
@@ -3916,6 +3825,18 @@
 },
 "type": "object"
 },
+"RetryPolicy": {
+"description": "The retry policy configuration for the Trigger. Can only be set with Cloud Run destinations.",
+"id": "RetryPolicy",
+"properties": {
+"maxAttempts": {
+"description": "Optional. The maximum number of delivery attempts for any message. The only valid value is 1.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
 "SetIamPolicyRequest": {
 "description": "Request message for `SetIamPolicy` method.",
 "id": "SetIamPolicyRequest",
@@ -4077,6 +3998,10 @@
 "description": "Required. The resource name of the trigger. Must be unique within the location of the project and must be in `projects/{project}/locations/{location}/triggers/{trigger}` format.",
 "type": "string"
 },
+"retryPolicy": {
+"$ref": "RetryPolicy",
+"description": "Optional. The retry policy to use in the Trigger. If unset, event delivery will be retried for up to 24 hours by default: https://cloud.google.com/eventarc/docs/retry-events"
+},
 "satisfiesPzs": {
 "description": "Output only. Whether or not this Trigger satisfies the requirements of physical zone separation",
 "readOnly": true,