google-cloud-support-v2 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3849242e47dbe8f4c18184a6db32ed02674382825090ff450a5fca4b05e698ad
-  data.tar.gz: c749c316cf94f14c995f88ebc453c5a327e03b649f348f5e836cec38add3628c
+  metadata.gz: 352f385b65eeb95d07f3b21325031879ad12e49db9957274e0e806c07179ebfc
+  data.tar.gz: 7d7d267f347f1d02957ab589618a32df37b579bc9e5bad791e57e8181012a87d
 SHA512:
-  metadata.gz: cc62c571c23d035066a71b2c21c6fd9f4b1a84c6e390be92f497c91dc318155f545b6b02caf224621d75229a7c75caa2dc527e772f69dbdd21469801f0185568
-  data.tar.gz: f214ca990e8af0032d5cae54e2da67490041a67d341098c1af5212e72830743624bc75a368ffb77d0f418e2b8076504da92e464e84f3a43351bd5a3017780cec
+  metadata.gz: fabb9fe277ab3c7c70e8122916a8f99201beaa85093a146fffdd9c5f4a1f5ff7f0b254ad9fcc1ed65b6b2dc6cb7f42475c8ae17b26abeb690465269517e2b353
+  data.tar.gz: cddccc37a6f16fe3f589488dc30ef305a6a1916fc8a250e16908637f933cbc503fca1d2798506d4ff3ec81e24f88eb9cbd805b3ccbfea93a8ba4202872f83a66

data/lib/google/cloud/support/v2/actor_pb.rb

@@ -7,7 +7,7 @@ require 'google/protobuf'
 require 'google/api/field_behavior_pb'
 
 
-descriptor_data = "\n#google/cloud/support/v2/actor.proto\x12\x17google.cloud.support.v2\x1a\x1fgoogle/api/field_behavior.proto\"I\n\x05\x41\x63tor\x12\x14\n\x0c\x64isplay_name\x18\x01 \x01(\t\x12\r\n\x05\x65mail\x18\x02 \x01(\t\x12\x1b\n\x0egoogle_support\x18\x04 \x01(\x08\x42\x03\xe0\x41\x03\x42\xb3\x01\n\x1b\x63om.google.cloud.support.v2B\nActorProtoP\x01Z5cloud.google.com/go/support/apiv2/supportpb;supportpb\xaa\x02\x17Google.Cloud.Support.V2\xca\x02\x17Google\\Cloud\\Support\\V2\xea\x02\x1aGoogle::Cloud::Support::V2b\x06proto3"
+descriptor_data = "\n#google/cloud/support/v2/actor.proto\x12\x17google.cloud.support.v2\x1a\x1fgoogle/api/field_behavior.proto\"d\n\x05\x41\x63tor\x12\x14\n\x0c\x64isplay_name\x18\x01 \x01(\t\x12\x11\n\x05\x65mail\x18\x02 \x01(\tB\x02\x18\x01\x12\x1b\n\x0egoogle_support\x18\x04 \x01(\x08\x42\x03\xe0\x41\x03\x12\x15\n\x08username\x18\x05 \x01(\tB\x03\xe0\x41\x03\x42\xb3\x01\n\x1b\x63om.google.cloud.support.v2B\nActorProtoP\x01Z5cloud.google.com/go/support/apiv2/supportpb;supportpb\xaa\x02\x17Google.Cloud.Support.V2\xca\x02\x17Google\\Cloud\\Support\\V2\xea\x02\x1aGoogle::Cloud::Support::V2b\x06proto3"
 
 pool = Google::Protobuf::DescriptorPool.generated_pool
 

data/lib/google/cloud/support/v2/attachment_service_services_pb.rb

@@ -24,7 +24,7 @@ module Google
     module Support
       module V2
         module CaseAttachmentService
-          # A service to manage file attachment for Google Cloud support cases.
+          # A service to manage file attachments for Google Cloud support cases.
           class Service
 
             include ::GRPC::GenericService
@@ -33,7 +33,37 @@ module Google
             self.unmarshal_class_method = :decode
             self.service_name = 'google.cloud.support.v2.CaseAttachmentService'
 
-            # Retrieve all attachments associated with a support case.
+            # 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())
+            # ```
             rpc :ListAttachments, ::Google::Cloud::Support::V2::ListAttachmentsRequest, ::Google::Cloud::Support::V2::ListAttachmentsResponse
           end
 

data/lib/google/cloud/support/v2/case_attachment_service/client.rb

@@ -27,7 +27,7 @@ module Google
           ##
           # Client for the CaseAttachmentService service.
           #
-          # A service to manage file attachment for Google Cloud support cases.
+          # A service to manage file attachments for Google Cloud support cases.
           #
           class Client
             # @private
@@ -189,7 +189,37 @@ module Google
             # Service calls
 
             ##
-            # Retrieve all attachments associated with a support case.
+            # 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())
+            # ```
             #
             # @overload list_attachments(request, options = nil)
             #   Pass arguments to `list_attachments` via a request object, either of type
@@ -207,12 +237,16 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     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 page_size [::Integer]
-            #     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.
+            #     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.
+            #
+            #     The size of each page can be smaller than the requested page size and can
+            #     include zero. For example, you could request 100 attachments on one page,
+            #     receive 0, and then on the next page, receive 90.
             #   @param page_token [::String]
             #     A token identifying the page of results to return. If unspecified, the
             #     first page is retrieved.

data/lib/google/cloud/support/v2/case_attachment_service.rb

@@ -31,7 +31,7 @@ module Google
     module Support
       module V2
         ##
-        # A service to manage file attachment for Google Cloud support cases.
+        # A service to manage file attachments for Google Cloud support cases.
         #
         # @example Load this service and instantiate a gRPC client
         #