google-cloud-discovery_engine-v1beta 0.15.0 → 0.17.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +30 -20
- data/lib/google/cloud/discovery_engine/v1beta/completion_service/client.rb +186 -6
- data/lib/google/cloud/discovery_engine/v1beta/completion_service/operations.rb +12 -15
- data/lib/google/cloud/discovery_engine/v1beta/completion_service/paths.rb +62 -0
- data/lib/google/cloud/discovery_engine/v1beta/completion_service/rest/client.rb +179 -6
- data/lib/google/cloud/discovery_engine/v1beta/completion_service/rest/operations.rb +43 -38
- data/lib/google/cloud/discovery_engine/v1beta/completion_service/rest/service_stub.rb +131 -31
- data/lib/google/cloud/discovery_engine/v1beta/control_service/client.rb +35 -12
- data/lib/google/cloud/discovery_engine/v1beta/control_service/rest/client.rb +35 -12
- data/lib/google/cloud/discovery_engine/v1beta/control_service/rest/service_stub.rb +54 -32
- data/lib/google/cloud/discovery_engine/v1beta/conversational_search_service/client.rb +48 -27
- data/lib/google/cloud/discovery_engine/v1beta/conversational_search_service/rest/client.rb +48 -27
- data/lib/google/cloud/discovery_engine/v1beta/conversational_search_service/rest/service_stub.rb +118 -80
- data/lib/google/cloud/discovery_engine/v1beta/data_store_service/client.rb +31 -6
- data/lib/google/cloud/discovery_engine/v1beta/data_store_service/operations.rb +12 -15
- data/lib/google/cloud/discovery_engine/v1beta/data_store_service/rest/client.rb +31 -6
- data/lib/google/cloud/discovery_engine/v1beta/data_store_service/rest/operations.rb +43 -38
- data/lib/google/cloud/discovery_engine/v1beta/data_store_service/rest/service_stub.rb +54 -32
- data/lib/google/cloud/discovery_engine/v1beta/document_service/client.rb +31 -9
- data/lib/google/cloud/discovery_engine/v1beta/document_service/operations.rb +12 -15
- data/lib/google/cloud/discovery_engine/v1beta/document_service/paths.rb +25 -0
- data/lib/google/cloud/discovery_engine/v1beta/document_service/rest/client.rb +31 -9
- data/lib/google/cloud/discovery_engine/v1beta/document_service/rest/operations.rb +43 -38
- data/lib/google/cloud/discovery_engine/v1beta/document_service/rest/service_stub.rb +78 -50
- data/lib/google/cloud/discovery_engine/v1beta/engine_service/client.rb +35 -12
- data/lib/google/cloud/discovery_engine/v1beta/engine_service/operations.rb +12 -15
- data/lib/google/cloud/discovery_engine/v1beta/engine_service/rest/client.rb +35 -12
- data/lib/google/cloud/discovery_engine/v1beta/engine_service/rest/operations.rb +43 -38
- data/lib/google/cloud/discovery_engine/v1beta/engine_service/rest/service_stub.rb +78 -50
- data/lib/google/cloud/discovery_engine/v1beta/evaluation_service/client.rb +31 -5
- data/lib/google/cloud/discovery_engine/v1beta/evaluation_service/operations.rb +12 -15
- data/lib/google/cloud/discovery_engine/v1beta/evaluation_service/rest/client.rb +31 -5
- data/lib/google/cloud/discovery_engine/v1beta/evaluation_service/rest/operations.rb +43 -38
- data/lib/google/cloud/discovery_engine/v1beta/evaluation_service/rest/service_stub.rb +46 -26
- data/lib/google/cloud/discovery_engine/v1beta/grounded_generation_service/client.rb +244 -6
- data/lib/google/cloud/discovery_engine/v1beta/grounded_generation_service/paths.rb +85 -0
- data/lib/google/cloud/discovery_engine/v1beta/grounded_generation_service/rest/client.rb +152 -6
- data/lib/google/cloud/discovery_engine/v1beta/grounded_generation_service/rest/service_stub.rb +83 -7
- data/lib/google/cloud/discovery_engine/v1beta/project_service/client.rb +29 -2
- data/lib/google/cloud/discovery_engine/v1beta/project_service/operations.rb +12 -15
- data/lib/google/cloud/discovery_engine/v1beta/project_service/rest/client.rb +29 -2
- data/lib/google/cloud/discovery_engine/v1beta/project_service/rest/operations.rb +43 -38
- data/lib/google/cloud/discovery_engine/v1beta/project_service/rest/service_stub.rb +22 -8
- data/lib/google/cloud/discovery_engine/v1beta/rank_service/client.rb +29 -3
- data/lib/google/cloud/discovery_engine/v1beta/rank_service/rest/client.rb +29 -3
- data/lib/google/cloud/discovery_engine/v1beta/rank_service/rest/service_stub.rb +22 -8
- data/lib/google/cloud/discovery_engine/v1beta/recommendation_service/client.rb +28 -2
- data/lib/google/cloud/discovery_engine/v1beta/recommendation_service/rest/client.rb +28 -2
- data/lib/google/cloud/discovery_engine/v1beta/recommendation_service/rest/service_stub.rb +22 -8
- data/lib/google/cloud/discovery_engine/v1beta/sample_query_service/client.rb +30 -7
- data/lib/google/cloud/discovery_engine/v1beta/sample_query_service/operations.rb +12 -15
- data/lib/google/cloud/discovery_engine/v1beta/sample_query_service/rest/client.rb +30 -7
- data/lib/google/cloud/discovery_engine/v1beta/sample_query_service/rest/operations.rb +43 -38
- data/lib/google/cloud/discovery_engine/v1beta/sample_query_service/rest/service_stub.rb +62 -38
- data/lib/google/cloud/discovery_engine/v1beta/sample_query_set_service/client.rb +29 -6
- data/lib/google/cloud/discovery_engine/v1beta/sample_query_set_service/rest/client.rb +29 -6
- data/lib/google/cloud/discovery_engine/v1beta/sample_query_set_service/rest/service_stub.rb +54 -32
- data/lib/google/cloud/discovery_engine/v1beta/schema_service/client.rb +32 -6
- data/lib/google/cloud/discovery_engine/v1beta/schema_service/operations.rb +12 -15
- data/lib/google/cloud/discovery_engine/v1beta/schema_service/rest/client.rb +32 -6
- data/lib/google/cloud/discovery_engine/v1beta/schema_service/rest/operations.rb +43 -38
- data/lib/google/cloud/discovery_engine/v1beta/schema_service/rest/service_stub.rb +54 -32
- data/lib/google/cloud/discovery_engine/v1beta/search_service/client.rb +427 -3
- data/lib/google/cloud/discovery_engine/v1beta/search_service/rest/client.rb +417 -3
- data/lib/google/cloud/discovery_engine/v1beta/search_service/rest/service_stub.rb +99 -7
- data/lib/google/cloud/discovery_engine/v1beta/search_tuning_service/client.rb +29 -3
- data/lib/google/cloud/discovery_engine/v1beta/search_tuning_service/operations.rb +12 -15
- data/lib/google/cloud/discovery_engine/v1beta/search_tuning_service/rest/client.rb +29 -3
- data/lib/google/cloud/discovery_engine/v1beta/search_tuning_service/rest/operations.rb +43 -38
- data/lib/google/cloud/discovery_engine/v1beta/search_tuning_service/rest/service_stub.rb +30 -14
- data/lib/google/cloud/discovery_engine/v1beta/serving_config_service/client.rb +31 -6
- data/lib/google/cloud/discovery_engine/v1beta/serving_config_service/rest/client.rb +31 -6
- data/lib/google/cloud/discovery_engine/v1beta/serving_config_service/rest/service_stub.rb +38 -20
- data/lib/google/cloud/discovery_engine/v1beta/site_search_engine_service/client.rb +361 -14
- data/lib/google/cloud/discovery_engine/v1beta/site_search_engine_service/operations.rb +12 -15
- data/lib/google/cloud/discovery_engine/v1beta/site_search_engine_service/paths.rb +49 -0
- data/lib/google/cloud/discovery_engine/v1beta/site_search_engine_service/rest/client.rb +340 -14
- data/lib/google/cloud/discovery_engine/v1beta/site_search_engine_service/rest/operations.rb +43 -38
- data/lib/google/cloud/discovery_engine/v1beta/site_search_engine_service/rest/service_stub.rb +308 -73
- data/lib/google/cloud/discovery_engine/v1beta/user_event_service/client.rb +31 -6
- data/lib/google/cloud/discovery_engine/v1beta/user_event_service/operations.rb +12 -15
- data/lib/google/cloud/discovery_engine/v1beta/user_event_service/rest/client.rb +31 -6
- data/lib/google/cloud/discovery_engine/v1beta/user_event_service/rest/operations.rb +43 -38
- data/lib/google/cloud/discovery_engine/v1beta/user_event_service/rest/service_stub.rb +46 -26
- data/lib/google/cloud/discovery_engine/v1beta/version.rb +1 -1
- data/lib/google/cloud/discoveryengine/v1beta/answer_pb.rb +1 -1
- data/lib/google/cloud/discoveryengine/v1beta/common_pb.rb +1 -1
- data/lib/google/cloud/discoveryengine/v1beta/completion_service_pb.rb +18 -1
- data/lib/google/cloud/discoveryengine/v1beta/completion_service_services_pb.rb +2 -0
- data/lib/google/cloud/discoveryengine/v1beta/control_pb.rb +1 -1
- data/lib/google/cloud/discoveryengine/v1beta/conversational_search_service_pb.rb +4 -1
- data/lib/google/cloud/discoveryengine/v1beta/custom_tuning_model_pb.rb +1 -1
- data/lib/google/cloud/discoveryengine/v1beta/data_store_pb.rb +7 -1
- data/lib/google/cloud/discoveryengine/v1beta/document_service_pb.rb +2 -1
- data/lib/google/cloud/discoveryengine/v1beta/engine_pb.rb +1 -1
- data/lib/google/cloud/discoveryengine/v1beta/grounded_generation_service_pb.rb +24 -1
- data/lib/google/cloud/discoveryengine/v1beta/grounded_generation_service_services_pb.rb +4 -0
- data/lib/google/cloud/discoveryengine/v1beta/grounding_pb.rb +2 -1
- data/lib/google/cloud/discoveryengine/v1beta/search_service_pb.rb +3 -1
- data/lib/google/cloud/discoveryengine/v1beta/search_service_services_pb.rb +14 -0
- data/lib/google/cloud/discoveryengine/v1beta/serving_config_pb.rb +2 -2
- data/lib/google/cloud/discoveryengine/v1beta/site_search_engine_pb.rb +2 -1
- data/lib/google/cloud/discoveryengine/v1beta/site_search_engine_service_pb.rb +10 -1
- data/lib/google/cloud/discoveryengine/v1beta/site_search_engine_service_services_pb.rb +7 -0
- data/lib/google/cloud/discoveryengine/v1beta/user_event_pb.rb +1 -1
- data/proto_docs/google/api/client.rb +39 -0
- data/proto_docs/google/cloud/discoveryengine/v1beta/answer.rb +20 -6
- data/proto_docs/google/cloud/discoveryengine/v1beta/completion_service.rb +268 -0
- data/proto_docs/google/cloud/discoveryengine/v1beta/control.rb +9 -0
- data/proto_docs/google/cloud/discoveryengine/v1beta/control_service.rb +6 -6
- data/proto_docs/google/cloud/discoveryengine/v1beta/conversational_search_service.rb +95 -15
- data/proto_docs/google/cloud/discoveryengine/v1beta/custom_tuning_model.rb +8 -3
- data/proto_docs/google/cloud/discoveryengine/v1beta/data_store.rb +131 -0
- data/proto_docs/google/cloud/discoveryengine/v1beta/document_processing_config.rb +7 -5
- data/proto_docs/google/cloud/discoveryengine/v1beta/document_service.rb +19 -0
- data/proto_docs/google/cloud/discoveryengine/v1beta/engine.rb +5 -1
- data/proto_docs/google/cloud/discoveryengine/v1beta/engine_service.rb +4 -4
- data/proto_docs/google/cloud/discoveryengine/v1beta/grounded_generation_service.rb +396 -1
- data/proto_docs/google/cloud/discoveryengine/v1beta/grounding.rb +10 -0
- data/proto_docs/google/cloud/discoveryengine/v1beta/project.rb +1 -1
- data/proto_docs/google/cloud/discoveryengine/v1beta/purge_config.rb +1 -1
- data/proto_docs/google/cloud/discoveryengine/v1beta/rank_service.rb +1 -1
- data/proto_docs/google/cloud/discoveryengine/v1beta/search_service.rb +71 -0
- data/proto_docs/google/cloud/discoveryengine/v1beta/serving_config.rb +16 -0
- data/proto_docs/google/cloud/discoveryengine/v1beta/serving_config_service.rb +2 -2
- data/proto_docs/google/cloud/discoveryengine/v1beta/site_search_engine.rb +17 -0
- data/proto_docs/google/cloud/discoveryengine/v1beta/site_search_engine_service.rb +147 -1
- data/proto_docs/google/cloud/discoveryengine/v1beta/user_event.rb +9 -1
- data/proto_docs/google/longrunning/operations.rb +19 -14
- metadata +5 -5
@@ -156,14 +156,26 @@ module Google
|
|
156
156
|
endpoint: @config.endpoint,
|
157
157
|
endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
|
158
158
|
universe_domain: @config.universe_domain,
|
159
|
-
credentials: credentials
|
159
|
+
credentials: credentials,
|
160
|
+
logger: @config.logger
|
160
161
|
)
|
161
162
|
|
163
|
+
@rank_service_stub.logger(stub: true)&.info do |entry|
|
164
|
+
entry.set_system_name
|
165
|
+
entry.set_service
|
166
|
+
entry.message = "Created client for #{entry.service}"
|
167
|
+
entry.set_credentials_fields credentials
|
168
|
+
entry.set "customEndpoint", @config.endpoint if @config.endpoint
|
169
|
+
entry.set "defaultTimeout", @config.timeout if @config.timeout
|
170
|
+
entry.set "quotaProject", @quota_project_id if @quota_project_id
|
171
|
+
end
|
172
|
+
|
162
173
|
@location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
|
163
174
|
config.credentials = credentials
|
164
175
|
config.quota_project = @quota_project_id
|
165
176
|
config.endpoint = @rank_service_stub.endpoint
|
166
177
|
config.universe_domain = @rank_service_stub.universe_domain
|
178
|
+
config.logger = @rank_service_stub.logger if config.respond_to? :logger=
|
167
179
|
end
|
168
180
|
end
|
169
181
|
|
@@ -174,6 +186,15 @@ module Google
|
|
174
186
|
#
|
175
187
|
attr_reader :location_client
|
176
188
|
|
189
|
+
##
|
190
|
+
# The logger used for request/response debug logging.
|
191
|
+
#
|
192
|
+
# @return [Logger]
|
193
|
+
#
|
194
|
+
def logger
|
195
|
+
@rank_service_stub.logger
|
196
|
+
end
|
197
|
+
|
177
198
|
# Service calls
|
178
199
|
|
179
200
|
##
|
@@ -196,7 +217,7 @@ module Google
|
|
196
217
|
#
|
197
218
|
# @param ranking_config [::String]
|
198
219
|
# Required. The resource name of the rank service config, such as
|
199
|
-
# `projects/{project_num}/locations/{
|
220
|
+
# `projects/{project_num}/locations/{location}/rankingConfigs/default_ranking_config`.
|
200
221
|
# @param model [::String]
|
201
222
|
# The identifier of the model to use. It is one of:
|
202
223
|
#
|
@@ -285,7 +306,6 @@ module Google
|
|
285
306
|
|
286
307
|
@rank_service_stub.rank request, options do |result, operation|
|
287
308
|
yield result, operation if block_given?
|
288
|
-
return result
|
289
309
|
end
|
290
310
|
rescue ::Gapic::Rest::Error => e
|
291
311
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -365,6 +385,11 @@ module Google
|
|
365
385
|
# default endpoint URL. The default value of nil uses the environment
|
366
386
|
# universe (usually the default "googleapis.com" universe).
|
367
387
|
# @return [::String,nil]
|
388
|
+
# @!attribute [rw] logger
|
389
|
+
# A custom logger to use for request/response debug logging, or the value
|
390
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
391
|
+
# explicitly disable logging.
|
392
|
+
# @return [::Logger,:default,nil]
|
368
393
|
#
|
369
394
|
class Configuration
|
370
395
|
extend ::Gapic::Config
|
@@ -386,6 +411,7 @@ module Google
|
|
386
411
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
387
412
|
config_attr :quota_project, nil, ::String, nil
|
388
413
|
config_attr :universe_domain, nil, ::String, nil
|
414
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
389
415
|
|
390
416
|
# @private
|
391
417
|
def initialize parent_config = nil
|
@@ -30,7 +30,8 @@ module Google
|
|
30
30
|
# including transcoding, making the REST call, and deserialing the response.
|
31
31
|
#
|
32
32
|
class ServiceStub
|
33
|
-
|
33
|
+
# @private
|
34
|
+
def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
|
34
35
|
# These require statements are intentionally placed here to initialize
|
35
36
|
# the REST modules only when it's required.
|
36
37
|
require "gapic/rest"
|
@@ -40,7 +41,9 @@ module Google
|
|
40
41
|
universe_domain: universe_domain,
|
41
42
|
credentials: credentials,
|
42
43
|
numeric_enums: true,
|
43
|
-
|
44
|
+
service_name: self.class,
|
45
|
+
raise_faraday_errors: false,
|
46
|
+
logger: logger
|
44
47
|
end
|
45
48
|
|
46
49
|
##
|
@@ -61,6 +64,15 @@ module Google
|
|
61
64
|
@client_stub.endpoint
|
62
65
|
end
|
63
66
|
|
67
|
+
##
|
68
|
+
# The logger used for request/response debug logging.
|
69
|
+
#
|
70
|
+
# @return [Logger]
|
71
|
+
#
|
72
|
+
def logger stub: false
|
73
|
+
stub ? @client_stub.stub_logger : @client_stub.logger
|
74
|
+
end
|
75
|
+
|
64
76
|
##
|
65
77
|
# Baseline implementation for the rank REST call
|
66
78
|
#
|
@@ -87,16 +99,18 @@ module Google
|
|
87
99
|
|
88
100
|
response = @client_stub.make_http_request(
|
89
101
|
verb,
|
90
|
-
uri:
|
91
|
-
body:
|
92
|
-
params:
|
102
|
+
uri: uri,
|
103
|
+
body: body || "",
|
104
|
+
params: query_string_params,
|
105
|
+
method_name: "rank",
|
93
106
|
options: options
|
94
107
|
)
|
95
108
|
operation = ::Gapic::Rest::TransportOperation.new response
|
96
109
|
result = ::Google::Cloud::DiscoveryEngine::V1beta::RankResponse.decode_json response.body, ignore_unknown_fields: true
|
97
|
-
|
98
|
-
|
99
|
-
|
110
|
+
catch :response do
|
111
|
+
yield result, operation if block_given?
|
112
|
+
result
|
113
|
+
end
|
100
114
|
end
|
101
115
|
|
102
116
|
##
|
@@ -163,14 +163,26 @@ module Google
|
|
163
163
|
universe_domain: @config.universe_domain,
|
164
164
|
channel_args: @config.channel_args,
|
165
165
|
interceptors: @config.interceptors,
|
166
|
-
channel_pool_config: @config.channel_pool
|
166
|
+
channel_pool_config: @config.channel_pool,
|
167
|
+
logger: @config.logger
|
167
168
|
)
|
168
169
|
|
170
|
+
@recommendation_service_stub.stub_logger&.info do |entry|
|
171
|
+
entry.set_system_name
|
172
|
+
entry.set_service
|
173
|
+
entry.message = "Created client for #{entry.service}"
|
174
|
+
entry.set_credentials_fields credentials
|
175
|
+
entry.set "customEndpoint", @config.endpoint if @config.endpoint
|
176
|
+
entry.set "defaultTimeout", @config.timeout if @config.timeout
|
177
|
+
entry.set "quotaProject", @quota_project_id if @quota_project_id
|
178
|
+
end
|
179
|
+
|
169
180
|
@location_client = Google::Cloud::Location::Locations::Client.new do |config|
|
170
181
|
config.credentials = credentials
|
171
182
|
config.quota_project = @quota_project_id
|
172
183
|
config.endpoint = @recommendation_service_stub.endpoint
|
173
184
|
config.universe_domain = @recommendation_service_stub.universe_domain
|
185
|
+
config.logger = @recommendation_service_stub.logger if config.respond_to? :logger=
|
174
186
|
end
|
175
187
|
end
|
176
188
|
|
@@ -181,6 +193,15 @@ module Google
|
|
181
193
|
#
|
182
194
|
attr_reader :location_client
|
183
195
|
|
196
|
+
##
|
197
|
+
# The logger used for request/response debug logging.
|
198
|
+
#
|
199
|
+
# @return [Logger]
|
200
|
+
#
|
201
|
+
def logger
|
202
|
+
@recommendation_service_stub.logger
|
203
|
+
end
|
204
|
+
|
184
205
|
# Service calls
|
185
206
|
|
186
207
|
##
|
@@ -377,7 +398,6 @@ module Google
|
|
377
398
|
|
378
399
|
@recommendation_service_stub.call_rpc :recommend, request, options: options do |response, operation|
|
379
400
|
yield response, operation if block_given?
|
380
|
-
return response
|
381
401
|
end
|
382
402
|
rescue ::GRPC::BadStatus => e
|
383
403
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -466,6 +486,11 @@ module Google
|
|
466
486
|
# default endpoint URL. The default value of nil uses the environment
|
467
487
|
# universe (usually the default "googleapis.com" universe).
|
468
488
|
# @return [::String,nil]
|
489
|
+
# @!attribute [rw] logger
|
490
|
+
# A custom logger to use for request/response debug logging, or the value
|
491
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
492
|
+
# explicitly disable logging.
|
493
|
+
# @return [::Logger,:default,nil]
|
469
494
|
#
|
470
495
|
class Configuration
|
471
496
|
extend ::Gapic::Config
|
@@ -490,6 +515,7 @@ module Google
|
|
490
515
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
491
516
|
config_attr :quota_project, nil, ::String, nil
|
492
517
|
config_attr :universe_domain, nil, ::String, nil
|
518
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
493
519
|
|
494
520
|
# @private
|
495
521
|
def initialize parent_config = nil
|
@@ -156,14 +156,26 @@ module Google
|
|
156
156
|
endpoint: @config.endpoint,
|
157
157
|
endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
|
158
158
|
universe_domain: @config.universe_domain,
|
159
|
-
credentials: credentials
|
159
|
+
credentials: credentials,
|
160
|
+
logger: @config.logger
|
160
161
|
)
|
161
162
|
|
163
|
+
@recommendation_service_stub.logger(stub: true)&.info do |entry|
|
164
|
+
entry.set_system_name
|
165
|
+
entry.set_service
|
166
|
+
entry.message = "Created client for #{entry.service}"
|
167
|
+
entry.set_credentials_fields credentials
|
168
|
+
entry.set "customEndpoint", @config.endpoint if @config.endpoint
|
169
|
+
entry.set "defaultTimeout", @config.timeout if @config.timeout
|
170
|
+
entry.set "quotaProject", @quota_project_id if @quota_project_id
|
171
|
+
end
|
172
|
+
|
162
173
|
@location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
|
163
174
|
config.credentials = credentials
|
164
175
|
config.quota_project = @quota_project_id
|
165
176
|
config.endpoint = @recommendation_service_stub.endpoint
|
166
177
|
config.universe_domain = @recommendation_service_stub.universe_domain
|
178
|
+
config.logger = @recommendation_service_stub.logger if config.respond_to? :logger=
|
167
179
|
end
|
168
180
|
end
|
169
181
|
|
@@ -174,6 +186,15 @@ module Google
|
|
174
186
|
#
|
175
187
|
attr_reader :location_client
|
176
188
|
|
189
|
+
##
|
190
|
+
# The logger used for request/response debug logging.
|
191
|
+
#
|
192
|
+
# @return [Logger]
|
193
|
+
#
|
194
|
+
def logger
|
195
|
+
@recommendation_service_stub.logger
|
196
|
+
end
|
197
|
+
|
177
198
|
# Service calls
|
178
199
|
|
179
200
|
##
|
@@ -363,7 +384,6 @@ module Google
|
|
363
384
|
|
364
385
|
@recommendation_service_stub.recommend request, options do |result, operation|
|
365
386
|
yield result, operation if block_given?
|
366
|
-
return result
|
367
387
|
end
|
368
388
|
rescue ::Gapic::Rest::Error => e
|
369
389
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -443,6 +463,11 @@ module Google
|
|
443
463
|
# default endpoint URL. The default value of nil uses the environment
|
444
464
|
# universe (usually the default "googleapis.com" universe).
|
445
465
|
# @return [::String,nil]
|
466
|
+
# @!attribute [rw] logger
|
467
|
+
# A custom logger to use for request/response debug logging, or the value
|
468
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
469
|
+
# explicitly disable logging.
|
470
|
+
# @return [::Logger,:default,nil]
|
446
471
|
#
|
447
472
|
class Configuration
|
448
473
|
extend ::Gapic::Config
|
@@ -464,6 +489,7 @@ module Google
|
|
464
489
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
465
490
|
config_attr :quota_project, nil, ::String, nil
|
466
491
|
config_attr :universe_domain, nil, ::String, nil
|
492
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
467
493
|
|
468
494
|
# @private
|
469
495
|
def initialize parent_config = nil
|
@@ -30,7 +30,8 @@ module Google
|
|
30
30
|
# including transcoding, making the REST call, and deserialing the response.
|
31
31
|
#
|
32
32
|
class ServiceStub
|
33
|
-
|
33
|
+
# @private
|
34
|
+
def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
|
34
35
|
# These require statements are intentionally placed here to initialize
|
35
36
|
# the REST modules only when it's required.
|
36
37
|
require "gapic/rest"
|
@@ -40,7 +41,9 @@ module Google
|
|
40
41
|
universe_domain: universe_domain,
|
41
42
|
credentials: credentials,
|
42
43
|
numeric_enums: true,
|
43
|
-
|
44
|
+
service_name: self.class,
|
45
|
+
raise_faraday_errors: false,
|
46
|
+
logger: logger
|
44
47
|
end
|
45
48
|
|
46
49
|
##
|
@@ -61,6 +64,15 @@ module Google
|
|
61
64
|
@client_stub.endpoint
|
62
65
|
end
|
63
66
|
|
67
|
+
##
|
68
|
+
# The logger used for request/response debug logging.
|
69
|
+
#
|
70
|
+
# @return [Logger]
|
71
|
+
#
|
72
|
+
def logger stub: false
|
73
|
+
stub ? @client_stub.stub_logger : @client_stub.logger
|
74
|
+
end
|
75
|
+
|
64
76
|
##
|
65
77
|
# Baseline implementation for the recommend REST call
|
66
78
|
#
|
@@ -87,16 +99,18 @@ module Google
|
|
87
99
|
|
88
100
|
response = @client_stub.make_http_request(
|
89
101
|
verb,
|
90
|
-
uri:
|
91
|
-
body:
|
92
|
-
params:
|
102
|
+
uri: uri,
|
103
|
+
body: body || "",
|
104
|
+
params: query_string_params,
|
105
|
+
method_name: "recommend",
|
93
106
|
options: options
|
94
107
|
)
|
95
108
|
operation = ::Gapic::Rest::TransportOperation.new response
|
96
109
|
result = ::Google::Cloud::DiscoveryEngine::V1beta::RecommendResponse.decode_json response.body, ignore_unknown_fields: true
|
97
|
-
|
98
|
-
|
99
|
-
|
110
|
+
catch :response do
|
111
|
+
yield result, operation if block_given?
|
112
|
+
result
|
113
|
+
end
|
100
114
|
end
|
101
115
|
|
102
116
|
##
|
@@ -171,14 +171,26 @@ module Google
|
|
171
171
|
universe_domain: @config.universe_domain,
|
172
172
|
channel_args: @config.channel_args,
|
173
173
|
interceptors: @config.interceptors,
|
174
|
-
channel_pool_config: @config.channel_pool
|
174
|
+
channel_pool_config: @config.channel_pool,
|
175
|
+
logger: @config.logger
|
175
176
|
)
|
176
177
|
|
178
|
+
@sample_query_service_stub.stub_logger&.info do |entry|
|
179
|
+
entry.set_system_name
|
180
|
+
entry.set_service
|
181
|
+
entry.message = "Created client for #{entry.service}"
|
182
|
+
entry.set_credentials_fields credentials
|
183
|
+
entry.set "customEndpoint", @config.endpoint if @config.endpoint
|
184
|
+
entry.set "defaultTimeout", @config.timeout if @config.timeout
|
185
|
+
entry.set "quotaProject", @quota_project_id if @quota_project_id
|
186
|
+
end
|
187
|
+
|
177
188
|
@location_client = Google::Cloud::Location::Locations::Client.new do |config|
|
178
189
|
config.credentials = credentials
|
179
190
|
config.quota_project = @quota_project_id
|
180
191
|
config.endpoint = @sample_query_service_stub.endpoint
|
181
192
|
config.universe_domain = @sample_query_service_stub.universe_domain
|
193
|
+
config.logger = @sample_query_service_stub.logger if config.respond_to? :logger=
|
182
194
|
end
|
183
195
|
end
|
184
196
|
|
@@ -196,6 +208,15 @@ module Google
|
|
196
208
|
#
|
197
209
|
attr_reader :location_client
|
198
210
|
|
211
|
+
##
|
212
|
+
# The logger used for request/response debug logging.
|
213
|
+
#
|
214
|
+
# @return [Logger]
|
215
|
+
#
|
216
|
+
def logger
|
217
|
+
@sample_query_service_stub.logger
|
218
|
+
end
|
219
|
+
|
199
220
|
# Service calls
|
200
221
|
|
201
222
|
##
|
@@ -288,7 +309,6 @@ module Google
|
|
288
309
|
|
289
310
|
@sample_query_service_stub.call_rpc :get_sample_query, request, options: options do |response, operation|
|
290
311
|
yield response, operation if block_given?
|
291
|
-
return response
|
292
312
|
end
|
293
313
|
rescue ::GRPC::BadStatus => e
|
294
314
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -404,7 +424,7 @@ module Google
|
|
404
424
|
@sample_query_service_stub.call_rpc :list_sample_queries, request, options: options do |response, operation|
|
405
425
|
response = ::Gapic::PagedEnumerable.new @sample_query_service_stub, :list_sample_queries, request, response, operation, options
|
406
426
|
yield response, operation if block_given?
|
407
|
-
|
427
|
+
throw :response, response
|
408
428
|
end
|
409
429
|
rescue ::GRPC::BadStatus => e
|
410
430
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -513,7 +533,6 @@ module Google
|
|
513
533
|
|
514
534
|
@sample_query_service_stub.call_rpc :create_sample_query, request, options: options do |response, operation|
|
515
535
|
yield response, operation if block_given?
|
516
|
-
return response
|
517
536
|
end
|
518
537
|
rescue ::GRPC::BadStatus => e
|
519
538
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -609,7 +628,6 @@ module Google
|
|
609
628
|
|
610
629
|
@sample_query_service_stub.call_rpc :update_sample_query, request, options: options do |response, operation|
|
611
630
|
yield response, operation if block_given?
|
612
|
-
return response
|
613
631
|
end
|
614
632
|
rescue ::GRPC::BadStatus => e
|
615
633
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -704,7 +722,6 @@ module Google
|
|
704
722
|
|
705
723
|
@sample_query_service_stub.call_rpc :delete_sample_query, request, options: options do |response, operation|
|
706
724
|
yield response, operation if block_given?
|
707
|
-
return response
|
708
725
|
end
|
709
726
|
rescue ::GRPC::BadStatus => e
|
710
727
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -818,7 +835,7 @@ module Google
|
|
818
835
|
@sample_query_service_stub.call_rpc :import_sample_queries, request, options: options do |response, operation|
|
819
836
|
response = ::Gapic::Operation.new response, @operations_client, options: options
|
820
837
|
yield response, operation if block_given?
|
821
|
-
|
838
|
+
throw :response, response
|
822
839
|
end
|
823
840
|
rescue ::GRPC::BadStatus => e
|
824
841
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -907,6 +924,11 @@ module Google
|
|
907
924
|
# default endpoint URL. The default value of nil uses the environment
|
908
925
|
# universe (usually the default "googleapis.com" universe).
|
909
926
|
# @return [::String,nil]
|
927
|
+
# @!attribute [rw] logger
|
928
|
+
# A custom logger to use for request/response debug logging, or the value
|
929
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
930
|
+
# explicitly disable logging.
|
931
|
+
# @return [::Logger,:default,nil]
|
910
932
|
#
|
911
933
|
class Configuration
|
912
934
|
extend ::Gapic::Config
|
@@ -931,6 +953,7 @@ module Google
|
|
931
953
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
932
954
|
config_attr :quota_project, nil, ::String, nil
|
933
955
|
config_attr :universe_domain, nil, ::String, nil
|
956
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
934
957
|
|
935
958
|
# @private
|
936
959
|
def initialize parent_config = nil
|
@@ -124,14 +124,6 @@ module Google
|
|
124
124
|
# Lists operations that match the specified filter in the request. If the
|
125
125
|
# server doesn't support this method, it returns `UNIMPLEMENTED`.
|
126
126
|
#
|
127
|
-
# NOTE: the `name` binding allows API services to override the binding
|
128
|
-
# to use different resource name schemes, such as `users/*/operations`. To
|
129
|
-
# override the binding, API services can add a binding such as
|
130
|
-
# `"/v1/{name=users/*}/operations"` to their service configuration.
|
131
|
-
# For backwards compatibility, the default name includes the operations
|
132
|
-
# collection id, however overriding users must ensure the name binding
|
133
|
-
# is the parent resource, without the operations collection id.
|
134
|
-
#
|
135
127
|
# @overload list_operations(request, options = nil)
|
136
128
|
# Pass arguments to `list_operations` via a request object, either of type
|
137
129
|
# {::Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
|
@@ -221,7 +213,7 @@ module Google
|
|
221
213
|
wrap_lro_operation = ->(op_response) { ::Gapic::Operation.new op_response, @operations_client }
|
222
214
|
response = ::Gapic::PagedEnumerable.new @operations_stub, :list_operations, request, response, operation, options, format_resource: wrap_lro_operation
|
223
215
|
yield response, operation if block_given?
|
224
|
-
|
216
|
+
throw :response, response
|
225
217
|
end
|
226
218
|
rescue ::GRPC::BadStatus => e
|
227
219
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -317,7 +309,7 @@ module Google
|
|
317
309
|
@operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
|
318
310
|
response = ::Gapic::Operation.new response, @operations_client, options: options
|
319
311
|
yield response, operation if block_given?
|
320
|
-
|
312
|
+
throw :response, response
|
321
313
|
end
|
322
314
|
rescue ::GRPC::BadStatus => e
|
323
315
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -406,7 +398,6 @@ module Google
|
|
406
398
|
|
407
399
|
@operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
|
408
400
|
yield response, operation if block_given?
|
409
|
-
return response
|
410
401
|
end
|
411
402
|
rescue ::GRPC::BadStatus => e
|
412
403
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -421,8 +412,9 @@ module Google
|
|
421
412
|
# other methods to check whether the cancellation succeeded or whether the
|
422
413
|
# operation completed despite cancellation. On successful cancellation,
|
423
414
|
# the operation is not deleted; instead, it becomes an operation with
|
424
|
-
# an {::Google::Longrunning::Operation#error Operation.error} value with a
|
425
|
-
# corresponding to
|
415
|
+
# an {::Google::Longrunning::Operation#error Operation.error} value with a
|
416
|
+
# {::Google::Rpc::Status#code google.rpc.Status.code} of `1`, corresponding to
|
417
|
+
# `Code.CANCELLED`.
|
426
418
|
#
|
427
419
|
# @overload cancel_operation(request, options = nil)
|
428
420
|
# Pass arguments to `cancel_operation` via a request object, either of type
|
@@ -501,7 +493,6 @@ module Google
|
|
501
493
|
|
502
494
|
@operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
|
503
495
|
yield response, operation if block_given?
|
504
|
-
return response
|
505
496
|
end
|
506
497
|
rescue ::GRPC::BadStatus => e
|
507
498
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -599,7 +590,7 @@ module Google
|
|
599
590
|
@operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
|
600
591
|
response = ::Gapic::Operation.new response, @operations_client, options: options
|
601
592
|
yield response, operation if block_given?
|
602
|
-
|
593
|
+
throw :response, response
|
603
594
|
end
|
604
595
|
rescue ::GRPC::BadStatus => e
|
605
596
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -688,6 +679,11 @@ module Google
|
|
688
679
|
# default endpoint URL. The default value of nil uses the environment
|
689
680
|
# universe (usually the default "googleapis.com" universe).
|
690
681
|
# @return [::String,nil]
|
682
|
+
# @!attribute [rw] logger
|
683
|
+
# A custom logger to use for request/response debug logging, or the value
|
684
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
685
|
+
# explicitly disable logging.
|
686
|
+
# @return [::Logger,:default,nil]
|
691
687
|
#
|
692
688
|
class Configuration
|
693
689
|
extend ::Gapic::Config
|
@@ -712,6 +708,7 @@ module Google
|
|
712
708
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
713
709
|
config_attr :quota_project, nil, ::String, nil
|
714
710
|
config_attr :universe_domain, nil, ::String, nil
|
711
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
715
712
|
|
716
713
|
# @private
|
717
714
|
def initialize parent_config = nil
|
@@ -164,14 +164,26 @@ module Google
|
|
164
164
|
endpoint: @config.endpoint,
|
165
165
|
endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
|
166
166
|
universe_domain: @config.universe_domain,
|
167
|
-
credentials: credentials
|
167
|
+
credentials: credentials,
|
168
|
+
logger: @config.logger
|
168
169
|
)
|
169
170
|
|
171
|
+
@sample_query_service_stub.logger(stub: true)&.info do |entry|
|
172
|
+
entry.set_system_name
|
173
|
+
entry.set_service
|
174
|
+
entry.message = "Created client for #{entry.service}"
|
175
|
+
entry.set_credentials_fields credentials
|
176
|
+
entry.set "customEndpoint", @config.endpoint if @config.endpoint
|
177
|
+
entry.set "defaultTimeout", @config.timeout if @config.timeout
|
178
|
+
entry.set "quotaProject", @quota_project_id if @quota_project_id
|
179
|
+
end
|
180
|
+
|
170
181
|
@location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
|
171
182
|
config.credentials = credentials
|
172
183
|
config.quota_project = @quota_project_id
|
173
184
|
config.endpoint = @sample_query_service_stub.endpoint
|
174
185
|
config.universe_domain = @sample_query_service_stub.universe_domain
|
186
|
+
config.logger = @sample_query_service_stub.logger if config.respond_to? :logger=
|
175
187
|
end
|
176
188
|
end
|
177
189
|
|
@@ -189,6 +201,15 @@ module Google
|
|
189
201
|
#
|
190
202
|
attr_reader :location_client
|
191
203
|
|
204
|
+
##
|
205
|
+
# The logger used for request/response debug logging.
|
206
|
+
#
|
207
|
+
# @return [Logger]
|
208
|
+
#
|
209
|
+
def logger
|
210
|
+
@sample_query_service_stub.logger
|
211
|
+
end
|
212
|
+
|
192
213
|
# Service calls
|
193
214
|
|
194
215
|
##
|
@@ -274,7 +295,6 @@ module Google
|
|
274
295
|
|
275
296
|
@sample_query_service_stub.get_sample_query request, options do |result, operation|
|
276
297
|
yield result, operation if block_given?
|
277
|
-
return result
|
278
298
|
end
|
279
299
|
rescue ::Gapic::Rest::Error => e
|
280
300
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -383,7 +403,7 @@ module Google
|
|
383
403
|
@sample_query_service_stub.list_sample_queries request, options do |result, operation|
|
384
404
|
result = ::Gapic::Rest::PagedEnumerable.new @sample_query_service_stub, :list_sample_queries, "sample_queries", request, result, options
|
385
405
|
yield result, operation if block_given?
|
386
|
-
|
406
|
+
throw :response, result
|
387
407
|
end
|
388
408
|
rescue ::Gapic::Rest::Error => e
|
389
409
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -485,7 +505,6 @@ module Google
|
|
485
505
|
|
486
506
|
@sample_query_service_stub.create_sample_query request, options do |result, operation|
|
487
507
|
yield result, operation if block_given?
|
488
|
-
return result
|
489
508
|
end
|
490
509
|
rescue ::Gapic::Rest::Error => e
|
491
510
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -574,7 +593,6 @@ module Google
|
|
574
593
|
|
575
594
|
@sample_query_service_stub.update_sample_query request, options do |result, operation|
|
576
595
|
yield result, operation if block_given?
|
577
|
-
return result
|
578
596
|
end
|
579
597
|
rescue ::Gapic::Rest::Error => e
|
580
598
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -662,7 +680,6 @@ module Google
|
|
662
680
|
|
663
681
|
@sample_query_service_stub.delete_sample_query request, options do |result, operation|
|
664
682
|
yield result, operation if block_given?
|
665
|
-
return result
|
666
683
|
end
|
667
684
|
rescue ::Gapic::Rest::Error => e
|
668
685
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -769,7 +786,7 @@ module Google
|
|
769
786
|
@sample_query_service_stub.import_sample_queries request, options do |result, operation|
|
770
787
|
result = ::Gapic::Operation.new result, @operations_client, options: options
|
771
788
|
yield result, operation if block_given?
|
772
|
-
|
789
|
+
throw :response, result
|
773
790
|
end
|
774
791
|
rescue ::Gapic::Rest::Error => e
|
775
792
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -849,6 +866,11 @@ module Google
|
|
849
866
|
# default endpoint URL. The default value of nil uses the environment
|
850
867
|
# universe (usually the default "googleapis.com" universe).
|
851
868
|
# @return [::String,nil]
|
869
|
+
# @!attribute [rw] logger
|
870
|
+
# A custom logger to use for request/response debug logging, or the value
|
871
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
872
|
+
# explicitly disable logging.
|
873
|
+
# @return [::Logger,:default,nil]
|
852
874
|
#
|
853
875
|
class Configuration
|
854
876
|
extend ::Gapic::Config
|
@@ -870,6 +892,7 @@ module Google
|
|
870
892
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
871
893
|
config_attr :quota_project, nil, ::String, nil
|
872
894
|
config_attr :universe_domain, nil, ::String, nil
|
895
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
873
896
|
|
874
897
|
# @private
|
875
898
|
def initialize parent_config = nil
|