google-cloud-support-v2beta 0.1.1 → 0.3.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: 6f707e6e25ee5154cc295e635c6ff99987a92e36ccb12fc0660f34d3482331ac
4
- data.tar.gz: 7f8ee2e47d9b349bfa6d465cb1ac7c3b0e0bd015a24f69fb8e6b77c0b7146ca9
3
+ metadata.gz: 862da1418dda5c2d06291fe7acb25bf16de7459b546f2a797ca62b66393cb839
4
+ data.tar.gz: 4e47080947512be8c6ad3e9885d92197e0c5725dda9838dfc148172fd49294c3
5
5
  SHA512:
6
- metadata.gz: 76d1f0bc8553271b15735c9cf270d34bd34d18be52f23c3816f12115f2686c6f5c9e7db1f826d69f3d2f566232ece19e7872da8a32ac8fcca6c97451d7ab14cb
7
- data.tar.gz: 041f4dfb4e5b16ea96f2e81eb3c6947dce75741bf6cebdcfbc32edc5b5d771ef90ec86ebd1f45049585cb7d2ce02f4ab0ff7dd91b9fcf158a626a4bb3ea420c4
6
+ metadata.gz: 8abb8323fd81efcbd7805b1aa600cba11a00a2f423802c38a33299e4da4ff47f5f30ca3b392f7780942bbb7ebc78ce0479d1ce6ab83f9b64a232b03279e80962
7
+ data.tar.gz: 8c87f29a8d8ae987615022826eae158dc96ee686e36fcf32810afd20c844bff421645da39af221395c98c62f3dbe2f9eacd8c73e2b98dcf08c46298721e77c50
@@ -11,7 +11,7 @@ require 'google/api/resource_pb'
11
11
  require 'google/cloud/support/v2beta/attachment_pb'
12
12
 
13
13
 
14
- descriptor_data = "\n4google/cloud/support/v2beta/attachment_service.proto\x12\x1bgoogle.cloud.support.v2beta\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/v2beta/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\"p\n\x17ListAttachmentsResponse\x12<\n\x0b\x61ttachments\x18\x01 \x03(\x0b\x32\'.google.cloud.support.v2beta.Attachment\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t2\xe1\x02\n\x15\x43\x61seAttachmentService\x12\xf6\x01\n\x0fListAttachments\x12\x33.google.cloud.support.v2beta.ListAttachmentsRequest\x1a\x34.google.cloud.support.v2beta.ListAttachmentsResponse\"x\xda\x41\x06parent\x82\xd3\xe4\x93\x02i\x12//v2beta/{parent=projects/*/cases/*}/attachmentsZ6\x12\x34/v2beta/{parent=organizations/*/cases/*}/attachments\x1aO\xca\x41\x1b\x63loudsupport.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\xd3\x01\n\x1f\x63om.google.cloud.support.v2betaB\x16\x41ttachmentServiceProtoP\x01Z9cloud.google.com/go/support/apiv2beta/supportpb;supportpb\xaa\x02\x1bGoogle.Cloud.Support.V2Beta\xca\x02\x1bGoogle\\Cloud\\Support\\V2beta\xea\x02\x1eGoogle::Cloud::Support::V2betab\x06proto3"
14
+ descriptor_data = "\n4google/cloud/support/v2beta/attachment_service.proto\x12\x1bgoogle.cloud.support.v2beta\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/v2beta/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\"p\n\x17ListAttachmentsResponse\x12<\n\x0b\x61ttachments\x18\x01 \x03(\x0b\x32\'.google.cloud.support.v2beta.Attachment\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t2\x88\x04\n\x15\x43\x61seAttachmentService\x12\xf6\x01\n\x0fListAttachments\x12\x33.google.cloud.support.v2beta.ListAttachmentsRequest\x1a\x34.google.cloud.support.v2beta.ListAttachmentsResponse\"x\xda\x41\x06parent\x82\xd3\xe4\x93\x02i\x12//v2beta/{parent=projects/*/cases/*}/attachmentsZ6\x12\x34/v2beta/{parent=organizations/*/cases/*}/attachments\x12\xa4\x01\n\rGetAttachment\x12\x31.google.cloud.support.v2beta.GetAttachmentRequest\x1a\'.google.cloud.support.v2beta.Attachment\"7\xda\x41\x04name\x82\xd3\xe4\x93\x02*\x12(/v2beta/{name=*/*/cases/*/attachments/*}\x1aO\xca\x41\x1b\x63loudsupport.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\xd3\x01\n\x1f\x63om.google.cloud.support.v2betaB\x16\x41ttachmentServiceProtoP\x01Z9cloud.google.com/go/support/apiv2beta/supportpb;supportpb\xaa\x02\x1bGoogle.Cloud.Support.V2Beta\xca\x02\x1bGoogle\\Cloud\\Support\\V2beta\xea\x02\x1eGoogle::Cloud::Support::V2betab\x06proto3"
15
15
 
