google-cloud-dialogflow-v2 0.7.0 → 0.8.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (36) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/dialogflow/v2.rb +2 -0
  3. data/lib/google/cloud/dialogflow/v2/agents/paths.rb +42 -3
  4. data/lib/google/cloud/dialogflow/v2/answer_record_services_pb.rb +1 -2
  5. data/lib/google/cloud/dialogflow/v2/answer_records.rb +1 -2
  6. data/lib/google/cloud/dialogflow/v2/answer_records/client.rb +1 -2
  7. data/lib/google/cloud/dialogflow/v2/contexts/paths.rb +72 -0
  8. data/lib/google/cloud/dialogflow/v2/conversation_profiles/paths.rb +44 -3
  9. data/lib/google/cloud/dialogflow/v2/entity_types/paths.rb +58 -12
  10. data/lib/google/cloud/dialogflow/v2/environment_pb.rb +50 -1
  11. data/lib/google/cloud/dialogflow/v2/environment_services_pb.rb +21 -0
  12. data/lib/google/cloud/dialogflow/v2/environments/client.rb +411 -1
  13. data/lib/google/cloud/dialogflow/v2/environments/paths.rb +104 -5
  14. data/lib/google/cloud/dialogflow/v2/fulfillment_pb.rb +59 -0
  15. data/lib/google/cloud/dialogflow/v2/fulfillment_services_pb.rb +47 -0
  16. data/lib/google/cloud/dialogflow/v2/fulfillments.rb +49 -0
  17. data/lib/google/cloud/dialogflow/v2/fulfillments/client.rb +460 -0
  18. data/lib/google/cloud/dialogflow/v2/fulfillments/credentials.rb +52 -0
  19. data/lib/google/cloud/dialogflow/v2/fulfillments/paths.rb +69 -0
  20. data/lib/google/cloud/dialogflow/v2/intents/paths.rb +96 -12
  21. data/lib/google/cloud/dialogflow/v2/participants/paths.rb +76 -0
  22. data/lib/google/cloud/dialogflow/v2/session_entity_types/paths.rb +72 -0
  23. data/lib/google/cloud/dialogflow/v2/sessions/paths.rb +110 -0
  24. data/lib/google/cloud/dialogflow/v2/version.rb +1 -1
  25. data/lib/google/cloud/dialogflow/v2/version_pb.rb +69 -0
  26. data/lib/google/cloud/dialogflow/v2/version_services_pb.rb +59 -0
  27. data/lib/google/cloud/dialogflow/v2/versions.rb +49 -0
  28. data/lib/google/cloud/dialogflow/v2/versions/client.rb +709 -0
  29. data/lib/google/cloud/dialogflow/v2/versions/credentials.rb +52 -0
  30. data/lib/google/cloud/dialogflow/v2/versions/paths.rb +110 -0
  31. data/proto_docs/google/cloud/dialogflow/v2/answer_record.rb +9 -16
  32. data/proto_docs/google/cloud/dialogflow/v2/conversation_profile.rb +14 -2
  33. data/proto_docs/google/cloud/dialogflow/v2/environment.rb +169 -4
  34. data/proto_docs/google/cloud/dialogflow/v2/fulfillment.rb +144 -0
  35. data/proto_docs/google/cloud/dialogflow/v2/version.rb +176 -0
  36. metadata +17 -3
@@ -27,15 +27,114 @@ module Google
27
27
  ##
28
28
  # Create a fully-qualified Agent resource string.
29
29
  #
30
- # The resource will be in the following format:
30
+ # @overload agent_path(project:)
31
+ # The resource will be in the following format:
31
32
  #
32
- # `projects/{project}/agent`
33
+ # `projects/{project}/agent`
33
34
  #
