google-apis-discoveryengine_v1alpha 0.50.0 → 0.52.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -1252,6 +1252,75 @@ module Google
1252
1252
  execute_or_queue_command(command, &block)
1253
1253
  end
1254
1254
 
1255
+ # Imports CompletionSuggestions for a DataStore.
1256
+ # @param [String] parent
1257
+ # Required. The parent data store resource name for which to import customer
1258
+ # autocomplete suggestions. Follows pattern `projects/*/locations/*/collections/*
1259
+ # /dataStores/*`
1260
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaImportCompletionSuggestionsRequest] google_cloud_discoveryengine_v1alpha_import_completion_suggestions_request_object
1261
+ # @param [String] fields
1262
+ # Selector specifying which fields to include in a partial response.
1263
+ # @param [String] quota_user
1264
+ # Available to use for quota purposes for server-side applications. Can be any
1265
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1266
+ # @param [Google::Apis::RequestOptions] options
1267
+ # Request-specific options
1268
+ #
1269
+ # @yield [result, err] Result & error if block supplied
1270
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation] parsed result object
1271
+ # @yieldparam err [StandardError] error object if request failed
1272
+ #
1273
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation]
1274
+ #
1275
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1276
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1277
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1278
+ def import_project_location_collection_data_store_completion_suggestion(parent, google_cloud_discoveryengine_v1alpha_import_completion_suggestions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1279
+ command = make_simple_command(:post, 'v1alpha/{+parent}/completionSuggestions:import', options)
1280
+ command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaImportCompletionSuggestionsRequest::Representation
1281
+ command.request_object = google_cloud_discoveryengine_v1alpha_import_completion_suggestions_request_object
1282
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation::Representation
1283
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation
1284
+ command.params['parent'] = parent unless parent.nil?
1285
+ command.query['fields'] = fields unless fields.nil?
1286
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1287
+ execute_or_queue_command(command, &block)
1288
+ end
1289
+
1290
+ # Permanently deletes all CompletionSuggestions for a DataStore.
1291
+ # @param [String] parent
1292
+ # Required. The parent data store resource name for which to purge completion
1293
+ # suggestions. Follows pattern projects/*/locations/*/collections/*/dataStores/*.
1294
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaPurgeCompletionSuggestionsRequest] google_cloud_discoveryengine_v1alpha_purge_completion_suggestions_request_object
1295
+ # @param [String] fields
1296
+ # Selector specifying which fields to include in a partial response.
1297
+ # @param [String] quota_user
1298
+ # Available to use for quota purposes for server-side applications. Can be any
1299
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1300
+ # @param [Google::Apis::RequestOptions] options
1301
+ # Request-specific options
1302
+ #
1303
+ # @yield [result, err] Result & error if block supplied
1304
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation] parsed result object
1305
+ # @yieldparam err [StandardError] error object if request failed
1306
+ #
1307
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation]
1308
+ #
1309
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1310
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1311
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1312
+ def purge_project_location_collection_data_store_completion_suggestion(parent, google_cloud_discoveryengine_v1alpha_purge_completion_suggestions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1313
+ command = make_simple_command(:post, 'v1alpha/{+parent}/completionSuggestions:purge', options)
1314
+ command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaPurgeCompletionSuggestionsRequest::Representation
1315
+ command.request_object = google_cloud_discoveryengine_v1alpha_purge_completion_suggestions_request_object
1316
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation::Representation
1317
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation
1318
+ command.params['parent'] = parent unless parent.nil?
1319
+ command.query['fields'] = fields unless fields.nil?
1320
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1321
+ execute_or_queue_command(command, &block)
1322
+ end
1323
+
1255
1324
  # Creates a Control. By default 1000 controls are allowed for a data store. A
1256
1325
  # request can be submitted to adjust this limit. If the Control to create
1257
1326
  # already exists, an ALREADY_EXISTS error is returned.
@@ -2705,6 +2774,38 @@ module Google
2705
2774
  execute_or_queue_command(command, &block)
2706
2775
  end
2707
2776
 
2777
+ # Gets the URI Pattern to Document data mapping for an Advanced Site Search
2778
+ # DataStore.
2779
+ # @param [String] site_search_engine
2780
+ # Required. Full resource name of the SiteSearchEngine, such as `projects/*/
2781
+ # locations/*/collections/*/dataStores/*/siteSearchEngine`.
2782
+ # @param [String] fields
2783
+ # Selector specifying which fields to include in a partial response.
2784
+ # @param [String] quota_user
2785
+ # Available to use for quota purposes for server-side applications. Can be any
2786
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2787
+ # @param [Google::Apis::RequestOptions] options
2788
+ # Request-specific options
2789
+ #
2790
+ # @yield [result, err] Result & error if block supplied
2791
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaGetUriPatternDocumentDataResponse] parsed result object
2792
+ # @yieldparam err [StandardError] error object if request failed
2793
+ #
2794
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaGetUriPatternDocumentDataResponse]
2795
+ #
2796
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2797
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2798
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2799
+ def get_project_location_collection_data_store_site_search_engine_uri_pattern_document_data(site_search_engine, fields: nil, quota_user: nil, options: nil, &block)
2800
+ command = make_simple_command(:get, 'v1alpha/{+siteSearchEngine}:getUriPatternDocumentData', options)
2801
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaGetUriPatternDocumentDataResponse::Representation
2802
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaGetUriPatternDocumentDataResponse
2803
+ command.params['siteSearchEngine'] = site_search_engine unless site_search_engine.nil?
2804
+ command.query['fields'] = fields unless fields.nil?
2805
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2806
+ execute_or_queue_command(command, &block)
2807
+ end
2808
+
2708
2809
  # Request on-demand recrawl for a list of URIs.
2709
2810
  # @param [String] site_search_engine
2710
2811
  # Required. Full resource name of the SiteSearchEngine, such as `projects/*/
@@ -2739,6 +2840,41 @@ module Google
2739
2840
  execute_or_queue_command(command, &block)
2740
2841
  end
2741
2842
 
