google-cloud-dialogflow-cx-v3 1.2.0 → 1.4.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 +4 -4
- data/README.md +31 -21
- data/lib/google/cloud/dialogflow/cx/v3/agents/client.rb +44 -12
- data/lib/google/cloud/dialogflow/cx/v3/agents/operations.rb +19 -15
- data/lib/google/cloud/dialogflow/cx/v3/agents/rest/client.rb +44 -12
- data/lib/google/cloud/dialogflow/cx/v3/agents/rest/operations.rb +50 -38
- data/lib/google/cloud/dialogflow/cx/v3/agents/rest/service_stub.rb +102 -68
- data/lib/google/cloud/dialogflow/cx/v3/changelogs/client.rb +36 -3
- data/lib/google/cloud/dialogflow/cx/v3/changelogs/rest/client.rb +36 -3
- data/lib/google/cloud/dialogflow/cx/v3/changelogs/rest/service_stub.rb +30 -14
- data/lib/google/cloud/dialogflow/cx/v3/deployments/client.rb +36 -3
- data/lib/google/cloud/dialogflow/cx/v3/deployments/rest/client.rb +36 -3
- data/lib/google/cloud/dialogflow/cx/v3/deployments/rest/service_stub.rb +30 -14
- data/lib/google/cloud/dialogflow/cx/v3/entity_types/client.rb +46 -8
- data/lib/google/cloud/dialogflow/cx/v3/entity_types/operations.rb +19 -15
- data/lib/google/cloud/dialogflow/cx/v3/entity_types/rest/client.rb +46 -8
- data/lib/google/cloud/dialogflow/cx/v3/entity_types/rest/operations.rb +50 -38
- data/lib/google/cloud/dialogflow/cx/v3/entity_types/rest/service_stub.rb +70 -44
- data/lib/google/cloud/dialogflow/cx/v3/environments/client.rb +42 -10
- data/lib/google/cloud/dialogflow/cx/v3/environments/operations.rb +19 -15
- data/lib/google/cloud/dialogflow/cx/v3/environments/rest/client.rb +42 -10
- data/lib/google/cloud/dialogflow/cx/v3/environments/rest/operations.rb +50 -38
- data/lib/google/cloud/dialogflow/cx/v3/environments/rest/service_stub.rb +86 -56
- data/lib/google/cloud/dialogflow/cx/v3/experiments/client.rb +36 -8
- data/lib/google/cloud/dialogflow/cx/v3/experiments/rest/client.rb +36 -8
- data/lib/google/cloud/dialogflow/cx/v3/experiments/rest/service_stub.rb +70 -44
- data/lib/google/cloud/dialogflow/cx/v3/flows/client.rb +43 -11
- data/lib/google/cloud/dialogflow/cx/v3/flows/operations.rb +19 -15
- data/lib/google/cloud/dialogflow/cx/v3/flows/rest/client.rb +43 -11
- data/lib/google/cloud/dialogflow/cx/v3/flows/rest/operations.rb +50 -38
- data/lib/google/cloud/dialogflow/cx/v3/flows/rest/service_stub.rb +94 -62
- data/lib/google/cloud/dialogflow/cx/v3/generators/client.rb +36 -6
- data/lib/google/cloud/dialogflow/cx/v3/generators/rest/client.rb +36 -6
- data/lib/google/cloud/dialogflow/cx/v3/generators/rest/service_stub.rb +54 -32
- data/lib/google/cloud/dialogflow/cx/v3/intents/client.rb +46 -8
- data/lib/google/cloud/dialogflow/cx/v3/intents/operations.rb +19 -15
- data/lib/google/cloud/dialogflow/cx/v3/intents/rest/client.rb +46 -8
- data/lib/google/cloud/dialogflow/cx/v3/intents/rest/operations.rb +50 -38
- data/lib/google/cloud/dialogflow/cx/v3/intents/rest/service_stub.rb +70 -44
- data/lib/google/cloud/dialogflow/cx/v3/pages/client.rb +36 -6
- data/lib/google/cloud/dialogflow/cx/v3/pages/rest/client.rb +36 -6
- data/lib/google/cloud/dialogflow/cx/v3/pages/rest/service_stub.rb +54 -32
- data/lib/google/cloud/dialogflow/cx/v3/security_settings_service/client.rb +36 -6
- data/lib/google/cloud/dialogflow/cx/v3/security_settings_service/rest/client.rb +36 -6
- data/lib/google/cloud/dialogflow/cx/v3/security_settings_service/rest/service_stub.rb +54 -32
- data/lib/google/cloud/dialogflow/cx/v3/session_entity_types/client.rb +36 -6
- data/lib/google/cloud/dialogflow/cx/v3/session_entity_types/rest/client.rb +36 -6
- data/lib/google/cloud/dialogflow/cx/v3/session_entity_types/rest/service_stub.rb +54 -32
- data/lib/google/cloud/dialogflow/cx/v3/sessions/client.rb +35 -7
- data/lib/google/cloud/dialogflow/cx/v3/sessions/rest/client.rb +35 -5
- data/lib/google/cloud/dialogflow/cx/v3/sessions/rest/service_stub.rb +47 -26
- data/lib/google/cloud/dialogflow/cx/v3/test_cases/client.rb +45 -13
- data/lib/google/cloud/dialogflow/cx/v3/test_cases/operations.rb +19 -15
- data/lib/google/cloud/dialogflow/cx/v3/test_cases/rest/client.rb +45 -13
- data/lib/google/cloud/dialogflow/cx/v3/test_cases/rest/operations.rb +50 -38
- data/lib/google/cloud/dialogflow/cx/v3/test_cases/rest/service_stub.rb +110 -74
- data/lib/google/cloud/dialogflow/cx/v3/transition_route_groups/client.rb +36 -6
- data/lib/google/cloud/dialogflow/cx/v3/transition_route_groups/rest/client.rb +36 -6
- data/lib/google/cloud/dialogflow/cx/v3/transition_route_groups/rest/service_stub.rb +54 -32
- data/lib/google/cloud/dialogflow/cx/v3/version.rb +1 -1
- data/lib/google/cloud/dialogflow/cx/v3/versions/client.rb +38 -8
- data/lib/google/cloud/dialogflow/cx/v3/versions/operations.rb +19 -15
- data/lib/google/cloud/dialogflow/cx/v3/versions/rest/client.rb +38 -8
- data/lib/google/cloud/dialogflow/cx/v3/versions/rest/operations.rb +50 -38
- data/lib/google/cloud/dialogflow/cx/v3/versions/rest/service_stub.rb +70 -44
- data/lib/google/cloud/dialogflow/cx/v3/webhooks/client.rb +36 -6
- data/lib/google/cloud/dialogflow/cx/v3/webhooks/rest/client.rb +36 -6
- data/lib/google/cloud/dialogflow/cx/v3/webhooks/rest/service_stub.rb +54 -32
- data/proto_docs/google/api/client.rb +19 -0
- data/proto_docs/google/cloud/dialogflow/cx/v3/agent.rb +12 -0
- data/proto_docs/google/cloud/dialogflow/cx/v3/entity_type.rb +12 -0
- data/proto_docs/google/cloud/dialogflow/cx/v3/experiment.rb +4 -0
- data/proto_docs/google/cloud/dialogflow/cx/v3/flow.rb +8 -0
- data/proto_docs/google/cloud/dialogflow/cx/v3/fulfillment.rb +4 -0
- data/proto_docs/google/cloud/dialogflow/cx/v3/intent.rb +12 -0
- data/proto_docs/google/cloud/dialogflow/cx/v3/page.rb +12 -0
- data/proto_docs/google/cloud/dialogflow/cx/v3/response_message.rb +28 -0
- data/proto_docs/google/cloud/dialogflow/cx/v3/security_settings.rb +4 -0
- data/proto_docs/google/cloud/dialogflow/cx/v3/session.rb +32 -0
- data/proto_docs/google/cloud/dialogflow/cx/v3/test_case.rb +22 -0
- data/proto_docs/google/cloud/dialogflow/cx/v3/webhook.rb +18 -0
- data/proto_docs/google/longrunning/operations.rb +23 -14
- data/proto_docs/google/protobuf/struct.rb +12 -0
- metadata +6 -9
@@ -125,14 +125,6 @@ module Google
|
|
125
125
|
# Lists operations that match the specified filter in the request. If the
|
126
126
|
# server doesn't support this method, it returns `UNIMPLEMENTED`.
|
127
127
|
#
|
128
|
-
# NOTE: the `name` binding allows API services to override the binding
|
129
|
-
# to use different resource name schemes, such as `users/*/operations`. To
|
130
|
-
# override the binding, API services can add a binding such as
|
131
|
-
# `"/v1/{name=users/*}/operations"` to their service configuration.
|
132
|
-
# For backwards compatibility, the default name includes the operations
|
133
|
-
# collection id, however overriding users must ensure the name binding
|
134
|
-
# is the parent resource, without the operations collection id.
|
135
|
-
#
|
136
128
|
# @overload list_operations(request, options = nil)
|
137
129
|
# Pass arguments to `list_operations` via a request object, either of type
|
138
130
|
# {::Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
|
@@ -222,7 +214,7 @@ module Google
|
|
222
214
|
wrap_lro_operation = ->(op_response) { ::Gapic::Operation.new op_response, @operations_client }
|
223
215
|
response = ::Gapic::PagedEnumerable.new @operations_stub, :list_operations, request, response, operation, options, format_resource: wrap_lro_operation
|
224
216
|
yield response, operation if block_given?
|
225
|
-
|
217
|
+
throw :response, response
|
226
218
|
end
|
227
219
|
rescue ::GRPC::BadStatus => e
|
228
220
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -318,7 +310,7 @@ module Google
|
|
318
310
|
@operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
|
319
311
|
response = ::Gapic::Operation.new response, @operations_client, options: options
|
320
312
|
yield response, operation if block_given?
|
321
|
-
|
313
|
+
throw :response, response
|
322
314
|
end
|
323
315
|
rescue ::GRPC::BadStatus => e
|
324
316
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -407,7 +399,6 @@ module Google
|
|
407
399
|
|
408
400
|
@operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
|
409
401
|
yield response, operation if block_given?
|
410
|
-
return response
|
411
402
|
end
|
412
403
|
rescue ::GRPC::BadStatus => e
|
413
404
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -422,8 +413,9 @@ module Google
|
|
422
413
|
# other methods to check whether the cancellation succeeded or whether the
|
423
414
|
# operation completed despite cancellation. On successful cancellation,
|
424
415
|
# the operation is not deleted; instead, it becomes an operation with
|
425
|
-
# an {::Google::Longrunning::Operation#error Operation.error} value with a
|
426
|
-
# corresponding to
|
416
|
+
# an {::Google::Longrunning::Operation#error Operation.error} value with a
|
417
|
+
# {::Google::Rpc::Status#code google.rpc.Status.code} of `1`, corresponding to
|
418
|
+
# `Code.CANCELLED`.
|
427
419
|
#
|
428
420
|
# @overload cancel_operation(request, options = nil)
|
429
421
|
# Pass arguments to `cancel_operation` via a request object, either of type
|
@@ -502,7 +494,6 @@ module Google
|
|
502
494
|
|
503
495
|
@operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
|
504
496
|
yield response, operation if block_given?
|
505
|
-
return response
|
506
497
|
end
|
507
498
|
rescue ::GRPC::BadStatus => e
|
508
499
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -600,7 +591,7 @@ module Google
|
|
600
591
|
@operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
|
601
592
|
response = ::Gapic::Operation.new response, @operations_client, options: options
|
602
593
|
yield response, operation if block_given?
|
603
|
-
|
594
|
+
throw :response, response
|
604
595
|
end
|
605
596
|
rescue ::GRPC::BadStatus => e
|
606
597
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -650,6 +641,13 @@ module Google
|
|
650
641
|
# * (`GRPC::Core::Channel`) a gRPC channel with included credentials
|
651
642
|
# * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
|
652
643
|
# * (`nil`) indicating no credentials
|
644
|
+
#
|
645
|
+
# Warning: If you accept a credential configuration (JSON file or Hash) from an
|
646
|
+
# external source for authentication to Google Cloud, you must validate it before
|
647
|
+
# providing it to a Google API client library. Providing an unvalidated credential
|
648
|
+
# configuration to Google APIs can compromise the security of your systems and data.
|
649
|
+
# For more information, refer to [Validate credential configurations from external
|
650
|
+
# sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
|
653
651
|
# @return [::Object]
|
654
652
|
# @!attribute [rw] scope
|
655
653
|
# The OAuth scopes
|
@@ -689,6 +687,11 @@ module Google
|
|
689
687
|
# default endpoint URL. The default value of nil uses the environment
|
690
688
|
# universe (usually the default "googleapis.com" universe).
|
691
689
|
# @return [::String,nil]
|
690
|
+
# @!attribute [rw] logger
|
691
|
+
# A custom logger to use for request/response debug logging, or the value
|
692
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
693
|
+
# explicitly disable logging.
|
694
|
+
# @return [::Logger,:default,nil]
|
692
695
|
#
|
693
696
|
class Configuration
|
694
697
|
extend ::Gapic::Config
|
@@ -713,6 +716,7 @@ module Google
|
|
713
716
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
714
717
|
config_attr :quota_project, nil, ::String, nil
|
715
718
|
config_attr :universe_domain, nil, ::String, nil
|
719
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
716
720
|
|
717
721
|
# @private
|
718
722
|
def initialize parent_config = nil
|
@@ -164,15 +164,27 @@ 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
|
+
@entity_types_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 = @entity_types_stub.endpoint
|
174
185
|
config.universe_domain = @entity_types_stub.universe_domain
|
175
186
|
config.bindings_override = @config.bindings_override
|
187
|
+
config.logger = @entity_types_stub.logger if config.respond_to? :logger=
|
176
188
|
end
|
177
189
|
end
|
178
190
|
|
@@ -190,6 +202,15 @@ module Google
|
|
190
202
|
#
|
191
203
|
attr_reader :location_client
|
192
204
|
|
205
|
+
##
|
206
|
+
# The logger used for request/response debug logging.
|
207
|
+
#
|
208
|
+
# @return [Logger]
|
209
|
+
#
|
210
|
+
def logger
|
211
|
+
@entity_types_stub.logger
|
212
|
+
end
|
213
|
+
|
193
214
|
# Service calls
|
194
215
|
|
195
216
|
##
|
@@ -280,7 +301,6 @@ module Google
|
|
280
301
|
|
281
302
|
@entity_types_stub.get_entity_type request, options do |result, operation|
|
282
303
|
yield result, operation if block_given?
|
283
|
-
return result
|
284
304
|
end
|
285
305
|
rescue ::Gapic::Rest::Error => e
|
286
306
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -378,7 +398,6 @@ module Google
|
|
378
398
|
|
379
399
|
@entity_types_stub.create_entity_type request, options do |result, operation|
|
380
400
|
yield result, operation if block_given?
|
381
|
-
return result
|
382
401
|
end
|
383
402
|
rescue ::Gapic::Rest::Error => e
|
384
403
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -475,7 +494,6 @@ module Google
|
|
475
494
|
|
476
495
|
@entity_types_stub.update_entity_type request, options do |result, operation|
|
477
496
|
yield result, operation if block_given?
|
478
|
-
return result
|
479
497
|
end
|
480
498
|
rescue ::Gapic::Rest::Error => e
|
481
499
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -573,7 +591,6 @@ module Google
|
|
573
591
|
|
574
592
|
@entity_types_stub.delete_entity_type request, options do |result, operation|
|
575
593
|
yield result, operation if block_given?
|
576
|
-
return result
|
577
594
|
end
|
578
595
|
rescue ::Gapic::Rest::Error => e
|
579
596
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -676,7 +693,7 @@ module Google
|
|
676
693
|
@entity_types_stub.list_entity_types request, options do |result, operation|
|
677
694
|
result = ::Gapic::Rest::PagedEnumerable.new @entity_types_stub, :list_entity_types, "entity_types", request, result, options
|
678
695
|
yield result, operation if block_given?
|
679
|
-
|
696
|
+
throw :response, result
|
680
697
|
end
|
681
698
|
rescue ::Gapic::Rest::Error => e
|
682
699
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -718,8 +735,12 @@ module Google
|
|
718
735
|
# have write permissions for the object. For more information, see
|
719
736
|
# [Dialogflow access
|
720
737
|
# control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
|
738
|
+
#
|
739
|
+
# Note: The following fields are mutually exclusive: `entity_types_uri`, `entity_types_content_inline`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
721
740
|
# @param entity_types_content_inline [::Boolean]
|
722
741
|
# Optional. The option to return the serialized entity types inline.
|
742
|
+
#
|
743
|
+
# Note: The following fields are mutually exclusive: `entity_types_content_inline`, `entity_types_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
723
744
|
# @param data_format [::Google::Cloud::Dialogflow::CX::V3::ExportEntityTypesRequest::DataFormat]
|
724
745
|
# Optional. The data format of the exported entity types. If not specified,
|
725
746
|
# `BLOB` is assumed.
|
@@ -797,7 +818,7 @@ module Google
|
|
797
818
|
@entity_types_stub.export_entity_types request, options do |result, operation|
|
798
819
|
result = ::Gapic::Operation.new result, @operations_client, options: options
|
799
820
|
yield result, operation if block_given?
|
800
|
-
|
821
|
+
throw :response, result
|
801
822
|
end
|
802
823
|
rescue ::Gapic::Rest::Error => e
|
803
824
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -834,8 +855,12 @@ module Google
|
|
834
855
|
# have read permissions for the object. For more information, see
|
835
856
|
# [Dialogflow access
|
836
857
|
# control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
|
858
|
+
#
|
859
|
+
# Note: The following fields are mutually exclusive: `entity_types_uri`, `entity_types_content`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
837
860
|
# @param entity_types_content [::Google::Cloud::Dialogflow::CX::V3::InlineSource, ::Hash]
|
838
861
|
# Uncompressed byte content of entity types.
|
862
|
+
#
|
863
|
+
# Note: The following fields are mutually exclusive: `entity_types_content`, `entity_types_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
839
864
|
# @param merge_option [::Google::Cloud::Dialogflow::CX::V3::ImportEntityTypesRequest::MergeOption]
|
840
865
|
# Required. Merge option for importing entity types.
|
841
866
|
# @param target_entity_type [::String]
|
@@ -908,7 +933,7 @@ module Google
|
|
908
933
|
@entity_types_stub.import_entity_types request, options do |result, operation|
|
909
934
|
result = ::Gapic::Operation.new result, @operations_client, options: options
|
910
935
|
yield result, operation if block_given?
|
911
|
-
|
936
|
+
throw :response, result
|
912
937
|
end
|
913
938
|
rescue ::Gapic::Rest::Error => e
|
914
939
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -956,6 +981,13 @@ module Google
|
|
956
981
|
# * (`Signet::OAuth2::Client`) A signet oauth2 client object
|
957
982
|
# (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
|
958
983
|
# * (`nil`) indicating no credentials
|
984
|
+
#
|
985
|
+
# Warning: If you accept a credential configuration (JSON file or Hash) from an
|
986
|
+
# external source for authentication to Google Cloud, you must validate it before
|
987
|
+
# providing it to a Google API client library. Providing an unvalidated credential
|
988
|
+
# configuration to Google APIs can compromise the security of your systems and data.
|
989
|
+
# For more information, refer to [Validate credential configurations from external
|
990
|
+
# sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
|
959
991
|
# @return [::Object]
|
960
992
|
# @!attribute [rw] scope
|
961
993
|
# The OAuth scopes
|
@@ -988,6 +1020,11 @@ module Google
|
|
988
1020
|
# default endpoint URL. The default value of nil uses the environment
|
989
1021
|
# universe (usually the default "googleapis.com" universe).
|
990
1022
|
# @return [::String,nil]
|
1023
|
+
# @!attribute [rw] logger
|
1024
|
+
# A custom logger to use for request/response debug logging, or the value
|
1025
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
1026
|
+
# explicitly disable logging.
|
1027
|
+
# @return [::Logger,:default,nil]
|
991
1028
|
#
|
992
1029
|
class Configuration
|
993
1030
|
extend ::Gapic::Config
|
@@ -1016,6 +1053,7 @@ module Google
|
|
1016
1053
|
# by the host service.
|
1017
1054
|
# @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
|
1018
1055
|
config_attr :bindings_override, {}, ::Hash, nil
|
1056
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
1019
1057
|
|
1020
1058
|
# @private
|
1021
1059
|
def initialize parent_config = nil
|
@@ -116,14 +116,6 @@ module Google
|
|
116
116
|
# Lists operations that match the specified filter in the request. If the
|
117
117
|
# server doesn't support this method, it returns `UNIMPLEMENTED`.
|
118
118
|
#
|
119
|
-
# NOTE: the `name` binding allows API services to override the binding
|
120
|
-
# to use different resource name schemes, such as `users/*/operations`. To
|
121
|
-
# override the binding, API services can add a binding such as
|
122
|
-
# `"/v1/{name=users/*}/operations"` to their service configuration.
|
123
|
-
# For backwards compatibility, the default name includes the operations
|
124
|
-
# collection id, however overriding users must ensure the name binding
|
125
|
-
# is the parent resource, without the operations collection id.
|
126
|
-
#
|
127
119
|
# @overload list_operations(request, options = nil)
|
128
120
|
# Pass arguments to `list_operations` via a request object, either of type
|
129
121
|
# {::Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
|
@@ -205,7 +197,7 @@ module Google
|
|
205
197
|
@operations_stub.list_operations request, options do |result, operation|
|
206
198
|
result = ::Gapic::Rest::PagedEnumerable.new @operations_stub, :list_operations, "operations", request, result, options
|
207
199
|
yield result, operation if block_given?
|
208
|
-
|
200
|
+
throw :response, result
|
209
201
|
end
|
210
202
|
rescue ::Gapic::Rest::Error => e
|
211
203
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -294,7 +286,7 @@ module Google
|
|
294
286
|
@operations_stub.get_operation request, options do |result, operation|
|
295
287
|
result = ::Gapic::Operation.new result, @operations_client, options: options
|
296
288
|
yield result, operation if block_given?
|
297
|
-
|
289
|
+
throw :response, result
|
298
290
|
end
|
299
291
|
rescue ::Gapic::Rest::Error => e
|
300
292
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -376,7 +368,6 @@ module Google
|
|
376
368
|
|
377
369
|
@operations_stub.delete_operation request, options do |result, operation|
|
378
370
|
yield result, operation if block_given?
|
379
|
-
return result
|
380
371
|
end
|
381
372
|
rescue ::Gapic::Rest::Error => e
|
382
373
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -391,8 +382,9 @@ module Google
|
|
391
382
|
# other methods to check whether the cancellation succeeded or whether the
|
392
383
|
# operation completed despite cancellation. On successful cancellation,
|
393
384
|
# the operation is not deleted; instead, it becomes an operation with
|
394
|
-
# an {::Google::Longrunning::Operation#error Operation.error} value with a
|
395
|
-
# corresponding to
|
385
|
+
# an {::Google::Longrunning::Operation#error Operation.error} value with a
|
386
|
+
# {::Google::Rpc::Status#code google.rpc.Status.code} of `1`, corresponding to
|
387
|
+
# `Code.CANCELLED`.
|
396
388
|
#
|
397
389
|
# @overload cancel_operation(request, options = nil)
|
398
390
|
# Pass arguments to `cancel_operation` via a request object, either of type
|
@@ -464,7 +456,6 @@ module Google
|
|
464
456
|
|
465
457
|
@operations_stub.cancel_operation request, options do |result, operation|
|
466
458
|
yield result, operation if block_given?
|
467
|
-
return result
|
468
459
|
end
|
469
460
|
rescue ::Gapic::Rest::Error => e
|
470
461
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -512,6 +503,13 @@ module Google
|
|
512
503
|
# * (`Signet::OAuth2::Client`) A signet oauth2 client object
|
513
504
|
# (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
|
514
505
|
# * (`nil`) indicating no credentials
|
506
|
+
#
|
507
|
+
# Warning: If you accept a credential configuration (JSON file or Hash) from an
|
508
|
+
# external source for authentication to Google Cloud, you must validate it before
|
509
|
+
# providing it to a Google API client library. Providing an unvalidated credential
|
510
|
+
# configuration to Google APIs can compromise the security of your systems and data.
|
511
|
+
# For more information, refer to [Validate credential configurations from external
|
512
|
+
# sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
|
515
513
|
# @return [::Object]
|
516
514
|
# @!attribute [rw] scope
|
517
515
|
# The OAuth scopes
|
@@ -544,6 +542,11 @@ module Google
|
|
544
542
|
# default endpoint URL. The default value of nil uses the environment
|
545
543
|
# universe (usually the default "googleapis.com" universe).
|
546
544
|
# @return [::String,nil]
|
545
|
+
# @!attribute [rw] logger
|
546
|
+
# A custom logger to use for request/response debug logging, or the value
|
547
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
548
|
+
# explicitly disable logging.
|
549
|
+
# @return [::Logger,:default,nil]
|
547
550
|
#
|
548
551
|
class Configuration
|
549
552
|
extend ::Gapic::Config
|
@@ -565,6 +568,7 @@ module Google
|
|
565
568
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
566
569
|
config_attr :quota_project, nil, ::String, nil
|
567
570
|
config_attr :universe_domain, nil, ::String, nil
|
571
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
568
572
|
|
569
573
|
# @private
|
570
574
|
def initialize parent_config = nil
|
@@ -684,16 +688,18 @@ module Google
|
|
684
688
|
|
685
689
|
response = @client_stub.make_http_request(
|
686
690
|
verb,
|
687
|
-
uri:
|
688
|
-
body:
|
689
|
-
params:
|
691
|
+
uri: uri,
|
692
|
+
body: body || "",
|
693
|
+
params: query_string_params,
|
694
|
+
method_name: "list_operations",
|
690
695
|
options: options
|
691
696
|
)
|
692
697
|
operation = ::Gapic::Rest::TransportOperation.new response
|
693
698
|
result = ::Google::Longrunning::ListOperationsResponse.decode_json response.body, ignore_unknown_fields: true
|
694
|
-
|
695
|
-
|
696
|
-
|
699
|
+
catch :response do
|
700
|
+
yield result, operation if block_given?
|
701
|
+
result
|
702
|
+
end
|
697
703
|
end
|
698
704
|
|
699
705
|
##
|
@@ -722,16 +728,18 @@ module Google
|
|
722
728
|
|
723
729
|
response = @client_stub.make_http_request(
|
724
730
|
verb,
|
725
|
-
uri:
|
726
|
-
body:
|
727
|
-
params:
|
731
|
+
uri: uri,
|
732
|
+
body: body || "",
|
733
|
+
params: query_string_params,
|
734
|
+
method_name: "get_operation",
|
728
735
|
options: options
|
729
736
|
)
|
730
737
|
operation = ::Gapic::Rest::TransportOperation.new response
|
731
738
|
result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
|
732
|
-
|
733
|
-
|
734
|
-
|
739
|
+
catch :response do
|
740
|
+
yield result, operation if block_given?
|
741
|
+
result
|
742
|
+
end
|
735
743
|
end
|
736
744
|
|
737
745
|
##
|
@@ -760,16 +768,18 @@ module Google
|
|
760
768
|
|
761
769
|
response = @client_stub.make_http_request(
|
762
770
|
verb,
|
763
|
-
uri:
|
764
|
-
body:
|
765
|
-
params:
|
771
|
+
uri: uri,
|
772
|
+
body: body || "",
|
773
|
+
params: query_string_params,
|
774
|
+
method_name: "delete_operation",
|
766
775
|
options: options
|
767
776
|
)
|
768
777
|
operation = ::Gapic::Rest::TransportOperation.new response
|
769
778
|
result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
|
770
|
-
|
771
|
-
|
772
|
-
|
779
|
+
catch :response do
|
780
|
+
yield result, operation if block_given?
|
781
|
+
result
|
782
|
+
end
|
773
783
|
end
|
774
784
|
|
775
785
|
##
|
@@ -798,16 +808,18 @@ module Google
|
|
798
808
|
|
799
809
|
response = @client_stub.make_http_request(
|
800
810
|
verb,
|
801
|
-
uri:
|
802
|
-
body:
|
803
|
-
params:
|
811
|
+
uri: uri,
|
812
|
+
body: body || "",
|
813
|
+
params: query_string_params,
|
814
|
+
method_name: "cancel_operation",
|
804
815
|
options: options
|
805
816
|
)
|
806
817
|
operation = ::Gapic::Rest::TransportOperation.new response
|
807
818
|
result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
|
808
|
-
|
809
|
-
|
810
|
-
|
819
|
+
catch :response do
|
820
|
+
yield result, operation if block_given?
|
821
|
+
result
|
822
|
+
end
|
811
823
|
end
|
812
824
|
|
813
825
|
##
|
@@ -31,7 +31,8 @@ module Google
|
|
31
31
|
# including transcoding, making the REST call, and deserialing the response.
|
32
32
|
#
|
33
33
|
class ServiceStub
|
34
|
-
|
34
|
+
# @private
|
35
|
+
def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
|
35
36
|
# These require statements are intentionally placed here to initialize
|
36
37
|
# the REST modules only when it's required.
|
37
38
|
require "gapic/rest"
|
@@ -41,7 +42,9 @@ module Google
|
|
41
42
|
universe_domain: universe_domain,
|
42
43
|
credentials: credentials,
|
43
44
|
numeric_enums: true,
|
44
|
-
|
45
|
+
service_name: self.class,
|
46
|
+
raise_faraday_errors: false,
|
47
|
+
logger: logger
|
45
48
|
end
|
46
49
|
|
47
50
|
##
|
@@ -62,6 +65,15 @@ module Google
|
|
62
65
|
@client_stub.endpoint
|
63
66
|
end
|
64
67
|
|
68
|
+
##
|
69
|
+
# The logger used for request/response debug logging.
|
70
|
+
#
|
71
|
+
# @return [Logger]
|
72
|
+
#
|
73
|
+
def logger stub: false
|
74
|
+
stub ? @client_stub.stub_logger : @client_stub.logger
|
75
|
+
end
|
76
|
+
|
65
77
|
##
|
66
78
|
# Baseline implementation for the get_entity_type REST call
|
67
79
|
#
|
@@ -88,16 +100,18 @@ module Google
|
|
88
100
|
|
89
101
|
response = @client_stub.make_http_request(
|
90
102
|
verb,
|
91
|
-
uri:
|
92
|
-
body:
|
93
|
-
params:
|
103
|
+
uri: uri,
|
104
|
+
body: body || "",
|
105
|
+
params: query_string_params,
|
106
|
+
method_name: "get_entity_type",
|
94
107
|
options: options
|
95
108
|
)
|
96
109
|
operation = ::Gapic::Rest::TransportOperation.new response
|
97
110
|
result = ::Google::Cloud::Dialogflow::CX::V3::EntityType.decode_json response.body, ignore_unknown_fields: true
|
98
|
-
|
99
|
-
|
100
|
-
|
111
|
+
catch :response do
|
112
|
+
yield result, operation if block_given?
|
113
|
+
result
|
114
|
+
end
|
101
115
|
end
|
102
116
|
|
103
117
|
##
|
@@ -126,16 +140,18 @@ module Google
|
|
126
140
|
|
127
141
|
response = @client_stub.make_http_request(
|
128
142
|
verb,
|
129
|
-
uri:
|
130
|
-
body:
|
131
|
-
params:
|
143
|
+
uri: uri,
|
144
|
+
body: body || "",
|
145
|
+
params: query_string_params,
|
146
|
+
method_name: "create_entity_type",
|
132
147
|
options: options
|
133
148
|
)
|
134
149
|
operation = ::Gapic::Rest::TransportOperation.new response
|
135
150
|
result = ::Google::Cloud::Dialogflow::CX::V3::EntityType.decode_json response.body, ignore_unknown_fields: true
|
136
|
-
|
137
|
-
|
138
|
-
|
151
|
+
catch :response do
|
152
|
+
yield result, operation if block_given?
|
153
|
+
result
|
154
|
+
end
|
139
155
|
end
|
140
156
|
|
141
157
|
##
|
@@ -164,16 +180,18 @@ module Google
|
|
164
180
|
|
165
181
|
response = @client_stub.make_http_request(
|
166
182
|
verb,
|
167
|
-
uri:
|
168
|
-
body:
|
169
|
-
params:
|
183
|
+
uri: uri,
|
184
|
+
body: body || "",
|
185
|
+
params: query_string_params,
|
186
|
+
method_name: "update_entity_type",
|
170
187
|
options: options
|
171
188
|
)
|
172
189
|
operation = ::Gapic::Rest::TransportOperation.new response
|
173
190
|
result = ::Google::Cloud::Dialogflow::CX::V3::EntityType.decode_json response.body, ignore_unknown_fields: true
|
174
|
-
|
175
|
-
|
176
|
-
|
191
|
+
catch :response do
|
192
|
+
yield result, operation if block_given?
|
193
|
+
result
|
194
|
+
end
|
177
195
|
end
|
178
196
|
|
179
197
|
##
|
@@ -202,16 +220,18 @@ module Google
|
|
202
220
|
|
203
221
|
response = @client_stub.make_http_request(
|
204
222
|
verb,
|
205
|
-
uri:
|
206
|
-
body:
|
207
|
-
params:
|
223
|
+
uri: uri,
|
224
|
+
body: body || "",
|
225
|
+
params: query_string_params,
|
226
|
+
method_name: "delete_entity_type",
|
208
227
|
options: options
|
209
228
|
)
|
210
229
|
operation = ::Gapic::Rest::TransportOperation.new response
|
211
230
|
result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
|
212
|
-
|
213
|
-
|
214
|
-
|
231
|
+
catch :response do
|
232
|
+
yield result, operation if block_given?
|
233
|
+
result
|
234
|
+
end
|
215
235
|
end
|
216
236
|
|
217
237
|
##
|
@@ -240,16 +260,18 @@ module Google
|
|
240
260
|
|
241
261
|
response = @client_stub.make_http_request(
|
242
262
|
verb,
|
243
|
-
uri:
|
244
|
-
body:
|
245
|
-
params:
|
263
|
+
uri: uri,
|
264
|
+
body: body || "",
|
265
|
+
params: query_string_params,
|
266
|
+
method_name: "list_entity_types",
|
246
267
|
options: options
|
247
268
|
)
|
248
269
|
operation = ::Gapic::Rest::TransportOperation.new response
|
249
270
|
result = ::Google::Cloud::Dialogflow::CX::V3::ListEntityTypesResponse.decode_json response.body, ignore_unknown_fields: true
|
250
|
-
|
251
|
-
|
252
|
-
|
271
|
+
catch :response do
|
272
|
+
yield result, operation if block_given?
|
273
|
+
result
|
274
|
+
end
|
253
275
|
end
|
254
276
|
|
255
277
|
##
|
@@ -278,16 +300,18 @@ module Google
|
|
278
300
|
|
279
301
|
response = @client_stub.make_http_request(
|
280
302
|
verb,
|
281
|
-
uri:
|
282
|
-
body:
|
283
|
-
params:
|
303
|
+
uri: uri,
|
304
|
+
body: body || "",
|
305
|
+
params: query_string_params,
|
306
|
+
method_name: "export_entity_types",
|
284
307
|
options: options
|
285
308
|
)
|
286
309
|
operation = ::Gapic::Rest::TransportOperation.new response
|
287
310
|
result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
|
288
|
-
|
289
|
-
|
290
|
-
|
311
|
+
catch :response do
|
312
|
+
yield result, operation if block_given?
|
313
|
+
result
|
314
|
+
end
|
291
315
|
end
|
292
316
|
|
293
317
|
##
|
@@ -316,16 +340,18 @@ module Google
|
|
316
340
|
|
317
341
|
response = @client_stub.make_http_request(
|
318
342
|
verb,
|
319
|
-
uri:
|
320
|
-
body:
|
321
|
-
params:
|
343
|
+
uri: uri,
|
344
|
+
body: body || "",
|
345
|
+
params: query_string_params,
|
346
|
+
method_name: "import_entity_types",
|
322
347
|
options: options
|
323
348
|
)
|
324
349
|
operation = ::Gapic::Rest::TransportOperation.new response
|
325
350
|
result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
|
326
|
-
|
327
|
-
|
328
|
-
|
351
|
+
catch :response do
|
352
|
+
yield result, operation if block_given?
|
353
|
+
result
|
354
|
+
end
|
329
355
|
end
|
330
356
|
|
331
357
|
##
|