google-apis-cloudsupport_v2beta 0.26.0 → 0.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 11b7b98694bd54f24a2b2c16872fba4040bb4c5b44ea3d8234473a6654c39a71
-  data.tar.gz: 61ae2b86f4186e44342fd6d6cd32f2d152cc3a0dba0357dbb7a87563799dfbc1
+  metadata.gz: 9f39d56eb38f84807afcfc4c6dbda7197df541f382edb784579e394b36b1f29e
+  data.tar.gz: a04dfebf26395a2bce4d166eeabaa853ea0ded7cf5a373b648356c0dd3eaee12
 SHA512:
-  metadata.gz: f8cb4f4738730baf055acfd335748c50e786db585df330604adc53de55f09039f3ee5304b890d65181818dbf8cbe9fd5025a9e45ab50e9727ee394f839e16f1a
-  data.tar.gz: 2d02306e5e312cb10645c9ff98ad97219a405a96dd62f06d235ad6b835723958f34f0a0f4a390a865dba0946805ef1d15918ebe0bea274f59ef1b9606706bda4
+  metadata.gz: 3fd82da5e727575991a90a4b0c476685397011c0787ccd5bc7fd12719d7e87e04954dcd326c52809194210ab26263bc0cd8fec1b10a08df1e2b1be79a63d9f9f
+  data.tar.gz: 61470fbbc9eae8fcb75788326e5a1c89732a72991e9b556e4b19a604bec98e9f6239b53e4fb51aaf20d15f5ca43ff1f2ef6be59ffd19578703d69d68ff4f3c20

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-cloudsupport_v2beta
 
+### v0.28.0 (2023-09-24)
+
+* Regenerated from discovery document revision 20230920
+
+### v0.27.0 (2023-09-10)
+
+* Regenerated from discovery document revision 20230904
+
 ### v0.26.0 (2023-08-27)
 
 * Regenerated from discovery document revision 20230818

data/lib/google/apis/cloudsupport_v2beta/classes.rb

@@ -736,14 +736,14 @@ module Google
       class ListAttachmentsResponse
         include Google::Apis::Core::Hashable
       
-        # The list of attachments associated with the given case.
+        # The list of attachments associated with a case.
         # Corresponds to the JSON property `attachments`
         # @return [Array<Google::Apis::CloudsupportV2beta::Attachment>]
         attr_accessor :attachments
       
-        # 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.
+        # 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.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -763,15 +763,15 @@ module Google
       class ListCasesResponse
         include Google::Apis::Core::Hashable
       
-        # The list of cases associated with the Google Cloud Resource, after any filters
-        # have been applied.
+        # The list of cases associated with the parent after any filters have been
+        # applied.
         # Corresponds to the JSON property `cases`
         # @return [Array<Google::Apis::CloudsupportV2beta::Case>]
         attr_accessor :cases
       
-        # A token to retrieve the next page of results. This should be set in the `
-        # page_token` field of the subsequent `ListCasesRequest` message that is issued.
-        # If unspecified, there are no more results to retrieve.
+        # A token to retrieve the next page of results. Set this in the `page_token`
+        # field of subsequent `cases.list` requests. If unspecified, there are no more
+        # results to retrieve.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -791,14 +791,14 @@ module Google
       class ListCommentsResponse
         include Google::Apis::Core::Hashable
       
-        # The list of Comments associated with the given Case.
+        # List of the comments associated with the case.
         # Corresponds to the JSON property `comments`
         # @return [Array<Google::Apis::CloudsupportV2beta::Comment>]
         attr_accessor :comments
       
-        # 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.
+        # 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.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -1057,9 +1057,9 @@ module Google
         # @return [Array<Google::Apis::CloudsupportV2beta::CaseClassification>]
         attr_accessor :case_classifications
       