2843
+ # Sets the URI Pattern to Document data mapping for an Advanced Site Search
2844
+ # DataStore.
2845
+ # @param [String] site_search_engine
2846
+ # Required. Full resource name of the SiteSearchEngine, such as `projects/*/
2847
+ # locations/*/collections/*/dataStores/*/siteSearchEngine`.
2848
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSetUriPatternDocumentDataRequest] google_cloud_discoveryengine_v1alpha_set_uri_pattern_document_data_request_object
2849
+ # @param [String] fields
2850
+ # Selector specifying which fields to include in a partial response.
2851
+ # @param [String] quota_user
2852
+ # Available to use for quota purposes for server-side applications. Can be any
2853
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2854
+ # @param [Google::Apis::RequestOptions] options
2855
+ # Request-specific options
2856
+ #
2857
+ # @yield [result, err] Result & error if block supplied
2858
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation] parsed result object
2859
+ # @yieldparam err [StandardError] error object if request failed
2860
+ #
2861
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation]
2862
+ #
2863
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2864
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2865
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2866
+ def set_project_location_collection_data_store_site_search_engine_uri_pattern_document_data(site_search_engine, google_cloud_discoveryengine_v1alpha_set_uri_pattern_document_data_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2867
+ command = make_simple_command(:post, 'v1alpha/{+siteSearchEngine}:setUriPatternDocumentData', options)
2868
+ command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSetUriPatternDocumentDataRequest::Representation
2869
+ command.request_object = google_cloud_discoveryengine_v1alpha_set_uri_pattern_document_data_request_object
2870
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation::Representation
2871
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation
2872
+ command.params['siteSearchEngine'] = site_search_engine unless site_search_engine.nil?
2873
+ command.query['fields'] = fields unless fields.nil?
2874
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2875
+ execute_or_queue_command(command, &block)
2876
+ end
2877
+
2742
2878
  # Gets the latest state of a long-running operation. Clients can use this method
2743
2879
  # to poll the operation result at intervals as recommended by the API service.
2744
2880
  # @param [String] name
@@ -5532,6 +5668,75 @@ module Google
5532
5668
  execute_or_queue_command(command, &block)
5533
5669
  end
5534
5670
 
5671
+ # Imports CompletionSuggestions for a DataStore.
5672
+ # @param [String] parent
5673
+ # Required. The parent data store resource name for which to import customer
5674
+ # autocomplete suggestions. Follows pattern `projects/*/locations/*/collections/*
5675
+ # /dataStores/*`
5676
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaImportCompletionSuggestionsRequest] google_cloud_discoveryengine_v1alpha_import_completion_suggestions_request_object
5677
+ # @param [String] fields
5678
+ # Selector specifying which fields to include in a partial response.
5679
+ # @param [String] quota_user
5680
+ # Available to use for quota purposes for server-side applications. Can be any
5681
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5682
+ # @param [Google::Apis::RequestOptions] options
5683
+ # Request-specific options
5684
+ #
5685
+ # @yield [result, err] Result & error if block supplied
5686
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation] parsed result object
5687
+ # @yieldparam err [StandardError] error object if request failed
5688
+ #
5689
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation]
5690
+ #
5691
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5692
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5693
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5694
+ def import_project_location_data_store_completion_suggestion(parent, google_cloud_discoveryengine_v1alpha_import_completion_suggestions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
5695
+ command = make_simple_command(:post, 'v1alpha/{+parent}/completionSuggestions:import', options)
5696
+ command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaImportCompletionSuggestionsRequest::Representation
5697
+ command.request_object = google_cloud_discoveryengine_v1alpha_import_completion_suggestions_request_object
5698
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation::Representation
5699
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation
5700
+ command.params['parent'] = parent unless parent.nil?
5701
+ command.query['fields'] = fields unless fields.nil?
5702
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5703
+ execute_or_queue_command(command, &block)
5704
+ end
5705
+
5706
+ # Permanently deletes all CompletionSuggestions for a DataStore.
5707
+ # @param [String] parent
5708
+ # Required. The parent data store resource name for which to purge completion
5709
+ # suggestions. Follows pattern projects/*/locations/*/collections/*/dataStores/*.
5710
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaPurgeCompletionSuggestionsRequest] google_cloud_discoveryengine_v1alpha_purge_completion_suggestions_request_object
5711
+ # @param [String] fields
5712
+ # Selector specifying which fields to include in a partial response.
5713
+ # @param [String] quota_user
5714
+ # Available to use for quota purposes for server-side applications. Can be any
5715
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5716
+ # @param [Google::Apis::RequestOptions] options
5717
+ # Request-specific options
5718
+ #
5719
+ # @yield [result, err] Result & error if block supplied
5720
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation] parsed result object
5721
+ # @yieldparam err [StandardError] error object if request failed
5722
+ #
5723
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation]
5724
+ #
5725
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5726
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5727
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5728
+ def purge_project_location_data_store_completion_suggestion(parent, google_cloud_discoveryengine_v1alpha_purge_completion_suggestions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
5729
+ command = make_simple_command(:post, 'v1alpha/{+parent}/completionSuggestions:purge', options)
5730
+ command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaPurgeCompletionSuggestionsRequest::Representation
5731
+ command.request_object = google_cloud_discoveryengine_v1alpha_purge_completion_suggestions_request_object
5732
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation::Representation
5733
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation
5734
+ command.params['parent'] = parent unless parent.nil?
5735
+ command.query['fields'] = fields unless fields.nil?
5736
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5737
+ execute_or_queue_command(command, &block)
5738
+ end
5739
+
5535
5740
  # Creates a Control. By default 1000 controls are allowed for a data store. A
5536
5741
  # request can be submitted to adjust this limit. If the Control to create
5537
5742
  # already exists, an ALREADY_EXISTS error is returned.
@@ -7291,10 +7496,12 @@ module Google
7291
7496
  execute_or_queue_command(command, &block)
7292
7497
  end
7293
7498
 
7294
- # Gets the latest state of a long-running operation. Clients can use this method
7295
- # to poll the operation result at intervals as recommended by the API service.
7296
- # @param [String] name
7297
- # The name of the operation resource.
7499
+ # Creates a Evaluation. Upon creation, the evaluation will be automatically
7500
+ # triggered and begin execution.
7501
+ # @param [String] parent
7502
+ # Required. The parent resource name, such as `projects/`project`/locations/`
7503
+ # location``.
7504
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaEvaluation] google_cloud_discoveryengine_v1alpha_evaluation_object
7298
7505
  # @param [String] fields
7299
7506
  # Selector specifying which fields to include in a partial response.
7300
7507
  # @param [String] quota_user
@@ -7312,21 +7519,25 @@ module Google
7312
7519
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7313
7520
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7314
7521
  # @raise [Google::Apis::AuthorizationError] Authorization is required
7315
- def get_project_location_evaluation_operation(name, fields: nil, quota_user: nil, options: nil, &block)
7316
- command = make_simple_command(:get, 'v1alpha/{+name}', options)
7522
+ def create_project_location_evaluation(parent, google_cloud_discoveryengine_v1alpha_evaluation_object = nil, fields: nil, quota_user: nil, options: nil, &block)
7523
+ command = make_simple_command(:post, 'v1alpha/{+parent}/evaluations', options)
7524
+ command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaEvaluation::Representation
7525
+ command.request_object = google_cloud_discoveryengine_v1alpha_evaluation_object
7317
7526
  command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation::Representation
7318
7527
  command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation
7319
- command.params['name'] = name unless name.nil?
7528
+ command.params['parent'] = parent unless parent.nil?
7320
7529
  command.query['fields'] = fields unless fields.nil?
7321
7530
  command.query['quotaUser'] = quota_user unless quota_user.nil?
7322
7531
  execute_or_queue_command(command, &block)
7323
7532
  end
7324
7533
 
7325
- # Performs a grounding check.
7326
- # @param [String] grounding_config
7327
- # Required. The resource name of the grounding config, such as `projects/*/
7328
- # locations/global/groundingConfigs/default_grounding_config`.
7329
- # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaCheckGroundingRequest] google_cloud_discoveryengine_v1alpha_check_grounding_request_object
7534
+ # Gets a Evaluation.
7535
+ # @param [String] name
7536
+ # Required. Full resource name of Evaluation, such as `projects/`project`/
7537
+ # locations/`location`/evaluations/`evaluation``. If the caller does not have
7538
+ # permission to access the Evaluation, regardless of whether or not it exists, a
7539
+ # PERMISSION_DENIED error is returned. If the requested Evaluation does not
7540
+ # exist, a NOT_FOUND error is returned.
7330
7541
  # @param [String] fields
