google-api-python-client 2.97.0__py2.py3-none-any.whl → 2.99.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/cloudchannel.v1.json

@@ -2178,7 +2178,7 @@
       }
     }
   },
-  "revision": "20230812",
+  "revision": "20230910",
   "rootUrl": "https://cloudchannel.googleapis.com/",
   "schemas": {
     "GoogleCloudChannelV1ActivateEntitlementRequest": {
@@ -2747,7 +2747,7 @@
         },
         "orgPostalAddress": {
           "$ref": "GoogleTypePostalAddress",
-          "description": "Required. The organization address for the customer. To enforce US laws and embargoes, we require a region and zip code. You must provide valid addresses for every customer. To set the customer's language, use the Customer-level language code."
+          "description": "Required. The organization address for the customer. To enforce US laws and embargoes, we require a region, postal code, and address lines. You must provide valid addresses for every customer. To set the customer's language, use the Customer-level language code."
         },
         "primaryContactInfo": {
           "$ref": "GoogleCloudChannelV1ContactInfo",
@@ -4428,7 +4428,8 @@
         },
         "channelPartnerGranularity": {
           "$ref": "GoogleCloudChannelV1RepricingConfigChannelPartnerGranularity",
-          "description": "Applies the repricing configuration at the channel partner level. Only ChannelPartnerRepricingConfig supports this value."
+          "deprecated": true,
+          "description": "Applies the repricing configuration at the channel partner level. Only ChannelPartnerRepricingConfig supports this value. Deprecated: This is no longer supported. Use RepricingConfig.entitlement_granularity instead."
         },
         "conditionalOverrides": {
           "description": "The conditional overrides to apply for this configuration. If you list multiple overrides, only the first valid override is used. If you don't list any overrides, the API uses the normal adjustment and rebilling basis.",
@@ -4463,7 +4464,8 @@
       "type": "object"
     },
     "GoogleCloudChannelV1RepricingConfigChannelPartnerGranularity": {
-      "description": "Applies the repricing configuration at the channel partner level. The channel partner value is derived from the resource name. Takes an empty json object.",
+      "deprecated": true,
+      "description": "Applies the repricing configuration at the channel partner level. The channel partner value is derived from the resource name. Takes an empty json object. Deprecated: This is no longer supported. Use RepricingConfig.EntitlementGranularity instead.",
       "id": "GoogleCloudChannelV1RepricingConfigChannelPartnerGranularity",
       "properties": {},
       "type": "object"

googleapiclient/discovery_cache/documents/clouddeploy.v1.json

@@ -448,6 +448,34 @@
                     "https://www.googleapis.com/auth/cloud-platform"
                   ]
                 },
+                "rollbackTarget": {
+                  "description": "Creates a `Rollout` to roll back the specified target.",
+                  "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}:rollbackTarget",
+                  "httpMethod": "POST",
+                  "id": "clouddeploy.projects.locations.deliveryPipelines.rollbackTarget",
+                  "parameterOrder": [
+                    "name"
+                  ],
+                  "parameters": {
+                    "name": {
+                      "description": "Required. The `DeliveryPipeline` for which the rollback `Rollout` should be created. Format should be projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}.",
+                      "location": "path",
+                      "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+$",
+                      "required": true,
+                      "type": "string"
+                    }
+                  },
+                  "path": "v1/{+name}:rollbackTarget",
+                  "request": {
+                    "$ref": "RollbackTargetRequest"
+                  },
+                  "response": {
+                    "$ref": "RollbackTargetResponse"
+                  },
+                  "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}/deliveryPipelines/{deliveryPipelinesId}:setIamPolicy",
@@ -1451,7 +1479,7 @@
       }
     }
   },
