google-cloud-discovery_engine-v1 0.4.2 → 0.5.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (90) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/discovery_engine/v1/completion_service/client.rb +235 -4
  3. data/lib/google/cloud/discovery_engine/v1/completion_service/operations.rb +801 -0
  4. data/lib/google/cloud/discovery_engine/v1/completion_service/rest/client.rb +221 -4
  5. data/lib/google/cloud/discovery_engine/v1/completion_service/rest/operations.rb +1091 -0
  6. data/lib/google/cloud/discovery_engine/v1/completion_service/rest/service_stub.rb +136 -0
  7. data/lib/google/cloud/discovery_engine/v1/completion_service/rest.rb +1 -0
  8. data/lib/google/cloud/discovery_engine/v1/completion_service.rb +1 -0
  9. data/lib/google/cloud/discovery_engine/v1/conversational_search_service/client.rb +20 -3
  10. data/lib/google/cloud/discovery_engine/v1/conversational_search_service/paths.rb +91 -0
  11. data/lib/google/cloud/discovery_engine/v1/conversational_search_service/rest/client.rb +20 -3
  12. data/lib/google/cloud/discovery_engine/v1/conversational_search_service/rest/service_stub.rb +45 -0
  13. data/lib/google/cloud/discovery_engine/v1/data_store_service/client.rb +924 -0
  14. data/lib/google/cloud/discovery_engine/v1/data_store_service/credentials.rb +47 -0
  15. data/lib/google/cloud/discovery_engine/v1/data_store_service/operations.rb +801 -0
  16. data/lib/google/cloud/discovery_engine/v1/data_store_service/paths.rb +97 -0
  17. data/lib/google/cloud/discovery_engine/v1/data_store_service/rest/client.rb +863 -0
  18. data/lib/google/cloud/discovery_engine/v1/data_store_service/rest/operations.rb +1091 -0
  19. data/lib/google/cloud/discovery_engine/v1/data_store_service/rest/service_stub.rb +403 -0
  20. data/lib/google/cloud/discovery_engine/v1/data_store_service/rest.rb +54 -0
  21. data/lib/google/cloud/discovery_engine/v1/data_store_service.rb +57 -0
  22. data/lib/google/cloud/discovery_engine/v1/document_service/rest/operations.rb +14 -0
  23. data/lib/google/cloud/discovery_engine/v1/engine_service/client.rb +885 -0
  24. data/lib/google/cloud/discovery_engine/v1/engine_service/credentials.rb +47 -0
  25. data/lib/google/cloud/discovery_engine/v1/engine_service/operations.rb +801 -0
  26. data/lib/google/cloud/discovery_engine/v1/engine_service/paths.rb +73 -0
  27. data/lib/google/cloud/discovery_engine/v1/engine_service/rest/client.rb +824 -0
  28. data/lib/google/cloud/discovery_engine/v1/engine_service/rest/operations.rb +1091 -0
  29. data/lib/google/cloud/discovery_engine/v1/engine_service/rest/service_stub.rb +366 -0
  30. data/lib/google/cloud/discovery_engine/v1/engine_service/rest.rb +54 -0
  31. data/lib/google/cloud/discovery_engine/v1/engine_service.rb +57 -0
  32. data/lib/google/cloud/discovery_engine/v1/rest.rb +3 -0
  33. data/lib/google/cloud/discovery_engine/v1/schema_service/rest/operations.rb +14 -0
  34. data/lib/google/cloud/discovery_engine/v1/search_service/client.rb +40 -4
  35. data/lib/google/cloud/discovery_engine/v1/search_service/paths.rb +19 -0
  36. data/lib/google/cloud/discovery_engine/v1/search_service/rest/client.rb +40 -4
  37. data/lib/google/cloud/discovery_engine/v1/search_service/rest/service_stub.rb +8 -0
  38. data/lib/google/cloud/discovery_engine/v1/site_search_engine_service/client.rb +1631 -0
  39. data/lib/google/cloud/discovery_engine/v1/site_search_engine_service/credentials.rb +47 -0
  40. data/lib/google/cloud/discovery_engine/v1/site_search_engine_service/operations.rb +801 -0
  41. data/lib/google/cloud/discovery_engine/v1/site_search_engine_service/paths.rb +127 -0
  42. data/lib/google/cloud/discovery_engine/v1/site_search_engine_service/rest/client.rb +1521 -0
  43. data/lib/google/cloud/discovery_engine/v1/site_search_engine_service/rest/operations.rb +1091 -0
  44. data/lib/google/cloud/discovery_engine/v1/site_search_engine_service/rest/service_stub.rb +860 -0
  45. data/lib/google/cloud/discovery_engine/v1/site_search_engine_service/rest.rb +53 -0
  46. data/lib/google/cloud/discovery_engine/v1/site_search_engine_service.rb +56 -0
  47. data/lib/google/cloud/discovery_engine/v1/user_event_service/rest/operations.rb +14 -0
  48. data/lib/google/cloud/discovery_engine/v1/version.rb +1 -1
  49. data/lib/google/cloud/discovery_engine/v1.rb +3 -0
  50. data/lib/google/cloud/discoveryengine/v1/common_pb.rb +5 -1
  51. data/lib/google/cloud/discoveryengine/v1/completion_pb.rb +45 -0
  52. data/lib/google/cloud/discoveryengine/v1/completion_service_pb.rb +4 -1
  53. data/lib/google/cloud/discoveryengine/v1/completion_service_services_pb.rb +8 -0
  54. data/lib/google/cloud/discoveryengine/v1/conversation_pb.rb +1 -1
  55. data/lib/google/cloud/discoveryengine/v1/conversational_search_service_pb.rb +1 -1
  56. data/lib/google/cloud/discoveryengine/v1/data_store_pb.rb +49 -0
  57. data/lib/google/cloud/discoveryengine/v1/data_store_service_pb.rb +62 -0
  58. data/lib/google/cloud/discoveryengine/v1/data_store_service_services_pb.rb +61 -0
  59. data/lib/google/cloud/discoveryengine/v1/document_pb.rb +1 -1
  60. data/lib/google/cloud/discoveryengine/v1/document_service_pb.rb +1 -1
  61. data/lib/google/cloud/discoveryengine/v1/engine_pb.rb +53 -0
  62. data/lib/google/cloud/discoveryengine/v1/engine_service_pb.rb +62 -0
  63. data/lib/google/cloud/discoveryengine/v1/engine_service_services_pb.rb +55 -0
  64. data/lib/google/cloud/discoveryengine/v1/import_config_pb.rb +7 -1
  65. data/lib/google/cloud/discoveryengine/v1/purge_config_pb.rb +6 -1
  66. data/lib/google/cloud/discoveryengine/v1/schema_pb.rb +1 -1
  67. data/lib/google/cloud/discoveryengine/v1/schema_service_pb.rb +1 -1
  68. data/lib/google/cloud/discoveryengine/v1/search_service_pb.rb +8 -1
  69. data/lib/google/cloud/discoveryengine/v1/site_search_engine_pb.rb +54 -0
  70. data/lib/google/cloud/discoveryengine/v1/site_search_engine_service_pb.rb +82 -0
  71. data/lib/google/cloud/discoveryengine/v1/site_search_engine_service_services_pb.rb +73 -0
  72. data/lib/google/cloud/discoveryengine/v1/user_event_pb.rb +1 -1
  73. data/lib/google/cloud/discoveryengine/v1/user_event_service_pb.rb +1 -1
  74. data/proto_docs/google/cloud/discoveryengine/v1/common.rb +51 -0
  75. data/proto_docs/google/cloud/discoveryengine/v1/completion.rb +53 -0
  76. data/proto_docs/google/cloud/discoveryengine/v1/completion_service.rb +10 -4
  77. data/proto_docs/google/cloud/discoveryengine/v1/conversation.rb +2 -0
  78. data/proto_docs/google/cloud/discoveryengine/v1/conversational_search_service.rb +19 -1
  79. data/proto_docs/google/cloud/discoveryengine/v1/data_store.rb +88 -0
  80. data/proto_docs/google/cloud/discoveryengine/v1/data_store_service.rb +214 -0
  81. data/proto_docs/google/cloud/discoveryengine/v1/document.rb +1 -1
  82. data/proto_docs/google/cloud/discoveryengine/v1/engine.rb +214 -0
  83. data/proto_docs/google/cloud/discoveryengine/v1/engine_service.rb +177 -0
  84. data/proto_docs/google/cloud/discoveryengine/v1/import_config.rb +66 -0
  85. data/proto_docs/google/cloud/discoveryengine/v1/purge_config.rb +41 -0
  86. data/proto_docs/google/cloud/discoveryengine/v1/search_service.rb +149 -4
  87. data/proto_docs/google/cloud/discoveryengine/v1/site_search_engine.rb +160 -0
  88. data/proto_docs/google/cloud/discoveryengine/v1/site_search_engine_service.rb +525 -0
  89. data/proto_docs/google/cloud/discoveryengine/v1/user_event.rb +3 -3
  90. metadata +48 -2