7331
7542
  # Selector specifying which fields to include in a partial response.
7332
7543
  # @param [String] quota_user
@@ -7336,30 +7547,40 @@ module Google
7336
7547
  # Request-specific options
7337
7548
  #
7338
7549
  # @yield [result, err] Result & error if block supplied
7339
- # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaCheckGroundingResponse] parsed result object
7550
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaEvaluation] parsed result object
7340
7551
  # @yieldparam err [StandardError] error object if request failed
7341
7552
  #
7342
- # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaCheckGroundingResponse]
7553
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaEvaluation]
7343
7554
  #
7344
7555
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7345
7556
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7346
7557
  # @raise [Google::Apis::AuthorizationError] Authorization is required
7347
- def check_project_location_grounding_config(grounding_config, google_cloud_discoveryengine_v1alpha_check_grounding_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
7348
- command = make_simple_command(:post, 'v1alpha/{+groundingConfig}:check', options)
7349
- command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaCheckGroundingRequest::Representation
7350
- command.request_object = google_cloud_discoveryengine_v1alpha_check_grounding_request_object
7351
- command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaCheckGroundingResponse::Representation
7352
- command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaCheckGroundingResponse
7353
- command.params['groundingConfig'] = grounding_config unless grounding_config.nil?
7558
+ def get_project_location_evaluation(name, fields: nil, quota_user: nil, options: nil, &block)
7559
+ command = make_simple_command(:get, 'v1alpha/{+name}', options)
7560
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaEvaluation::Representation
7561
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaEvaluation
7562
+ command.params['name'] = name unless name.nil?
7354
7563
  command.query['fields'] = fields unless fields.nil?
7355
7564
  command.query['quotaUser'] = quota_user unless quota_user.nil?
7356
7565
  execute_or_queue_command(command, &block)
7357
7566
  end
7358
7567
 
7359
- # Gets the latest state of a long-running operation. Clients can use this method
7360
- # to poll the operation result at intervals as recommended by the API service.
7361
- # @param [String] name
7362
- # The name of the operation resource.
7568
+ # Gets a list of Evaluations.
7569
+ # @param [String] parent
7570
+ # Required. The parent location resource name, such as `projects/`project`/
7571
+ # locations/`location``. If the caller does not have permission to list
7572
+ # Evaluations under this location, regardless of whether or not this location
7573
+ # exists, a `PERMISSION_DENIED` error is returned.
7574
+ # @param [Fixnum] page_size
7575
+ # Maximum number of Evaluations to return. If unspecified, defaults to 100. The
7576
+ # maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If
7577
+ # this field is negative, an `INVALID_ARGUMENT` error is returned.
7578
+ # @param [String] page_token
7579
+ # A page token ListEvaluationsResponse.next_page_token, received from a previous
7580
+ # EvaluationService.ListEvaluations call. Provide this to retrieve the
7581
+ # subsequent page. When paginating, all other parameters provided to
7582
+ # EvaluationService.ListEvaluations must match the call that provided the page
7583
+ # token. Otherwise, an `INVALID_ARGUMENT` error is returned.
7363
7584
  # @param [String] fields
7364
7585
  # Selector specifying which fields to include in a partial response.
7365
7586
  # @param [String] quota_user
@@ -7369,34 +7590,42 @@ module Google
7369
7590
  # Request-specific options
7370
7591
  #
7371
7592
  # @yield [result, err] Result & error if block supplied
7372
- # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation] parsed result object
7593
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListEvaluationsResponse] parsed result object
7373
7594
  # @yieldparam err [StandardError] error object if request failed
7374
7595
  #
7375
- # @return [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation]
7596
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListEvaluationsResponse]
7376
7597
  #
7377
7598
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7378
7599
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7379
7600
  # @raise [Google::Apis::AuthorizationError] Authorization is required
7380
- def get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
7381
- command = make_simple_command(:get, 'v1alpha/{+name}', options)
7382
- command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation::Representation
7383
- command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation
7384
- command.params['name'] = name unless name.nil?
7601
+ def list_project_location_evaluations(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
7602
+ command = make_simple_command(:get, 'v1alpha/{+parent}/evaluations', options)
7603
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListEvaluationsResponse::Representation
7604
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListEvaluationsResponse
7605
+ command.params['parent'] = parent unless parent.nil?
7606
+ command.query['pageSize'] = page_size unless page_size.nil?
7607
+ command.query['pageToken'] = page_token unless page_token.nil?
7385
7608
  command.query['fields'] = fields unless fields.nil?
7386
7609
  command.query['quotaUser'] = quota_user unless quota_user.nil?
7387
7610
  execute_or_queue_command(command, &block)
7388
7611
  end
7389
7612
 
7390
- # Lists operations that match the specified filter in the request. If the server
7391
- # doesn't support this method, it returns `UNIMPLEMENTED`.
7392
- # @param [String] name
7393
- # The name of the operation's parent resource.
7394
- # @param [String] filter
7395
- # The standard list filter.
7613
+ # Gets a list of results for a given a Evaluation.
7614
+ # @param [String] evaluation
7615
+ # Required. The evaluation resource name, such as `projects/`project`/locations/`
7616
+ # location`/evaluations/`evaluation``. If the caller does not have permission to
7617
+ # list EvaluationResult under this evaluation, regardless of whether or not this
7618
+ # evaluation set exists, a `PERMISSION_DENIED` error is returned.
7396
7619
  # @param [Fixnum] page_size
7397
- # The standard list page size.
7620
+ # Maximum number of EvaluationResult to return. If unspecified, defaults to 100.
7621
+ # The maximum allowed value is 1000. Values above 1000 will be coerced to 1000.
7622
+ # If this field is negative, an `INVALID_ARGUMENT` error is returned.
7398
7623
  # @param [String] page_token
7399
- # The standard list page token.
7624
+ # A page token ListEvaluationResultsResponse.next_page_token, received from a
7625
+ # previous EvaluationService.ListEvaluationResults call. Provide this to
7626
+ # retrieve the subsequent page. When paginating, all other parameters provided
7627
+ # to EvaluationService.ListEvaluationResults must match the call that provided
7628
+ # the page token. Otherwise, an `INVALID_ARGUMENT` error is returned.
7400
7629
  # @param [String] fields
7401
7630
  # Selector specifying which fields to include in a partial response.
7402
7631
  # @param [String] quota_user
@@ -7406,20 +7635,19 @@ module Google
7406
7635
  # Request-specific options
7407
7636
  #
7408
7637
  # @yield [result, err] Result & error if block supplied
7409
- # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningListOperationsResponse] parsed result object
7638
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListEvaluationResultsResponse] parsed result object
7410
7639
  # @yieldparam err [StandardError] error object if request failed
7411
7640
  #