-  "revision": "20230802",
+  "revision": "20230904",
   "rootUrl": "https://clouddeploy.googleapis.com/",
   "schemas": {
     "AbandonReleaseRequest": {
@@ -3384,6 +3412,63 @@
       "properties": {},
       "type": "object"
     },
+    "RollbackTargetConfig": {
+      "description": "Configs for the Rollback rollout.",
+      "id": "RollbackTargetConfig",
+      "properties": {
+        "rollout": {
+          "$ref": "Rollout",
+          "description": "Optional. The rollback `Rollout` to create."
+        },
+        "startingPhaseId": {
+          "description": "Optional. The starting phase ID for the `Rollout`. If unspecified, the `Rollout` will start in the stable phase.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "RollbackTargetRequest": {
+      "description": "The request object for `RollbackTarget`.",
+      "id": "RollbackTargetRequest",
+      "properties": {
+        "releaseId": {
+          "description": "Optional. ID of the `Release` to roll back to. If this isn't specified, the previous successful `Rollout` to the specified target will be used to determine the `Release`.",
+          "type": "string"
+        },
+        "rollbackConfig": {
+          "$ref": "RollbackTargetConfig",
+          "description": "Optional. Configs for the rollback `Rollout`."
+        },
+        "rolloutId": {
+          "description": "Required. ID of the rollback `Rollout` to create.",
+          "type": "string"
+        },
+        "rolloutToRollBack": {
+          "description": "Optional. If provided, this must be the latest `Rollout` that is on the `Target`.",
+          "type": "string"
+        },
+        "targetId": {
+          "description": "Required. ID of the `Target` that is being rolled back.",
+          "type": "string"
+        },
+        "validateOnly": {
+          "description": "Optional. If set to true, the request is validated and the user is provided with a `RollbackTargetResponse`.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "RollbackTargetResponse": {
+      "description": "The response object from `RollbackTarget`.",
+      "id": "RollbackTargetResponse",
+      "properties": {
+        "rollbackConfig": {
+          "$ref": "RollbackTargetConfig",
+          "description": "The config of the rollback `Rollout` created or will be created."
+        }
+      },
+      "type": "object"
+    },
     "Rollout": {
       "description": "A `Rollout` resource in the Cloud Deploy API. A `Rollout` contains information around a specific deployment to a `Target`.",
       "id": "Rollout",
@@ -3516,6 +3601,19 @@
           "readOnly": true,
           "type": "array"
         },
+        "rollbackOfRollout": {
+          "description": "Output only. Name of the `Rollout` that is rolled back by this `Rollout`. Empty if this `Rollout` wasn't created as a rollback.",
+          "readOnly": true,
+          "type": "string"
+        },
+        "rolledBackByRollouts": {
+          "description": "Output only. Names of `Rollouts` that rolled back this `Rollout`.",
+          "items": {
+            "type": "string"
+          },
+          "readOnly": true,
+          "type": "array"
+        },
         "state": {
           "description": "Output only. Current state of the `Rollout`.",
           "enum": [

googleapiclient/discovery_cache/documents/clouderrorreporting.v1beta1.json

@@ -430,7 +430,7 @@
       }
     }
   },
-  "revision": "20230809",
+  "revision": "20230901",
   "rootUrl": "https://clouderrorreporting.googleapis.com/",
   "schemas": {
     "DeleteEventsResponse": {
@@ -494,7 +494,7 @@
       "id": "ErrorGroup",
       "properties": {
         "groupId": {
-          "description": "Group IDs are unique for a given project. If the same kind of error occurs in different service contexts, it will receive the same group ID.",
+          "description": "An opaque identifier of the group. This field is assigned by the Error Reporting system and always populated. In the group resource name, the `group_id` is a unique identifier for a particular error group. The identifier is derived from key parts of the error-log content and is treated as Service Data. For information about how Service Data is handled, see [Google Cloud Privacy Notice](https://cloud.google.com/terms/cloud-privacy-notice).",
           "type": "string"
         },
         "name": {

googleapiclient/discovery_cache/documents/cloudfunctions.v1.json

@@ -546,7 +546,7 @@
       }
     }
   },
-  "revision": "20230803",
+  "revision": "20230904",
   "rootUrl": "https://cloudfunctions.googleapis.com/",
   "schemas": {
     "AuditConfig": {

googleapiclient/discovery_cache/documents/cloudfunctions.v2.json

@@ -571,7 +571,7 @@
       }
     }
   },
-  "revision": "20230803",
+  "revision": "20230904",
   "rootUrl": "https://cloudfunctions.googleapis.com/",
   "schemas": {
     "AuditConfig": {

googleapiclient/discovery_cache/documents/cloudfunctions.v2alpha.json

@@ -571,7 +571,7 @@
       }
     }
   },
-  "revision": "20230803",
+  "revision": "20230904",
   "rootUrl": "https://cloudfunctions.googleapis.com/",
   "schemas": {
     "AuditConfig": {

googleapiclient/discovery_cache/documents/cloudfunctions.v2beta.json

@@ -571,7 +571,7 @@
       }
     }
   },
-  "revision": "20230803",
+  "revision": "20230904",
   "rootUrl": "https://cloudfunctions.googleapis.com/",
   "schemas": {
     "AuditConfig": {

googleapiclient/discovery_cache/documents/cloudidentity.v1.json

@@ -1990,7 +1990,7 @@
       }
     }
   },
-  "revision": "20230808",
+  "revision": "20230904",
   "rootUrl": "https://cloudidentity.googleapis.com/",
   "schemas": {
     "AddIdpCredentialOperationMetadata": {

googleapiclient/discovery_cache/documents/cloudidentity.v1beta1.json

@@ -2015,7 +2015,7 @@
       }
     }
   },
