google-cloud-recommender-v1 0.4.3 → 0.6.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 0fa6709702cbfa76e63fc80af13987becad8f6a02a251a867ffb38be92678419
4
- data.tar.gz: 4b94202ff71a5d024df9e63eaa60afd34166b955e4dad6c571c488839b46c48c
3
+ metadata.gz: 46fb7c89b82a0dea66ee1a8f050fef7fee2ca7f0ca80a708e0ec5da7a46078ce
4
+ data.tar.gz: f05bb2566528e5dcc18e3529748db0d9b9b4ab0e3cfdf24b4c06c4f4dfcb88b2
5
5
  SHA512:
6
- metadata.gz: 4357f1e257fd83e1d6dd908ccd2566243f7131cc0c92e1022e14cfe0a6d00a163dd30f6e4f39f807ecf852c6c8cdb9be50492253be3d5618a3879d76f77a5022
7
- data.tar.gz: e2f75c28174c6fa73715ef818ea5d98543012c080922a8010053ee6ce9a2fcad242ca13848cc063bb1b4cc4f9499f1cebb6d978904c4a882fc7337c641100cb7
6
+ metadata.gz: 500a68ce669f879dd97620bb00eff11a50238f8065d74fb7538def6ccfa96de555b0b7dccba5af074906439561b12e00aae5693db35f08c91e848ab717c58749
7
+ data.tar.gz: f7954ff026b31d5ac06e4dd56251252c85f37bba6828249f2fb43fc351186f45c85d16cea443fe8ad4138bf4eb1cba918ebc2163da860a8004a91f5405a1d168
data/README.md CHANGED
@@ -28,7 +28,7 @@ require "google/cloud/recommender/v1"
28
28
 
29
29
  client = ::Google::Cloud::Recommender::V1::Recommender::Client.new
30
30
  request = my_create_request