16
16
  pool = Google::Protobuf::DescriptorPool.generated_pool
17
17
 
@@ -43,6 +43,7 @@ module Google
43
43
  module Support
44
44
  module V2beta
45
45
  ListAttachmentsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.support.v2beta.ListAttachmentsRequest").msgclass
46
+ GetAttachmentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.support.v2beta.GetAttachmentRequest").msgclass
46
47
  ListAttachmentsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.support.v2beta.ListAttachmentsResponse").msgclass
47
48
  end
48
49
  end
@@ -35,6 +35,8 @@ module Google
35
35
 
36
36
  # List all the attachments associated with a support case.
37
37
  rpc :ListAttachments, ::Google::Cloud::Support::V2beta::ListAttachmentsRequest, ::Google::Cloud::Support::V2beta::ListAttachmentsResponse
38
+ # Retrieve an attachment.
39
+ rpc :GetAttachment, ::Google::Cloud::Support::V2beta::GetAttachmentRequest, ::Google::Cloud::Support::V2beta::Attachment
38
40
  end
39
41
 
40
42
  Stub = Service.rpc_stub_class
@@ -291,6 +291,91 @@ module Google
291
291
  raise ::Google::Cloud::Error.from_error(e)
292
292
  end
293
293
 
294
+ ##
295
+ # Retrieve an attachment.
296
+ #
297
+ # @overload get_attachment(request, options = nil)
298
+ # Pass arguments to `get_attachment` via a request object, either of type
299
+ # {::Google::Cloud::Support::V2beta::GetAttachmentRequest} or an equivalent Hash.
300
+ #
301
+ # @param request [::Google::Cloud::Support::V2beta::GetAttachmentRequest, ::Hash]
302
+ # A request object representing the call parameters. Required. To specify no
303
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
304
+ # @param options [::Gapic::CallOptions, ::Hash]
305
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
306
+ #
307
+ # @overload get_attachment(name: nil)
308
+ # Pass arguments to `get_attachment` via keyword arguments. Note that at
309
+ # least one keyword argument is required. To specify no parameters, or to keep all
310
+ # the default parameter values, pass an empty Hash as a request object (see above).
311
+ #
312
+ # @param name [::String]
313
+ # Required. The name of the attachment to get.
314
+ #
315
+ # @yield [response, operation] Access the result along with the RPC operation
316
+ # @yieldparam response [::Google::Cloud::Support::V2beta::Attachment]
317
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
318
+ #
319
+ # @return [::Google::Cloud::Support::V2beta::Attachment]
320
+ #
321
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
322
+ #
323
+ # @example Basic example
324
+ # require "google/cloud/support/v2beta"
325
+ #
326
+ # # Create a client object. The client can be reused for multiple calls.
327
+ # client = Google::Cloud::Support::V2beta::CaseAttachmentService::Client.new
328
+ #
329
+ # # Create a request. To set request fields, pass in keyword arguments.
330
+ # request = Google::Cloud::Support::V2beta::GetAttachmentRequest.new
331
+ #
332
+ # # Call the get_attachment method.
333
+ # result = client.get_attachment request
334
+ #
335
+ # # The returned object is of type Google::Cloud::Support::V2beta::Attachment.
336
+ # p result
337
+ #
338
+ def get_attachment request, options = nil
339
+ raise ::ArgumentError, "request must be provided" if request.nil?
340
+
341
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Support::V2beta::GetAttachmentRequest
342
+
343
+ # Converts hash and nil to an options object
344
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
345
+
346
+ # Customize the options with defaults
347
+ metadata = @config.rpcs.get_attachment.metadata.to_h
348
+
349
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
350
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
351
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
352
+ gapic_version: ::Google::Cloud::Support::V2beta::VERSION
353
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
354
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
355
+
356
+ header_params = {}
357
+ if request.name
358
+ header_params["name"] = request.name
359
+ end
360
+
361
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
362
+ metadata[:"x-goog-request-params"] ||= request_params_header
363
+
364
+ options.apply_defaults timeout: @config.rpcs.get_attachment.timeout,
365
+ metadata: metadata,
366
+ retry_policy: @config.rpcs.get_attachment.retry_policy
367
+
368
+ options.apply_defaults timeout: @config.timeout,
369
+ metadata: @config.metadata,
370
+ retry_policy: @config.retry_policy
371
+
372
+ @case_attachment_service_stub.call_rpc :get_attachment, request, options: options do |response, operation|
373
+ yield response, operation if block_given?
374
+ end
375
+ rescue ::GRPC::BadStatus => e
376
+ raise ::Google::Cloud::Error.from_error(e)
377
+ end
378
+
294
379
  ##