-        # A token to retrieve the next page of results. This should be set in the `
-        # page_token` field of subsequent `SearchCaseClassificationsRequest` message
-        # that is issued. If unspecified, there are no more results to retrieve.
+        # A token to retrieve the next page of results. Set this in the `page_token`
+        # field of subsequent `caseClassifications.list` requests. If unspecified, there
+        # are no more results to retrieve.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -1079,15 +1079,15 @@ module Google
       class SearchCasesResponse
         include Google::Apis::Core::Hashable
       
-        # The list of cases associated with the Google Cloud Resource, after any filters
-        # have been applied.
+        # The list of cases associated with the parent after any filters have been
+        # applied.
         # Corresponds to the JSON property `cases`
         # @return [Array<Google::Apis::CloudsupportV2beta::Case>]
         attr_accessor :cases
       
-        # A token to retrieve the next page of results. This should be set in the `
-        # page_token` field of subsequent `SearchCaseRequest` message that is issued. If
-        # unspecified, there are no more results to retrieve.
+        # A token to retrieve the next page of results. Set this in the `page_token`
+        # field of subsequent `cases.search` requests. If unspecified, there are no more
+        # results to retrieve.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token

data/lib/google/apis/cloudsupport_v2beta/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module CloudsupportV2beta
       # Version of the google-apis-cloudsupport_v2beta gem
-      GEM_VERSION = "0.26.0"
+      GEM_VERSION = "0.28.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.12.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230818"
+      REVISION = "20230920"
     end
   end
 end

data/lib/google/apis/cloudsupport_v2beta/service.rb

@@ -50,26 +50,30 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Retrieve valid classifications to be used when creating a support case. The
-        # classications are hierarchical, with each classification containing all levels
-        # of the hierarchy, separated by `" > "`. For example `"Technical Issue >
-        # Compute > Compute Engine"`. Classification IDs returned by `
-        # caseClassifications.search` are guaranteed to be valid for at least six months.
-        # If a given classification is deactivated, it immediately stops being returned.
-        # After six months, `case.create` requests using the classification ID will
-        # fail. Here is an example of calling this endpoint using cURL: ```shell curl \ -
-        # -header "Authorization: Bearer $(gcloud auth print-access-token)" \ 'https://
-        # cloudsupport.googleapis.com/v2/caseClassifications:search?query=display_name:"*
-        # Compute%20Engine*"' ```
+        # Retrieve valid classifications to use when creating a support case.
+        # Classifications are hierarchical. Each classification is a string containing
+        # all levels of the hierarchy separated by `" > "`. For example, `"Technical
+        # Issue > Compute > Compute Engine"`. Classification IDs returned by this
+        # endpoint are valid for at least six months. When a classification is
+        # deactivated, this endpoint immediately stops returning it. After six months, `
+        # case.create` requests using the classification will fail. EXAMPLES: cURL: ```
+        # shell curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)"
+        # \ 'https://cloudsupport.googleapis.com/v2/caseClassifications:search?query=
+        # display_name:"*Compute%20Engine*"' ``` Python: ```python import
+        # googleapiclient.discovery supportApiService = googleapiclient.discovery.build(
+        # serviceName="cloudsupport", version="v2", discoveryServiceUrl=f"https://
+        # cloudsupport.googleapis.com/$discovery/rest?version=v2", ) request =
+        # supportApiService.caseClassifications().search( query='display_name:"*Compute
+        # Engine*"' ) print(request.execute()) ```
         # @param [Fixnum] page_size
-        #   The maximum number of cases fetched with each request.
+        #   The maximum number of classifications fetched with each request.
         # @param [String] page_token
         #   A token identifying the page of results to return. If unspecified, the first
         #   page is retrieved.
         # @param [String] query
-        #   An expression written in the Google Cloud filter language. If non-empty, then
-        #   only cases whose fields match the filter are returned. If empty, then no
-        #   messages are filtered out.
+        #   An expression used to filter case classifications. If it's an empty string,
+        #   then no filtering happens. Otherwise, case classifications will be returned
+        #   that match the filter.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -99,12 +103,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Close the specified case. Here is an example of calling this endpoint using
-        # cURL: ```shell case="projects/some-project/cases/43595344" curl \ --request
-        # POST \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "
-        # https://cloudsupport.googleapis.com/v2/$case:close" ```
+        # Close a case. EXAMPLES: cURL: ```shell case="projects/some-project/cases/
+        # 43595344" curl \ --request POST \ --header "Authorization: Bearer $(gcloud
+        # auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$case:
+        # close" ``` 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().close( name="projects/some-project/cases/43595344" )
+        # print(request.execute()) ```
         # @param [String] name