@@ -99,6 +99,82 @@ module Google
99
99
  result
100
100
  end
101
101
 
102
+ ##
103
+ # Baseline implementation for the import_suggestion_deny_list_entries REST call
104
+ #
105
+ # @param request_pb [::Google::Cloud::DiscoveryEngine::V1::ImportSuggestionDenyListEntriesRequest]
106
+ # A request object representing the call parameters. Required.
107
+ # @param options [::Gapic::CallOptions]
108
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
109
+ #
110
+ # @yield [result, operation] Access the result along with the TransportOperation object
111
+ # @yieldparam result [::Google::Longrunning::Operation]
112
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
113
+ #
114
+ # @return [::Google::Longrunning::Operation]
115
+ # A result object deserialized from the server's reply
116
+ def import_suggestion_deny_list_entries request_pb, options = nil
117
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
118
+
119
+ verb, uri, query_string_params, body = ServiceStub.transcode_import_suggestion_deny_list_entries_request request_pb
120
+ query_string_params = if query_string_params.any?
121
+ query_string_params.to_h { |p| p.split "=", 2 }
122
+ else
123
+ {}
124
+ end
125
+
126
+ response = @client_stub.make_http_request(
127
+ verb,
128
+ uri: uri,
129
+ body: body || "",
130
+ params: query_string_params,
131
+ options: options
132
+ )
133
+ operation = ::Gapic::Rest::TransportOperation.new response
134
+ result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
135
+
136
+ yield result, operation if block_given?
137
+ result
138
+ end
139
+
140
+ ##
141
+ # Baseline implementation for the purge_suggestion_deny_list_entries REST call
142
+ #
143
+ # @param request_pb [::Google::Cloud::DiscoveryEngine::V1::PurgeSuggestionDenyListEntriesRequest]
144
+ # A request object representing the call parameters. Required.
145
+ # @param options [::Gapic::CallOptions]
146
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
147
+ #
148
+ # @yield [result, operation] Access the result along with the TransportOperation object
149
+ # @yieldparam result [::Google::Longrunning::Operation]
150
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
151
+ #
152
+ # @return [::Google::Longrunning::Operation]
153
+ # A result object deserialized from the server's reply
154
+ def purge_suggestion_deny_list_entries request_pb, options = nil
155
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
156
+
157
+ verb, uri, query_string_params, body = ServiceStub.transcode_purge_suggestion_deny_list_entries_request request_pb
158
+ query_string_params = if query_string_params.any?
159
+ query_string_params.to_h { |p| p.split "=", 2 }
160
+ else
161
+ {}
162
+ end
163
+
164
+ response = @client_stub.make_http_request(
165
+ verb,
166
+ uri: uri,
167
+ body: body || "",
168
+ params: query_string_params,
169
+ options: options
170
+ )
171
+ operation = ::Gapic::Rest::TransportOperation.new response
172
+ result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
173
+
174
+ yield result, operation if block_given?
175
+ result
176
+ end
177
+
102
178
  ##