-  "revision": "20230808",
+  "revision": "20230904",
   "rootUrl": "https://cloudidentity.googleapis.com/",
   "schemas": {
     "AddIdpCredentialOperationMetadata": {

googleapiclient/discovery_cache/documents/cloudkms.v1.json

@@ -1821,7 +1821,7 @@
       }
     }
   },
-  "revision": "20230808",
+  "revision": "20230831",
   "rootUrl": "https://cloudkms.googleapis.com/",
   "schemas": {
     "AsymmetricDecryptRequest": {

googleapiclient/discovery_cache/documents/cloudprofiler.v2.json

@@ -216,7 +216,7 @@
       }
     }
   },
-  "revision": "20230806",
+  "revision": "20230821",
   "rootUrl": "https://cloudprofiler.googleapis.com/",
   "schemas": {
     "CreateProfileRequest": {

googleapiclient/discovery_cache/documents/cloudresourcemanager.v1.json

@@ -1171,7 +1171,7 @@
       }
     }
   },
-  "revision": "20230810",
+  "revision": "20230910",
   "rootUrl": "https://cloudresourcemanager.googleapis.com/",
   "schemas": {
     "Ancestor": {

googleapiclient/discovery_cache/documents/cloudresourcemanager.v1beta1.json

@@ -568,7 +568,7 @@
       }
     }
   },
-  "revision": "20230810",
+  "revision": "20230910",
   "rootUrl": "https://cloudresourcemanager.googleapis.com/",
   "schemas": {
     "Ancestor": {

googleapiclient/discovery_cache/documents/cloudresourcemanager.v2.json

@@ -450,7 +450,7 @@
       }
     }
   },
-  "revision": "20230810",
+  "revision": "20230910",
   "rootUrl": "https://cloudresourcemanager.googleapis.com/",
   "schemas": {
     "AuditConfig": {

googleapiclient/discovery_cache/documents/cloudresourcemanager.v2beta1.json

@@ -450,7 +450,7 @@
       }
     }
   },
-  "revision": "20230810",
+  "revision": "20230910",
   "rootUrl": "https://cloudresourcemanager.googleapis.com/",
   "schemas": {
     "AuditConfig": {

googleapiclient/discovery_cache/documents/cloudresourcemanager.v3.json

@@ -1805,7 +1805,7 @@
       }
     }
   },
-  "revision": "20230810",
+  "revision": "20230910",
   "rootUrl": "https://cloudresourcemanager.googleapis.com/",
   "schemas": {
     "AuditConfig": {

googleapiclient/discovery_cache/documents/cloudscheduler.v1.json

@@ -418,7 +418,7 @@
       }
     }
   },