295
380
  # Configuration class for the CaseAttachmentService API.
296
381
  #
@@ -462,11 +547,18 @@ module Google
462
547
  # @return [::Gapic::Config::Method]
463
548
  #
464
549
  attr_reader :list_attachments
550
+ ##
551
+ # RPC-specific configuration for `get_attachment`
552
+ # @return [::Gapic::Config::Method]
553
+ #
554
+ attr_reader :get_attachment
465
555
 
466
556
  # @private
467
557
  def initialize parent_rpcs = nil
468
558
  list_attachments_config = parent_rpcs.list_attachments if parent_rpcs.respond_to? :list_attachments
469
559
  @list_attachments = ::Gapic::Config::Method.new list_attachments_config
560
+ get_attachment_config = parent_rpcs.get_attachment if parent_rpcs.respond_to? :get_attachment
561
+ @get_attachment = ::Gapic::Config::Method.new get_attachment_config
470
562
 
471
563
  yield self if block_given?
472
564
  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
  #
@@ -277,6 +277,84 @@ module Google
277
277
  raise ::Google::Cloud::Error.from_error(e)
278
278
  end
279
279
 
280
+ ##
281
+ # Retrieve an attachment.
282
+ #
283
+ # @overload get_attachment(request, options = nil)
284
+ # Pass arguments to `get_attachment` via a request object, either of type
285
+ # {::Google::Cloud::Support::V2beta::GetAttachmentRequest} or an equivalent Hash.
286
+ #
287
+ # @param request [::Google::Cloud::Support::V2beta::GetAttachmentRequest, ::Hash]
288
+ # A request object representing the call parameters. Required. To specify no
289
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
290
+ # @param options [::Gapic::CallOptions, ::Hash]
291
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
292
+ #
293
+ # @overload get_attachment(name: nil)
294
+ # Pass arguments to `get_attachment` via keyword arguments. Note that at
295
+ # least one keyword argument is required. To specify no parameters, or to keep all
296
+ # the default parameter values, pass an empty Hash as a request object (see above).
297
+ #
298
+ # @param name [::String]
299
+ # Required. The name of the attachment to get.
300
+ # @yield [result, operation] Access the result along with the TransportOperation object
301
+ # @yieldparam result [::Google::Cloud::Support::V2beta::Attachment]
302
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
303
+ #
304
+ # @return [::Google::Cloud::Support::V2beta::Attachment]
305
+ #
306
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
307
+ #
308
+ # @example Basic example
309
+ # require "google/cloud/support/v2beta"
310
+ #
311
+ # # Create a client object. The client can be reused for multiple calls.
312
+ # client = Google::Cloud::Support::V2beta::CaseAttachmentService::Rest::Client.new
313
+ #
314
+ # # Create a request. To set request fields, pass in keyword arguments.
315
+ # request = Google::Cloud::Support::V2beta::GetAttachmentRequest.new
316
+ #
317
+ # # Call the get_attachment method.
318
+ # result = client.get_attachment request
319
+ #
320
+ # # The returned object is of type Google::Cloud::Support::V2beta::Attachment.
321
+ # p result
322
+ #
323
+ def get_attachment request, options = nil
324
+ raise ::ArgumentError, "request must be provided" if request.nil?
325
+
326
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Support::V2beta::GetAttachmentRequest
327
+
328
+ # Converts hash and nil to an options object
329
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
330
+
331
+ # Customize the options with defaults
332
+ call_metadata = @config.rpcs.get_attachment.metadata.to_h
333
+
334
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
335
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
336
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
337
+ gapic_version: ::Google::Cloud::Support::V2beta::VERSION,
338
+ transports_version_send: [:rest]
339
+
340
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
341
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
342
+
343
+ options.apply_defaults timeout: @config.rpcs.get_attachment.timeout,
344
+ metadata: call_metadata,
345
+ retry_policy: @config.rpcs.get_attachment.retry_policy
346
+
347
+ options.apply_defaults timeout: @config.timeout,
348
+ metadata: @config.metadata,
349
+ retry_policy: @config.retry_policy
350
+
351
+ @case_attachment_service_stub.get_attachment request, options do |result, operation|
352
+ yield result, operation if block_given?
353
+ end
354
+ rescue ::Gapic::Rest::Error => e
355
+ raise ::Google::Cloud::Error.from_error(e)
356
+ end
357
+
280
358
  ##