103
179
  # @private
104
180
  #
@@ -126,6 +202,66 @@ module Google
126
202
  )
127
203
  transcoder.transcode request_pb
128
204
  end
205
+
206
+ ##
207
+ # @private
208
+ #
209
+ # GRPC transcoding helper method for the import_suggestion_deny_list_entries REST call
210
+ #
211
+ # @param request_pb [::Google::Cloud::DiscoveryEngine::V1::ImportSuggestionDenyListEntriesRequest]
212
+ # A request object representing the call parameters. Required.
213
+ # @return [Array(String, [String, nil], Hash{String => String})]
214
+ # Uri, Body, Query string parameters
215
+ def self.transcode_import_suggestion_deny_list_entries_request request_pb
216
+ transcoder = Gapic::Rest::GrpcTranscoder.new
217
+ .with_bindings(
218
+ uri_method: :post,
219
+ uri_template: "/v1/{parent}/suggestionDenyListEntries:import",
220
+ body: "*",
221
+ matches: [
222
+ ["parent", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/?$}, false]
223
+ ]
224
+ )
225
+ .with_bindings(
226
+ uri_method: :post,
227
+ uri_template: "/v1/{parent}/suggestionDenyListEntries:import",
228
+ body: "*",
229
+ matches: [
230
+ ["parent", %r{^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/?$}, false]
231
+ ]
232
+ )
233
+ transcoder.transcode request_pb
234
+ end
235
+
236
+ ##
237
+ # @private
238
+ #
239
+ # GRPC transcoding helper method for the purge_suggestion_deny_list_entries REST call
240
+ #
241
+ # @param request_pb [::Google::Cloud::DiscoveryEngine::V1::PurgeSuggestionDenyListEntriesRequest]
242
+ # A request object representing the call parameters. Required.
243
+ # @return [Array(String, [String, nil], Hash{String => String})]
244
+ # Uri, Body, Query string parameters
245
+ def self.transcode_purge_suggestion_deny_list_entries_request request_pb
246
+ transcoder = Gapic::Rest::GrpcTranscoder.new
247
+ .with_bindings(
248
+ uri_method: :post,
249
+ uri_template: "/v1/{parent}/suggestionDenyListEntries:purge",
250
+ body: "*",
251
+ matches: [
252
+ ["parent", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/?$}, false]
253
+ ]
254
+ )
255
+ .with_bindings(
256
+ uri_method: :post,
257
+ uri_template: "/v1/{parent}/suggestionDenyListEntries:purge",
258
+ body: "*",
259
+ matches: [
260
+ ["parent", %r{^projects/[^/]+/locations/[^/]+/dataStores(?:/.*)?$}, true]
261
+ ]
262
+ )
263
+ transcoder.transcode request_pb
264
+ end
129
265
  end