31
- response = client.list_recommendations request
31
+ response = client.list_insights request
32
32
  ```
33
33
 
34
34
  View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-recommender-v1/latest)
@@ -33,3 +33,6 @@ module Google
33
33
  end
34
34
  end
35
35
  end
36
+
37
+ helper_path = ::File.join __dir__, "v1", "_helpers.rb"
38
+ require "google/cloud/recommender/v1/_helpers" if ::File.file? helper_path
@@ -0,0 +1,60 @@
1
+ # Generated by the protocol buffer compiler. DO NOT EDIT!
2
+ # source: google/cloud/recommender/v1/insight.proto
3
+
4
+ require 'google/protobuf'
5
+
6
+ require 'google/api/resource_pb'
7
+ require 'google/protobuf/duration_pb'
8
+ require 'google/protobuf/struct_pb'
9
+ require 'google/protobuf/timestamp_pb'
10
+ Google::Protobuf::DescriptorPool.generated_pool.build do
11
+ add_file("google/cloud/recommender/v1/insight.proto", :syntax => :proto3) do
12
+ add_message "google.cloud.recommender.v1.Insight" do
13
+ optional :name, :string, 1
14
+ optional :description, :string, 2
15
+ repeated :target_resources, :string, 9
16
+ optional :insight_subtype, :string, 10
17
+ optional :content, :message, 3, "google.protobuf.Struct"
18
+ optional :last_refresh_time, :message, 4, "google.protobuf.Timestamp"
19
+ optional :observation_period, :message, 5, "google.protobuf.Duration"
20
+ optional :state_info, :message, 6, "google.cloud.recommender.v1.InsightStateInfo"
21
+ optional :category, :enum, 7, "google.cloud.recommender.v1.Insight.Category"
22
+ optional :etag, :string, 11
23
+ repeated :associated_recommendations, :message, 8, "google.cloud.recommender.v1.Insight.RecommendationReference"
24
+ end
25
+ add_message "google.cloud.recommender.v1.Insight.RecommendationReference" do
26
+ optional :recommendation, :string, 1
27
+ end
28
+ add_enum "google.cloud.recommender.v1.Insight.Category" do
29
+ value :CATEGORY_UNSPECIFIED, 0
30
+ value :COST, 1
31
+ value :SECURITY, 2
32
+ value :PERFORMANCE, 3
33
+ value :MANAGEABILITY, 4
34
+ end
35
+ add_message "google.cloud.recommender.v1.InsightStateInfo" do
36
+ optional :state, :enum, 1, "google.cloud.recommender.v1.InsightStateInfo.State"
37
+ map :state_metadata, :string, :string, 2
38
+ end
39
+ add_enum "google.cloud.recommender.v1.InsightStateInfo.State" do
40
+ value :STATE_UNSPECIFIED, 0
41
+ value :ACTIVE, 1
42
+ value :ACCEPTED, 2
43
+ value :DISMISSED, 3
44
+ end
45
+ end
46
+ end
47
+
48
+ module Google
49
+ module Cloud
50
+ module Recommender
51
+ module V1
52
+ Insight = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.recommender.v1.Insight").msgclass
53
+ Insight::RecommendationReference = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.recommender.v1.Insight.RecommendationReference").msgclass
54
+ Insight::Category = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.recommender.v1.Insight.Category").enummodule
55
+ InsightStateInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.recommender.v1.InsightStateInfo").msgclass
56
+ InsightStateInfo::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.recommender.v1.InsightStateInfo.State").enummodule
57
+ end
58
+ end
59
+ end
60
+ end
@@ -20,6 +20,10 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
20
20
  optional :content, :message, 7, "google.cloud.recommender.v1.RecommendationContent"
21
21
  optional :state_info, :message, 10, "google.cloud.recommender.v1.RecommendationStateInfo"
22
22
  optional :etag, :string, 11
23
+ repeated :associated_insights, :message, 14, "google.cloud.recommender.v1.Recommendation.InsightReference"
24
+ end
25
+ add_message "google.cloud.recommender.v1.Recommendation.InsightReference" do
26
+ optional :insight, :string, 1
23
27
  end
24
28
  add_message "google.cloud.recommender.v1.RecommendationContent" do
25
29
  repeated :operation_groups, :message, 2, "google.cloud.recommender.v1.OperationGroup"
@@ -83,6 +87,7 @@ module Google
83
87
  module Recommender
84
88
  module V1
85
89
  Recommendation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.recommender.v1.Recommendation").msgclass
90
+ Recommendation::InsightReference = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.recommender.v1.Recommendation.InsightReference").msgclass
86
91
  RecommendationContent = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.recommender.v1.RecommendationContent").msgclass
87
92
  OperationGroup = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.recommender.v1.OperationGroup").msgclass
88
93
  Operation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.recommender.v1.Operation").msgclass
@@ -31,10 +31,10 @@ module Google
31
31
  module Recommender
32
32
  module V1
33
33
  ##
34
- # Provides recommendations for cloud customers for various categories like
35
- # performance optimization, cost savings, reliability, feature discovery, etc.
36
- # These recommendations are generated automatically based on analysis of user
37
- # resources, configuration and monitoring metrics.
34
+ # Provides insights and recommendations for cloud customers for various
35
+ # categories like performance optimization, cost savings, reliability, feature
36
+ # discovery, etc. Insights and recommendations are generated automatically
37
+ # based on analysis of user resources, configuration and monitoring metrics.
38
38
  #
39
39
  # To load this service and instantiate a client:
40
40
  #
@@ -27,10 +27,10 @@ module Google
27
27
  ##
28
28
  # Client for the Recommender service.
29
29
  #
30
- # Provides recommendations for cloud customers for various categories like
31
- # performance optimization, cost savings, reliability, feature discovery, etc.
32
- # These recommendations are generated automatically based on analysis of user
33
- # resources, configuration and monitoring metrics.
30
+ # Provides insights and recommendations for cloud customers for various
31
+ # categories like performance optimization, cost savings, reliability, feature
32
+ # discovery, etc. Insights and recommendations are generated automatically
33
+ # based on analysis of user resources, configuration and monitoring metrics.
34
34
  #
35
35
  class Client
36
36
  include Paths
@@ -68,12 +68,30 @@ module Google
68
68
  end
69
69
  default_config = Client::Configuration.new parent_config
70
70
 
71
+ default_config.rpcs.list_insights.timeout = 60.0
72
+ default_config.rpcs.list_insights.retry_policy = {
73
+ initial_delay: 0.1,
74
+ max_delay: 60.0,
75
+ multiplier: 1.3,
76
+ retry_codes: [4, 14]
77
+ }
78
+
79
+ default_config.rpcs.get_insight.timeout = 60.0
80
+ default_config.rpcs.get_insight.retry_policy = {
81
+ initial_delay: 0.1,
82
+ max_delay: 60.0,
83
+ multiplier: 1.3,
84
+ retry_codes: [4, 14]
85
+ }
86
+
87
+ default_config.rpcs.mark_insight_accepted.timeout = 60.0
88
+
71
89
  default_config.rpcs.list_recommendations.timeout = 60.0
72
90
  default_config.rpcs.list_recommendations.retry_policy = {
73
91
  initial_delay: 0.1,
74
92
  max_delay: 60.0,
75
93
  multiplier: 1.3,
76
- retry_codes: ["DEADLINE_EXCEEDED", "UNAVAILABLE"]
94
+ retry_codes: [4, 14]
77
95
  }
78
96
 
79
97
  default_config.rpcs.get_recommendation.timeout = 60.0
@@ -81,7 +99,7 @@ module Google
81
99
  initial_delay: 0.1,
82
100
  max_delay: 60.0,
83
101
  multiplier: 1.3,
84
- retry_codes: ["DEADLINE_EXCEEDED", "UNAVAILABLE"]
102
+ retry_codes: [4, 14]
85
103
  }
86
104
 
87
105
  default_config.rpcs.mark_recommendation_claimed.timeout = 60.0
@@ -169,6 +187,239 @@ module Google
169
187
 
170
188
  # Service calls
171
189
 
190
+ ##
191
+ # Lists insights for a Cloud project. Requires the recommender.*.list IAM
192
+ # permission for the specified insight type.
193
+ #
194
+ # @overload list_insights(request, options = nil)
195
+ # Pass arguments to `list_insights` via a request object, either of type
196
+ # {::Google::Cloud::Recommender::V1::ListInsightsRequest} or an equivalent Hash.
197
+ #
198
+ # @param request [::Google::Cloud::Recommender::V1::ListInsightsRequest, ::Hash]
199
+ # A request object representing the call parameters. Required. To specify no
200
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
201
+ # @param options [::Gapic::CallOptions, ::Hash]
202
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
203
+ #
204
+ # @overload list_insights(parent: nil, page_size: nil, page_token: nil, filter: nil)
205
+ # Pass arguments to `list_insights` via keyword arguments. Note that at
206
+ # least one keyword argument is required. To specify no parameters, or to keep all
207
+ # the default parameter values, pass an empty Hash as a request object (see above).
208
+ #
209
+ # @param parent [::String]
210
+ # Required. The container resource on which to execute the request.
211
+ # Acceptable formats:
212
+ #
213
+ # 1.
214
+ # "projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]",
215
+ #
216
+ # LOCATION here refers to GCP Locations:
217
+ # https://cloud.google.com/about/locations/
218
+ # INSIGHT_TYPE_ID refers to supported insight types:
219
+ # https://cloud.google.com/recommender/docs/insights/insight-types.)
220
+ # @param page_size [::Integer]
221
+ # Optional. The maximum number of results to return from this request. Non-positive
222
+ # values are ignored. If not specified, the server will determine the number
223
+ # of results to return.
224
+ # @param page_token [::String]
225
+ # Optional. If present, retrieves the next batch of results from the preceding call to
226
+ # this method. `page_token` must be the value of `next_page_token` from the
227
+ # previous response. The values of other method parameters must be identical
228
+ # to those in the previous call.
229
+ # @param filter [::String]
230
+ # Optional. Filter expression to restrict the insights returned. Supported
231
+ # filter fields: state
232
+ # Eg: `state:"DISMISSED" or state:"ACTIVE"
233
+ #
234
+ # @yield [response, operation] Access the result along with the RPC operation
235
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Recommender::V1::Insight>]
236
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
237
+ #
238
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::Recommender::V1::Insight>]
239
+ #
240
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
241
+ #
242
+ def list_insights request, options = nil
243
+ raise ::ArgumentError, "request must be provided" if request.nil?
244
+
245
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Recommender::V1::ListInsightsRequest
246
+
247
+ # Converts hash and nil to an options object
248
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
249
+
250
+ # Customize the options with defaults
251
+ metadata = @config.rpcs.list_insights.metadata.to_h
252
+
253
+ # Set x-goog-api-client and x-goog-user-project headers
254
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
255
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
256
+ gapic_version: ::Google::Cloud::Recommender::V1::VERSION
257
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
258
+
259
+ header_params = {
260
+ "parent" => request.parent
261
+ }
262
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
263
+ metadata[:"x-goog-request-params"] ||= request_params_header
264
+
265
+ options.apply_defaults timeout: @config.rpcs.list_insights.timeout,
266
+ metadata: metadata,
267
+ retry_policy: @config.rpcs.list_insights.retry_policy
268
+ options.apply_defaults metadata: @config.metadata,
269
+ retry_policy: @config.retry_policy
270
+
271
+ @recommender_stub.call_rpc :list_insights, request, options: options do |response, operation|
272
+ response = ::Gapic::PagedEnumerable.new @recommender_stub, :list_insights, request, response, operation, options
273
+ yield response, operation if block_given?
274
+ return response
275
+ end
276
+ rescue ::GRPC::BadStatus => e
277
+ raise ::Google::Cloud::Error.from_error(e)
278
+ end
279
+
280
+ ##
281
+ # Gets the requested insight. Requires the recommender.*.get IAM permission
282
+ # for the specified insight type.
283
+ #
284
+ # @overload get_insight(request, options = nil)
285
+ # Pass arguments to `get_insight` via a request object, either of type
286
+ # {::Google::Cloud::Recommender::V1::GetInsightRequest} or an equivalent Hash.
287
+ #
288
+ # @param request [::Google::Cloud::Recommender::V1::GetInsightRequest, ::Hash]
289
+ # A request object representing the call parameters. Required. To specify no
290
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
291
+ # @param options [::Gapic::CallOptions, ::Hash]
292
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
293
+ #
294
+ # @overload get_insight(name: nil)
295
+ # Pass arguments to `get_insight` via keyword arguments. Note that at
296
+ # least one keyword argument is required. To specify no parameters, or to keep all
297
+ # the default parameter values, pass an empty Hash as a request object (see above).
298
+ #
299
+ # @param name [::String]
300
+ # Required. Name of the insight.
301
+ #
302
+ # @yield [response, operation] Access the result along with the RPC operation
303
+ # @yieldparam response [::Google::Cloud::Recommender::V1::Insight]
304
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
305
+ #
306
+ # @return [::Google::Cloud::Recommender::V1::Insight]
307
+ #
308
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
309
+ #
310
+ def get_insight request, options = nil
311
+ raise ::ArgumentError, "request must be provided" if request.nil?
312
+
313
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Recommender::V1::GetInsightRequest
314
+
315
+ # Converts hash and nil to an options object
316
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
317
+
318
+ # Customize the options with defaults
319
+ metadata = @config.rpcs.get_insight.metadata.to_h
320
+
321
+ # Set x-goog-api-client and x-goog-user-project headers
322
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
323
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
324
+ gapic_version: ::Google::Cloud::Recommender::V1::VERSION
325
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
326
+
327
+ header_params = {
328
+ "name" => request.name
329
+ }
330
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
331
+ metadata[:"x-goog-request-params"] ||= request_params_header
332
+
333
+ options.apply_defaults timeout: @config.rpcs.get_insight.timeout,
334
+ metadata: metadata,
335
+ retry_policy: @config.rpcs.get_insight.retry_policy
336
+ options.apply_defaults metadata: @config.metadata,
337
+ retry_policy: @config.retry_policy
338
+
339
+ @recommender_stub.call_rpc :get_insight, request, options: options do |response, operation|
340
+ yield response, operation if block_given?
341
+ return response
342
+ end
343
+ rescue ::GRPC::BadStatus => e
344
+ raise ::Google::Cloud::Error.from_error(e)
345
+ end
346
+
347
+ ##
348
+ # Marks the Insight State as Accepted. Users can use this method to
349
+ # indicate to the Recommender API that they have applied some action based
350
+ # on the insight. This stops the insight content from being updated.
351
+ #
352
+ # MarkInsightAccepted can be applied to insights in ACTIVE state. Requires
353
+ # the recommender.*.update IAM permission for the specified insight.
354
+ #
355
+ # @overload mark_insight_accepted(request, options = nil)
356
+ # Pass arguments to `mark_insight_accepted` via a request object, either of type
357
+ # {::Google::Cloud::Recommender::V1::MarkInsightAcceptedRequest} or an equivalent Hash.
358
+ #
359
+ # @param request [::Google::Cloud::Recommender::V1::MarkInsightAcceptedRequest, ::Hash]
360
+ # A request object representing the call parameters. Required. To specify no
361
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
362
+ # @param options [::Gapic::CallOptions, ::Hash]
363
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
364
+ #
365
+ # @overload mark_insight_accepted(name: nil, state_metadata: nil, etag: nil)
366
+ # Pass arguments to `mark_insight_accepted` via keyword arguments. Note that at
367
+ # least one keyword argument is required. To specify no parameters, or to keep all
368
+ # the default parameter values, pass an empty Hash as a request object (see above).
369
+ #
370
+ # @param name [::String]
371
+ # Required. Name of the insight.
372
+ # @param state_metadata [::Hash{::String => ::String}]
373
+ # Optional. State properties user wish to include with this state. Full replace of the
374
+ # current state_metadata.
375
+ # @param etag [::String]
376
+ # Required. Fingerprint of the Insight. Provides optimistic locking.
377
+ #
378
+ # @yield [response, operation] Access the result along with the RPC operation
379
+ # @yieldparam response [::Google::Cloud::Recommender::V1::Insight]
380
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
381
+ #
382
+ # @return [::Google::Cloud::Recommender::V1::Insight]
383
+ #
384
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
385
+ #
386
+ def mark_insight_accepted request, options = nil
387
+ raise ::ArgumentError, "request must be provided" if request.nil?
388
+
389
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Recommender::V1::MarkInsightAcceptedRequest
390
+
391
+ # Converts hash and nil to an options object
392
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
393
+
394
+ # Customize the options with defaults
395
+ metadata = @config.rpcs.mark_insight_accepted.metadata.to_h
396
+
397
+ # Set x-goog-api-client and x-goog-user-project headers
398
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
399
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
400
+ gapic_version: ::Google::Cloud::Recommender::V1::VERSION
401
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
402
+
403
+ header_params = {
404
+ "name" => request.name
405
+ }
406
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
407
+ metadata[:"x-goog-request-params"] ||= request_params_header
408
+
409
+ options.apply_defaults timeout: @config.rpcs.mark_insight_accepted.timeout,
410
+ metadata: metadata,
411
+ retry_policy: @config.rpcs.mark_insight_accepted.retry_policy
412
+ options.apply_defaults metadata: @config.metadata,
413
+ retry_policy: @config.retry_policy
414
+
415
+ @recommender_stub.call_rpc :mark_insight_accepted, request, options: options do |response, operation|
416
+ yield response, operation if block_given?
417
+ return response
418
+ end
419
+ rescue ::GRPC::BadStatus => e
420
+ raise ::Google::Cloud::Error.from_error(e)
421
+ end
422
+
172
423
  ##