281
359
  # Configuration class for the CaseAttachmentService REST API.
282
360
  #
@@ -428,11 +506,18 @@ module Google
428
506
  # @return [::Gapic::Config::Method]
429
507
  #
430
508
  attr_reader :list_attachments
509
+ ##
510
+ # RPC-specific configuration for `get_attachment`
511
+ # @return [::Gapic::Config::Method]
512
+ #
513
+ attr_reader :get_attachment
431
514
 
432
515
  # @private
433
516
  def initialize parent_rpcs = nil
434
517
  list_attachments_config = parent_rpcs.list_attachments if parent_rpcs.respond_to? :list_attachments
435
518
  @list_attachments = ::Gapic::Config::Method.new list_attachments_config
519
+ get_attachment_config = parent_rpcs.get_attachment if parent_rpcs.respond_to? :get_attachment
520
+ @get_attachment = ::Gapic::Config::Method.new get_attachment_config
436
521
 
437
522
  yield self if block_given?
438
523
  end
@@ -113,6 +113,46 @@ module Google
113
113
  end
114
114
  end
115
115
 
116
+ ##
117
+ # Baseline implementation for the get_attachment REST call
118
+ #
119
+ # @param request_pb [::Google::Cloud::Support::V2beta::GetAttachmentRequest]
120
+ # A request object representing the call parameters. Required.
121
+ # @param options [::Gapic::CallOptions]
122
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
123
+ #
124
+ # @yield [result, operation] Access the result along with the TransportOperation object
125
+ # @yieldparam result [::Google::Cloud::Support::V2beta::Attachment]
126
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
127
+ #
128
+ # @return [::Google::Cloud::Support::V2beta::Attachment]
129
+ # A result object deserialized from the server's reply
130
+ def get_attachment request_pb, options = nil
131
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
132
+
133
+ verb, uri, query_string_params, body = ServiceStub.transcode_get_attachment_request request_pb
134
+ query_string_params = if query_string_params.any?
135
+ query_string_params.to_h { |p| p.split "=", 2 }
136
+ else
137
+ {}
138
+ end
139
+
140
+ response = @client_stub.make_http_request(
141
+ verb,
142
+ uri: uri,
143
+ body: body || "",
144
+ params: query_string_params,
145
+ method_name: "get_attachment",
146
+ options: options
147
+ )
148
+ operation = ::Gapic::Rest::TransportOperation.new response
149
+ result = ::Google::Cloud::Support::V2beta::Attachment.decode_json response.body, ignore_unknown_fields: true
150
+ catch :response do
151
+ yield result, operation if block_given?
152
+ result
153
+ end
154
+ end
155
+
116
156
  ##
117
157
  # @private
118
158
  #
@@ -140,6 +180,27 @@ module Google
140
180
  )
141
181
  transcoder.transcode request_pb
142
182
  end
183
+
184
+ ##
185
+ # @private
186
+ #
187
+ # GRPC transcoding helper method for the get_attachment REST call
188
+ #
189
+ # @param request_pb [::Google::Cloud::Support::V2beta::GetAttachmentRequest]
190
+ # A request object representing the call parameters. Required.
191
+ # @return [Array(String, [String, nil], Hash{String => String})]
192
+ # Uri, Body, Query string parameters
193
+ def self.transcode_get_attachment_request request_pb
194
+ transcoder = Gapic::Rest::GrpcTranscoder.new
195
+ .with_bindings(
196
+ uri_method: :get,
197
+ uri_template: "/v2beta/{name}",
198
+ matches: [
199
+ ["name", %r{^[^/]+/[^/]+/cases/[^/]+/attachments/[^/]+/?$}, false]
200
+ ]
201
+ )
202
+ transcoder.transcode request_pb
203
+ end
143
204
  end
144
205
  end
145
206
  end
@@ -375,6 +375,91 @@ module Google
375
375
  raise ::Google::Cloud::Error.from_error(e)
376
376
  end
377
377
 