130
266
  end
131
267
  end
@@ -24,6 +24,7 @@ require "google/cloud/discovery_engine/v1/version"
24
24
 
25
25
  require "google/cloud/discovery_engine/v1/completion_service/credentials"
26
26
  require "google/cloud/discovery_engine/v1/completion_service/paths"
27
+ require "google/cloud/discovery_engine/v1/completion_service/rest/operations"
27
28
  require "google/cloud/discovery_engine/v1/completion_service/rest/client"
28
29
 
29
30
  module Google
@@ -24,6 +24,7 @@ require "google/cloud/discovery_engine/v1/version"
24
24
 
25
25
  require "google/cloud/discovery_engine/v1/completion_service/credentials"
26
26
  require "google/cloud/discovery_engine/v1/completion_service/paths"
27
+ require "google/cloud/discovery_engine/v1/completion_service/operations"
27
28
  require "google/cloud/discovery_engine/v1/completion_service/client"
28
29
  require "google/cloud/discovery_engine/v1/completion_service/rest"
29
30
 
@@ -193,7 +193,7 @@ module Google
193
193
  # @param options [::Gapic::CallOptions, ::Hash]
194
194
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
195
195
  #
196
- # @overload converse_conversation(name: nil, query: nil, serving_config: nil, conversation: nil, safe_search: nil, user_labels: nil, summary_spec: nil)
196
+ # @overload converse_conversation(name: nil, query: nil, serving_config: nil, conversation: nil, safe_search: nil, user_labels: nil, summary_spec: nil, filter: nil)
197
197
  # Pass arguments to `converse_conversation` via keyword arguments. Note that at
198
198
  # least one keyword argument is required. To specify no parameters, or to keep all
199
199
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -237,6 +237,23 @@ module Google
237
237
  # for more details.
238
238
  # @param summary_spec [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::ContentSearchSpec::SummarySpec, ::Hash]
239
239
  # A specification for configuring the summary returned in the response.