173
424
  # Lists recommendations for a Cloud project. Requires the recommender.*.list
174
425
  # IAM permission for the specified recommender.
@@ -197,6 +448,8 @@ module Google
197
448
  #
198
449
  # LOCATION here refers to GCP Locations:
199
450
  # https://cloud.google.com/about/locations/
451
+ # RECOMMENDER_ID refers to supported recommenders:
452
+ # https://cloud.google.com/recommender/docs/recommenders.
200
453
  # @param page_size [::Integer]
201
454
  # Optional. The maximum number of results to return from this request. Non-positive
202
455
  # values are ignored. If not specified, the server will determine the number
@@ -325,10 +578,10 @@ module Google
325
578
  end
326
579
 
327
580
  ##
328
- # Mark the Recommendation State as Claimed. Users can use this method to
581
+ # Marks the Recommendation State as Claimed. Users can use this method to
329
582
  # indicate to the Recommender API that they are starting to apply the
330
583
  # recommendation themselves. This stops the recommendation content from being
331
- # updated.
584
+ # updated. Associated insights are frozen and placed in the ACCEPTED state.
332
585
  #
333
586
  # MarkRecommendationClaimed can be applied to recommendations in CLAIMED,
334
587
  # SUCCEEDED, FAILED, or ACTIVE state.
