google-apis-cloudsupport_v2beta 0.25.0 → 0.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5542ebc619e24bb450b22f7094204f398a06d1bf07f836f2301b027939cb7bbc
-  data.tar.gz: a47a1a4d0df4585a63907c652ea7e918b892e15fbcb19d3fbe262146b0168eea
+  metadata.gz: d37245884663234301c05439dff26b923b8b4bdb11e3a4fe5c3b16ed45c92c2e
+  data.tar.gz: ff29a7456ff6fabcdd395665f213dcef28998b4fc399ffdc87c97095c577fc99
 SHA512:
-  metadata.gz: d1d41b562d7d926ff405c04778c31c229c0359d16c1da9414f4a213e722e06de8b5efde0bd2c0e1d42d189cd41b568baf4a96cd4b7cee58702a3aeaea3e59a34
-  data.tar.gz: f4e652d7a9456265ebff380d94275834f6eb3e98ae5706edcfe8291b5da41ef3061b4eaa67c5831eab9e7ae9b57ba48b151c05a26ab752fa8caf7912cb376f2d
+  metadata.gz: 516f298dd70a8ebdfe045a34f94548412ea539e650ee4aa8972e8dd98963307ca767e078924eccad5c83fa071d87c35217d566a2dc30100efbc2f5654669cc75
+  data.tar.gz: efec61d5e3834f99a3c980d841a42793c70c88814221041a47eff0065a14a3b17338e692876814c74a7ac738fc87372b496a690e1f2ad1c811d3d913ccc4677f

data/CHANGELOG.md

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

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
@@ -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

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.25.0"
+      GEM_VERSION = "0.27.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 = "20230725"
+      REVISION = "20230904"
     end
   end
 end

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

@@ -135,14 +135,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # 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": "
+        # 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": "
         # 1BT1M2T31DHNMENPO6KS36CPJ786L2TBFEHGN6NPI64R3CDHN8880G08I1H3MURR7DHII0GRCDTQM8"
         # `, "time_zone": "-07:00", "subscriber_email_addresses": [ "foo@domain.com", "
         # bar@domain.com" ], "testCase": true, "priority": "P3" `' \ "https://
@@ -419,13 +420,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.
@@ -461,14 +467,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.
@@ -499,18 +511,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
@@ -540,14 +556,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
@@ -582,17 +603,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.25.0
+  version: 0.27.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-08-06 00:00:00.000000000 Z
+date: 2023-09-10 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.25.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudsupport_v2beta/v0.27.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudsupport_v2beta
 post_install_message: 
 rdoc_options: []
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.2
+rubygems_version: 3.4.19
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Google Cloud Support API V2beta