34
- # @param project [String]
35
+ # @param project [String]
36
+ #
37
+ # @overload agent_path(project:, location:)
38
+ # The resource will be in the following format:
39
+ #
40
+ # `projects/{project}/locations/{location}/agent`
41
+ #
42
+ # @param project [String]
43
+ # @param location [String]
44
+ #
45
+ # @return [::String]
46
+ def agent_path **args
47
+ resources = {
48
+ "project" => (proc do |project:|
49
+ "projects/#{project}/agent"
50
+ end),
51
+ "location:project" => (proc do |project:, location:|
52
+ raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
53
+
54
+ "projects/#{project}/locations/#{location}/agent"
55
+ end)
56
+ }
57
+
58
+ resource = resources[args.keys.sort.join(":")]
59
+ raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
60
+ resource.call(**args)
61
+ end
62
+
63
+ ##
64
+ # Create a fully-qualified Environment resource string.
65
+ #
66
+ # @overload environment_path(project:, environment:)
67
+ # The resource will be in the following format:
68
+ #
69
+ # `projects/{project}/agent/environments/{environment}`
70
+ #
71
+ # @param project [String]
72
+ # @param environment [String]
73
+ #
74
+ # @overload environment_path(project:, location:, environment:)
75
+ # The resource will be in the following format:
76
+ #
77
+ # `projects/{project}/locations/{location}/agent/environments/{environment}`
78
+ #
79
+ # @param project [String]
80
+ # @param location [String]
81
+ # @param environment [String]
35
82
  #
36
83
  # @return [::String]
37
- def agent_path project:
38
- "projects/#{project}/agent"
84
+ def environment_path **args
85
+ resources = {
86
+ "environment:project" => (proc do |project:, environment:|
87
+ raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
88
+
89
+ "projects/#{project}/agent/environments/#{environment}"
90
+ end),
91
+ "environment:location:project" => (proc do |project:, location:, environment:|
92
+ raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
93
+ raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
94
+
95
+ "projects/#{project}/locations/#{location}/agent/environments/#{environment}"
96
+ end)
97
+ }
98
+
99
+ resource = resources[args.keys.sort.join(":")]
100
+ raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
101
+ resource.call(**args)
102
+ end
103
+
104
+ ##
105
+ # Create a fully-qualified Fulfillment resource string.
106
+ #
107
+ # @overload fulfillment_path(project:)
108
+ # The resource will be in the following format:
109
+ #
110
+ # `projects/{project}/agent/fulfillment`
111
+ #
112
+ # @param project [String]
113
+ #
114
+ # @overload fulfillment_path(project:, location:)
115
+ # The resource will be in the following format:
116
+ #
117
+ # `projects/{project}/locations/{location}/agent/fulfillment`
118
+ #
119
+ # @param project [String]
120
+ # @param location [String]
121
+ #
122
+ # @return [::String]
123
+ def fulfillment_path **args
124
+ resources = {
125
+ "project" => (proc do |project:|
126
+ "projects/#{project}/agent/fulfillment"
127
+ end),
128
+ "location:project" => (proc do |project:, location:|
129
+ raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
130
+
131
+ "projects/#{project}/locations/#{location}/agent/fulfillment"
132
+ end)
133
+ }
134
+
135
+ resource = resources[args.keys.sort.join(":")]
136
+ raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
137
+ resource.call(**args)
39
138
  end
40
139
 
41
140
  extend self