378
+ ##
379
+ # Retrieve a comment.
380
+ #
381
+ # @overload get_comment(request, options = nil)
382
+ # Pass arguments to `get_comment` via a request object, either of type
383
+ # {::Google::Cloud::Support::V2beta::GetCommentRequest} or an equivalent Hash.
384
+ #
385
+ # @param request [::Google::Cloud::Support::V2beta::GetCommentRequest, ::Hash]
386
+ # A request object representing the call parameters. Required. To specify no
387
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
388
+ # @param options [::Gapic::CallOptions, ::Hash]
389
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
390
+ #
391
+ # @overload get_comment(name: nil)
392
+ # Pass arguments to `get_comment` via keyword arguments. Note that at
393
+ # least one keyword argument is required. To specify no parameters, or to keep all
394
+ # the default parameter values, pass an empty Hash as a request object (see above).
395
+ #
396
+ # @param name [::String]
397
+ # Required. The name of the comment to retrieve.
398
+ #
399
+ # @yield [response, operation] Access the result along with the RPC operation
400
+ # @yieldparam response [::Google::Cloud::Support::V2beta::Comment]
401
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
402
+ #
403
+ # @return [::Google::Cloud::Support::V2beta::Comment]
404
+ #
405
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
406
+ #
407
+ # @example Basic example
408
+ # require "google/cloud/support/v2beta"
409
+ #
410
+ # # Create a client object. The client can be reused for multiple calls.
411
+ # client = Google::Cloud::Support::V2beta::CommentService::Client.new
412
+ #
413
+ # # Create a request. To set request fields, pass in keyword arguments.
414
+ # request = Google::Cloud::Support::V2beta::GetCommentRequest.new
415
+ #
416
+ # # Call the get_comment method.
417
+ # result = client.get_comment request
418
+ #
419
+ # # The returned object is of type Google::Cloud::Support::V2beta::Comment.
420
+ # p result
421
+ #
422
+ def get_comment request, options = nil
423
+ raise ::ArgumentError, "request must be provided" if request.nil?
424
+
425
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Support::V2beta::GetCommentRequest
426
+
427
+ # Converts hash and nil to an options object
428
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
429
+
430
+ # Customize the options with defaults
431
+ metadata = @config.rpcs.get_comment.metadata.to_h
432
+
433
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
434
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
435
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
436
+ gapic_version: ::Google::Cloud::Support::V2beta::VERSION
437
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
438
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
439
+
440
+ header_params = {}
441
+ if request.name
442
+ header_params["name"] = request.name
443
+ end
444
+
445
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
446
+ metadata[:"x-goog-request-params"] ||= request_params_header
447
+
448
+ options.apply_defaults timeout: @config.rpcs.get_comment.timeout,
449
+ metadata: metadata,
450
+ retry_policy: @config.rpcs.get_comment.retry_policy
451
+
452
+ options.apply_defaults timeout: @config.timeout,
453
+ metadata: @config.metadata,
454
+ retry_policy: @config.retry_policy
455
+
456
+ @comment_service_stub.call_rpc :get_comment, request, options: options do |response, operation|
457
+ yield response, operation if block_given?
458
+ end
459
+ rescue ::GRPC::BadStatus => e
460
+ raise ::Google::Cloud::Error.from_error(e)
461
+ end
462
+
378
463
  ##
379
464
  # Configuration class for the CommentService API.
380
465
  #
@@ -551,6 +636,11 @@ module Google
551
636
  # @return [::Gapic::Config::Method]
552
637
  #
553
638
  attr_reader :create_comment
639
+ ##
640
+ # RPC-specific configuration for `get_comment`
641
+ # @return [::Gapic::Config::Method]
642
+ #
643
+ attr_reader :get_comment
554
644
 
555
645
  # @private
556
646
  def initialize parent_rpcs = nil
@@ -558,6 +648,8 @@ module Google
558
648
  @list_comments = ::Gapic::Config::Method.new list_comments_config
559
649
  create_comment_config = parent_rpcs.create_comment if parent_rpcs.respond_to? :create_comment
560
650
  @create_comment = ::Gapic::Config::Method.new create_comment_config
651
+ get_comment_config = parent_rpcs.get_comment if parent_rpcs.respond_to? :get_comment
652
+ @get_comment = ::Gapic::Config::Method.new get_comment_config
561
653
 
562
654
  yield self if block_given?
563
655
  end
@@ -354,6 +354,84 @@ module Google
354
354
  raise ::Google::Cloud::Error.from_error(e)