-        #   Required. The fully qualified name of the case resource to be closed.
+        #   Required. The name of the case to close.
         # @param [Google::Apis::CloudsupportV2beta::CloseCaseRequest] close_case_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -135,22 +144,29 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # 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": "
+        # Create a new case and associate it with a parent. It 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`. EXAMPLES: 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": "
         # 1BT1M2T31DHNMENPO6KS36CPJ786L2TBFEHGN6NPI64R3CDHN8880G08I1H3MURR7DHII0GRCDTQM8"
         # `, "time_zone": "-07:00", "subscriber_email_addresses": [ "foo@domain.com", "
         # bar@domain.com" ], "testCase": true, "priority": "P3" `' \ "https://
-        # cloudsupport.googleapis.com/v2/$parent/cases" ```
+        # cloudsupport.googleapis.com/v2/$parent/cases" ``` 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().
+        # create( parent="projects/some-project", body=` "displayName": "A Test Case", "
+        # description": "This is a test case.", "testCase": True, "priority": "P2", "
+        # classification": ` "id": "
+        # 1BT1M2T31DHNMENPO6KS36CPJ786L2TBFEHGN6NPI64R3CDHN8880G08I1H3MURR7DHII0GRCDTQM8"
+        # `, `, ) print(request.execute()) ```
         # @param [String] parent
-        #   Required. The name of the Google Cloud Resource under which the case should be
-        #   created.
+        #   Required. The name of the parent under which the case should be created.
         # @param [Google::Apis::CloudsupportV2beta::Case] case_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -181,18 +197,24 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Escalate a case. Escalating a case initiates the Google Cloud Support
-        # escalation management process. This operation is only available to certain
-        # Customer Care support services. Go to https://cloud.google.com/support and
-        # look for 'Technical support escalations' in the feature list to find out which
-        # support services let you perform escalations. Here is an example of calling
-        # this endpoint using cURL: ```shell case="projects/some-project/cases/43595344"
-        # curl \ --request POST \ --header "Authorization: Bearer $(gcloud auth print-
-        # access-token)" \ --header "Content-Type: application/json" \ --data '` "
-        # escalation": ` "reason": "BUSINESS_IMPACT", "justification": "This is a test
-        # escalation." ` `' \ "https://cloudsupport.googleapis.com/v2/$case:escalate" ```
+        # Escalate a case, starting the Google Cloud Support escalation management
+        # process. This operation is only available for some support services. Go to
+        # https://cloud.google.com/support and look for 'Technical support escalations'
+        # in the feature list to find out which ones let you do that. EXAMPLES: cURL: ```
+        # shell case="projects/some-project/cases/43595344" curl \ --request POST \ --
+        # header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header "
+        # Content-Type: application/json" \ --data '` "escalation": ` "reason": "
+        # BUSINESS_IMPACT", "justification": "This is a test escalation." ` `' \ "https:/
+        # /cloudsupport.googleapis.com/v2/$case:escalate" ``` 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().
+        # escalate( name="projects/some-project/cases/43595344", body=` "escalation": ` "
+        # reason": "BUSINESS_IMPACT", "justification": "This is a test escalation.", `, `
+        # , ) print(request.execute()) ```
         # @param [String] name
-        #   Required. The fully qualified name of the Case resource to be escalated.
+        #   Required. The name of the case to be escalated.
         # @param [Google::Apis::CloudsupportV2beta::EscalateCaseRequest] escalate_case_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -223,12 +245,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieve the specified case. Here is an example of calling this endpoint using
