google-cloud-support-v2 1.7.1 → 1.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 43c6407c40376559b21b420740ca036d5389142726962fe288e7fe648bc461e7
4
- data.tar.gz: c41b97d81874b973b08de89db6e42d0a92ee5c9595ef3b3f1542f5fcdbd182a3
3
+ metadata.gz: 7282f710988af572b2d57db45d80cf0989ff118d0592340137907464f5085ebe
4
+ data.tar.gz: e908ff3c123fd91791b5d6774f603daaf1c824ac7977a86dcbd3e9535b590f51
5
5
  SHA512:
6
- metadata.gz: c97545ec2b1f7931f035e8e4df0dabe3f33dbb9742778577e2ef9bf91cde00a3f9c6f8a8f7ab48b388d80dea0b5145d9f2769b5e6423dd0c86bca049ee52689d
7
- data.tar.gz: be514bc9cb7cff7f9f04ad936acb5fcbc4810f08b2fcc25dcd69a65c03e029ea5977bd6e462e673053dde569f08db140ebc6e751c6b135632a79a7102205116e
6
+ metadata.gz: d542e87a1c9eb97714f175721f2700b1378a7123c1464f4ebebf23a131578eff3b3c8e734d1cbee0370aa2bc71f586fb1563550933d2312ec97ac67d514ce2aa
7
+ data.tar.gz: 6570aadff3ad52b9191df6f51a220ebe0dda0d35b827893dc140b91d2bf81589ce51a874a7d36581ec387551923575298ea0c64e75648cffe0385b646f04ee7e
data/README.md CHANGED
@@ -86,7 +86,7 @@ To browse ready to use code samples check [Google Cloud Samples](https://cloud.g
86
86
 
87
87
  ## Supported Ruby Versions
88
88
 
89
- This library is supported on Ruby 3.0+.
89
+ This library is supported on Ruby 3.2+.
90
90
 
91
91
  Google provides official support for Ruby versions that are actively supported
92
92
  by Ruby Core—that is, Ruby versions that are either in normal maintenance or
@@ -11,7 +11,7 @@ require 'google/api/resource_pb'
11
11
  require 'google/cloud/support/v2/attachment_pb'
12
12
 
13
13
 
14
- descriptor_data = "\n0google/cloud/support/v2/attachment_service.proto\x12\x17google.cloud.support.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a(google/cloud/support/v2/attachment.proto\"y\n\x16ListAttachmentsRequest\x12\x38\n\x06parent\x18\x01 \x01(\tB(\xe0\x41\x02\xfa\x41\"\n cloudsupport.googleapis.com/Case\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\"l\n\x17ListAttachmentsResponse\x12\x38\n\x0b\x61ttachments\x18\x01 \x03(\x0b\x32#.google.cloud.support.v2.Attachment\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t2\xd1\x02\n\x15\x43\x61seAttachmentService\x12\xe6\x01\n\x0fListAttachments\x12/.google.cloud.support.v2.ListAttachmentsRequest\x1a\x30.google.cloud.support.v2.ListAttachmentsResponse\"p\xda\x41\x06parent\x82\xd3\xe4\x93\x02\x61\x12+/v2/{parent=projects/*/cases/*}/attachmentsZ2\x12\x30/v2/{parent=organizations/*/cases/*}/attachments\x1aO\xca\x41\x1b\x63loudsupport.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\xbf\x01\n\x1b\x63om.google.cloud.support.v2B\x16\x41ttachmentServiceProtoP\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"
14
+ descriptor_data = "\n0google/cloud/support/v2/attachment_service.proto\x12\x17google.cloud.support.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a(google/cloud/support/v2/attachment.proto\"y\n\x16ListAttachmentsRequest\x12\x38\n\x06parent\x18\x01 \x01(\tB(\xe0\x41\x02\xfa\x41\"\n cloudsupport.googleapis.com/Case\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\"T\n\x14GetAttachmentRequest\x12<\n\x04name\x18\x01 \x01(\tB.\xe0\x41\x02\xfa\x41(\n&cloudsupport.googleapis.com/Attachment\"l\n\x17ListAttachmentsResponse\x12\x38\n\x0b\x61ttachments\x18\x01 \x03(\x0b\x32#.google.cloud.support.v2.Attachment\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t2\xec\x03\n\x15\x43\x61seAttachmentService\x12\xe6\x01\n\x0fListAttachments\x12/.google.cloud.support.v2.ListAttachmentsRequest\x1a\x30.google.cloud.support.v2.ListAttachmentsResponse\"p\xda\x41\x06parent\x82\xd3\xe4\x93\x02\x61\x12+/v2/{parent=projects/*/cases/*}/attachmentsZ2\x12\x30/v2/{parent=organizations/*/cases/*}/attachments\x12\x98\x01\n\rGetAttachment\x12-.google.cloud.support.v2.GetAttachmentRequest\x1a#.google.cloud.support.v2.Attachment\"3\xda\x41\x04name\x82\xd3\xe4\x93\x02&\x12$/v2/{name=*/*/cases/*/attachments/*}\x1aO\xca\x41\x1b\x63loudsupport.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\xbf\x01\n\x1b\x63om.google.cloud.support.v2B\x16\x41ttachmentServiceProtoP\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"
15
15
 
16
16
  pool = ::Google::Protobuf::DescriptorPool.generated_pool
17
17
  pool.add_serialized_file(descriptor_data)
@@ -21,6 +21,7 @@ module Google
21
21
  module Support
22
22
  module V2
23
23
  ListAttachmentsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.support.v2.ListAttachmentsRequest").msgclass
24
+ GetAttachmentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.support.v2.GetAttachmentRequest").msgclass
24
25
  ListAttachmentsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.support.v2.ListAttachmentsResponse").msgclass
25
26
  end
26
27
  end
@@ -35,6 +35,38 @@ module Google
35
35
 
36
36
  # List all the attachments associated with a support case.
37
37
  rpc :ListAttachments, ::Google::Cloud::Support::V2::ListAttachmentsRequest, ::Google::Cloud::Support::V2::ListAttachmentsResponse
38
+ # Retrieve an attachment associated with a support case.
39
+ #
40
+ # EXAMPLES:
41
+ #
42
+ # cURL:
43
+ #
44
+ # ```shell
45
+ # attachment="projects/some-project/cases/23598314/attachments/0684M00000P3h1fQAB"
46
+ # curl \
47
+ # --header "Authorization: Bearer $(gcloud auth print-access-token)" \
48
+ # "https://cloudsupport.googleapis.com/v2/$attachment"
49
+ # ```
50
+ #
51
+ # Python:
52
+ #
53
+ # ```python
54
+ # import googleapiclient.discovery
55
+ #
56
+ # api_version = "v2"
57
+ # supportApiService = googleapiclient.discovery.build(
58
+ # serviceName="cloudsupport",
59
+ # version=api_version,
60
+ # discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}",
61
+ # )
62
+ # request = (
63
+ # supportApiService.cases()
64
+ # .attachments()
65
+ # .get(name="projects/some-project/cases/43595344/attachments/0684M00000P3h1fQAB")
66
+ # )
67
+ # print(request.execute())
68
+ # ```
69
+ rpc :GetAttachment, ::Google::Cloud::Support::V2::GetAttachmentRequest, ::Google::Cloud::Support::V2::Attachment
38
70
  end
39
71
 
40
72
  Stub = Service.rpc_stub_class
@@ -291,6 +291,121 @@ module Google
291
291
  raise ::Google::Cloud::Error.from_error(e)
292
292
  end
293
293
 
294
+ ##
295
+ # Retrieve an attachment associated with a support case.
296
+ #
297
+ # EXAMPLES:
298
+ #
299
+ # cURL:
300
+ #
301
+ # ```shell
302
+ # attachment="projects/some-project/cases/23598314/attachments/0684M00000P3h1fQAB"
303
+ # curl \
304
+ # --header "Authorization: Bearer $(gcloud auth print-access-token)" \
305
+ # "https://cloudsupport.googleapis.com/v2/$attachment"
306
+ # ```
307
+ #
308
+ # Python:
309
+ #
310
+ # ```python
311
+ # import googleapiclient.discovery
312
+ #
313
+ # api_version = "v2"
314
+ # supportApiService = googleapiclient.discovery.build(
315
+ # serviceName="cloudsupport",
316
+ # version=api_version,
317
+ # discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version=\\{api_version}",
318
+ # )
319
+ # request = (
320
+ # supportApiService.cases()
321
+ # .attachments()
322
+ # .get(name="projects/some-project/cases/43595344/attachments/0684M00000P3h1fQAB")
323
+ # )
324
+ # print(request.execute())
325
+ # ```
326
+ #
327
+ # @overload get_attachment(request, options = nil)
328
+ # Pass arguments to `get_attachment` via a request object, either of type
329
+ # {::Google::Cloud::Support::V2::GetAttachmentRequest} or an equivalent Hash.
330
+ #
331
+ # @param request [::Google::Cloud::Support::V2::GetAttachmentRequest, ::Hash]
332
+ # A request object representing the call parameters. Required. To specify no
333
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
334
+ # @param options [::Gapic::CallOptions, ::Hash]
335
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
336
+ #
337
+ # @overload get_attachment(name: nil)
338
+ # Pass arguments to `get_attachment` via keyword arguments. Note that at
339
+ # least one keyword argument is required. To specify no parameters, or to keep all
340
+ # the default parameter values, pass an empty Hash as a request object (see above).
341
+ #
342
+ # @param name [::String]
343
+ # Required. The name of the attachment to get.
344
+ #
345
+ # @yield [response, operation] Access the result along with the RPC operation
346
+ # @yieldparam response [::Google::Cloud::Support::V2::Attachment]
347
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
348
+ #
349
+ # @return [::Google::Cloud::Support::V2::Attachment]
350
+ #
351
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
352
+ #
353
+ # @example Basic example
354
+ # require "google/cloud/support/v2"
355
+ #
356
+ # # Create a client object. The client can be reused for multiple calls.
357
+ # client = Google::Cloud::Support::V2::CaseAttachmentService::Client.new
358
+ #
359
+ # # Create a request. To set request fields, pass in keyword arguments.
360
+ # request = Google::Cloud::Support::V2::GetAttachmentRequest.new
361
+ #
362
+ # # Call the get_attachment method.
363
+ # result = client.get_attachment request
364
+ #
365
+ # # The returned object is of type Google::Cloud::Support::V2::Attachment.
366
+ # p result
367
+ #
368
+ def get_attachment request, options = nil
369
+ raise ::ArgumentError, "request must be provided" if request.nil?
370
+
371
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Support::V2::GetAttachmentRequest
372
+
373
+ # Converts hash and nil to an options object
374
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
375
+
376
+ # Customize the options with defaults
377
+ metadata = @config.rpcs.get_attachment.metadata.to_h
378
+
379
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
380
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
381
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
382
+ gapic_version: ::Google::Cloud::Support::V2::VERSION
383
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
384
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
385
+
386
+ header_params = {}
387
+ if request.name
388
+ header_params["name"] = request.name
389
+ end
390
+
391
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
392
+ metadata[:"x-goog-request-params"] ||= request_params_header
393
+
394
+ options.apply_defaults timeout: @config.rpcs.get_attachment.timeout,
395
+ metadata: metadata,
396
+ retry_policy: @config.rpcs.get_attachment.retry_policy
397
+
398
+ options.apply_defaults timeout: @config.timeout,
399
+ metadata: @config.metadata,
400
+ retry_policy: @config.retry_policy
401
+
402
+ @case_attachment_service_stub.call_rpc :get_attachment, request, options: options do |response, operation|
403
+ yield response, operation if block_given?
404
+ end
405
+ rescue ::GRPC::BadStatus => e
406
+ raise ::Google::Cloud::Error.from_error(e)
407
+ end
408
+
294
409
  ##
295
410
  # Configuration class for the CaseAttachmentService API.
296
411
  #
@@ -387,6 +502,7 @@ module Google
387
502
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
388
503
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
389
504
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
505
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
390
506
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
391
507
  # trigger a retry.
392
508
  # @return [::Hash]
@@ -470,6 +586,7 @@ module Google
470
586
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
471
587
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
472
588
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
589
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
473
590
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
474
591
  # trigger a retry.
475
592
  #
@@ -479,11 +596,18 @@ module Google
479
596
  # @return [::Gapic::Config::Method]
480
597
  #
481
598
  attr_reader :list_attachments
599
+ ##
600
+ # RPC-specific configuration for `get_attachment`
601
+ # @return [::Gapic::Config::Method]
602
+ #
603
+ attr_reader :get_attachment
482
604
 
483
605
  # @private
484
606
  def initialize parent_rpcs = nil
485
607
  list_attachments_config = parent_rpcs.list_attachments if parent_rpcs.respond_to? :list_attachments
486
608
  @list_attachments = ::Gapic::Config::Method.new list_attachments_config
609
+ get_attachment_config = parent_rpcs.get_attachment if parent_rpcs.respond_to? :get_attachment
610
+ @get_attachment = ::Gapic::Config::Method.new get_attachment_config
487
611
 
488
612
  yield self if block_given?
489
613
  end
@@ -24,6 +24,49 @@ module Google
24
24
  module CaseAttachmentService
25
25
  # Path helper methods for the CaseAttachmentService API.
26
26
  module Paths
27
+ ##
28
+ # Create a fully-qualified Attachment resource string.
29
+ #
30
+ # @overload attachment_path(organization:, case:, attachment_id:)
31
+ # The resource will be in the following format:
32
+ #
33
+ # `organizations/{organization}/cases/{case}/attachments/{attachment_id}`
34
+ #
35
+ # @param organization [String]
36
+ # @param case [String]
37
+ # @param attachment_id [String]
38
+ #
39
+ # @overload attachment_path(project:, case:, attachment_id:)
40
+ # The resource will be in the following format:
41
+ #
42
+ # `projects/{project}/cases/{case}/attachments/{attachment_id}`
43
+ #
44
+ # @param project [String]
45
+ # @param case [String]
46
+ # @param attachment_id [String]
47
+ #
48
+ # @return [::String]
49
+ def attachment_path **args
50
+ resources = {
51
+ "attachment_id:case:organization" => (proc do |organization:, case:, attachment_id:|
52
+ raise ::ArgumentError, "organization cannot contain /" if organization.to_s.include? "/"
53
+ raise ::ArgumentError, "case cannot contain /" if binding.local_variable_get(:case).to_s.include? "/"
54
+
55
+ "organizations/#{organization}/cases/#{binding.local_variable_get :case}/attachments/#{attachment_id}"
56
+ end),
57
+ "attachment_id:case:project" => (proc do |project:, case:, attachment_id:|
58
+ raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
59
+ raise ::ArgumentError, "case cannot contain /" if binding.local_variable_get(:case).to_s.include? "/"
60
+
61
+ "projects/#{project}/cases/#{binding.local_variable_get :case}/attachments/#{attachment_id}"
62
+ end)
63
+ }
64
+
65
+ resource = resources[args.keys.sort.join(":")]
66
+ raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
67
+ resource.call(**args)
68
+ end
69
+
27
70
  ##
28
71
  # Create a fully-qualified Case resource string.
29
72
  #
@@ -1105,6 +1105,7 @@ module Google
1105
1105
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
1106
1106
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
1107
1107
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
1108
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
1108
1109
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
1109
1110
  # trigger a retry.
1110
1111
  # @return [::Hash]
@@ -1188,6 +1189,7 @@ module Google
1188
1189
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
1189
1190
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
1190
1191
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
1192
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
1191
1193
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
1192
1194
  # trigger a retry.
1193
1195
  #
@@ -375,6 +375,120 @@ module Google
375
375
  raise ::Google::Cloud::Error.from_error(e)
376
376
  end
377
377
 
378
+ ##
379
+ # Retrieve a comment.
380
+ #
381
+ # EXAMPLES:
382
+ #
383
+ # cURL:
384
+ #
385
+ # ```shell
386
+ # comment="projects/some-project/cases/43595344/comments/234567890"
387
+ # curl \
388
+ # --header "Authorization: Bearer $(gcloud auth print-access-token)" \
389
+ # "https://cloudsupport.googleapis.com/v2/$comment"
390
+ # ```
391
+ #
392
+ # Python:
393
+ #
394
+ # ```python
395
+ # import googleapiclient.discovery
396
+ #
397
+ # api_version = "v2"
398
+ # supportApiService = googleapiclient.discovery.build(
399
+ # serviceName="cloudsupport",
400
+ # version=api_version,
401
+ # discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version=\\{api_version}",
402
+ # )
403
+ #
404
+ # request = supportApiService.cases().comments().get(
405
+ # name="projects/some-project/cases/43595344/comments/234567890",
406
+ # )
407
+ # print(request.execute())
408
+ # ```
409
+ #
410
+ # @overload get_comment(request, options = nil)
411
+ # Pass arguments to `get_comment` via a request object, either of type
412
+ # {::Google::Cloud::Support::V2::GetCommentRequest} or an equivalent Hash.
413
+ #
414
+ # @param request [::Google::Cloud::Support::V2::GetCommentRequest, ::Hash]
415
+ # A request object representing the call parameters. Required. To specify no
416
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
417
+ # @param options [::Gapic::CallOptions, ::Hash]
418
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
419
+ #
420
+ # @overload get_comment(name: nil)
421
+ # Pass arguments to `get_comment` via keyword arguments. Note that at
422
+ # least one keyword argument is required. To specify no parameters, or to keep all
423
+ # the default parameter values, pass an empty Hash as a request object (see above).
424
+ #
425
+ # @param name [::String]
426
+ # Required. The name of the comment to retrieve.
427
+ #
428
+ # @yield [response, operation] Access the result along with the RPC operation
429
+ # @yieldparam response [::Google::Cloud::Support::V2::Comment]
430
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
431
+ #
432
+ # @return [::Google::Cloud::Support::V2::Comment]
433
+ #
434
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
435
+ #
436
+ # @example Basic example
437
+ # require "google/cloud/support/v2"
438
+ #
439
+ # # Create a client object. The client can be reused for multiple calls.
440
+ # client = Google::Cloud::Support::V2::CommentService::Client.new
441
+ #
442
+ # # Create a request. To set request fields, pass in keyword arguments.
443
+ # request = Google::Cloud::Support::V2::GetCommentRequest.new
444
+ #
445
+ # # Call the get_comment method.
446
+ # result = client.get_comment request
447
+ #
448
+ # # The returned object is of type Google::Cloud::Support::V2::Comment.
449
+ # p result
450
+ #
451
+ def get_comment request, options = nil
452
+ raise ::ArgumentError, "request must be provided" if request.nil?
453
+
454
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Support::V2::GetCommentRequest
455
+
456
+ # Converts hash and nil to an options object
457
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
458
+
459
+ # Customize the options with defaults
460
+ metadata = @config.rpcs.get_comment.metadata.to_h
461
+
462
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
463
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
464
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
465
+ gapic_version: ::Google::Cloud::Support::V2::VERSION
466
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
467
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
468
+
469
+ header_params = {}
470
+ if request.name
471
+ header_params["name"] = request.name
472
+ end
473
+
474
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
475
+ metadata[:"x-goog-request-params"] ||= request_params_header
476
+
477
+ options.apply_defaults timeout: @config.rpcs.get_comment.timeout,
478
+ metadata: metadata,
479
+ retry_policy: @config.rpcs.get_comment.retry_policy
480
+
481
+ options.apply_defaults timeout: @config.timeout,
482
+ metadata: @config.metadata,
483
+ retry_policy: @config.retry_policy
484
+
485
+ @comment_service_stub.call_rpc :get_comment, request, options: options do |response, operation|
486
+ yield response, operation if block_given?
487
+ end
488
+ rescue ::GRPC::BadStatus => e
489
+ raise ::Google::Cloud::Error.from_error(e)
490
+ end
491
+
378
492
  ##
379
493
  # Configuration class for the CommentService API.
380
494
  #
@@ -471,6 +585,7 @@ module Google
471
585
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
472
586
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
473
587
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
588
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
474
589
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
475
590
  # trigger a retry.
476
591
  # @return [::Hash]
@@ -554,6 +669,7 @@ module Google
554
669
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
555
670
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
556
671
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
672
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
557
673
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
558
674
  # trigger a retry.
559
675
  #
@@ -568,6 +684,11 @@ module Google
568
684
  # @return [::Gapic::Config::Method]
569
685
  #
570
686
  attr_reader :create_comment
687
+ ##
688
+ # RPC-specific configuration for `get_comment`
689
+ # @return [::Gapic::Config::Method]
690
+ #
691
+ attr_reader :get_comment
571
692
 
572
693
  # @private
573
694
  def initialize parent_rpcs = nil
@@ -575,6 +696,8 @@ module Google
575
696
  @list_comments = ::Gapic::Config::Method.new list_comments_config
576
697
  create_comment_config = parent_rpcs.create_comment if parent_rpcs.respond_to? :create_comment
577
698
  @create_comment = ::Gapic::Config::Method.new create_comment_config
699
+ get_comment_config = parent_rpcs.get_comment if parent_rpcs.respond_to? :get_comment
700
+ @get_comment = ::Gapic::Config::Method.new get_comment_config
578
701
 
579
702
  yield self if block_given?
580
703
  end
@@ -11,7 +11,7 @@ require 'google/api/resource_pb'
11
11
  require 'google/cloud/support/v2/comment_pb'
12
12
 
13
13
 
14
- descriptor_data = "\n-google/cloud/support/v2/comment_service.proto\x12\x17google.cloud.support.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a%google/cloud/support/v2/comment.proto\"v\n\x13ListCommentsRequest\x12\x38\n\x06parent\x18\x01 \x01(\tB(\xe0\x41\x02\xfa\x41\"\n cloudsupport.googleapis.com/Case\x12\x11\n\tpage_size\x18\x04 \x01(\x05\x12\x12\n\npage_token\x18\x05 \x01(\t\"c\n\x14ListCommentsResponse\x12\x32\n\x08\x63omments\x18\x01 \x03(\x0b\x32 .google.cloud.support.v2.Comment\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"\x88\x01\n\x14\x43reateCommentRequest\x12\x38\n\x06parent\x18\x01 \x01(\tB(\xe0\x41\x02\xfa\x41\"\n cloudsupport.googleapis.com/Case\x12\x36\n\x07\x63omment\x18\x02 \x01(\x0b\x32 .google.cloud.support.v2.CommentB\x03\xe0\x41\x02\x32\xa5\x04\n\x0e\x43ommentService\x12\xd7\x01\n\x0cListComments\x12,.google.cloud.support.v2.ListCommentsRequest\x1a-.google.cloud.support.v2.ListCommentsResponse\"j\xda\x41\x06parent\x82\xd3\xe4\x93\x02[\x12(/v2/{parent=projects/*/cases/*}/commentsZ/\x12-/v2/{parent=organizations/*/cases/*}/comments\x12\xe7\x01\n\rCreateComment\x12-.google.cloud.support.v2.CreateCommentRequest\x1a .google.cloud.support.v2.Comment\"\x84\x01\xda\x41\x0eparent,comment\x82\xd3\xe4\x93\x02m\"(/v2/{parent=projects/*/cases/*}/comments:\x07\x63ommentZ8\"-/v2/{parent=organizations/*/cases/*}/comments:\x07\x63omment\x1aO\xca\x41\x1b\x63loudsupport.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\xbc\x01\n\x1b\x63om.google.cloud.support.v2B\x13\x43ommentServiceProtoP\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"
14
+ descriptor_data = "\n-google/cloud/support/v2/comment_service.proto\x12\x17google.cloud.support.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a%google/cloud/support/v2/comment.proto\"v\n\x13ListCommentsRequest\x12\x38\n\x06parent\x18\x01 \x01(\tB(\xe0\x41\x02\xfa\x41\"\n cloudsupport.googleapis.com/Case\x12\x11\n\tpage_size\x18\x04 \x01(\x05\x12\x12\n\npage_token\x18\x05 \x01(\t\"c\n\x14ListCommentsResponse\x12\x32\n\x08\x63omments\x18\x01 \x03(\x0b\x32 .google.cloud.support.v2.Comment\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"\x88\x01\n\x14\x43reateCommentRequest\x12\x38\n\x06parent\x18\x01 \x01(\tB(\xe0\x41\x02\xfa\x41\"\n cloudsupport.googleapis.com/Case\x12\x36\n\x07\x63omment\x18\x02 \x01(\x0b\x32 .google.cloud.support.v2.CommentB\x03\xe0\x41\x02\"N\n\x11GetCommentRequest\x12\x39\n\x04name\x18\x01 \x01(\tB+\xe0\x41\x02\xfa\x41%\n#cloudsupport.googleapis.com/Comment2\xb4\x05\n\x0e\x43ommentService\x12\xd7\x01\n\x0cListComments\x12,.google.cloud.support.v2.ListCommentsRequest\x1a-.google.cloud.support.v2.ListCommentsResponse\"j\xda\x41\x06parent\x82\xd3\xe4\x93\x02[\x12(/v2/{parent=projects/*/cases/*}/commentsZ/\x12-/v2/{parent=organizations/*/cases/*}/comments\x12\xe7\x01\n\rCreateComment\x12-.google.cloud.support.v2.CreateCommentRequest\x1a .google.cloud.support.v2.Comment\"\x84\x01\xda\x41\x0eparent,comment\x82\xd3\xe4\x93\x02m\"(/v2/{parent=projects/*/cases/*}/comments:\x07\x63ommentZ8\"-/v2/{parent=organizations/*/cases/*}/comments:\x07\x63omment\x12\x8c\x01\n\nGetComment\x12*.google.cloud.support.v2.GetCommentRequest\x1a .google.cloud.support.v2.Comment\"0\xda\x41\x04name\x82\xd3\xe4\x93\x02#\x12!/v2/{name=*/*/cases/*/comments/*}\x1aO\xca\x41\x1b\x63loudsupport.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\xbc\x01\n\x1b\x63om.google.cloud.support.v2B\x13\x43ommentServiceProtoP\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"
15
15
 
16
16
  pool = ::Google::Protobuf::DescriptorPool.generated_pool
17
17
  pool.add_serialized_file(descriptor_data)
@@ -23,6 +23,7 @@ module Google
23
23
  ListCommentsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.support.v2.ListCommentsRequest").msgclass
24
24
  ListCommentsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.support.v2.ListCommentsResponse").msgclass
25
25
  CreateCommentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.support.v2.CreateCommentRequest").msgclass
26
+ GetCommentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.support.v2.GetCommentRequest").msgclass
26
27
  end
27
28
  end
28
29
  end
@@ -39,6 +39,37 @@ module Google
39
39
  #
40
40
  # The comment must have the following fields set: `body`.
41
41
  rpc :CreateComment, ::Google::Cloud::Support::V2::CreateCommentRequest, ::Google::Cloud::Support::V2::Comment
42
+ # Retrieve a comment.
43
+ #
44
+ # EXAMPLES:
45
+ #
46
+ # cURL:
47
+ #
48
+ # ```shell
49
+ # comment="projects/some-project/cases/43595344/comments/234567890"
50
+ # curl \
51
+ # --header "Authorization: Bearer $(gcloud auth print-access-token)" \
52
+ # "https://cloudsupport.googleapis.com/v2/$comment"
53
+ # ```
54
+ #
55
+ # Python:
56
+ #
57
+ # ```python
58
+ # import googleapiclient.discovery
59
+ #
60
+ # api_version = "v2"
61
+ # supportApiService = googleapiclient.discovery.build(
62
+ # serviceName="cloudsupport",
63
+ # version=api_version,
64
+ # discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}",
65
+ # )
66
+ #
67
+ # request = supportApiService.cases().comments().get(
68
+ # name="projects/some-project/cases/43595344/comments/234567890",
69
+ # )
70
+ # print(request.execute())
71
+ # ```
72
+ rpc :GetComment, ::Google::Cloud::Support::V2::GetCommentRequest, ::Google::Cloud::Support::V2::Comment
42
73
  end
43
74
 
44
75
  Stub = Service.rpc_stub_class
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Support
23
23
  module V2
24
- VERSION = "1.7.1"
24
+ VERSION = "1.9.0"
25
25
  end
26
26
  end
27
27
  end
@@ -44,6 +44,15 @@ module Google
44
44
  extend ::Google::Protobuf::MessageExts::ClassMethods
45
45
  end
46
46
 
47
+ # Request for getting an attachment.
48
+ # @!attribute [rw] name
49
+ # @return [::String]
50
+ # Required. The name of the attachment to get.
51
+ class GetAttachmentRequest
52
+ include ::Google::Protobuf::MessageExts
53
+ extend ::Google::Protobuf::MessageExts::ClassMethods
54
+ end
55
+
47
56
  # The response message for the ListAttachments endpoint.
48
57
  # @!attribute [rw] attachments
49
58
  # @return [::Array<::Google::Cloud::Support::V2::Attachment>]
@@ -62,6 +62,15 @@ module Google
62
62
  include ::Google::Protobuf::MessageExts
63
63
  extend ::Google::Protobuf::MessageExts::ClassMethods
64
64
  end
65
+
66
+ # The request message for the GetComment endpoint.
67
+ # @!attribute [rw] name
68
+ # @return [::String]
69
+ # Required. The name of the comment to retrieve.
70
+ class GetCommentRequest
71
+ include ::Google::Protobuf::MessageExts
72
+ extend ::Google::Protobuf::MessageExts::ClassMethods
73
+ end
65
74
  end
66
75
  end
67
76
  end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-support-v2
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.7.1
4
+ version: 1.9.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
@@ -15,14 +15,14 @@ dependencies:
15
15
  requirements:
16
16
  - - "~>"
17
17
  - !ruby/object:Gem::Version
18
- version: '1.2'
18
+ version: '1.3'
19
19
  type: :runtime
20
20
  prerelease: false
21
21
  version_requirements: !ruby/object:Gem::Requirement
22
22
  requirements:
23
23
  - - "~>"
24
24
  - !ruby/object:Gem::Version
25
- version: '1.2'
25
+ version: '1.3'
26
26
  - !ruby/object:Gem::Dependency
27
27
  name: google-cloud-errors
28
28
  requirement: !ruby/object:Gem::Requirement