355
355
  end
356
356
 
357
+ ##
358
+ # Retrieve a comment.
359
+ #
360
+ # @overload get_comment(request, options = nil)
361
+ # Pass arguments to `get_comment` via a request object, either of type
362
+ # {::Google::Cloud::Support::V2beta::GetCommentRequest} or an equivalent Hash.
363
+ #
364
+ # @param request [::Google::Cloud::Support::V2beta::GetCommentRequest, ::Hash]
365
+ # A request object representing the call parameters. Required. To specify no
366
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
367
+ # @param options [::Gapic::CallOptions, ::Hash]
368
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
369
+ #
370
+ # @overload get_comment(name: nil)
371
+ # Pass arguments to `get_comment` via keyword arguments. Note that at
372
+ # least one keyword argument is required. To specify no parameters, or to keep all
373
+ # the default parameter values, pass an empty Hash as a request object (see above).
374
+ #
375
+ # @param name [::String]
376
+ # Required. The name of the comment to retrieve.
377
+ # @yield [result, operation] Access the result along with the TransportOperation object
378
+ # @yieldparam result [::Google::Cloud::Support::V2beta::Comment]
379
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
380
+ #
381
+ # @return [::Google::Cloud::Support::V2beta::Comment]
382
+ #
383
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
384
+ #
385
+ # @example Basic example
386
+ # require "google/cloud/support/v2beta"
387
+ #
388
+ # # Create a client object. The client can be reused for multiple calls.
389
+ # client = Google::Cloud::Support::V2beta::CommentService::Rest::Client.new
390
+ #
391
+ # # Create a request. To set request fields, pass in keyword arguments.
392
+ # request = Google::Cloud::Support::V2beta::GetCommentRequest.new
393
+ #
394
+ # # Call the get_comment method.
395
+ # result = client.get_comment request
396
+ #
397
+ # # The returned object is of type Google::Cloud::Support::V2beta::Comment.
398
+ # p result
399
+ #
400
+ def get_comment request, options = nil
401
+ raise ::ArgumentError, "request must be provided" if request.nil?
402
+
403
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Support::V2beta::GetCommentRequest
404
+
405
+ # Converts hash and nil to an options object
406
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
407
+
408
+ # Customize the options with defaults
409
+ call_metadata = @config.rpcs.get_comment.metadata.to_h
410
+
411
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
412
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
413
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
414
+ gapic_version: ::Google::Cloud::Support::V2beta::VERSION,
415
+ transports_version_send: [:rest]
416
+
417
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
418
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
419
+
420
+ options.apply_defaults timeout: @config.rpcs.get_comment.timeout,
421
+ metadata: call_metadata,
422
+ retry_policy: @config.rpcs.get_comment.retry_policy
423
+
424
+ options.apply_defaults timeout: @config.timeout,
425
+ metadata: @config.metadata,
426
+ retry_policy: @config.retry_policy
427
+
428
+ @comment_service_stub.get_comment request, options do |result, operation|
429
+ yield result, operation if block_given?
430
+ end
431
+ rescue ::Gapic::Rest::Error => e
432
+ raise ::Google::Cloud::Error.from_error(e)
433
+ end
434
+
357
435
  ##
358
436
  # Configuration class for the CommentService REST API.
359
437
  #
@@ -510,6 +588,11 @@ module Google
510
588
  # @return [::Gapic::Config::Method]
511
589
  #
512
590
  attr_reader :create_comment
591
+ ##
592
+ # RPC-specific configuration for `get_comment`
593
+ # @return [::Gapic::Config::Method]
594
+ #
595
+ attr_reader :get_comment
513
596
 
514
597
  # @private
515
598
  def initialize parent_rpcs = nil
@@ -517,6 +600,8 @@ module Google
517
600
  @list_comments = ::Gapic::Config::Method.new list_comments_config
518
601
  create_comment_config = parent_rpcs.create_comment if parent_rpcs.respond_to? :create_comment
519
602
  @create_comment = ::Gapic::Config::Method.new create_comment_config
603
+ get_comment_config = parent_rpcs.get_comment if parent_rpcs.respond_to? :get_comment
604
+ @get_comment = ::Gapic::Config::Method.new get_comment_config
520
605
 
521
606
  yield self if block_given?
522
607
  end
@@ -153,6 +153,46 @@ module Google
153
153
  end
154
154
  end
155
155
 