7412
- # @return [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningListOperationsResponse]
7641
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListEvaluationResultsResponse]
7413
7642
  #
7414
7643
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7415
7644
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7416
7645
  # @raise [Google::Apis::AuthorizationError] Authorization is required
7417
- def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
7418
- command = make_simple_command(:get, 'v1alpha/{+name}/operations', options)
7419
- command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningListOperationsResponse::Representation
7420
- command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningListOperationsResponse
7421
- command.params['name'] = name unless name.nil?
7422
- command.query['filter'] = filter unless filter.nil?
7646
+ def list_project_location_evaluation_results(evaluation, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
7647
+ command = make_simple_command(:get, 'v1alpha/{+evaluation}:listResults', options)
7648
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListEvaluationResultsResponse::Representation
7649
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListEvaluationResultsResponse
7650
+ command.params['evaluation'] = evaluation unless evaluation.nil?
7423
7651
  command.query['pageSize'] = page_size unless page_size.nil?
7424
7652
  command.query['pageToken'] = page_token unless page_token.nil?
7425
7653
  command.query['fields'] = fields unless fields.nil?
@@ -7427,11 +7655,10 @@ module Google
7427
7655
  execute_or_queue_command(command, &block)
7428
7656
  end
7429
7657
 
7430
- # Ranks a list of text records based on the given input query.
7431
- # @param [String] ranking_config
7432
- # Required. The resource name of the rank service config, such as `projects/`
7433
- # project_num`/locations/`location_id`/rankingConfigs/default_ranking_config`.
7434
- # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaRankRequest] google_cloud_discoveryengine_v1alpha_rank_request_object
7658
+ # Gets the latest state of a long-running operation. Clients can use this method
7659
+ # to poll the operation result at intervals as recommended by the API service.
7660
+ # @param [String] name
7661
+ # The name of the operation resource.
7435
7662
  # @param [String] fields
7436
7663
  # Selector specifying which fields to include in a partial response.
7437
7664
  # @param [String] quota_user
@@ -7441,31 +7668,239 @@ module Google
7441
7668
  # Request-specific options
7442
7669
  #
7443
7670
  # @yield [result, err] Result & error if block supplied
7444
- # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaRankResponse] parsed result object
7671
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation] parsed result object
7445
7672
  # @yieldparam err [StandardError] error object if request failed
7446
7673
  #
7447
- # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaRankResponse]
7674
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation]
7448
7675
  #
7449
7676
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7450
7677
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7451
7678
  # @raise [Google::Apis::AuthorizationError] Authorization is required