-        # cURL: ```shell case="projects/some-project/cases/16033687" curl \ --header "
-        # Authorization: Bearer $(gcloud auth print-access-token)" \ "https://
-        # cloudsupport.googleapis.com/v2/$case" ```
+        # Retrieve a case. EXAMPLES: cURL: ```shell case="projects/some-project/cases/
+        # 16033687" curl \ --header "Authorization: Bearer $(gcloud auth print-access-
+        # token)" \ "https://cloudsupport.googleapis.com/v2/$case" ``` 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().
+        # get( name="projects/some-project/cases/43595344", ) print(request.execute()) ``
+        # `
         # @param [String] name
-        #   Required. The fully qualified name of a case to be retrieved.
+        #   Required. The full name of a case to be retrieved.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -256,25 +283,29 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieve all cases under the specified parent. Note: Listing cases under an
-        # organization returns only the cases directly parented by that organization. To
-        # retrieve all cases under an organization, including cases parented by projects
-        # under that organization, use `cases.search`. Here is an example of calling
-        # this endpoint using cURL: ```shell parent="projects/some-project" curl \ --
-        # header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://
-        # cloudsupport.googleapis.com/v2/$parent/cases" ```
+        # Retrieve all cases under a parent, but not its children. For example, listing
+        # cases under an organization only returns the cases that are directly parented
+        # by that organization. To retrieve cases under an organization and its projects,
+        # use `cases.search`. EXAMPLES: cURL: ```shell parent="projects/some-project"
+        # curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "
+        # https://cloudsupport.googleapis.com/v2/$parent/cases" ``` 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().
+        # list(parent="projects/some-project") print(request.execute()) ```
         # @param [String] parent
-        #   Required. The fully qualified name of parent resource to list cases under.
+        #   Required. The name of a parent to list cases under.
         # @param [String] filter
-        #   An expression written in filter language. If non-empty, the query returns the
-        #   cases that match the filter. Else, the query doesn't filter the cases. Filter
-        #   expressions use the following fields with the operators equals (`=`) and `AND`:
-        #   - `state`: The accepted values are `OPEN` or `CLOSED`. - `priority`: The
-        #   accepted values are `P0`, `P1`, `P2`, `P3`, or `P4`. You can specify multiple
-        #   values for priority using the `OR` operator. For example, `priority=P1 OR
-        #   priority=P2`. - `creator.email`: The email address of the case creator.
-        #   Examples: - `state=CLOSED` - `state=OPEN AND creator.email="tester@example.com"
-        #   ` - `state=OPEN AND (priority=P0 OR priority=P1)`
+        #   An expression used to filter cases. If it's an empty string, then no filtering
+        #   happens. Otherwise, the endpoint returns the cases that match the filter.
+        #   Expressions use the following fields separated by `AND` and specified with `=`:
+        #   - `state`: Can be `OPEN` or `CLOSED`. - `priority`: Can be `P0`, `P1`, `P2`, `
+        #   P3`, or `P4`. You can specify multiple values for priority using the `OR`
+        #   operator. For example, `priority=P1 OR priority=P2`. - `creator.email`: The
+        #   email address of the case creator. EXAMPLES: - `state=CLOSED` - `state=OPEN
+        #   AND creator.email="tester@example.com"` - `state=OPEN AND (priority=P0 OR
+        #   priority=P1)`
         # @param [Fixnum] page_size
         #   The maximum number of cases fetched with each request. Defaults to 10.
         # @param [String] page_token