-  "revision": "20230726",
+  "revision": "20230901",
   "rootUrl": "https://cloudscheduler.googleapis.com/",
   "schemas": {
     "AppEngineHttpTarget": {
@@ -596,7 +596,7 @@
           "description": "Settings that determine the retry behavior."
         },
         "schedule": {
-          "description": "Required, except when used with UpdateJob. Describes the schedule on which the job will be executed. The schedule can be either of the following types: * [Crontab](https://en.wikipedia.org/wiki/Cron#Overview) * English-like [schedule](https://cloud.google.com/scheduler/docs/configuring/cron-job-schedules) As a general rule, execution `n + 1` of a job will not begin until execution `n` has finished. Cloud Scheduler will never allow two simultaneously outstanding executions. For example, this implies that if the `n+1`th execution is scheduled to run at 16:00 but the `n`th execution takes until 16:15, the `n+1`th execution will not start until `16:15`. A scheduled start time will be delayed if the previous execution has not ended when its scheduled time occurs. If retry_count > 0 and a job attempt fails, the job will be tried a total of retry_count times, with exponential backoff, until the next scheduled start time.",
+          "description": "Required, except when used with UpdateJob. Describes the schedule on which the job will be executed. The schedule can be either of the following types: * [Crontab](https://en.wikipedia.org/wiki/Cron#Overview) * English-like [schedule](https://cloud.google.com/scheduler/docs/configuring/cron-job-schedules) As a general rule, execution `n + 1` of a job will not begin until execution `n` has finished. Cloud Scheduler will never allow two simultaneously outstanding executions. For example, this implies that if the `n+1`th execution is scheduled to run at 16:00 but the `n`th execution takes until 16:15, the `n+1`th execution will not start until `16:15`. A scheduled start time will be delayed if the previous execution has not ended when its scheduled time occurs. If retry_count > 0 and a job attempt fails, the job will be tried a total of retry_count times, with exponential backoff, until the next scheduled start time. If retry_count is 0, a job attempt will not be retried if it fails. Instead the Cloud Scheduler system will wait for the next scheduled execution time. Setting retry_count to 0 does not prevent failed jobs from running according to schedule after the failure.",
           "type": "string"
         },
         "scheduleTime": {
@@ -834,7 +834,7 @@
           "type": "string"
         },
         "retryCount": {
-          "description": "The number of attempts that the system will make to run a job using the exponential backoff procedure described by max_doublings. The default value of retry_count is zero. If retry_count is zero, a job attempt will *not* be retried if it fails. Instead the Cloud Scheduler system will wait for the next scheduled execution time. If retry_count is set to a non-zero number then Cloud Scheduler will retry failed attempts, using exponential backoff, retry_count times, or until the next scheduled execution time, whichever comes first. Values greater than 5 and negative values are not allowed.",
+          "description": "The number of attempts that the system will make to run a job using the exponential backoff procedure described by max_doublings. The default value of retry_count is zero. If retry_count is 0, a job attempt will not be retried if it fails. Instead the Cloud Scheduler system will wait for the next scheduled execution time. Setting retry_count to 0 does not prevent failed jobs from running according to schedule after the failure. If retry_count is set to a non-zero number then Cloud Scheduler will retry failed attempts, using exponential backoff, retry_count times, or until the next scheduled execution time, whichever comes first. Values greater than 5 and negative values are not allowed.",
           "format": "int32",
           "type": "integer"
         }

googleapiclient/discovery_cache/documents/cloudscheduler.v1beta1.json

@@ -433,7 +433,7 @@
       }
     }
   },