7452
- def rank_project_location_ranking_config(ranking_config, google_cloud_discoveryengine_v1alpha_rank_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
7453
- command = make_simple_command(:post, 'v1alpha/{+rankingConfig}:rank', options)
7454
- command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaRankRequest::Representation
7455
- command.request_object = google_cloud_discoveryengine_v1alpha_rank_request_object
7456
- command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaRankResponse::Representation
7457
- command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaRankResponse
7458
- command.params['rankingConfig'] = ranking_config unless ranking_config.nil?
7679
+ def get_project_location_evaluation_operation(name, fields: nil, quota_user: nil, options: nil, &block)
7680
+ command = make_simple_command(:get, 'v1alpha/{+name}', options)
7681
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation::Representation
7682
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation
7683
+ command.params['name'] = name unless name.nil?
7459
7684
  command.query['fields'] = fields unless fields.nil?
7460
7685
  command.query['quotaUser'] = quota_user unless quota_user.nil?
7461
7686
  execute_or_queue_command(command, &block)
7462
7687
  end
7463
7688
 
7464
- # Check a particular requirement.
7465
- # @param [String] location
7466
- # Required. Full resource name of the location. Format `projects/`
7467
- # project_number_or_id`/locations/`location``
7468
- # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaCheckRequirementRequest] google_cloud_discoveryengine_v1alpha_check_requirement_request_object
7689
+ # Performs a grounding check.
7690
+ # @param [String] grounding_config
7691
+ # Required. The resource name of the grounding config, such as `projects/*/
7692
+ # locations/global/groundingConfigs/default_grounding_config`.
7693
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaCheckGroundingRequest] google_cloud_discoveryengine_v1alpha_check_grounding_request_object
7694
+ # @param [String] fields
7695
+ # Selector specifying which fields to include in a partial response.
7696
+ # @param [String] quota_user
7697
+ # Available to use for quota purposes for server-side applications. Can be any
7698
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
7699
+ # @param [Google::Apis::RequestOptions] options
7700
+ # Request-specific options
7701
+ #
7702
+ # @yield [result, err] Result & error if block supplied
7703
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaCheckGroundingResponse] parsed result object
7704
+ # @yieldparam err [StandardError] error object if request failed
7705
+ #
7706
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaCheckGroundingResponse]
7707
+ #
7708
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7709
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7710
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7711
+ def check_project_location_grounding_config(grounding_config, google_cloud_discoveryengine_v1alpha_check_grounding_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
7712
+ command = make_simple_command(:post, 'v1alpha/{+groundingConfig}:check', options)
7713
+ command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaCheckGroundingRequest::Representation
7714
+ command.request_object = google_cloud_discoveryengine_v1alpha_check_grounding_request_object
7715
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaCheckGroundingResponse::Representation
7716
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaCheckGroundingResponse
7717
+ command.params['groundingConfig'] = grounding_config unless grounding_config.nil?
7718
+ command.query['fields'] = fields unless fields.nil?
7719
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7720
+ execute_or_queue_command(command, &block)
7721
+ end
7722
+
7723
+ # Gets the latest state of a long-running operation. Clients can use this method
7724
+ # to poll the operation result at intervals as recommended by the API service.
7725
+ # @param [String] name
7726
+ # The name of the operation resource.
7727
+ # @param [String] fields
7728
+ # Selector specifying which fields to include in a partial response.
7729
+ # @param [String] quota_user
7730
+ # Available to use for quota purposes for server-side applications. Can be any
7731
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
7732
+ # @param [Google::Apis::RequestOptions] options
7733
+ # Request-specific options
7734
+ #
7735
+ # @yield [result, err] Result & error if block supplied
7736
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation] parsed result object
7737
+ # @yieldparam err [StandardError] error object if request failed
7738
+ #
7739
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation]
7740
+ #
7741
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7742
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7743
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7744
+ def get_project_location_identity_mapping_store_operation(name, fields: nil, quota_user: nil, options: nil, &block)
7745
+ command = make_simple_command(:get, 'v1alpha/{+name}', options)
7746
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation::Representation
7747
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation
7748
+ command.params['name'] = name unless name.nil?
7749
+ command.query['fields'] = fields unless fields.nil?
7750
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7751
+ execute_or_queue_command(command, &block)
7752
+ end
7753
+
7754
+ # Lists operations that match the specified filter in the request. If the server
7755
+ # doesn't support this method, it returns `UNIMPLEMENTED`.
7756
+ # @param [String] name
7757
+ # The name of the operation's parent resource.
7758
+ # @param [String] filter
7759
+ # The standard list filter.
7760
+ # @param [Fixnum] page_size
7761
+ # The standard list page size.
7762
+ # @param [String] page_token
7763
+ # The standard list page token.
7764
+ # @param [String] fields
7765
+ # Selector specifying which fields to include in a partial response.
7766
+ # @param [String] quota_user
7767
+ # Available to use for quota purposes for server-side applications. Can be any
7768
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
7769
+ # @param [Google::Apis::RequestOptions] options
7770
+ # Request-specific options
7771
+ #
7772
+ # @yield [result, err] Result & error if block supplied
7773
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningListOperationsResponse] parsed result object
7774
+ # @yieldparam err [StandardError] error object if request failed
7775
+ #
7776
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningListOperationsResponse]
7777
+ #
7778
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7779
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7780
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7781
+ def list_project_location_identity_mapping_store_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
7782
+ command = make_simple_command(:get, 'v1alpha/{+name}/operations', options)
7783
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningListOperationsResponse::Representation
7784
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningListOperationsResponse
7785
+ command.params['name'] = name unless name.nil?
7786
+ command.query['filter'] = filter unless filter.nil?
7787
+ command.query['pageSize'] = page_size unless page_size.nil?
7788
+ command.query['pageToken'] = page_token unless page_token.nil?
7789
+ command.query['fields'] = fields unless fields.nil?
7790
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7791
+ execute_or_queue_command(command, &block)
7792
+ end
7793
+
7794
+ # Gets the latest state of a long-running operation. Clients can use this method
7795
+ # to poll the operation result at intervals as recommended by the API service.
7796
+ # @param [String] name
7797
+ # The name of the operation resource.
7798
+ # @param [String] fields
7799
+ # Selector specifying which fields to include in a partial response.
7800
+ # @param [String] quota_user
7801
+ # Available to use for quota purposes for server-side applications. Can be any
7802
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
7803
+ # @param [Google::Apis::RequestOptions] options
7804
+ # Request-specific options
7805
+ #
7806
+ # @yield [result, err] Result & error if block supplied
7807
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation] parsed result object
7808
+ # @yieldparam err [StandardError] error object if request failed
7809
+ #
7810
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation]
7811
+ #
7812
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7813
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7814
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7815
+ def get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
7816
+ command = make_simple_command(:get, 'v1alpha/{+name}', options)
7817
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation::Representation
7818
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation
7819
+ command.params['name'] = name unless name.nil?
7820
+ command.query['fields'] = fields unless fields.nil?
7821
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7822
+ execute_or_queue_command(command, &block)
7823
+ end
7824
+
7825
+ # Lists operations that match the specified filter in the request. If the server
7826
+ # doesn't support this method, it returns `UNIMPLEMENTED`.
7827
+ # @param [String] name
7828
+ # The name of the operation's parent resource.
7829
+ # @param [String] filter
7830
+ # The standard list filter.
7831
+ # @param [Fixnum] page_size
7832
+ # The standard list page size.
7833
+ # @param [String] page_token
7834
+ # The standard list page token.
7835
+ # @param [String] fields
7836
+ # Selector specifying which fields to include in a partial response.
7837
+ # @param [String] quota_user
7838
+ # Available to use for quota purposes for server-side applications. Can be any
7839
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
7840
+ # @param [Google::Apis::RequestOptions] options
7841
+ # Request-specific options
7842
+ #
7843
+ # @yield [result, err] Result & error if block supplied
7844
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningListOperationsResponse] parsed result object
7845
+ # @yieldparam err [StandardError] error object if request failed
7846
+ #
7847
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningListOperationsResponse]
7848
+ #
7849
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7850
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7851
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7852
+ def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
7853
+ command = make_simple_command(:get, 'v1alpha/{+name}/operations', options)
7854
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningListOperationsResponse::Representation
7855
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningListOperationsResponse
7856
+ command.params['name'] = name unless name.nil?
7857
+ command.query['filter'] = filter unless filter.nil?
7858
+ command.query['pageSize'] = page_size unless page_size.nil?
7859
+ command.query['pageToken'] = page_token unless page_token.nil?
7860
+ command.query['fields'] = fields unless fields.nil?
7861
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7862
+ execute_or_queue_command(command, &block)
7863
+ end
7864
+
7865
+ # Ranks a list of text records based on the given input query.
7866
+ # @param [String] ranking_config
7867
+ # Required. The resource name of the rank service config, such as `projects/`
7868
+ # project_num`/locations/`location_id`/rankingConfigs/default_ranking_config`.
7869
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaRankRequest] google_cloud_discoveryengine_v1alpha_rank_request_object
7870
+ # @param [String] fields
7871
+ # Selector specifying which fields to include in a partial response.
7872
+ # @param [String] quota_user
7873
+ # Available to use for quota purposes for server-side applications. Can be any
7874
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
7875
+ # @param [Google::Apis::RequestOptions] options
7876
+ # Request-specific options
7877
+ #
7878
+ # @yield [result, err] Result & error if block supplied
7879
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaRankResponse] parsed result object
7880
+ # @yieldparam err [StandardError] error object if request failed
7881
+ #
7882
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaRankResponse]
7883
+ #
7884
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7885
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7886
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7887
+ def rank_project_location_ranking_config(ranking_config, google_cloud_discoveryengine_v1alpha_rank_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
7888
+ command = make_simple_command(:post, 'v1alpha/{+rankingConfig}:rank', options)
7889
+ command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaRankRequest::Representation
7890
+ command.request_object = google_cloud_discoveryengine_v1alpha_rank_request_object
7891
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaRankResponse::Representation
7892
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaRankResponse
7893
+ command.params['rankingConfig'] = ranking_config unless ranking_config.nil?
7894
+ command.query['fields'] = fields unless fields.nil?
7895
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7896
+ execute_or_queue_command(command, &block)
7897
+ end
7898
+
7899
+ # Check a particular requirement.
7900
+ # @param [String] location
7901
+ # Required. Full resource name of the location. Format `projects/`
7902
+ # project_number_or_id`/locations/`location``
7903
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaCheckRequirementRequest] google_cloud_discoveryengine_v1alpha_check_requirement_request_object
7469
7904
  # @param [String] fields
7470
7905
  # Selector specifying which fields to include in a partial response.
7471
7906
  # @param [String] quota_user
@@ -7495,6 +7930,203 @@ module Google
7495
7930
  execute_or_queue_command(command, &block)
7496
7931
  end
7497
7932
 