@@ -310,23 +341,28 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Update the specified case. Only a subset of fields can be updated. Here is an
-        # example of calling this endpoint using cURL: ```shell case="projects/some-
-        # project/cases/43595344" curl \ --request PATCH \ --header "Authorization:
-        # Bearer $(gcloud auth print-access-token)" \ --header "Content-Type:
-        # application/json" \ --data '` "priority": "P1" `' \ "https://cloudsupport.
-        # googleapis.com/v2/$case?updateMask=priority" ```
+        # Update a case. Only some fields can be updated. EXAMPLES: cURL: ```shell case="
+        # projects/some-project/cases/43595344" curl \ --request PATCH \ --header "
+        # Authorization: Bearer $(gcloud auth print-access-token)" \ --header "Content-
+        # Type: application/json" \ --data '` "priority": "P1" `' \ "https://
+        # cloudsupport.googleapis.com/v2/$case?updateMask=priority" ``` 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().
+        # patch( name="projects/some-project/cases/43112854", body=` "displayName": "
+        # This is Now a New Title", "priority": "P2", `, ) print(request.execute()) ```
         # @param [String] name
         #   The resource name for the case.
         # @param [Google::Apis::CloudsupportV2beta::Case] case_object
         # @param [String] update_mask
-        #   A list of attributes of the case object that should be updated as part of this
-        #   request. Supported values are `priority`, `display_name`, and `
-        #   subscriber_email_addresses`. If no fields are specified, all supported fields
-        #   are updated. WARNING: If you do not provide a field mask, then you might
-        #   accidentally clear some fields. For example, if you leave the field mask empty
-        #   and do not provide a value for `subscriber_email_addresses`, then `
-        #   subscriber_email_addresses` is updated to empty.
+        #   A list of attributes of the case that should be updated. Supported values are `
+        #   priority`, `display_name`, and `subscriber_email_addresses`. If no fields are
+        #   specified, all supported fields are updated. Be careful - if you do not
+        #   provide a field mask, then you might accidentally clear some fields. For
+        #   example, if you leave the field mask empty and do not provide a value for `
+        #   subscriber_email_addresses`, then `subscriber_email_addresses` is updated to
+        #   empty.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -357,10 +393,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Search cases using the specified query. Here is an example of calling this
-        # endpoint using cURL: ```shell parent="projects/some-project" curl \ --header "
-        # Authorization: Bearer $(gcloud auth print-access-token)" \ "https://
-        # cloudsupport.googleapis.com/v2/$parent/cases:search" ```
+        # Search for cases using a query. EXAMPLES: cURL: ```shell parent="projects/some-
+        # project" curl \ --header "Authorization: Bearer $(gcloud auth print-access-
+        # token)" \ "https://cloudsupport.googleapis.com/v2/$parent/cases:search" ```
+        # 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().search( parent="projects/some-project", query="state=OPEN" ) print(
+        # request.execute()) ```
         # @param [Fixnum] page_size
         #   The maximum number of cases fetched with each request. The default page size
         #   is 10.
@@ -368,28 +409,27 @@ module Google
         #   A token identifying the page of results to return. If unspecified, the first
         #   page is retrieved.
         # @param [String] parent
-        #   The fully qualified name of parent resource to search cases under.
+        #   The name of the parent resource to search for cases under.
         # @param [String] query
-        #   An expression written in filter language. A query uses the following fields
-        #   with the operators equals (`=`) and `AND`: - `organization`: An organization
+        #   An expression used to filter cases. Expressions use the following fields
+        #   separated by `AND` and specified with `=`: - `organization`: An organization
         #   name in the form `organizations/`. - `project`: A project name in the form `