-  "revision": "20230726",
+  "revision": "20230901",
   "rootUrl": "https://cloudscheduler.googleapis.com/",
   "schemas": {
     "AppEngineHttpTarget": {
@@ -615,7 +615,7 @@
           "description": "Settings that determine the retry behavior."
         },
         "schedule": {
-          "description": "Required, except when used with UpdateJob. Describes the schedule on which the job will be executed. The schedule can be either of the following types: * [Crontab](https://en.wikipedia.org/wiki/Cron#Overview) * English-like [schedule](https://cloud.google.com/scheduler/docs/configuring/cron-job-schedules) As a general rule, execution `n + 1` of a job will not begin until execution `n` has finished. Cloud Scheduler will never allow two simultaneously outstanding executions. For example, this implies that if the `n+1`th execution is scheduled to run at 16:00 but the `n`th execution takes until 16:15, the `n+1`th execution will not start until `16:15`. A scheduled start time will be delayed if the previous execution has not ended when its scheduled time occurs. If retry_count > 0 and a job attempt fails, the job will be tried a total of retry_count times, with exponential backoff, until the next scheduled start time.",
+          "description": "Required, except when used with UpdateJob. Describes the schedule on which the job will be executed. The schedule can be either of the following types: * [Crontab](https://en.wikipedia.org/wiki/Cron#Overview) * English-like [schedule](https://cloud.google.com/scheduler/docs/configuring/cron-job-schedules) As a general rule, execution `n + 1` of a job will not begin until execution `n` has finished. Cloud Scheduler will never allow two simultaneously outstanding executions. For example, this implies that if the `n+1`th execution is scheduled to run at 16:00 but the `n`th execution takes until 16:15, the `n+1`th execution will not start until `16:15`. A scheduled start time will be delayed if the previous execution has not ended when its scheduled time occurs. If retry_count > 0 and a job attempt fails, the job will be tried a total of retry_count times, with exponential backoff, until the next scheduled start time. If retry_count is 0, a job attempt will not be retried if it fails. Instead the Cloud Scheduler system will wait for the next scheduled execution time. Setting retry_count to 0 does not prevent failed jobs from running according to schedule after the failure.",
           "type": "string"
         },
         "scheduleTime": {
@@ -853,7 +853,7 @@
           "type": "string"
         },
         "retryCount": {
-          "description": "The number of attempts that the system will make to run a job using the exponential backoff procedure described by max_doublings. The default value of retry_count is zero. If retry_count is zero, a job attempt will *not* be retried if it fails. Instead the Cloud Scheduler system will wait for the next scheduled execution time. If retry_count is set to a non-zero number then Cloud Scheduler will retry failed attempts, using exponential backoff, retry_count times, or until the next scheduled execution time, whichever comes first. Values greater than 5 and negative values are not allowed.",
+          "description": "The number of attempts that the system will make to run a job using the exponential backoff procedure described by max_doublings. The default value of retry_count is zero. If retry_count is 0, a job attempt will not be retried if it fails. Instead the Cloud Scheduler system will wait for the next scheduled execution time. Setting retry_count to 0 does not prevent failed jobs from running according to schedule after the failure. If retry_count is set to a non-zero number then Cloud Scheduler will retry failed attempts, using exponential backoff, retry_count times, or until the next scheduled execution time, whichever comes first. Values greater than 5 and negative values are not allowed.",
           "format": "int32",
           "type": "integer"
         }

googleapiclient/discovery_cache/documents/cloudsearch.v1.json

@@ -2096,7 +2096,7 @@
       }
     }
   },
-  "revision": "20230809",
+  "revision": "20230831",
   "rootUrl": "https://cloudsearch.googleapis.com/",
   "schemas": {
     "Action": {
@@ -7391,7 +7391,7 @@
           "type": "array"
         },
         "snippet": {
-          "description": "The snippet of the document. The snippet of the document. May contain escaped HTML character that should be unescaped prior to rendering.",
+          "description": "The snippet of the document. May contain escaped HTML character that should be unescaped prior to rendering.",
           "type": "string"
         }
       },

googleapiclient/discovery_cache/documents/cloudshell.v1.json

@@ -374,7 +374,7 @@
       }
     }
   },