@@ -407,10 +660,11 @@ module Google
407
660
  end
408
661
 
409
662
  ##
410
- # Mark the Recommendation State as Succeeded. Users can use this method to
663
+ # Marks the Recommendation State as Succeeded. Users can use this method to
411
664
  # indicate to the Recommender API that they have applied the recommendation
412
665
  # themselves, and the operation was successful. This stops the recommendation
413
- # content from being updated.
666
+ # content from being updated. Associated insights are frozen and placed in
667
+ # the ACCEPTED state.
414
668
  #
415
669
  # MarkRecommendationSucceeded can be applied to recommendations in ACTIVE,
416
670
  # CLAIMED, SUCCEEDED, or FAILED state.
@@ -489,10 +743,11 @@ module Google
489
743
  end
490
744
 
491
745
  ##
492
- # Mark the Recommendation State as Failed. Users can use this method to
746
+ # Marks the Recommendation State as Failed. Users can use this method to
493
747
  # indicate to the Recommender API that they have applied the recommendation
494
748
  # themselves, and the operation failed. This stops the recommendation content
495
- # from being updated.
749
+ # from being updated. Associated insights are frozen and placed in the
750
+ # ACCEPTED state.
496
751
  #
497
752
  # MarkRecommendationFailed can be applied to recommendations in ACTIVE,