@@ -0,0 +1,59 @@
1
+ # Generated by the protocol buffer compiler. DO NOT EDIT!
2
+ # source: google/cloud/dialogflow/v2/fulfillment.proto
3
+
4
+ require 'google/protobuf'
5
+
6
+ require 'google/api/annotations_pb'
7
+ require 'google/api/client_pb'
8
+ require 'google/api/field_behavior_pb'
9
+ require 'google/api/resource_pb'
10
+ require 'google/protobuf/field_mask_pb'
11
+ Google::Protobuf::DescriptorPool.generated_pool.build do
12
+ add_file("google/cloud/dialogflow/v2/fulfillment.proto", :syntax => :proto3) do
13
+ add_message "google.cloud.dialogflow.v2.Fulfillment" do
14
+ optional :name, :string, 1
15
+ optional :display_name, :string, 2
16
+ optional :enabled, :bool, 4
17
+ repeated :features, :message, 5, "google.cloud.dialogflow.v2.Fulfillment.Feature"
18
+ oneof :fulfillment do
19
+ optional :generic_web_service, :message, 3, "google.cloud.dialogflow.v2.Fulfillment.GenericWebService"
20
+ end
21
+ end
22
+ add_message "google.cloud.dialogflow.v2.Fulfillment.GenericWebService" do
23
+ optional :uri, :string, 1
24
+ optional :username, :string, 2
25
+ optional :password, :string, 3
26
+ map :request_headers, :string, :string, 4
27
+ optional :is_cloud_function, :bool, 5
28
+ end
29
+ add_message "google.cloud.dialogflow.v2.Fulfillment.Feature" do
30
+ optional :type, :enum, 1, "google.cloud.dialogflow.v2.Fulfillment.Feature.Type"
31
+ end
32
+ add_enum "google.cloud.dialogflow.v2.Fulfillment.Feature.Type" do
33
+ value :TYPE_UNSPECIFIED, 0
34
+ value :SMALLTALK, 1
35
+ end
36
+ add_message "google.cloud.dialogflow.v2.GetFulfillmentRequest" do
37
+ optional :name, :string, 1
38
+ end
39
+ add_message "google.cloud.dialogflow.v2.UpdateFulfillmentRequest" do
40
+ optional :fulfillment, :message, 1, "google.cloud.dialogflow.v2.Fulfillment"
41
+ optional :update_mask, :message, 2, "google.protobuf.FieldMask"
42
+ end
43
+ end
44
+ end
45
+
46
+ module Google
47
+ module Cloud
48
+ module Dialogflow
49
+ module V2
50
+ Fulfillment = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.Fulfillment").msgclass
51
+ Fulfillment::GenericWebService = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.Fulfillment.GenericWebService").msgclass
52
+ Fulfillment::Feature = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.Fulfillment.Feature").msgclass
53
+ Fulfillment::Feature::Type = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.Fulfillment.Feature.Type").enummodule
54
+ GetFulfillmentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.GetFulfillmentRequest").msgclass
55
+ UpdateFulfillmentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.UpdateFulfillmentRequest").msgclass
56
+ end
57
+ end
58
+ end
59
+ end
@@ -0,0 +1,47 @@
1
+ # Generated by the protocol buffer compiler. DO NOT EDIT!
2
+ # Source: google/cloud/dialogflow/v2/fulfillment.proto for package 'google.cloud.dialogflow.v2'
3
+ # Original file comments:
4
+ # Copyright 2021 Google LLC
5
+ #
6
+ # Licensed under the Apache License, Version 2.0 (the "License");
7
+ # you may not use this file except in compliance with the License.
8
+ # You may obtain a copy of the License at
9
+ #
10
+ # http://www.apache.org/licenses/LICENSE-2.0
11
+ #
12
+ # Unless required by applicable law or agreed to in writing, software
13
+ # distributed under the License is distributed on an "AS IS" BASIS,
14
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15
+ # See the License for the specific language governing permissions and
16
+ # limitations under the License.
17
+ #
18
+
19
+ require 'grpc'
20
+ require 'google/cloud/dialogflow/v2/fulfillment_pb'
21
+
22
+ module Google
23
+ module Cloud
24
+ module Dialogflow
25
+ module V2
26
+ module Fulfillments
27
+ # Service for managing [Fulfillments][google.cloud.dialogflow.v2.Fulfillment].
28
+ class Service
29
+
30
+ include GRPC::GenericService
31
+
32
+ self.marshal_class_method = :encode
33
+ self.unmarshal_class_method = :decode
34
+ self.service_name = 'google.cloud.dialogflow.v2.Fulfillments'
35
+
36
+ # Retrieves the fulfillment.
37
+ rpc :GetFulfillment, ::Google::Cloud::Dialogflow::V2::GetFulfillmentRequest, ::Google::Cloud::Dialogflow::V2::Fulfillment
38
+ # Updates the fulfillment.
39
+ rpc :UpdateFulfillment, ::Google::Cloud::Dialogflow::V2::UpdateFulfillmentRequest, ::Google::Cloud::Dialogflow::V2::Fulfillment
40
+ end
41
+
42
+ Stub = Service.rpc_stub_class
43
+ end
44
+ end
45
+ end
46
+ end
47
+ end
@@ -0,0 +1,49 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2021 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "gapic/common"
20
+ require "gapic/config"
21
+ require "gapic/config/method"
22
+
23
+ require "google/cloud/dialogflow/v2/version"
24
+
25
+ require "google/cloud/dialogflow/v2/fulfillments/credentials"
26
+ require "google/cloud/dialogflow/v2/fulfillments/paths"
27
+ require "google/cloud/dialogflow/v2/fulfillments/client"
28
+
29
+ module Google
30
+ module Cloud
31
+ module Dialogflow
32
+ module V2
33
+ ##
34
+ # Service for managing {::Google::Cloud::Dialogflow::V2::Fulfillment Fulfillments}.
35
+ #
36
+ # To load this service and instantiate a client:
37
+ #
38
+ # require "google/cloud/dialogflow/v2/fulfillments"
39
+ # client = ::Google::Cloud::Dialogflow::V2::Fulfillments::Client.new
40
+ #
41
+ module Fulfillments
42
+ end
43
+ end
44
+ end
45
+ end
46
+ end
47
+
48
+ helper_path = ::File.join __dir__, "fulfillments", "helpers.rb"
49
+ require "google/cloud/dialogflow/v2/fulfillments/helpers" if ::File.file? helper_path
@@ -0,0 +1,460 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2021 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "google/cloud/errors"
20
+ require "google/cloud/dialogflow/v2/fulfillment_pb"
21
+
22
+ module Google
23
+ module Cloud
24
+ module Dialogflow
25
+ module V2
26
+ module Fulfillments
27
+ ##
28
+ # Client for the Fulfillments service.
29
+ #
30
+ # Service for managing {::Google::Cloud::Dialogflow::V2::Fulfillment Fulfillments}.
31
+ #
32
+ class Client
33
+ include Paths
34
+
35
+ # @private
36
+ attr_reader :fulfillments_stub
37
+
38
+ ##
39
+ # Configure the Fulfillments Client class.
40
+ #
41
+ # See {::Google::Cloud::Dialogflow::V2::Fulfillments::Client::Configuration}
42
+ # for a description of the configuration fields.
43
+ #
44
+ # ## Example
45
+ #
46
+ # To modify the configuration for all Fulfillments clients:
47
+ #
48
+ # ::Google::Cloud::Dialogflow::V2::Fulfillments::Client.configure do |config|
49
+ # config.timeout = 10.0
50
+ # end
51
+ #
52
+ # @yield [config] Configure the Client client.
53
+ # @yieldparam config [Client::Configuration]
54
+ #
55
+ # @return [Client::Configuration]
56
+ #
57
+ def self.configure
58
+ @configure ||= begin
59
+ namespace = ["Google", "Cloud", "Dialogflow", "V2"]
60
+ parent_config = while namespace.any?
61
+ parent_name = namespace.join "::"
62
+ parent_const = const_get parent_name
63
+ break parent_const.configure if parent_const.respond_to? :configure
64
+ namespace.pop
65
+ end
66
+ default_config = Client::Configuration.new parent_config
67
+
68
+ default_config.timeout = 60.0
69
+ default_config.retry_policy = {
70
+ initial_delay: 0.1,
71
+ max_delay: 60.0,
72
+ multiplier: 1.3,
73
+ retry_codes: [14]
74
+ }
75
+
76
+ default_config
77
+ end
78
+ yield @configure if block_given?
79
+ @configure
80
+ end
81
+
82
+ ##
83
+ # Configure the Fulfillments Client instance.
84
+ #
85
+ # The configuration is set to the derived mode, meaning that values can be changed,
86
+ # but structural changes (adding new fields, etc.) are not allowed. Structural changes
87
+ # should be made on {Client.configure}.
88
+ #
89
+ # See {::Google::Cloud::Dialogflow::V2::Fulfillments::Client::Configuration}
90
+ # for a description of the configuration fields.
91
+ #
92
+ # @yield [config] Configure the Client client.
93
+ # @yieldparam config [Client::Configuration]
94
+ #
95
+ # @return [Client::Configuration]
96
+ #
97
+ def configure
98
+ yield @config if block_given?
99
+ @config
100
+ end
101
+
102
+ ##
103
+ # Create a new Fulfillments client object.
104
+ #
105
+ # ## Examples
106
+ #
107
+ # To create a new Fulfillments client with the default
108
+ # configuration:
109
+ #
110
+ # client = ::Google::Cloud::Dialogflow::V2::Fulfillments::Client.new
111
+ #
112
+ # To create a new Fulfillments client with a custom
113
+ # configuration:
114
+ #
115
+ # client = ::Google::Cloud::Dialogflow::V2::Fulfillments::Client.new do |config|
116
+ # config.timeout = 10.0
117
+ # end
118
+ #
119
+ # @yield [config] Configure the Fulfillments client.
120
+ # @yieldparam config [Client::Configuration]
121
+ #
122
+ def initialize
123
+ # These require statements are intentionally placed here to initialize
124
+ # the gRPC module only when it's required.
125
+ # See https://github.com/googleapis/toolkit/issues/446
126
+ require "gapic/grpc"
127
+ require "google/cloud/dialogflow/v2/fulfillment_services_pb"
128
+
129
+ # Create the configuration object
130
+ @config = Configuration.new Client.configure
131
+
132
+ # Yield the configuration if needed
133
+ yield @config if block_given?
134
+
135
+ # Create credentials
136
+ credentials = @config.credentials
137
+ # Use self-signed JWT if the scope and endpoint are unchanged from default,
138
+ # but only if the default endpoint does not have a region prefix.
139
+ enable_self_signed_jwt = @config.scope == Client.configure.scope &&
140
+ @config.endpoint == Client.configure.endpoint &&
141
+ !@config.endpoint.split(".").first.include?("-")
142
+ credentials ||= Credentials.default scope: @config.scope,
143
+ enable_self_signed_jwt: enable_self_signed_jwt
144
+ if credentials.is_a?(String) || credentials.is_a?(Hash)
145
+ credentials = Credentials.new credentials, scope: @config.scope
146
+ end
147
+ @quota_project_id = @config.quota_project
148
+ @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
149
+
150
+ @fulfillments_stub = ::Gapic::ServiceStub.new(
151
+ ::Google::Cloud::Dialogflow::V2::Fulfillments::Stub,
152
+ credentials: credentials,
153
+ endpoint: @config.endpoint,
154
+ channel_args: @config.channel_args,
155
+ interceptors: @config.interceptors
156
+ )
157
+ end
158
+
159
+ # Service calls
160
+
161
+ ##
162
+ # Retrieves the fulfillment.
163
+ #
164
+ # @overload get_fulfillment(request, options = nil)
165
+ # Pass arguments to `get_fulfillment` via a request object, either of type
166
+ # {::Google::Cloud::Dialogflow::V2::GetFulfillmentRequest} or an equivalent Hash.
167
+ #
168
+ # @param request [::Google::Cloud::Dialogflow::V2::GetFulfillmentRequest, ::Hash]
169
+ # A request object representing the call parameters. Required. To specify no
170
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
171
+ # @param options [::Gapic::CallOptions, ::Hash]
172
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
173
+ #
174
+ # @overload get_fulfillment(name: nil)
175
+ # Pass arguments to `get_fulfillment` via keyword arguments. Note that at
176
+ # least one keyword argument is required. To specify no parameters, or to keep all
177
+ # the default parameter values, pass an empty Hash as a request object (see above).
178
+ #
179
+ # @param name [::String]
180
+ # Required. The name of the fulfillment.
181
+ # Format: `projects/<Project ID>/agent/fulfillment`.
182
+ #
183
+ # @yield [response, operation] Access the result along with the RPC operation
184
+ # @yieldparam response [::Google::Cloud::Dialogflow::V2::Fulfillment]
185
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
186
+ #
187
+ # @return [::Google::Cloud::Dialogflow::V2::Fulfillment]
188
+ #
189
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
190
+ #
191
+ def get_fulfillment request, options = nil
192
+ raise ::ArgumentError, "request must be provided" if request.nil?
193
+
194
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dialogflow::V2::GetFulfillmentRequest
195
+
196
+ # Converts hash and nil to an options object
197
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
198
+
199
+ # Customize the options with defaults
200
+ metadata = @config.rpcs.get_fulfillment.metadata.to_h
201
+
202
+ # Set x-goog-api-client and x-goog-user-project headers
203
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
204
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
205
+ gapic_version: ::Google::Cloud::Dialogflow::V2::VERSION
206
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
207
+
208
+ header_params = {
209
+ "name" => request.name
210
+ }
211
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
212
+ metadata[:"x-goog-request-params"] ||= request_params_header
213
+
214
+ options.apply_defaults timeout: @config.rpcs.get_fulfillment.timeout,
215
+ metadata: metadata,
216
+ retry_policy: @config.rpcs.get_fulfillment.retry_policy
217
+ options.apply_defaults metadata: @config.metadata,
218
+ retry_policy: @config.retry_policy
219
+
220
+ @fulfillments_stub.call_rpc :get_fulfillment, request, options: options do |response, operation|
221
+ yield response, operation if block_given?
222
+ return response
223
+ end
224
+ rescue ::GRPC::BadStatus => e
225
+ raise ::Google::Cloud::Error.from_error(e)
226
+ end
227
+
228
+ ##
229
+ # Updates the fulfillment.
230
+ #
231
+ # @overload update_fulfillment(request, options = nil)
232
+ # Pass arguments to `update_fulfillment` via a request object, either of type
233
+ # {::Google::Cloud::Dialogflow::V2::UpdateFulfillmentRequest} or an equivalent Hash.
234
+ #
235
+ # @param request [::Google::Cloud::Dialogflow::V2::UpdateFulfillmentRequest, ::Hash]
236
+ # A request object representing the call parameters. Required. To specify no
237
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
238
+ # @param options [::Gapic::CallOptions, ::Hash]
239
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
240
+ #
241
+ # @overload update_fulfillment(fulfillment: nil, update_mask: nil)
242
+ # Pass arguments to `update_fulfillment` via keyword arguments. Note that at
243
+ # least one keyword argument is required. To specify no parameters, or to keep all
244
+ # the default parameter values, pass an empty Hash as a request object (see above).
245
+ #
246
+ # @param fulfillment [::Google::Cloud::Dialogflow::V2::Fulfillment, ::Hash]
247
+ # Required. The fulfillment to update.
248
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
249
+ # Required. The mask to control which fields get updated. If the mask is not
250
+ # present, all fields will be updated.
251
+ #
252
+ # @yield [response, operation] Access the result along with the RPC operation
253
+ # @yieldparam response [::Google::Cloud::Dialogflow::V2::Fulfillment]
254
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
255
+ #
256
+ # @return [::Google::Cloud::Dialogflow::V2::Fulfillment]
257
+ #
258
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
259
+ #
260
+ def update_fulfillment request, options = nil
261
+ raise ::ArgumentError, "request must be provided" if request.nil?
262
+
263
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dialogflow::V2::UpdateFulfillmentRequest
264
+
265
+ # Converts hash and nil to an options object
266
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
267
+
268
+ # Customize the options with defaults
269
+ metadata = @config.rpcs.update_fulfillment.metadata.to_h
270
+
271
+ # Set x-goog-api-client and x-goog-user-project headers
272
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
273
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
274
+ gapic_version: ::Google::Cloud::Dialogflow::V2::VERSION
275
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
276
+
277
+ header_params = {
278
+ "fulfillment.name" => request.fulfillment.name
279
+ }
280
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
281
+ metadata[:"x-goog-request-params"] ||= request_params_header
282
+
283
+ options.apply_defaults timeout: @config.rpcs.update_fulfillment.timeout,
284
+ metadata: metadata,
285
+ retry_policy: @config.rpcs.update_fulfillment.retry_policy
286
+ options.apply_defaults metadata: @config.metadata,
287
+ retry_policy: @config.retry_policy
288
+
289
+ @fulfillments_stub.call_rpc :update_fulfillment, request, options: options do |response, operation|
290
+ yield response, operation if block_given?
291
+ return response
292
+ end
293
+ rescue ::GRPC::BadStatus => e
294
+ raise ::Google::Cloud::Error.from_error(e)
295
+ end
296
+
297
+ ##
298
+ # Configuration class for the Fulfillments API.
299
+ #
300
+ # This class represents the configuration for Fulfillments,
301
+ # providing control over timeouts, retry behavior, logging, transport
302
+ # parameters, and other low-level controls. Certain parameters can also be
303
+ # applied individually to specific RPCs. See
304
+ # {::Google::Cloud::Dialogflow::V2::Fulfillments::Client::Configuration::Rpcs}
305
+ # for a list of RPCs that can be configured independently.
306
+ #
307
+ # Configuration can be applied globally to all clients, or to a single client
308
+ # on construction.
309
+ #
310
+ # # Examples
311
+ #
312
+ # To modify the global config, setting the timeout for get_fulfillment
313
+ # to 20 seconds, and all remaining timeouts to 10 seconds:
314
+ #
315
+ # ::Google::Cloud::Dialogflow::V2::Fulfillments::Client.configure do |config|
316
+ # config.timeout = 10.0
317
+ # config.rpcs.get_fulfillment.timeout = 20.0
318
+ # end
319
+ #
320
+ # To apply the above configuration only to a new client:
321
+ #
322
+ # client = ::Google::Cloud::Dialogflow::V2::Fulfillments::Client.new do |config|
323
+ # config.timeout = 10.0
324
+ # config.rpcs.get_fulfillment.timeout = 20.0
325
+ # end
326
+ #
327
+ # @!attribute [rw] endpoint
328
+ # The hostname or hostname:port of the service endpoint.
329
+ # Defaults to `"dialogflow.googleapis.com"`.
330
+ # @return [::String]
331
+ # @!attribute [rw] credentials
332
+ # Credentials to send with calls. You may provide any of the following types:
333
+ # * (`String`) The path to a service account key file in JSON format
334
+ # * (`Hash`) A service account key as a Hash
335
+ # * (`Google::Auth::Credentials`) A googleauth credentials object
336
+ # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
337
+ # * (`Signet::OAuth2::Client`) A signet oauth2 client object
338
+ # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
339
+ # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
340
+ # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
341
+ # * (`nil`) indicating no credentials
342
+ # @return [::Object]
343
+ # @!attribute [rw] scope
344
+ # The OAuth scopes
345
+ # @return [::Array<::String>]
346
+ # @!attribute [rw] lib_name
347
+ # The library name as recorded in instrumentation and logging
348
+ # @return [::String]
349
+ # @!attribute [rw] lib_version
350
+ # The library version as recorded in instrumentation and logging
351
+ # @return [::String]
352
+ # @!attribute [rw] channel_args
353
+ # Extra parameters passed to the gRPC channel. Note: this is ignored if a
354
+ # `GRPC::Core::Channel` object is provided as the credential.
355
+ # @return [::Hash]
356
+ # @!attribute [rw] interceptors
357
+ # An array of interceptors that are run before calls are executed.
358
+ # @return [::Array<::GRPC::ClientInterceptor>]
359
+ # @!attribute [rw] timeout
360
+ # The call timeout in seconds.
361
+ # @return [::Numeric]
362
+ # @!attribute [rw] metadata
363
+ # Additional gRPC headers to be sent with the call.
364
+ # @return [::Hash{::Symbol=>::String}]
365
+ # @!attribute [rw] retry_policy
366
+ # The retry policy. The value is a hash with the following keys:
367
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
368
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
369
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
370
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
371
+ # trigger a retry.
372
+ # @return [::Hash]
373
+ # @!attribute [rw] quota_project
374
+ # A separate project against which to charge quota.
375
+ # @return [::String]
376
+ #
377
+ class Configuration
378
+ extend ::Gapic::Config
379
+
380
+ config_attr :endpoint, "dialogflow.googleapis.com", ::String
381
+ config_attr :credentials, nil do |value|
382
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
383
+ allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
384
+ allowed.any? { |klass| klass === value }
385
+ end
386
+ config_attr :scope, nil, ::String, ::Array, nil
387
+ config_attr :lib_name, nil, ::String, nil
388
+ config_attr :lib_version, nil, ::String, nil
389
+ config_attr(:channel_args, { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
390
+ config_attr :interceptors, nil, ::Array, nil
391
+ config_attr :timeout, nil, ::Numeric, nil
392
+ config_attr :metadata, nil, ::Hash, nil
393
+ config_attr :retry_policy, nil, ::Hash, ::Proc, nil
394
+ config_attr :quota_project, nil, ::String, nil
395
+
396
+ # @private
397
+ def initialize parent_config = nil
398
+ @parent_config = parent_config unless parent_config.nil?
399
+
400
+ yield self if block_given?
401
+ end
402
+
403
+ ##
404
+ # Configurations for individual RPCs
405
+ # @return [Rpcs]
406
+ #
407
+ def rpcs
408
+ @rpcs ||= begin
409
+ parent_rpcs = nil
410
+ parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
411
+ Rpcs.new parent_rpcs
412
+ end
413
+ end
414
+
415
+ ##
416
+ # Configuration RPC class for the Fulfillments API.
417
+ #
418
+ # Includes fields providing the configuration for each RPC in this service.
419
+ # Each configuration object is of type `Gapic::Config::Method` and includes
420
+ # the following configuration fields:
421
+ #
422
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
423
+ # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
424
+ # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
425
+ # include the following keys:
426
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
427
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
428
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
429
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
430
+ # trigger a retry.
431
+ #
432
+ class Rpcs
433
+ ##
434
+ # RPC-specific configuration for `get_fulfillment`
435
+ # @return [::Gapic::Config::Method]
436
+ #
437
+ attr_reader :get_fulfillment
438
+ ##
439
+ # RPC-specific configuration for `update_fulfillment`
440
+ # @return [::Gapic::Config::Method]
441
+ #
442
+ attr_reader :update_fulfillment
443
+
444
+ # @private
445
+ def initialize parent_rpcs = nil
446
+ get_fulfillment_config = parent_rpcs.get_fulfillment if parent_rpcs.respond_to? :get_fulfillment
447
+ @get_fulfillment = ::Gapic::Config::Method.new get_fulfillment_config
448
+ update_fulfillment_config = parent_rpcs.update_fulfillment if parent_rpcs.respond_to? :update_fulfillment
449
+ @update_fulfillment = ::Gapic::Config::Method.new update_fulfillment_config
450
+
451
+ yield self if block_given?
452
+ end
453
+ end
454
+ end
455
+ end
456
+ end
457
+ end
458
+ end
459
+ end
460
+ end