156
+ ##
157
+ # Baseline implementation for the get_comment REST call
158
+ #
159
+ # @param request_pb [::Google::Cloud::Support::V2beta::GetCommentRequest]
160
+ # A request object representing the call parameters. Required.
161
+ # @param options [::Gapic::CallOptions]
162
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
163
+ #
164
+ # @yield [result, operation] Access the result along with the TransportOperation object
165
+ # @yieldparam result [::Google::Cloud::Support::V2beta::Comment]
166
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
167
+ #
168
+ # @return [::Google::Cloud::Support::V2beta::Comment]
169
+ # A result object deserialized from the server's reply
170
+ def get_comment request_pb, options = nil
171
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
172
+
173
+ verb, uri, query_string_params, body = ServiceStub.transcode_get_comment_request request_pb
174
+ query_string_params = if query_string_params.any?
175
+ query_string_params.to_h { |p| p.split "=", 2 }
176
+ else
177
+ {}
178
+ end
179
+
180
+ response = @client_stub.make_http_request(
181
+ verb,
182
+ uri: uri,
183
+ body: body || "",
184
+ params: query_string_params,
185
+ method_name: "get_comment",
186
+ options: options
187
+ )
188
+ operation = ::Gapic::Rest::TransportOperation.new response
189
+ result = ::Google::Cloud::Support::V2beta::Comment.decode_json response.body, ignore_unknown_fields: true
190
+ catch :response do
191
+ yield result, operation if block_given?
192
+ result
193
+ end
194
+ end
195
+
156
196
  ##
157
197
  # @private
158
198
  #
@@ -210,6 +250,27 @@ module Google
210
250
  )
211
251
  transcoder.transcode request_pb
212
252
  end
253
+
254
+ ##
255
+ # @private
256
+ #
257
+ # GRPC transcoding helper method for the get_comment REST call
258
+ #
259
+ # @param request_pb [::Google::Cloud::Support::V2beta::GetCommentRequest]
260
+ # A request object representing the call parameters. Required.
261
+ # @return [Array(String, [String, nil], Hash{String => String})]
262
+ # Uri, Body, Query string parameters
263
+ def self.transcode_get_comment_request request_pb
264
+ transcoder = Gapic::Rest::GrpcTranscoder.new
265
+ .with_bindings(
266
+ uri_method: :get,
267
+ uri_template: "/v2beta/{name}",
268
+ matches: [
269
+ ["name", %r{^[^/]+/[^/]+/cases/[^/]+/comments/[^/]+/?$}, false]
270
+ ]
271
+ )
272
+ transcoder.transcode request_pb
273
+ end
213
274
  end
214
275
  end
215
276
  end
@@ -11,7 +11,7 @@ require 'google/api/resource_pb'
11
11
  require 'google/cloud/support/v2beta/comment_pb'
12
12
 
13
13
 