7933
+ # Creates a SampleQuerySet
7934
+ # @param [String] parent
7935
+ # Required. The parent resource name, such as `projects/`project`/locations/`
7936
+ # location``.
7937
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuerySet] google_cloud_discoveryengine_v1alpha_sample_query_set_object
7938
+ # @param [String] sample_query_set_id
7939
+ # Required. The ID to use for the SampleQuerySet, which will become the final
7940
+ # component of the SampleQuerySet.name. If the caller does not have permission
7941
+ # to create the SampleQuerySet, regardless of whether or not it exists, a `
7942
+ # PERMISSION_DENIED` error is returned. This field must be unique among all
7943
+ # SampleQuerySets with the same parent. Otherwise, an `ALREADY_EXISTS` error is
7944
+ # returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/
7945
+ # rfc1034) standard with a length limit of 63 characters. Otherwise, an `
7946
+ # INVALID_ARGUMENT` error is returned.
7947
+ # @param [String] fields
7948
+ # Selector specifying which fields to include in a partial response.
7949
+ # @param [String] quota_user
7950
+ # Available to use for quota purposes for server-side applications. Can be any
7951
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
7952
+ # @param [Google::Apis::RequestOptions] options
7953
+ # Request-specific options
7954
+ #
7955
+ # @yield [result, err] Result & error if block supplied
7956
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuerySet] parsed result object
7957
+ # @yieldparam err [StandardError] error object if request failed
7958
+ #
7959
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuerySet]
7960
+ #
7961
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7962
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7963
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7964
+ def create_project_location_sample_query_set(parent, google_cloud_discoveryengine_v1alpha_sample_query_set_object = nil, sample_query_set_id: nil, fields: nil, quota_user: nil, options: nil, &block)
7965
+ command = make_simple_command(:post, 'v1alpha/{+parent}/sampleQuerySets', options)
7966
+ command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuerySet::Representation
7967
+ command.request_object = google_cloud_discoveryengine_v1alpha_sample_query_set_object
7968
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuerySet::Representation
7969
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuerySet
7970
+ command.params['parent'] = parent unless parent.nil?
7971
+ command.query['sampleQuerySetId'] = sample_query_set_id unless sample_query_set_id.nil?
7972
+ command.query['fields'] = fields unless fields.nil?
7973
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7974
+ execute_or_queue_command(command, &block)
7975
+ end
7976
+
7977
+ # Deletes a SampleQuerySet.
7978
+ # @param [String] name
7979
+ # Required. Full resource name of SampleQuerySet, such as `projects/`project`/
7980
+ # locations/`location`/sampleQuerySets/`sampleQuerySet``. If the caller does not
7981
+ # have permission to delete the SampleQuerySet, regardless of whether or not it
7982
+ # exists, a `PERMISSION_DENIED` error is returned. If the SampleQuerySet to
7983
+ # delete does not exist, a `NOT_FOUND` error is returned.
7984
+ # @param [String] fields
7985
+ # Selector specifying which fields to include in a partial response.
7986
+ # @param [String] quota_user
7987
+ # Available to use for quota purposes for server-side applications. Can be any
7988
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
7989
+ # @param [Google::Apis::RequestOptions] options
7990
+ # Request-specific options
7991
+ #
7992
+ # @yield [result, err] Result & error if block supplied
7993
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleProtobufEmpty] parsed result object
7994
+ # @yieldparam err [StandardError] error object if request failed
7995
+ #
7996
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleProtobufEmpty]
7997
+ #
7998
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7999
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
8000
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
8001
+ def delete_project_location_sample_query_set(name, fields: nil, quota_user: nil, options: nil, &block)
8002
+ command = make_simple_command(:delete, 'v1alpha/{+name}', options)
8003
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleProtobufEmpty::Representation
8004
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleProtobufEmpty
8005
+ command.params['name'] = name unless name.nil?
8006
+ command.query['fields'] = fields unless fields.nil?
8007
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
8008
+ execute_or_queue_command(command, &block)
8009
+ end
8010
+
8011
+ # Gets a SampleQuerySet.
8012
+ # @param [String] name
8013
+ # Required. Full resource name of SampleQuerySet, such as `projects/`project`/
8014
+ # locations/`location`/sampleQuerySets/`sampleQuerySet``. If the caller does not
8015
+ # have permission to access the SampleQuerySet, regardless of whether or not it
8016
+ # exists, a PERMISSION_DENIED error is returned. If the requested SampleQuerySet
8017
+ # does not exist, a NOT_FOUND error is returned.
8018
+ # @param [String] fields
8019
+ # Selector specifying which fields to include in a partial response.
8020
+ # @param [String] quota_user
8021
+ # Available to use for quota purposes for server-side applications. Can be any
8022
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
8023
+ # @param [Google::Apis::RequestOptions] options
8024
+ # Request-specific options
8025
+ #
8026
+ # @yield [result, err] Result & error if block supplied
8027
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuerySet] parsed result object
8028
+ # @yieldparam err [StandardError] error object if request failed
8029
+ #
8030
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuerySet]
8031
+ #
8032
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
8033
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
8034
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
8035
+ def get_project_location_sample_query_set(name, fields: nil, quota_user: nil, options: nil, &block)
8036
+ command = make_simple_command(:get, 'v1alpha/{+name}', options)
8037
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuerySet::Representation
8038
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuerySet
8039
+ command.params['name'] = name unless name.nil?
8040
+ command.query['fields'] = fields unless fields.nil?
8041
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
8042
+ execute_or_queue_command(command, &block)
8043
+ end
8044
+
8045
+ # Gets a list of SampleQuerySets.
8046
+ # @param [String] parent
8047
+ # Required. The parent location resource name, such as `projects/`project`/
8048
+ # locations/`location``. If the caller does not have permission to list
8049
+ # SampleQuerySets under this location, regardless of whether or not this
8050
+ # location exists, a `PERMISSION_DENIED` error is returned.
8051
+ # @param [Fixnum] page_size
8052
+ # Maximum number of SampleQuerySets to return. If unspecified, defaults to 100.
8053
+ # The maximum allowed value is 1000. Values above 1000 will be coerced to 1000.
8054
+ # If this field is negative, an `INVALID_ARGUMENT` error is returned.
8055
+ # @param [String] page_token
8056
+ # A page token ListSampleQuerySetsResponse.next_page_token, received from a
8057
+ # previous SampleQuerySetService.ListSampleQuerySets call. Provide this to
8058
+ # retrieve the subsequent page. When paginating, all other parameters provided
8059
+ # to SampleQuerySetService.ListSampleQuerySets must match the call that provided
8060
+ # the page token. Otherwise, an `INVALID_ARGUMENT` error is returned.
8061
+ # @param [String] fields
8062
+ # Selector specifying which fields to include in a partial response.
8063
+ # @param [String] quota_user
8064
+ # Available to use for quota purposes for server-side applications. Can be any
8065
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
8066
+ # @param [Google::Apis::RequestOptions] options
8067
+ # Request-specific options
8068
+ #
8069
+ # @yield [result, err] Result & error if block supplied
8070
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListSampleQuerySetsResponse] parsed result object
8071
+ # @yieldparam err [StandardError] error object if request failed
8072
+ #
8073
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListSampleQuerySetsResponse]
8074
+ #
8075
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
8076
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
8077
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
8078
+ def list_project_location_sample_query_sets(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
8079
+ command = make_simple_command(:get, 'v1alpha/{+parent}/sampleQuerySets', options)
8080
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListSampleQuerySetsResponse::Representation
8081
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListSampleQuerySetsResponse
8082
+ command.params['parent'] = parent unless parent.nil?
8083
+ command.query['pageSize'] = page_size unless page_size.nil?
8084
+ command.query['pageToken'] = page_token unless page_token.nil?
8085
+ command.query['fields'] = fields unless fields.nil?
8086
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
8087
+ execute_or_queue_command(command, &block)
8088
+ end
8089
+
8090
+ # Updates a SampleQuerySet.
8091
+ # @param [String] name
8092
+ # Immutable. The full resource name of the SampleQuerySet, in the format of `
8093
+ # projects/`project`/locations/`location`/sampleQuerySets/`sampleQuerySet``.
8094
+ # This field must be a UTF-8 encoded string with a length limit of 1024
8095
+ # characters.
8096
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuerySet] google_cloud_discoveryengine_v1alpha_sample_query_set_object
8097
+ # @param [String] update_mask
8098
+ # Indicates which fields in the provided imported 'sample query set' to update.
8099
+ # If not set, will by default update all fields.
8100
+ # @param [String] fields
8101
+ # Selector specifying which fields to include in a partial response.
8102
+ # @param [String] quota_user
8103
+ # Available to use for quota purposes for server-side applications. Can be any
8104
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
8105
+ # @param [Google::Apis::RequestOptions] options
8106
+ # Request-specific options
8107
+ #
8108
+ # @yield [result, err] Result & error if block supplied
8109
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuerySet] parsed result object
8110
+ # @yieldparam err [StandardError] error object if request failed
8111
+ #
8112
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuerySet]
8113
+ #
8114
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
8115
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
8116
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
8117
+ def patch_project_location_sample_query_set(name, google_cloud_discoveryengine_v1alpha_sample_query_set_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
8118
+ command = make_simple_command(:patch, 'v1alpha/{+name}', options)
8119
+ command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuerySet::Representation
8120
+ command.request_object = google_cloud_discoveryengine_v1alpha_sample_query_set_object
8121
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuerySet::Representation
8122
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuerySet
8123
+ command.params['name'] = name unless name.nil?
8124
+ command.query['updateMask'] = update_mask unless update_mask.nil?
8125
+ command.query['fields'] = fields unless fields.nil?
8126
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
8127
+ execute_or_queue_command(command, &block)
8128
+ end
8129
+
7498
8130
  # Gets the latest state of a long-running operation. Clients can use this method
7499
8131
  # to poll the operation result at intervals as recommended by the API service.
7500
8132
  # @param [String] name
@@ -7526,6 +8158,245 @@ module Google
7526
8158
  execute_or_queue_command(command, &block)
7527
8159
  end
7528
8160
 
8161
+ # Creates a SampleQuery
8162
+ # @param [String] parent
8163
+ # Required. The parent resource name, such as `projects/`project`/locations/`
8164
+ # location`/sampleQuerySets/`sampleQuerySet``.
8165
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuery] google_cloud_discoveryengine_v1alpha_sample_query_object
8166
+ # @param [String] sample_query_id
8167
+ # Required. The ID to use for the SampleQuery, which will become the final
8168
+ # component of the SampleQuery.name. If the caller does not have permission to
8169
+ # create the SampleQuery, regardless of whether or not it exists, a `
8170
+ # PERMISSION_DENIED` error is returned. This field must be unique among all
8171
+ # SampleQuerys with the same parent. Otherwise, an `ALREADY_EXISTS` error is
8172
+ # returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/
8173
+ # rfc1034) standard with a length limit of 63 characters. Otherwise, an `
8174
+ # INVALID_ARGUMENT` error is returned.
8175
+ # @param [String] fields
8176
+ # Selector specifying which fields to include in a partial response.
8177
+ # @param [String] quota_user
8178
+ # Available to use for quota purposes for server-side applications. Can be any
8179
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
8180
+ # @param [Google::Apis::RequestOptions] options
8181
+ # Request-specific options
8182
+ #
8183
+ # @yield [result, err] Result & error if block supplied
8184
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuery] parsed result object
8185
+ # @yieldparam err [StandardError] error object if request failed
8186
+ #
8187
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuery]
8188
+ #
8189
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
8190
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
8191
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
8192
+ def create_project_location_sample_query_set_sample_query(parent, google_cloud_discoveryengine_v1alpha_sample_query_object = nil, sample_query_id: nil, fields: nil, quota_user: nil, options: nil, &block)
8193
+ command = make_simple_command(:post, 'v1alpha/{+parent}/sampleQueries', options)
8194
+ command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuery::Representation
8195
+ command.request_object = google_cloud_discoveryengine_v1alpha_sample_query_object
8196
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuery::Representation
8197
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuery
8198
+ command.params['parent'] = parent unless parent.nil?
8199
+ command.query['sampleQueryId'] = sample_query_id unless sample_query_id.nil?
8200
+ command.query['fields'] = fields unless fields.nil?
8201
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
8202
+ execute_or_queue_command(command, &block)
8203
+ end
8204
+
8205
+ # Deletes a SampleQuery.
8206
+ # @param [String] name
8207
+ # Required. Full resource name of SampleQuery, such as `projects/`project`/
8208
+ # locations/`location`/sampleQuerySets/`sampleQuerySet`/sampleQueries/`
8209
+ # sampleQuery``. If the caller does not have permission to delete the
8210
+ # SampleQuery, regardless of whether or not it exists, a `PERMISSION_DENIED`
8211
+ # error is returned. If the SampleQuery to delete does not exist, a `NOT_FOUND`
8212
+ # error is returned.
8213
+ # @param [String] fields
8214
+ # Selector specifying which fields to include in a partial response.
8215
+ # @param [String] quota_user
8216
+ # Available to use for quota purposes for server-side applications. Can be any
8217
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
8218
+ # @param [Google::Apis::RequestOptions] options
8219
+ # Request-specific options
8220
+ #
8221
+ # @yield [result, err] Result & error if block supplied
8222
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleProtobufEmpty] parsed result object
8223
+ # @yieldparam err [StandardError] error object if request failed
8224
+ #
8225
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleProtobufEmpty]
8226
+ #
8227
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
8228
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
8229
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
8230
+ def delete_project_location_sample_query_set_sample_query(name, fields: nil, quota_user: nil, options: nil, &block)
8231
+ command = make_simple_command(:delete, 'v1alpha/{+name}', options)
8232
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleProtobufEmpty::Representation
8233
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleProtobufEmpty
8234
+ command.params['name'] = name unless name.nil?
8235
+ command.query['fields'] = fields unless fields.nil?
8236
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
8237
+ execute_or_queue_command(command, &block)
8238
+ end
8239
+
8240
+ # Gets a SampleQuery.
8241
+ # @param [String] name
8242
+ # Required. Full resource name of SampleQuery, such as `projects/`project`/
8243
+ # locations/`location`/sampleQuerySets/`sampleQuerySet`/sampleQueries/`
8244
+ # sampleQuery``. If the caller does not have permission to access the
8245
+ # SampleQuery, regardless of whether or not it exists, a PERMISSION_DENIED error
8246
+ # is returned. If the requested SampleQuery does not exist, a NOT_FOUND error is
8247
+ # returned.
8248
+ # @param [String] fields
8249
+ # Selector specifying which fields to include in a partial response.
8250
+ # @param [String] quota_user
8251
+ # Available to use for quota purposes for server-side applications. Can be any
8252
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
8253
+ # @param [Google::Apis::RequestOptions] options
8254
+ # Request-specific options
8255
+ #
8256
+ # @yield [result, err] Result & error if block supplied
8257
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuery] parsed result object
8258
+ # @yieldparam err [StandardError] error object if request failed
8259
+ #
8260
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuery]
8261
+ #
8262
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
8263
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
8264
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
8265
+ def get_project_location_sample_query_set_sample_query(name, fields: nil, quota_user: nil, options: nil, &block)
8266
+ command = make_simple_command(:get, 'v1alpha/{+name}', options)
8267
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuery::Representation
8268
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuery
8269
+ command.params['name'] = name unless name.nil?
8270
+ command.query['fields'] = fields unless fields.nil?
8271
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
8272
+ execute_or_queue_command(command, &block)
8273
+ end
8274
+
8275
+ # Bulk import of multiple SampleQuerys. Sample queries that already exist may be
8276
+ # deleted. Note: It is possible for a subset of the SampleQuerys to be
8277
+ # successfully imported.
8278
+ # @param [String] parent
8279
+ # Required. The parent sample query set resource name, such as `projects/`
8280
+ # project`/locations/`location`/sampleQuerySets/`sampleQuerySet``. If the caller
8281
+ # does not have permission to list SampleQuerys under this sample query set,
8282
+ # regardless of whether or not this sample query set exists, a `
8283
+ # PERMISSION_DENIED` error is returned.
8284
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaImportSampleQueriesRequest] google_cloud_discoveryengine_v1alpha_import_sample_queries_request_object
8285
+ # @param [String] fields
8286
+ # Selector specifying which fields to include in a partial response.
8287
+ # @param [String] quota_user
8288
+ # Available to use for quota purposes for server-side applications. Can be any
8289
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
8290
+ # @param [Google::Apis::RequestOptions] options
8291
+ # Request-specific options
8292
+ #
8293
+ # @yield [result, err] Result & error if block supplied
8294
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation] parsed result object
8295
+ # @yieldparam err [StandardError] error object if request failed
8296
+ #
8297
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation]
8298
+ #
8299
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
8300
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
8301
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
8302
+ def import_project_location_sample_query_set_sample_query(parent, google_cloud_discoveryengine_v1alpha_import_sample_queries_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
8303
+ command = make_simple_command(:post, 'v1alpha/{+parent}/sampleQueries:import', options)
8304
+ command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaImportSampleQueriesRequest::Representation
8305
+ command.request_object = google_cloud_discoveryengine_v1alpha_import_sample_queries_request_object
8306
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation::Representation
8307
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation
8308
+ command.params['parent'] = parent unless parent.nil?
8309
+ command.query['fields'] = fields unless fields.nil?
8310
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
8311
+ execute_or_queue_command(command, &block)
8312
+ end
8313
+
8314
+ # Gets a list of SampleQuerys.
8315
+ # @param [String] parent
8316
+ # Required. The parent sample query set resource name, such as `projects/`
8317
+ # project`/locations/`location`/sampleQuerySets/`sampleQuerySet``. If the caller
8318
+ # does not have permission to list SampleQuerys under this sample query set,
8319
+ # regardless of whether or not this sample query set exists, a `
8320
+ # PERMISSION_DENIED` error is returned.
8321
+ # @param [Fixnum] page_size
8322
+ # Maximum number of SampleQuerys to return. If unspecified, defaults to 100. The
8323
+ # maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If
8324
+ # this field is negative, an `INVALID_ARGUMENT` error is returned.
8325
+ # @param [String] page_token
8326
+ # A page token ListSampleQueriesResponse.next_page_token, received from a
8327
+ # previous SampleQueryService.ListSampleQueries call. Provide this to retrieve
8328
+ # the subsequent page. When paginating, all other parameters provided to
8329
+ # SampleQueryService.ListSampleQueries must match the call that provided the
8330
+ # page token. Otherwise, an `INVALID_ARGUMENT` error is returned.
8331
+ # @param [String] fields
8332
+ # Selector specifying which fields to include in a partial response.
8333
+ # @param [String] quota_user
8334
+ # Available to use for quota purposes for server-side applications. Can be any
8335
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
8336
+ # @param [Google::Apis::RequestOptions] options
8337
+ # Request-specific options
8338
+ #
8339
+ # @yield [result, err] Result & error if block supplied
8340
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListSampleQueriesResponse] parsed result object
8341
+ # @yieldparam err [StandardError] error object if request failed
8342
+ #
8343
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListSampleQueriesResponse]
8344
+ #
8345
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
8346
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
8347
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
8348
+ def list_project_location_sample_query_set_sample_queries(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
8349
+ command = make_simple_command(:get, 'v1alpha/{+parent}/sampleQueries', options)
8350
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListSampleQueriesResponse::Representation
8351
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListSampleQueriesResponse
8352
+ command.params['parent'] = parent unless parent.nil?
8353
+ command.query['pageSize'] = page_size unless page_size.nil?
8354
+ command.query['pageToken'] = page_token unless page_token.nil?
8355
+ command.query['fields'] = fields unless fields.nil?
8356
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
8357
+ execute_or_queue_command(command, &block)
8358
+ end
8359
+
8360
+ # Updates a SampleQuery.
8361
+ # @param [String] name
8362
+ # Immutable. The full resource name of the sample query, in the format of `
8363
+ # projects/`project`/locations/`location`/sampleQuerySets/`sampleQuerySet`/
8364
+ # sampleQueries/`sampleQuery``. This field must be a UTF-8 encoded string with a
8365
+ # length limit of 1024 characters.
8366
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuery] google_cloud_discoveryengine_v1alpha_sample_query_object
8367
+ # @param [String] update_mask
8368
+ # Indicates which fields in the provided imported 'simple query' to update. If
8369
+ # not set, will by default update all fields.
8370
+ # @param [String] fields
8371
+ # Selector specifying which fields to include in a partial response.
8372
+ # @param [String] quota_user
8373
+ # Available to use for quota purposes for server-side applications. Can be any
8374
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
8375
+ # @param [Google::Apis::RequestOptions] options
8376
+ # Request-specific options
8377
+ #
8378
+ # @yield [result, err] Result & error if block supplied
8379
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuery] parsed result object
8380
+ # @yieldparam err [StandardError] error object if request failed
8381
+ #
8382
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuery]
8383
+ #
8384
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
8385
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
8386
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
8387
+ def patch_project_location_sample_query_set_sample_query(name, google_cloud_discoveryengine_v1alpha_sample_query_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
8388
+ command = make_simple_command(:patch, 'v1alpha/{+name}', options)
8389
+ command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuery::Representation
8390
+ command.request_object = google_cloud_discoveryengine_v1alpha_sample_query_object
8391
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuery::Representation
8392
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaSampleQuery
8393
+ command.params['name'] = name unless name.nil?
8394
+ command.query['updateMask'] = update_mask unless update_mask.nil?
8395
+ command.query['fields'] = fields unless fields.nil?
8396
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
8397
+ execute_or_queue_command(command, &block)
8398
+ end
8399
+
7529
8400
  # Writes a single user event from the browser. This uses a GET request to due to
7530
8401
  # browser restriction of POST-ing to a third-party domain. This method is used
7531
8402
  # only by the Discovery Engine API JavaScript pixel and Google Tag Manager.