240
+ # @param filter [::String]
241
+ # The filter syntax consists of an expression language for constructing a
242
+ # predicate from one or more fields of the documents being filtered. Filter
243
+ # expression is case-sensitive. This will be used to filter search results
244
+ # which may affect the summary response.
245
+ #
246
+ # If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
247
+ #
248
+ # Filtering in Vertex AI Search is done by mapping the LHS filter key to a
249
+ # key property defined in the Vertex AI Search backend -- this mapping is
250
+ # defined by the customer in their schema. For example a media customer might
251
+ # have a field 'name' in their schema. In this case the filter would look
252
+ # like this: filter --> name:'ANY("king kong")'
253
+ #
254
+ # For more information about filtering including syntax and filter
255
+ # operators, see
256
+ # [Filter](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)
240
257
  #
241
258
  # @yield [response, operation] Access the result along with the RPC operation
242
259
  # @yieldparam response [::Google::Cloud::DiscoveryEngine::V1::ConverseConversationResponse]
@@ -512,7 +529,7 @@ module Google
512
529
  # {::Google::Cloud::DiscoveryEngine::V1::Conversation Conversation} to update. The
513
530
  # following are NOT supported:
514
531
  #
515
- # * [conversation.name][]
532
+ # * {::Google::Cloud::DiscoveryEngine::V1::Conversation#name Conversation.name}
516
533
  #
517
534
  # If not set or empty, all supported fields are updated.
518
535
  #
@@ -668,7 +685,7 @@ module Google
668
685
 
669
686
  ##
670
687
  # Lists all Conversations by their parent
671
- # [DataStore][google.cloud.discoveryengine.v1.DataStore].
688
+ # {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore}.
672
689
  #
673
690
  # @overload list_conversations(request, options = nil)
674
691
  # Pass arguments to `list_conversations` via a request object, either of type
@@ -48,6 +48,17 @@ module Google
48
48
  # @param data_store [String]
49
49
  # @param conversation [String]
50
50
  #
51
+ # @overload conversation_path(project:, location:, collection:, engine:, conversation:)
52
+ # The resource will be in the following format:
53
+ #
54
+ # `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/conversations/{conversation}`
55
+ #
56
+ # @param project [String]
57
+ # @param location [String]
58
+ # @param collection [String]
59
+ # @param engine [String]
60
+ # @param conversation [String]
61
+ #
51
62
  # @return [::String]
52
63
  def conversation_path **args
53
64
  resources = {
@@ -65,6 +76,14 @@ module Google
65
76
  raise ::ArgumentError, "data_store cannot contain /" if data_store.to_s.include? "/"
66
77
 
67
78
  "projects/#{project}/locations/#{location}/collections/#{collection}/dataStores/#{data_store}/conversations/#{conversation}"
79
+ end),
80
+ "collection:conversation:engine:location:project" => (proc do |project:, location:, collection:, engine:, conversation:|
81
+ raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
82
+ raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
83
+ raise ::ArgumentError, "collection cannot contain /" if collection.to_s.include? "/"
84
+ raise ::ArgumentError, "engine cannot contain /" if engine.to_s.include? "/"
85
+
86
+ "projects/#{project}/locations/#{location}/collections/#{collection}/engines/#{engine}/conversations/#{conversation}"
68
87
  end)
69
88
  }
70
89
 
@@ -118,6 +137,59 @@ module Google
118
137
  resource.call(**args)
119
138
  end
120
139
 