-  "revision": "20230807",
+  "revision": "20230814",
   "rootUrl": "https://cloudshell.googleapis.com/",
   "schemas": {
     "AddPublicKeyMetadata": {

googleapiclient/discovery_cache/documents/cloudsupport.v2.json

@@ -172,7 +172,7 @@
           ]
         },
         "create": {
-          "description": "Create a new case and associate it with the given Google Cloud Resource. The case object must have the following fields set: `display_name`, `description`, `classification`, and `priority`. Here is an example of calling this endpoint using cURL: ```shell parent=\"projects/some-project\" curl \\ --request POST \\ --header \"Authorization: Bearer $(gcloud auth print-access-token)\" \\ --header 'Content-Type: application/json' \\ --data '{ \"display_name\": \"Test case created by me.\", \"description\": \"a random test case, feel free to close\", \"classification\": { \"id\": \"100IK2AKCLHMGRJ9CDGMOCGP8DM6UTB4BT262T31BT1M2T31DHNMENPO6KS36CPJ786L2TBFEHGN6NPI64R3CDHN8880G08I1H3MURR7DHII0GRCDTQM8\" }, \"time_zone\": \"-07:00\", \"subscriber_email_addresses\": [ \"foo@domain.com\", \"bar@domain.com\" ], \"testCase\": true, \"priority\": \"P3\" }' \\ \"https://cloudsupport.googleapis.com/v2/$parent/cases\" ```",
+          "description": "Create a new case and associate it with a Google Cloud Resource. The case object must have the following fields set: `display_name`, `description`, `classification`, and `priority`. If you're just testing the API and don't want to route your case to an agent, set `testCase=true`. Here is an example of calling this endpoint using cURL: ```shell parent=\"projects/some-project\" curl \\ --request POST \\ --header \"Authorization: Bearer $(gcloud auth print-access-token)\" \\ --header 'Content-Type: application/json' \\ --data '{ \"display_name\": \"Test case created by me.\", \"description\": \"a random test case, feel free to close\", \"classification\": { \"id\": \"100IK2AKCLHMGRJ9CDGMOCGP8DM6UTB4BT262T31BT1M2T31DHNMENPO6KS36CPJ786L2TBFEHGN6NPI64R3CDHN8880G08I1H3MURR7DHII0GRCDTQM8\" }, \"time_zone\": \"-07:00\", \"subscriber_email_addresses\": [ \"foo@domain.com\", \"bar@domain.com\" ], \"testCase\": true, \"priority\": \"P3\" }' \\ \"https://cloudsupport.googleapis.com/v2/$parent/cases\" ```",
           "flatPath": "v2/{v2Id}/{v2Id1}/cases",
           "httpMethod": "POST",
           "id": "cloudsupport.cases.create",
@@ -373,7 +373,7 @@
         "attachments": {
           "methods": {
             "list": {
-              "description": "Retrieve all attachments associated with a support case. Here is an example of calling this endpoint using cURL: ```shell case=\"projects/some-project/cases/23598314\" curl \\ --header \"Authorization: Bearer $(gcloud auth print-access-token)\" \\ \"https://cloudsupport.googleapis.com/v2/$case/attachments\" ```",
+              "description": "List all the attachments associated with a support case. EXAMPLES: cURL: ```shell case=\"projects/some-project/cases/23598314\" curl \\ --header \"Authorization: Bearer $(gcloud auth print-access-token)\" \\ \"https://cloudsupport.googleapis.com/v2/$case/attachments\" ``` Python: ```python import googleapiclient.discovery api_version = \"v2\" supportApiService = googleapiclient.discovery.build( serviceName=\"cloudsupport\", version=api_version, discoveryServiceUrl=f\"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}\", ) request = ( supportApiService.cases() .attachments() .list(parent=\"projects/some-project/cases/43595344\") ) print(request.execute()) ```",
               "flatPath": "v2/{v2Id}/{v2Id1}/cases/{casesId}/attachments",
               "httpMethod": "GET",
               "id": "cloudsupport.cases.attachments.list",
@@ -393,7 +393,7 @@
                   "type": "string"
                 },
                 "parent": {
-                  "description": "Required. The resource name of Case object for which attachments should be listed.",
+                  "description": "Required. The name of the case for which attachments should be listed.",
                   "location": "path",
                   "pattern": "^[^/]+/[^/]+/cases/[^/]+$",
                   "required": true,
@@ -413,7 +413,7 @@
         "comments": {
           "methods": {
             "create": {
-              "description": "Add a new comment to the specified Case. The comment object must have the following fields set: body. Here is an example of calling this endpoint using cURL: ```shell case=\"projects/some-project/cases/43591344\" curl \\ --request POST \\ --header \"Authorization: Bearer $(gcloud auth print-access-token)\" \\ --header 'Content-Type: application/json' \\ --data '{ \"body\": \"This is a test comment.\" }' \\ \"https://cloudsupport.googleapis.com/v2/$case/comments\" ```",
+              "description": "Add a new comment to a case. The comment must have the following fields set: `body`. EXAMPLES: cURL: ```shell case=\"projects/some-project/cases/43591344\" curl \\ --request POST \\ --header \"Authorization: Bearer $(gcloud auth print-access-token)\" \\ --header 'Content-Type: application/json' \\ --data '{ \"body\": \"This is a test comment.\" }' \\ \"https://cloudsupport.googleapis.com/v2/$case/comments\" ``` Python: ```python import googleapiclient.discovery api_version = \"v2\" supportApiService = googleapiclient.discovery.build( serviceName=\"cloudsupport\", version=api_version, discoveryServiceUrl=f\"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}\", ) request = ( supportApiService.cases() .comments() .create( parent=\"projects/some-project/cases/43595344\", body={\"body\": \"This is a test comment.\"}, ) ) print(request.execute()) ```",
               "flatPath": "v2/{v2Id}/{v2Id1}/cases/{casesId}/comments",
               "httpMethod": "POST",
               "id": "cloudsupport.cases.comments.create",
@@ -422,7 +422,7 @@
               ],
               "parameters": {
                 "parent": {
-                  "description": "Required. The resource name of Case to which this comment should be added.",
+                  "description": "Required. The name of the case to which the comment should be added.",
                   "location": "path",
                   "pattern": "^[^/]+/[^/]+/cases/[^/]+$",
                   "required": true,
@@ -441,7 +441,7 @@
               ]
             },
             "list": {
-              "description": "Retrieve all comments associated with the Case object. Here is an example of calling this endpoint using cURL: ```shell case=\"projects/cloud-support-qa-premium/cases/43595344\" curl \\ --header \"Authorization: Bearer $(gcloud auth print-access-token)\" \\ \"https://cloudsupport.googleapis.com/v2/$case/comments\" ```",
+              "description": "List all the comments associated with a case. EXAMPLES: cURL: ```shell case=\"projects/some-project/cases/43595344\" curl \\ --header \"Authorization: Bearer $(gcloud auth print-access-token)\" \\ \"https://cloudsupport.googleapis.com/v2/$case/comments\" ``` Python: ```python import googleapiclient.discovery api_version = \"v2\" supportApiService = googleapiclient.discovery.build( serviceName=\"cloudsupport\", version=api_version, discoveryServiceUrl=f\"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}\", ) request = ( supportApiService.cases() .comments() .list(parent=\"projects/some-project/cases/43595344\") ) print(request.execute()) ```",
               "flatPath": "v2/{v2Id}/{v2Id1}/cases/{casesId}/comments",
               "httpMethod": "GET",
               "id": "cloudsupport.cases.comments.list",
@@ -450,18 +450,18 @@
               ],
               "parameters": {
                 "pageSize": {
-                  "description": "The maximum number of comments fetched with each request. Defaults to 10.",
+                  "description": "The maximum number of comments to fetch. Defaults to 10.",
                   "format": "int32",
                   "location": "query",
                   "type": "integer"
                 },
                 "pageToken": {
-                  "description": "A token identifying the page of results to return. If unspecified, the first page is retrieved.",
+                  "description": "A token identifying the page of results to return. If unspecified, the first page is returned.",
                   "location": "query",
                   "type": "string"
                 },
                 "parent": {
-                  "description": "Required. The resource name of Case object for which comments should be listed.",
+                  "description": "Required. The name of the case for which to list comments.",
                   "location": "path",
                   "pattern": "^[^/]+/[^/]+/cases/[^/]+$",
                   "required": true,
@@ -483,7 +483,7 @@
     "media": {
       "methods": {
         "download": {
-          "description": "Download a file attachment on a case. Note: HTTP requests must append \"?alt=media\" to the URL. Here is an example of calling this endpoint using cURL: ```shell name=\"projects/some-project/cases/43594844/attachments/0674M00000WijAnZAJ\" curl \\ --header \"Authorization: Bearer $(gcloud auth print-access-token)\" \\ \"https://cloudsupport.googleapis.com/v2/$name:download?alt=media\" ```",
+          "description": "Download a file attached to a case. Note: HTTP requests must append \"?alt=media\" to the URL. EXAMPLES: cURL: ```shell name=\"projects/some-project/cases/43594844/attachments/0674M00000WijAnZAJ\" curl \\ --header \"Authorization: Bearer $(gcloud auth print-access-token)\" \\ \"https://cloudsupport.googleapis.com/v2/$name:download?alt=media\" ``` Python: ```python import googleapiclient.discovery api_version = \"v2\" supportApiService = googleapiclient.discovery.build( serviceName=\"cloudsupport\", version=api_version, discoveryServiceUrl=f\"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}\", ) request = supportApiService.media().download( name=\"projects/some-project/cases/43595344/attachments/0684M00000Pw6pHQAR\" ) request.uri = request.uri.split(\"?\")[0] + \"?alt=media\" print(request.execute()) ```",
           "flatPath": "v2/{v2Id}/{v2Id1}/cases/{casesId}/attachments/{attachmentsId}:download",
           "httpMethod": "GET",
           "id": "cloudsupport.media.download",
@@ -492,7 +492,7 @@
           ],
           "parameters": {
             "name": {
-              "description": "The resource name of the attachment to be downloaded.",
+              "description": "The name of the file attachment to download.",
               "location": "path",
               "pattern": "^[^/]+/[^/]+/cases/[^/]+/attachments/[^/]+$",
               "required": true,
@@ -510,7 +510,7 @@
           "useMediaDownloadService": true
         },
         "upload": {
-          "description": "Create a file attachment on a case or Cloud resource. The attachment object must have the following fields set: filename. Here is an example of calling this endpoint using cURL: ```shell echo \"This text is in a file I'm uploading using CSAPI.\" \\ > \"./example_file.txt\" case=\"projects/some-project/cases/43594844\" curl \\ --header \"Authorization: Bearer $(gcloud auth print-access-token)\" \\ --data-binary @\"./example_file.txt\" \\ \"https://cloudsupport.googleapis.com/upload/v2beta/$case/attachments?attachment.filename=uploaded_via_curl.txt\" ```",
+          "description": "Create a file attachment on a case or Cloud resource. The attachment must have the following fields set: `filename`. EXAMPLES: cURL: ```shell echo \"This text is in a file I'm uploading using CSAPI.\" \\ > \"./example_file.txt\" case=\"projects/some-project/cases/43594844\" curl \\ --header \"Authorization: Bearer $(gcloud auth print-access-token)\" \\ --data-binary @\"./example_file.txt\" \\ \"https://cloudsupport.googleapis.com/upload/v2beta/$case/attachments?attachment.filename=uploaded_via_curl.txt\" ``` Python: ```python import googleapiclient.discovery api_version = \"v2\" supportApiService = googleapiclient.discovery.build( serviceName=\"cloudsupport\", version=api_version, discoveryServiceUrl=f\"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}\", ) file_path = \"./example_file.txt\" with open(file_path, \"w\") as file: file.write( \"This text is inside a file I'm going to upload using the Cloud Support API.\", ) request = supportApiService.media().upload( parent=\"projects/some-project/cases/43595344\", media_body=file_path ) request.uri = request.uri.split(\"?\")[0] + \"?attachment.filename=uploaded_via_python.txt\" print(request.execute()) ```",
           "flatPath": "v2/{v2Id}/{v2Id1}/cases/{casesId}/attachments",
           "httpMethod": "POST",
           "id": "cloudsupport.media.upload",
@@ -530,7 +530,7 @@
           ],
           "parameters": {
             "parent": {
-              "description": "Required. The resource name of the case (or case parent) to which the attachment should be attached.",
+              "description": "Required. The name of the case or Cloud resource to which the attachment should be attached.",
               "location": "path",
               "pattern": "^[^/]+/[^/]+/cases/[^/]+$",
               "required": true,
@@ -552,7 +552,7 @@
       }
     }
   },
-  "revision": "20230809",
+  "revision": "20230911",
   "rootUrl": "https://cloudsupport.googleapis.com/",
   "schemas": {
     "Actor": {
@@ -1062,14 +1062,14 @@
       "id": "ListAttachmentsResponse",
       "properties": {
         "attachments": {
-          "description": "The list of attachments associated with the given case.",
+          "description": "The list of attachments associated with a case.",
           "items": {
             "$ref": "Attachment"
           },
           "type": "array"
         },
         "nextPageToken": {
-          "description": "A token to retrieve the next page of results. This should be set in the `page_token` field of subsequent `cases.attachments.list` requests. If unspecified, there are no more results to retrieve.",
+          "description": "A token to retrieve the next page of results. Set this in the `page_token` field of subsequent `cases.attachments.list` requests. If unspecified, there are no more results to retrieve.",
           "type": "string"
         }
       },
@@ -1098,14 +1098,14 @@
       "id": "ListCommentsResponse",
       "properties": {
         "comments": {
-          "description": "The list of Comments associated with the given Case.",
+          "description": "List of the comments associated with the case.",
           "items": {
             "$ref": "Comment"
           },
           "type": "array"
         },
         "nextPageToken": {
-          "description": "A token to retrieve the next page of results. This should be set in the `page_token` field of subsequent `ListCommentsRequest` message that is issued. If unspecified, there are no more results to retrieve.",
+          "description": "A token to retrieve the next page of results. Set this in the `page_token` field of subsequent `cases.comments.list` requests. If unspecified, there are no more results to retrieve.",
           "type": "string"
         }
       },