-        #   projects/`. - `state`: The accepted values are `OPEN` or `CLOSED`. - `priority`
-        #   : The accepted values are `P0`, `P1`, `P2`, `P3`, or `P4`. You can specify
-        #   multiple values for priority using the `OR` operator. For example, `priority=
-        #   P1 OR priority=P2`. - `creator.email`: The email address of the case creator. -
-        #   `billingAccount`: A billing account in the form `billingAccounts/` You must
-        #   specify either `organization` or `project`. To search across `displayName`, `
-        #   description`, and comments, use a global restriction with no keyword or
-        #   operator. For example, `"my search"`. To search only cases updated after a
-        #   certain date, use `update_time` restricted with that particular date, time,
-        #   and timezone in ISO datetime format. For example, `update_time>"2020-01-01T00:
-        #   00:00-05:00"`. `update_time` only supports the greater than operator (`>`).
-        #   Examples: - `organization="organizations/123456789"` - `project="projects/my-
-        #   project-id"` - `project="projects/123456789"` - `billing_account="
-        #   billingAccounts/123456-A0B0C0-CUZ789"` - `organization="organizations/
-        #   123456789" AND state=CLOSED` - `project="projects/my-project-id" AND creator.
-        #   email="tester@example.com"` - `project="projects/my-project-id" AND (priority=
-        #   P0 OR priority=P1)`
+        #   projects/`. - `state`: Can be `OPEN` or `CLOSED`. - `priority`: Can be `P0`, `
+        #   P1`, `P2`, `P3`, or `P4`. You can specify multiple values for priority using
+        #   the `OR` operator. For example, `priority=P1 OR priority=P2`. - `creator.email`
+        #   : The email address of the case creator. - `billingAccount`: A billing account
+        #   in the form `billingAccounts/` You must specify either `organization` or `
+        #   project`. To search across `displayName`, `description`, and comments, use a
+        #   global restriction with no keyword or operator. For example, `"my search"`. To
+        #   search only cases updated after a certain date, use `update_time` restricted
+        #   with that particular date, time, and timezone in ISO datetime format. For
+        #   example, `update_time>"2020-01-01T00:00:00-05:00"`. `update_time` only
+        #   supports the greater than operator (`>`). Examples: - `organization="
+        #   organizations/123456789"` - `project="projects/my-project-id"` - `project="
+        #   projects/123456789"` - `billing_account="billingAccounts/123456-A0B0C0-CUZ789"`
+        #   - `organization="organizations/123456789" AND state=CLOSED` - `project="
+        #   projects/my-project-id" AND creator.email="tester@example.com"` - `project="
+        #   projects/my-project-id" AND (priority=P0 OR priority=P1)`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -420,13 +460,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # 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" ```
+        # 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()) ```
         # @param [String] parent
-        #   Required. The resource name of Case object for which attachments should be
-        #   listed.
+        #   Required. The name of the case for which attachments should be listed.
         # @param [Fixnum] page_size
         #   The maximum number of attachments fetched with each request. If not provided,
         #   the default is 10. The maximum page size that will be returned is 100.
@@ -462,14 +507,20 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # 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" ```
+        # 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()) ```
         # @param [String] parent
-        #   Required. The resource name of Case to which this comment should be added.
+        #   Required. The name of the case to which the comment should be added.
         # @param [Google::Apis::CloudsupportV2beta::Comment] comment_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -500,18 +551,22 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # 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"
-        # ```
+        # 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()) ```
         # @param [String] parent
-        #   Required. The resource name of Case object for which comments should be listed.
+        #   Required. The name of the case for which to list comments.
         # @param [Fixnum] page_size
-        #   The maximum number of comments fetched with each request. Defaults to 10.
+        #   The maximum number of comments to fetch. Defaults to 10.
         # @param [String] page_token
         #   A token identifying the page of results to return. If unspecified, the first
-        #   page is retrieved.
+        #   page is returned.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -541,14 +596,19 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # 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" ```
+        # 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()) ```
         # @param [String] name
-        #   The resource name of the attachment to be downloaded.
+        #   The name of the file attachment to download.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -583,17 +643,24 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # 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" ```
+        # 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()) ```
         # @param [String] parent
-        #   Required. The resource name of the case (or case parent) to which the
-        #   attachment should be attached.
+        #   Required. The name of the case or Cloud resource to which the attachment
+        #   should be attached.
         # @param [Google::Apis::CloudsupportV2beta::CreateAttachmentRequest] create_attachment_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-cloudsupport_v2beta
 version: !ruby/object:Gem::Version
-  version: 0.26.0
+  version: 0.28.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-08-27 00:00:00.000000000 Z
+date: 2023-09-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudsupport_v2beta/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudsupport_v2beta/v0.26.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudsupport_v2beta/v0.28.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudsupport_v2beta
 post_install_message: 
 rdoc_options: []