498
753
  # CLAIMED, SUCCEEDED, or FAILED state.
@@ -585,19 +840,19 @@ module Google
585
840
  #
586
841
  # # Examples
587
842
  #
588
- # To modify the global config, setting the timeout for list_recommendations
843
+ # To modify the global config, setting the timeout for list_insights
589
844
  # to 20 seconds, and all remaining timeouts to 10 seconds:
590
845
  #
591
846
  # ::Google::Cloud::Recommender::V1::Recommender::Client.configure do |config|
592
847
  # config.timeout = 10.0
593
- # config.rpcs.list_recommendations.timeout = 20.0
848
+ # config.rpcs.list_insights.timeout = 20.0
594
849
  # end
595
850
  #
596
851
  # To apply the above configuration only to a new client:
597
852
  #
598
853
  # client = ::Google::Cloud::Recommender::V1::Recommender::Client.new do |config|
599
854
  # config.timeout = 10.0
600
- # config.rpcs.list_recommendations.timeout = 20.0
855
+ # config.rpcs.list_insights.timeout = 20.0
601
856
  # end
602
857
  #
603
858
  # @!attribute [rw] endpoint
@@ -655,7 +910,7 @@ module Google
655
910
 
656
911
  config_attr :endpoint, "recommender.googleapis.com", ::String