140
+ ##
141
+ # Create a fully-qualified Document resource string.
142
+ #
143
+ # @overload document_path(project:, location:, data_store:, branch:, document:)
144
+ # The resource will be in the following format:
145
+ #
146
+ # `projects/{project}/locations/{location}/dataStores/{data_store}/branches/{branch}/documents/{document}`
147
+ #
148
+ # @param project [String]
149
+ # @param location [String]
150
+ # @param data_store [String]
151
+ # @param branch [String]
152
+ # @param document [String]
153
+ #
154
+ # @overload document_path(project:, location:, collection:, data_store:, branch:, document:)
155
+ # The resource will be in the following format:
156
+ #
157
+ # `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document}`
158
+ #
159
+ # @param project [String]
160
+ # @param location [String]
161
+ # @param collection [String]
162
+ # @param data_store [String]
163
+ # @param branch [String]
164
+ # @param document [String]
165
+ #
166
+ # @return [::String]
167
+ def document_path **args
168
+ resources = {
169
+ "branch:data_store:document:location:project" => (proc do |project:, location:, data_store:, branch:, document:|
170
+ raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
171
+ raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
172
+ raise ::ArgumentError, "data_store cannot contain /" if data_store.to_s.include? "/"
173
+ raise ::ArgumentError, "branch cannot contain /" if branch.to_s.include? "/"
174
+
175
+ "projects/#{project}/locations/#{location}/dataStores/#{data_store}/branches/#{branch}/documents/#{document}"
176
+ end),
177
+ "branch:collection:data_store:document:location:project" => (proc do |project:, location:, collection:, data_store:, branch:, document:|
178
+ raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
179
+ raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
180
+ raise ::ArgumentError, "collection cannot contain /" if collection.to_s.include? "/"
181
+ raise ::ArgumentError, "data_store cannot contain /" if data_store.to_s.include? "/"
182
+ raise ::ArgumentError, "branch cannot contain /" if branch.to_s.include? "/"
183
+
184
+ "projects/#{project}/locations/#{location}/collections/#{collection}/dataStores/#{data_store}/branches/#{branch}/documents/#{document}"
185
+ end)
186
+ }
187
+
188
+ resource = resources[args.keys.sort.join(":")]
189
+ raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
190
+ resource.call(**args)
191
+ end
192
+
121
193
  ##
122
194
  # Create a fully-qualified ServingConfig resource string.
123
195
  #
@@ -142,6 +214,17 @@ module Google
142
214
  # @param data_store [String]
143
215
  # @param serving_config [String]
144
216
  #
217
+ # @overload serving_config_path(project:, location:, collection:, engine:, serving_config:)
218
+ # The resource will be in the following format:
219
+ #
220
+ # `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config}`
221
+ #
222
+ # @param project [String]
223
+ # @param location [String]
224
+ # @param collection [String]
225
+ # @param engine [String]
226
+ # @param serving_config [String]
227
+ #
145
228
  # @return [::String]
146
229
  def serving_config_path **args
147
230
  resources = {
@@ -159,6 +242,14 @@ module Google
159
242
  raise ::ArgumentError, "data_store cannot contain /" if data_store.to_s.include? "/"
160
243
 
161
244
  "projects/#{project}/locations/#{location}/collections/#{collection}/dataStores/#{data_store}/servingConfigs/#{serving_config}"
245
+ end),
246
+ "collection:engine:location:project:serving_config" => (proc do |project:, location:, collection:, engine:, serving_config:|
247
+ raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
248
+ raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
249
+ raise ::ArgumentError, "collection cannot contain /" if collection.to_s.include? "/"
250
+ raise ::ArgumentError, "engine cannot contain /" if engine.to_s.include? "/"
251
+
252
+ "projects/#{project}/locations/#{location}/collections/#{collection}/engines/#{engine}/servingConfigs/#{serving_config}"
162
253
  end)
163
254
  }
164
255
 
@@ -186,7 +186,7 @@ module Google
186
186
  # @param options [::Gapic::CallOptions, ::Hash]
187
187
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
188
188
  #
189
- # @overload converse_conversation(name: nil, query: nil, serving_config: nil, conversation: nil, safe_search: nil, user_labels: nil, summary_spec: nil)
189
+ # @overload converse_conversation(name: nil, query: nil, serving_config: nil, conversation: nil, safe_search: nil, user_labels: nil, summary_spec: nil, filter: nil)
190
190
  # Pass arguments to `converse_conversation` via keyword arguments. Note that at
191
191
  # least one keyword argument is required. To specify no parameters, or to keep all
192
192
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -230,6 +230,23 @@ module Google
230
230
  # for more details.
231
231
  # @param summary_spec [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::ContentSearchSpec::SummarySpec, ::Hash]
232
232
  # A specification for configuring the summary returned in the response.
233
+ # @param filter [::String]
234
+ # The filter syntax consists of an expression language for constructing a
235
+ # predicate from one or more fields of the documents being filtered. Filter
236
+ # expression is case-sensitive. This will be used to filter search results
237
+ # which may affect the summary response.
238
+ #
239
+ # If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
240
+ #
241
+ # Filtering in Vertex AI Search is done by mapping the LHS filter key to a
242
+ # key property defined in the Vertex AI Search backend -- this mapping is
243
+ # defined by the customer in their schema. For example a media customer might
244
+ # have a field 'name' in their schema. In this case the filter would look
245
+ # like this: filter --> name:'ANY("king kong")'
246
+ #
247
+ # For more information about filtering including syntax and filter
248
+ # operators, see
249
+ # [Filter](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)
233
250
  # @yield [result, operation] Access the result along with the TransportOperation object