14
- descriptor_data = "\n1google/cloud/support/v2beta/comment_service.proto\x12\x1bgoogle.cloud.support.v2beta\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/v2beta/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\"g\n\x14ListCommentsResponse\x12\x36\n\x08\x63omments\x18\x01 \x03(\x0b\x32$.google.cloud.support.v2beta.Comment\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"\x8c\x01\n\x14\x43reateCommentRequest\x12\x38\n\x06parent\x18\x01 \x01(\tB(\xe0\x41\x02\xfa\x41\"\n cloudsupport.googleapis.com/Case\x12:\n\x07\x63omment\x18\x02 \x01(\x0b\x32$.google.cloud.support.v2beta.CommentB\x03\xe0\x41\x02\x32\xc5\x04\n\x0e\x43ommentService\x12\xe7\x01\n\x0cListComments\x12\x30.google.cloud.support.v2beta.ListCommentsRequest\x1a\x31.google.cloud.support.v2beta.ListCommentsResponse\"r\xda\x41\x06parent\x82\xd3\xe4\x93\x02\x63\x12,/v2beta/{parent=projects/*/cases/*}/commentsZ3\x12\x31/v2beta/{parent=organizations/*/cases/*}/comments\x12\xf7\x01\n\rCreateComment\x12\x31.google.cloud.support.v2beta.CreateCommentRequest\x1a$.google.cloud.support.v2beta.Comment\"\x8c\x01\xda\x41\x0eparent,comment\x82\xd3\xe4\x93\x02u\",/v2beta/{parent=projects/*/cases/*}/comments:\x07\x63ommentZ<\"1/v2beta/{parent=organizations/*/cases/*}/comments:\x07\x63omment\x1aO\xca\x41\x1b\x63loudsupport.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\xd0\x01\n\x1f\x63om.google.cloud.support.v2betaB\x13\x43ommentServiceProtoP\x01Z9cloud.google.com/go/support/apiv2beta/supportpb;supportpb\xaa\x02\x1bGoogle.Cloud.Support.V2Beta\xca\x02\x1bGoogle\\Cloud\\Support\\V2beta\xea\x02\x1eGoogle::Cloud::Support::V2betab\x06proto3"
14
+ descriptor_data = "\n1google/cloud/support/v2beta/comment_service.proto\x12\x1bgoogle.cloud.support.v2beta\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/v2beta/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\"g\n\x14ListCommentsResponse\x12\x36\n\x08\x63omments\x18\x01 \x03(\x0b\x32$.google.cloud.support.v2beta.Comment\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"\x8c\x01\n\x14\x43reateCommentRequest\x12\x38\n\x06parent\x18\x01 \x01(\tB(\xe0\x41\x02\xfa\x41\"\n cloudsupport.googleapis.com/Case\x12:\n\x07\x63omment\x18\x02 \x01(\x0b\x32$.google.cloud.support.v2beta.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\xe0\x05\n\x0e\x43ommentService\x12\xe7\x01\n\x0cListComments\x12\x30.google.cloud.support.v2beta.ListCommentsRequest\x1a\x31.google.cloud.support.v2beta.ListCommentsResponse\"r\xda\x41\x06parent\x82\xd3\xe4\x93\x02\x63\x12,/v2beta/{parent=projects/*/cases/*}/commentsZ3\x12\x31/v2beta/{parent=organizations/*/cases/*}/comments\x12\xf7\x01\n\rCreateComment\x12\x31.google.cloud.support.v2beta.CreateCommentRequest\x1a$.google.cloud.support.v2beta.Comment\"\x8c\x01\xda\x41\x0eparent,comment\x82\xd3\xe4\x93\x02u\",/v2beta/{parent=projects/*/cases/*}/comments:\x07\x63ommentZ<\"1/v2beta/{parent=organizations/*/cases/*}/comments:\x07\x63omment\x12\x98\x01\n\nGetComment\x12..google.cloud.support.v2beta.GetCommentRequest\x1a$.google.cloud.support.v2beta.Comment\"4\xda\x41\x04name\x82\xd3\xe4\x93\x02\'\x12%/v2beta/{name=*/*/cases/*/comments/*}\x1aO\xca\x41\x1b\x63loudsupport.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\xd0\x01\n\x1f\x63om.google.cloud.support.v2betaB\x13\x43ommentServiceProtoP\x01Z9cloud.google.com/go/support/apiv2beta/supportpb;supportpb\xaa\x02\x1bGoogle.Cloud.Support.V2Beta\xca\x02\x1bGoogle\\Cloud\\Support\\V2beta\xea\x02\x1eGoogle::Cloud::Support::V2betab\x06proto3"
15
15
 
16
16
  pool = Google::Protobuf::DescriptorPool.generated_pool
17
17
 
@@ -45,6 +45,7 @@ module Google
45
45
  ListCommentsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.support.v2beta.ListCommentsRequest").msgclass
46
46
  ListCommentsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.support.v2beta.ListCommentsResponse").msgclass
47
47
  CreateCommentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.support.v2beta.CreateCommentRequest").msgclass
48
+ GetCommentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.support.v2beta.GetCommentRequest").msgclass
48
49
  end
49
50
  end
50
51
  end
@@ -39,6 +39,8 @@ module Google
39
39
  #
40
40
  # The comment must have the following fields set: `body`.
41
41
  rpc :CreateComment, ::Google::Cloud::Support::V2beta::CreateCommentRequest, ::Google::Cloud::Support::V2beta::Comment
42
+ # Retrieve a comment.
43
+ rpc :GetComment, ::Google::Cloud::Support::V2beta::GetCommentRequest, ::Google::Cloud::Support::V2beta::Comment
42
44
  end
43
45
 
44
46
  Stub = Service.rpc_stub_class
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Support
23
23
  module V2beta
24
- VERSION = "0.1.1"
24
+ VERSION = "0.3.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::V2beta::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-v2beta
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.1.1
4
+ version: 0.3.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.0'
18
+ version: '1.2'
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.0'
25
+ version: '1.2'
26
26
  - !ruby/object:Gem::Dependency
27
27
  name: google-cloud-errors
28
28
  requirement: !ruby/object:Gem::Requirement