657
912
  config_attr :credentials, nil do |value|
658
- allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
913
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
659
914
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
660
915
  allowed.any? { |klass| klass === value }
661
916
  end
@@ -695,7 +950,7 @@ module Google
695
950
  # Each configuration object is of type `Gapic::Config::Method` and includes
696
951
  # the following configuration fields:
697
952
  #
698
- # * `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
953
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
699
954
  # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
700
955
  # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
701
956
  # include the following keys:
@@ -706,6 +961,21 @@ module Google
706
961
  # trigger a retry.
707
962
  #
708
963
  class Rpcs
964
+ ##
965
+ # RPC-specific configuration for `list_insights`
966
+ # @return [::Gapic::Config::Method]
967
+ #
968
+ attr_reader :list_insights
969
+ ##
970
+ # RPC-specific configuration for `get_insight`
971
+ # @return [::Gapic::Config::Method]
972
+ #
973
+ attr_reader :get_insight
974
+ ##
975
+ # RPC-specific configuration for `mark_insight_accepted`
976
+ # @return [::Gapic::Config::Method]
977
+ #
978
+ attr_reader :mark_insight_accepted
709
979
  ##
710
980
  # RPC-specific configuration for `list_recommendations`
711
981
  # @return [::Gapic::Config::Method]
@@ -734,6 +1004,12 @@ module Google
734
1004
 
735
1005
  # @private
736
1006
  def initialize parent_rpcs = nil
1007
+ list_insights_config = parent_rpcs&.list_insights if parent_rpcs&.respond_to? :list_insights
1008
+ @list_insights = ::Gapic::Config::Method.new list_insights_config
1009
+ get_insight_config = parent_rpcs&.get_insight if parent_rpcs&.respond_to? :get_insight
1010
+ @get_insight = ::Gapic::Config::Method.new get_insight_config
1011
+ mark_insight_accepted_config = parent_rpcs&.mark_insight_accepted if parent_rpcs&.respond_to? :mark_insight_accepted
1012
+ @mark_insight_accepted = ::Gapic::Config::Method.new mark_insight_accepted_config
737
1013
  list_recommendations_config = parent_rpcs&.list_recommendations if parent_rpcs&.respond_to? :list_recommendations
738
1014
  @list_recommendations = ::Gapic::Config::Method.new list_recommendations_config
739
1015
  get_recommendation_config = parent_rpcs&.get_recommendation if parent_rpcs&.respond_to? :get_recommendation