google-apis-discoveryengine_v1beta 0.51.0 → 0.53.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -2173,6 +2173,45 @@ module Google
2173
2173
  execute_or_queue_command(command, &block)
2174
2174
  end
2175
2175
 
2176
+ # Answer query method (streaming). It takes one AnswerQueryRequest and returns
2177
+ # multiple AnswerQueryResponse messages in a stream.
2178
+ # @param [String] serving_config
2179
+ # Required. The resource name of the Search serving config, such as `projects/*/
2180
+ # locations/global/collections/default_collection/engines/*/servingConfigs/
2181
+ # default_serving_config`, or `projects/*/locations/global/collections/
2182
+ # default_collection/dataStores/*/servingConfigs/default_serving_config`. This
2183
+ # field is used to identify the serving configuration name, set of models used
2184
+ # to make the search.
2185
+ # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryRequest] google_cloud_discoveryengine_v1beta_answer_query_request_object
2186
+ # @param [String] fields
2187
+ # Selector specifying which fields to include in a partial response.
2188
+ # @param [String] quota_user
2189
+ # Available to use for quota purposes for server-side applications. Can be any
2190
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2191
+ # @param [Google::Apis::RequestOptions] options
2192
+ # Request-specific options
2193
+ #
2194
+ # @yield [result, err] Result & error if block supplied
2195
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse] parsed result object
2196
+ # @yieldparam err [StandardError] error object if request failed
2197
+ #
2198
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse]
2199
+ #
2200
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2201
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2202
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2203
+ def stream_project_location_collection_data_store_serving_config_answer(serving_config, google_cloud_discoveryengine_v1beta_answer_query_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2204
+ command = make_simple_command(:post, 'v1beta/{+servingConfig}:streamAnswer', options)
2205
+ command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryRequest::Representation
2206
+ command.request_object = google_cloud_discoveryengine_v1beta_answer_query_request_object
2207
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse::Representation
2208
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse
2209
+ command.params['servingConfig'] = serving_config unless serving_config.nil?
2210
+ command.query['fields'] = fields unless fields.nil?
2211
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2212
+ execute_or_queue_command(command, &block)
2213
+ end
2214
+
2176
2215
  # Creates a Session. If the Session to create already exists, an ALREADY_EXISTS
2177
2216
  # error is returned.
2178
2217
  # @param [String] parent
@@ -2246,6 +2285,9 @@ module Google
2246
2285
  # Required. The resource name of the Session to get. Format: `projects/`project`/
2247
2286
  # locations/`location`/collections/`collection`/dataStores/`data_store_id`/
2248
2287
  # sessions/`session_id``
2288
+ # @param [Boolean] include_answer_details
2289
+ # Optional. If set to true, the full session including all answer details will
2290
+ # be returned.
2249
2291
  # @param [String] fields
2250
2292
  # Selector specifying which fields to include in a partial response.
2251
2293
  # @param [String] quota_user
@@ -2263,11 +2305,12 @@ module Google
2263
2305
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2264
2306
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2265
2307
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2266
- def get_project_location_collection_data_store_session(name, fields: nil, quota_user: nil, options: nil, &block)
2308
+ def get_project_location_collection_data_store_session(name, include_answer_details: nil, fields: nil, quota_user: nil, options: nil, &block)
2267
2309
  command = make_simple_command(:get, 'v1beta/{+name}', options)
2268
2310
  command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession::Representation
2269
2311
  command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession
2270
2312
  command.params['name'] = name unless name.nil?
2313
+ command.query['includeAnswerDetails'] = include_answer_details unless include_answer_details.nil?
2271
2314
  command.query['fields'] = fields unless fields.nil?
2272
2315
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2273
2316
  execute_or_queue_command(command, &block)
@@ -2283,7 +2326,9 @@ module Google
2283
2326
  # @param [String] order_by
2284
2327
  # A comma-separated list of fields to order by, sorted in ascending order. Use "
2285
2328
  # desc" after a field name for descending. Supported fields: * `update_time` * `
2286
- # create_time` * `session_name` Example: "update_time desc" "create_time"
2329
+ # create_time` * `session_name` * `is_pinned` Example: * "update_time desc" * "
2330
+ # create_time" * "is_pinned desc,update_time desc": list sessions by is_pinned
2331
+ # first, then by update_time.
2287
2332
  # @param [Fixnum] page_size
2288
2333
  # Maximum number of results to return. If unspecified, defaults to 50. Max
2289
2334
  # allowed value is 1000.
@@ -3082,8 +3127,12 @@ module Google
3082
3127
  # only by the Discovery Engine API JavaScript pixel and Google Tag Manager.
3083
3128
  # Users should not call this method directly.
3084
3129
  # @param [String] parent
3085
- # Required. The parent DataStore resource name, such as `projects/`project`/
3086
- # locations/`location`/collections/`collection`/dataStores/`data_store``.
3130
+ # Required. The parent resource name. If the collect user event action is
3131
+ # applied in DataStore level, the format is: `projects/`project`/locations/`
3132
+ # location`/collections/`collection`/dataStores/`data_store``. If the collect
3133
+ # user event action is applied in Location level, for example, the event with
3134
+ # Document across multiple DataStore, the format is: `projects/`project`/
3135
+ # locations/`location``.
3087
3136
  # @param [Fixnum] ets
3088
3137
  # The event timestamp in milliseconds. This prevents browser caching of
3089
3138
  # otherwise identical get requests. The name is abbreviated to reduce the
@@ -4337,6 +4386,45 @@ module Google
4337
4386
  execute_or_queue_command(command, &block)
4338
4387
  end
4339
4388
 
4389
+ # Answer query method (streaming). It takes one AnswerQueryRequest and returns
4390
+ # multiple AnswerQueryResponse messages in a stream.
4391
+ # @param [String] serving_config
4392
+ # Required. The resource name of the Search serving config, such as `projects/*/
4393
+ # locations/global/collections/default_collection/engines/*/servingConfigs/
4394
+ # default_serving_config`, or `projects/*/locations/global/collections/
4395
+ # default_collection/dataStores/*/servingConfigs/default_serving_config`. This
4396
+ # field is used to identify the serving configuration name, set of models used
4397
+ # to make the search.
4398
+ # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryRequest] google_cloud_discoveryengine_v1beta_answer_query_request_object
4399
+ # @param [String] fields
4400
+ # Selector specifying which fields to include in a partial response.
4401
+ # @param [String] quota_user
4402
+ # Available to use for quota purposes for server-side applications. Can be any
4403
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4404
+ # @param [Google::Apis::RequestOptions] options
4405
+ # Request-specific options
4406
+ #
4407
+ # @yield [result, err] Result & error if block supplied
4408
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse] parsed result object
4409
+ # @yieldparam err [StandardError] error object if request failed
4410
+ #
4411
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse]
4412
+ #
4413
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4414
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4415
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4416
+ def stream_project_location_collection_engine_serving_config_answer(serving_config, google_cloud_discoveryengine_v1beta_answer_query_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
4417
+ command = make_simple_command(:post, 'v1beta/{+servingConfig}:streamAnswer', options)
4418
+ command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryRequest::Representation
4419
+ command.request_object = google_cloud_discoveryengine_v1beta_answer_query_request_object
4420
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse::Representation
4421
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse
4422
+ command.params['servingConfig'] = serving_config unless serving_config.nil?
4423
+ command.query['fields'] = fields unless fields.nil?
4424
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4425
+ execute_or_queue_command(command, &block)
4426
+ end
4427
+
4340
4428
  # Creates a Session. If the Session to create already exists, an ALREADY_EXISTS
4341
4429
  # error is returned.
4342
4430
  # @param [String] parent
@@ -4410,6 +4498,9 @@ module Google
4410
4498
  # Required. The resource name of the Session to get. Format: `projects/`project`/
4411
4499
  # locations/`location`/collections/`collection`/dataStores/`data_store_id`/
4412
4500
  # sessions/`session_id``
4501
+ # @param [Boolean] include_answer_details
4502
+ # Optional. If set to true, the full session including all answer details will
4503
+ # be returned.
4413
4504
  # @param [String] fields
4414
4505
  # Selector specifying which fields to include in a partial response.
4415
4506
  # @param [String] quota_user
@@ -4427,11 +4518,12 @@ module Google
4427
4518
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4428
4519
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4429
4520
  # @raise [Google::Apis::AuthorizationError] Authorization is required
4430
- def get_project_location_collection_engine_session(name, fields: nil, quota_user: nil, options: nil, &block)
4521
+ def get_project_location_collection_engine_session(name, include_answer_details: nil, fields: nil, quota_user: nil, options: nil, &block)
4431
4522
  command = make_simple_command(:get, 'v1beta/{+name}', options)
4432
4523
  command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession::Representation
4433
4524
  command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession
4434
4525
  command.params['name'] = name unless name.nil?
4526
+ command.query['includeAnswerDetails'] = include_answer_details unless include_answer_details.nil?
4435
4527
  command.query['fields'] = fields unless fields.nil?
4436
4528
  command.query['quotaUser'] = quota_user unless quota_user.nil?
4437
4529
  execute_or_queue_command(command, &block)
@@ -4447,7 +4539,9 @@ module Google
4447
4539
  # @param [String] order_by
4448
4540
  # A comma-separated list of fields to order by, sorted in ascending order. Use "
4449
4541
  # desc" after a field name for descending. Supported fields: * `update_time` * `
4450
- # create_time` * `session_name` Example: "update_time desc" "create_time"
4542
+ # create_time` * `session_name` * `is_pinned` Example: * "update_time desc" * "
4543
+ # create_time" * "is_pinned desc,update_time desc": list sessions by is_pinned
4544
+ # first, then by update_time.
4451
4545
  # @param [Fixnum] page_size
4452
4546
  # Maximum number of results to return. If unspecified, defaults to 50. Max
4453
4547
  # allowed value is 1000.
@@ -6504,6 +6598,45 @@ module Google
6504
6598
  execute_or_queue_command(command, &block)
6505
6599
  end
6506
6600
 
6601
+ # Answer query method (streaming). It takes one AnswerQueryRequest and returns
6602
+ # multiple AnswerQueryResponse messages in a stream.
6603
+ # @param [String] serving_config
6604
+ # Required. The resource name of the Search serving config, such as `projects/*/
6605
+ # locations/global/collections/default_collection/engines/*/servingConfigs/
6606
+ # default_serving_config`, or `projects/*/locations/global/collections/
6607
+ # default_collection/dataStores/*/servingConfigs/default_serving_config`. This
6608
+ # field is used to identify the serving configuration name, set of models used
6609
+ # to make the search.
6610
+ # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryRequest] google_cloud_discoveryengine_v1beta_answer_query_request_object
6611
+ # @param [String] fields
6612
+ # Selector specifying which fields to include in a partial response.
6613
+ # @param [String] quota_user
6614
+ # Available to use for quota purposes for server-side applications. Can be any
6615
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6616
+ # @param [Google::Apis::RequestOptions] options
6617
+ # Request-specific options
6618
+ #
6619
+ # @yield [result, err] Result & error if block supplied
6620
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse] parsed result object
6621
+ # @yieldparam err [StandardError] error object if request failed
6622
+ #
6623
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse]
6624
+ #
6625
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6626
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6627
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6628
+ def stream_project_location_data_store_serving_config_answer(serving_config, google_cloud_discoveryengine_v1beta_answer_query_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
6629
+ command = make_simple_command(:post, 'v1beta/{+servingConfig}:streamAnswer', options)
6630
+ command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryRequest::Representation
6631
+ command.request_object = google_cloud_discoveryengine_v1beta_answer_query_request_object
6632
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse::Representation
6633
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse
6634
+ command.params['servingConfig'] = serving_config unless serving_config.nil?
6635
+ command.query['fields'] = fields unless fields.nil?
6636
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6637
+ execute_or_queue_command(command, &block)
6638
+ end
6639
+
6507
6640
  # Creates a Session. If the Session to create already exists, an ALREADY_EXISTS
6508
6641
  # error is returned.
6509
6642
  # @param [String] parent
@@ -6577,6 +6710,9 @@ module Google
6577
6710
  # Required. The resource name of the Session to get. Format: `projects/`project`/
6578
6711
  # locations/`location`/collections/`collection`/dataStores/`data_store_id`/
6579
6712
  # sessions/`session_id``
6713
+ # @param [Boolean] include_answer_details
6714
+ # Optional. If set to true, the full session including all answer details will
6715
+ # be returned.
6580
6716
  # @param [String] fields
6581
6717
  # Selector specifying which fields to include in a partial response.
6582
6718
  # @param [String] quota_user
@@ -6594,11 +6730,12 @@ module Google
6594
6730
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6595
6731
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6596
6732
  # @raise [Google::Apis::AuthorizationError] Authorization is required
6597
- def get_project_location_data_store_session(name, fields: nil, quota_user: nil, options: nil, &block)
6733
+ def get_project_location_data_store_session(name, include_answer_details: nil, fields: nil, quota_user: nil, options: nil, &block)
6598
6734
  command = make_simple_command(:get, 'v1beta/{+name}', options)
6599
6735
  command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession::Representation
6600
6736
  command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession
6601
6737
  command.params['name'] = name unless name.nil?
6738
+ command.query['includeAnswerDetails'] = include_answer_details unless include_answer_details.nil?
6602
6739
  command.query['fields'] = fields unless fields.nil?
6603
6740
  command.query['quotaUser'] = quota_user unless quota_user.nil?
6604
6741
  execute_or_queue_command(command, &block)
@@ -6614,7 +6751,9 @@ module Google
6614
6751
  # @param [String] order_by
6615
6752
  # A comma-separated list of fields to order by, sorted in ascending order. Use "
6616
6753
  # desc" after a field name for descending. Supported fields: * `update_time` * `
6617
- # create_time` * `session_name` Example: "update_time desc" "create_time"
6754
+ # create_time` * `session_name` * `is_pinned` Example: * "update_time desc" * "
6755
+ # create_time" * "is_pinned desc,update_time desc": list sessions by is_pinned
6756
+ # first, then by update_time.
6618
6757
  # @param [Fixnum] page_size
6619
6758
  # Maximum number of results to return. If unspecified, defaults to 50. Max
6620
6759
  # allowed value is 1000.
@@ -7224,8 +7363,12 @@ module Google
7224
7363
  # only by the Discovery Engine API JavaScript pixel and Google Tag Manager.
7225
7364
  # Users should not call this method directly.
7226
7365
  # @param [String] parent
7227
- # Required. The parent DataStore resource name, such as `projects/`project`/
7228
- # locations/`location`/collections/`collection`/dataStores/`data_store``.
7366
+ # Required. The parent resource name. If the collect user event action is
7367
+ # applied in DataStore level, the format is: `projects/`project`/locations/`
7368
+ # location`/collections/`collection`/dataStores/`data_store``. If the collect
7369
+ # user event action is applied in Location level, for example, the event with
7370
+ # Document across multiple DataStore, the format is: `projects/`project`/
7371
+ # locations/`location``.
7229
7372
  # @param [Fixnum] ets
7230
7373
  # The event timestamp in milliseconds. This prevents browser caching of
7231
7374
  # otherwise identical get requests. The name is abbreviated to reduce the
@@ -8257,8 +8400,12 @@ module Google
8257
8400
  # only by the Discovery Engine API JavaScript pixel and Google Tag Manager.
8258
8401
  # Users should not call this method directly.
8259
8402
  # @param [String] parent
8260
- # Required. The parent DataStore resource name, such as `projects/`project`/
8261
- # locations/`location`/collections/`collection`/dataStores/`data_store``.
8403
+ # Required. The parent resource name. If the collect user event action is
8404
+ # applied in DataStore level, the format is: `projects/`project`/locations/`
8405
+ # location`/collections/`collection`/dataStores/`data_store``. If the collect
8406
+ # user event action is applied in Location level, for example, the event with
8407
+ # Document across multiple DataStore, the format is: `projects/`project`/
8408
+ # locations/`location``.
8262
8409
  # @param [Fixnum] ets
8263
8410
  # The event timestamp in milliseconds. This prevents browser caching of
8264
8411
  # otherwise identical get requests. The name is abbreviated to reduce the
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-discoveryengine_v1beta
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.51.0
4
+ version: 0.53.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-12-04 00:00:00.000000000 Z
11
+ date: 2024-12-15 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
60
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-discoveryengine_v1beta/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-discoveryengine_v1beta/v0.51.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-discoveryengine_v1beta/v0.53.0
62
62
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-discoveryengine_v1beta
63
63
  post_install_message:
64
64
  rdoc_options: []
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
75
75
  - !ruby/object:Gem::Version
76
76
  version: '0'
77
77
  requirements: []
78
- rubygems_version: 3.5.22
78
+ rubygems_version: 3.5.23
79
79
  signing_key:
80
80
  specification_version: 4
81
81
  summary: Simple REST client for Discovery Engine API V1beta