234
251
  # @yieldparam result [::Google::Cloud::DiscoveryEngine::V1::ConverseConversationResponse]
235
252
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -484,7 +501,7 @@ module Google
484
501
  # {::Google::Cloud::DiscoveryEngine::V1::Conversation Conversation} to update. The
485
502
  # following are NOT supported:
486
503
  #
487
- # * [conversation.name][]
504
+ # * {::Google::Cloud::DiscoveryEngine::V1::Conversation#name Conversation.name}
488
505
  #
489
506
  # If not set or empty, all supported fields are updated.
490
507
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -626,7 +643,7 @@ module Google
626
643
 
627
644
  ##
628
645
  # Lists all Conversations by their parent
629
- # [DataStore][google.cloud.discoveryengine.v1.DataStore].
646
+ # {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore}.
630
647
  #
631
648
  # @overload list_conversations(request, options = nil)
632
649
  # Pass arguments to `list_conversations` via a request object, either of type
@@ -316,6 +316,14 @@ module Google
316
316
  ["name", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/conversations/[^/]+/?$}, false]
317
317
  ]
318
318
  )
319
+ .with_bindings(
320
+ uri_method: :post,
321
+ uri_template: "/v1/{name}:converse",
322
+ body: "*",
323
+ matches: [
324
+ ["name", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/conversations/[^/]+/?$}, false]
325
+ ]
326
+ )
319
327
  transcoder.transcode request_pb
320
328
  end
321
329
 
@@ -346,6 +354,14 @@ module Google
346
354
  ["parent", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/?$}, false]
347
355
  ]
348
356
  )
357
+ .with_bindings(
358
+ uri_method: :post,
359
+ uri_template: "/v1/{parent}/conversations",
360
+ body: "conversation",
361
+ matches: [
362
+ ["parent", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/?$}, false]
363
+ ]
364
+ )
349
365
  transcoder.transcode request_pb
350
366
  end
351
367
 
@@ -374,6 +390,13 @@ module Google
374
390
  ["name", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/conversations/[^/]+/?$}, false]
375
391
  ]
376
392
  )
393
+ .with_bindings(
394
+ uri_method: :delete,
395
+ uri_template: "/v1/{name}",
396
+ matches: [
397
+ ["name", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/conversations/[^/]+/?$}, false]
398
+ ]
399
+ )
377
400
  transcoder.transcode request_pb
378
401
  end
379
402
 
@@ -404,6 +427,14 @@ module Google
404
427
  ["conversation.name", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/conversations/[^/]+/?$}, false]
405
428
  ]
406
429
  )
430
+ .with_bindings(
431
+ uri_method: :patch,
432
+ uri_template: "/v1/{conversation.name}",
433
+ body: "conversation",
434
+ matches: [
435
+ ["conversation.name", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/conversations/[^/]+/?$}, false]
436
+ ]
437
+ )
407
438
  transcoder.transcode request_pb
408
439
  end
409
440
 
@@ -432,6 +463,13 @@ module Google
432
463
  ["name", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/conversations/[^/]+/?$}, false]
433
464
  ]
434
465
  )
466
+ .with_bindings(
467
+ uri_method: :get,
468
+ uri_template: "/v1/{name}",
469
+ matches: [
470
+ ["name", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/conversations/[^/]+/?$}, false]
471
+ ]
472
+ )
435
473
  transcoder.transcode request_pb
436
474
  end
437
475
 
@@ -460,6 +498,13 @@ module Google
460
498
  ["parent", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/?$}, false]
461
499
  ]
462
500
  )
501
+ .with_bindings(
502
+ uri_method: :get,
503
+ uri_template: "/v1/{parent}/conversations",
504
+ matches: [
505
+ ["parent", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/?$}, false]
506
+ ]
507
+ )
463
508
  transcoder.transcode request_pb
464
509
  end
465
510
  end