class Google::Apis::CloudsearchV1::CloudSearchService
Cloud Search API
Cloud Search provides cloud-based search capabilities over Google
Workspace
data. The Cloud Search API allows indexing of non-Google Workspace data into Cloud Search.
@example
require 'google/apis/cloudsearch_v1' Cloudsearch = Google::Apis::CloudsearchV1 # Alias the module service = Cloudsearch::CloudSearchService.new
Attributes
@return [String]
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
@return [String]
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
Public Class Methods
# File lib/google/apis/cloudsearch_v1/service.rb, line 47 def initialize super('https://cloudsearch.googleapis.com/', '', client_name: 'google-apis-cloudsearch_v1', client_version: Google::Apis::CloudsearchV1::GEM_VERSION) @batch_path = 'batch' end
Public Instance Methods
Checks whether an item is accessible by specified principal. Note: This API requires an admin account to execute. @param [String] name
Item name, format: datasources/`source_id`/items/`item_id`
@param [Google::Apis::CloudsearchV1::Principal] principal_object @param [Boolean] debug_options_enable_debugging
If you are asked by Google to help with debugging, set this field. Otherwise, ignore this field.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::CheckAccessResponse] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::CheckAccessResponse]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 79 def check_debug_datasource_item_access(name, principal_object = nil, debug_options_enable_debugging: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/debug/{+name}:checkAccess', options) command.request_representation = Google::Apis::CloudsearchV1::Principal::Representation command.request_object = principal_object command.response_representation = Google::Apis::CloudsearchV1::CheckAccessResponse::Representation command.response_class = Google::Apis::CloudsearchV1::CheckAccessResponse command.params['name'] = name unless name.nil? command.query['debugOptions.enableDebugging'] = debug_options_enable_debugging unless debug_options_enable_debugging.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Creates a datasource. Note: This API requires an admin account to execute. @param [Google::Apis::CloudsearchV1::DataSource] data_source_object @param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::Operation] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::Operation]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 1085 def create_setting_datasource(data_source_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/settings/datasources', options) command.request_representation = Google::Apis::CloudsearchV1::DataSource::Representation command.request_object = data_source_object command.response_representation = Google::Apis::CloudsearchV1::Operation::Representation command.response_class = Google::Apis::CloudsearchV1::Operation command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Creates a search application. Note: This API requires an admin account to execute. @param [Google::Apis::CloudsearchV1::SearchApplication] search_application_object @param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::Operation] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::Operation]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 1256 def create_setting_searchapplication(search_application_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/settings/searchapplications', options) command.request_representation = Google::Apis::CloudsearchV1::SearchApplication::Representation command.request_object = search_application_object command.response_representation = Google::Apis::CloudsearchV1::Operation::Representation command.response_class = Google::Apis::CloudsearchV1::Operation command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Deletes Item
resource for the specified resource name. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. @param [String] name
Required. Name of the item to delete. Format: datasources/`source_id`/items/` item_id`
@param [String] connector_name
Name of connector making this call. Format: datasources/`source_id`/connectors/ `ID`
@param [Boolean] debug_options_enable_debugging
If you are asked by Google to help with debugging, set this field. Otherwise, ignore this field.
@param [String] mode
Required. The RequestMode for this request.
@param [String] version
Required. The incremented version of the item to delete from the index. The indexing system stores the version from the datasource as a byte string and compares the Item version in the index to the version of the queued Item using lexical ordering. Cloud Search Indexing won't delete any queued item with a version value that is less than or equal to the version of the currently indexed item. The maximum length for this field is 1024 bytes.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::Operation] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::Operation]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 403 def delete_indexing_datasource_item(name, connector_name: nil, debug_options_enable_debugging: nil, mode: nil, version: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:delete, 'v1/indexing/{+name}', options) command.response_representation = Google::Apis::CloudsearchV1::Operation::Representation command.response_class = Google::Apis::CloudsearchV1::Operation command.params['name'] = name unless name.nil? command.query['connectorName'] = connector_name unless connector_name.nil? command.query['debugOptions.enableDebugging'] = debug_options_enable_debugging unless debug_options_enable_debugging.nil? command.query['mode'] = mode unless mode.nil? command.query['version'] = version unless version.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Deletes the schema of a data source. Note: This API requires an admin or service account to execute. @param [String] name
Name of the data source to delete Schema. Format: datasources/`source_id`
@param [Boolean] debug_options_enable_debugging
If you are asked by Google to help with debugging, set this field. Otherwise, ignore this field.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::Operation] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::Operation]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 283 def delete_indexing_datasource_schema(name, debug_options_enable_debugging: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:delete, 'v1/indexing/{+name}/schema', options) command.response_representation = Google::Apis::CloudsearchV1::Operation::Representation command.response_class = Google::Apis::CloudsearchV1::Operation command.params['name'] = name unless name.nil? command.query['debugOptions.enableDebugging'] = debug_options_enable_debugging unless debug_options_enable_debugging.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Deletes all items in a queue. This method is useful for deleting stale items. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. @param [String] name
Name of the Data Source to delete items in a queue. Format: datasources/` source_id`
@param [Google::Apis::CloudsearchV1::DeleteQueueItemsRequest] delete_queue_items_request_object @param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::Operation] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::Operation]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 441 def delete_queue_items(name, delete_queue_items_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/indexing/{+name}/items:deleteQueueItems', options) command.request_representation = Google::Apis::CloudsearchV1::DeleteQueueItemsRequest::Representation command.request_object = delete_queue_items_request_object command.response_representation = Google::Apis::CloudsearchV1::Operation::Representation command.response_class = Google::Apis::CloudsearchV1::Operation command.params['name'] = name unless name.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Deletes a datasource. Note: This API requires an admin account to execute. @param [String] name
Name of the datasource. Format: datasources/`source_id`.
@param [Boolean] debug_options_enable_debugging
If you are asked by Google to help with debugging, set this field. Otherwise, ignore this field.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::Operation] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::Operation]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 1119 def delete_setting_datasource(name, debug_options_enable_debugging: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:delete, 'v1/settings/{+name}', options) command.response_representation = Google::Apis::CloudsearchV1::Operation::Representation command.response_class = Google::Apis::CloudsearchV1::Operation command.params['name'] = name unless name.nil? command.query['debugOptions.enableDebugging'] = debug_options_enable_debugging unless debug_options_enable_debugging.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Deletes a search application. Note: This API requires an admin account to execute. @param [String] name
The name of the search application to be deleted. Format: applications/` application_id`.
@param [Boolean] debug_options_enable_debugging
If you are asked by Google to help with debugging, set this field. Otherwise, ignore this field.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::Operation] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::Operation]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 1292 def delete_setting_searchapplication(name, debug_options_enable_debugging: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:delete, 'v1/settings/{+name}', options) command.response_representation = Google::Apis::CloudsearchV1::Operation::Representation command.response_class = Google::Apis::CloudsearchV1::Operation command.params['name'] = name unless name.nil? command.query['debugOptions.enableDebugging'] = debug_options_enable_debugging unless debug_options_enable_debugging.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Gets Item
resource by item name. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. @param [String] name
Name of the item to get info. Format: datasources/`source_id`/items/`item_id`
@param [String] connector_name
Name of connector making this call. Format: datasources/`source_id`/connectors/ `ID`
@param [Boolean] debug_options_enable_debugging
If you are asked by Google to help with debugging, set this field. Otherwise, ignore this field.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::Item] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::Item]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 481 def get_indexing_datasource_item(name, connector_name: nil, debug_options_enable_debugging: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/indexing/{+name}', options) command.response_representation = Google::Apis::CloudsearchV1::Item::Representation command.response_class = Google::Apis::CloudsearchV1::Item command.params['name'] = name unless name.nil? command.query['connectorName'] = connector_name unless connector_name.nil? command.query['debugOptions.enableDebugging'] = debug_options_enable_debugging unless debug_options_enable_debugging.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Gets the schema of a data source. Note: This API requires an admin or service account to execute. @param [String] name
Name of the data source to get Schema. Format: datasources/`source_id`
@param [Boolean] debug_options_enable_debugging
If you are asked by Google to help with debugging, set this field. Otherwise, ignore this field.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::Schema] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::Schema]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 318 def get_indexing_datasource_schema(name, debug_options_enable_debugging: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/indexing/{+name}/schema', options) command.response_representation = Google::Apis::CloudsearchV1::Schema::Representation command.response_class = Google::Apis::CloudsearchV1::Schema command.params['name'] = name unless name.nil? command.query['debugOptions.enableDebugging'] = debug_options_enable_debugging unless debug_options_enable_debugging.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service. @param [String] name
The name of the operation resource.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::Operation] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::Operation]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 815 def get_operation(name, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/{+name}', options) command.response_representation = Google::Apis::CloudsearchV1::Operation::Representation command.response_class = Google::Apis::CloudsearchV1::Operation command.params['name'] = name unless name.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Get customer settings. Note: This API requires an admin account to execute. @param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::CustomerSettings] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::CustomerSettings]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 1020 def get_setting_customer(fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/settings/customer', options) command.response_representation = Google::Apis::CloudsearchV1::CustomerSettings::Representation command.response_class = Google::Apis::CloudsearchV1::CustomerSettings command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Gets a datasource. Note: This API requires an admin account to execute. @param [String] name
Name of the datasource resource. Format: datasources/`source_id`.
@param [Boolean] debug_options_enable_debugging
If you are asked by Google to help with debugging, set this field. Otherwise, ignore this field.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::DataSource] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::DataSource]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 1153 def get_setting_datasource(name, debug_options_enable_debugging: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/settings/{+name}', options) command.response_representation = Google::Apis::CloudsearchV1::DataSource::Representation command.response_class = Google::Apis::CloudsearchV1::DataSource command.params['name'] = name unless name.nil? command.query['debugOptions.enableDebugging'] = debug_options_enable_debugging unless debug_options_enable_debugging.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Gets the specified search application. Note: This API requires an admin account to execute. @param [String] name
Name of the search application. Format: searchapplications/`application_id`.
@param [Boolean] debug_options_enable_debugging
If you are asked by Google to help with debugging, set this field. Otherwise, ignore this field.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::SearchApplication] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::SearchApplication]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 1327 def get_setting_searchapplication(name, debug_options_enable_debugging: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/settings/{+name}', options) command.response_representation = Google::Apis::CloudsearchV1::SearchApplication::Representation command.response_class = Google::Apis::CloudsearchV1::SearchApplication command.params['name'] = name unless name.nil? command.query['debugOptions.enableDebugging'] = debug_options_enable_debugging unless debug_options_enable_debugging.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Gets indexed item statistics aggreggated across all data sources. This API only returns statistics for previous dates; it doesn't return statistics for the current day. Note: This API requires a standard end user account to execute. @param [Fixnum] from_date_day
Day of month. Must be from 1 to 31 and valid for the year and month.
@param [Fixnum] from_date_month
Month of date. Must be from 1 to 12.
@param [Fixnum] from_date_year
Year of date. Must be from 1 to 9999.
@param [Fixnum] to_date_day
Day of month. Must be from 1 to 31 and valid for the year and month.
@param [Fixnum] to_date_month
Month of date. Must be from 1 to 12.
@param [Fixnum] to_date_year
Year of date. Must be from 1 to 9999.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::GetCustomerIndexStatsResponse] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::GetCustomerIndexStatsResponse]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 1479 def get_stat_index(from_date_day: nil, from_date_month: nil, from_date_year: nil, to_date_day: nil, to_date_month: nil, to_date_year: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/stats/index', options) command.response_representation = Google::Apis::CloudsearchV1::GetCustomerIndexStatsResponse::Representation command.response_class = Google::Apis::CloudsearchV1::GetCustomerIndexStatsResponse command.query['fromDate.day'] = from_date_day unless from_date_day.nil? command.query['fromDate.month'] = from_date_month unless from_date_month.nil? command.query['fromDate.year'] = from_date_year unless from_date_year.nil? command.query['toDate.day'] = to_date_day unless to_date_day.nil? command.query['toDate.month'] = to_date_month unless to_date_month.nil? command.query['toDate.year'] = to_date_year unless to_date_year.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Gets indexed item statistics for a single data source. Note: This API requires a standard end user account to execute. @param [String] name
The resource id of the data source to retrieve statistics for, in the following format: "datasources/`source_id`"
@param [Fixnum] from_date_day
Day of month. Must be from 1 to 31 and valid for the year and month.
@param [Fixnum] from_date_month
Month of date. Must be from 1 to 12.
@param [Fixnum] from_date_year
Year of date. Must be from 1 to 9999.
@param [Fixnum] to_date_day
Day of month. Must be from 1 to 31 and valid for the year and month.
@param [Fixnum] to_date_month
Month of date. Must be from 1 to 12.
@param [Fixnum] to_date_year
Year of date. Must be from 1 to 9999.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::GetDataSourceIndexStatsResponse] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::GetDataSourceIndexStatsResponse]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 1667 def get_stat_index_datasource(name, from_date_day: nil, from_date_month: nil, from_date_year: nil, to_date_day: nil, to_date_month: nil, to_date_year: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/stats/index/{+name}', options) command.response_representation = Google::Apis::CloudsearchV1::GetDataSourceIndexStatsResponse::Representation command.response_class = Google::Apis::CloudsearchV1::GetDataSourceIndexStatsResponse command.params['name'] = name unless name.nil? command.query['fromDate.day'] = from_date_day unless from_date_day.nil? command.query['fromDate.month'] = from_date_month unless from_date_month.nil? command.query['fromDate.year'] = from_date_year unless from_date_year.nil? command.query['toDate.day'] = to_date_day unless to_date_day.nil? command.query['toDate.month'] = to_date_month unless to_date_month.nil? command.query['toDate.year'] = to_date_year unless to_date_year.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Get the query statistics for customer. Note: This API requires a standard end user account to execute. @param [Fixnum] from_date_day
Day of month. Must be from 1 to 31 and valid for the year and month.
@param [Fixnum] from_date_month
Month of date. Must be from 1 to 12.
@param [Fixnum] from_date_year
Year of date. Must be from 1 to 9999.
@param [Fixnum] to_date_day
Day of month. Must be from 1 to 31 and valid for the year and month.
@param [Fixnum] to_date_month
Month of date. Must be from 1 to 12.
@param [Fixnum] to_date_year
Year of date. Must be from 1 to 9999.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::GetCustomerQueryStatsResponse] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::GetCustomerQueryStatsResponse]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 1525 def get_stat_query(from_date_day: nil, from_date_month: nil, from_date_year: nil, to_date_day: nil, to_date_month: nil, to_date_year: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/stats/query', options) command.response_representation = Google::Apis::CloudsearchV1::GetCustomerQueryStatsResponse::Representation command.response_class = Google::Apis::CloudsearchV1::GetCustomerQueryStatsResponse command.query['fromDate.day'] = from_date_day unless from_date_day.nil? command.query['fromDate.month'] = from_date_month unless from_date_month.nil? command.query['fromDate.year'] = from_date_year unless from_date_year.nil? command.query['toDate.day'] = to_date_day unless to_date_day.nil? command.query['toDate.month'] = to_date_month unless to_date_month.nil? command.query['toDate.year'] = to_date_year unless to_date_year.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Get the query statistics for search application. Note: This API requires a standard end user account to execute. @param [String] name
The resource id of the search application query stats, in the following format: searchapplications/`application_id`
@param [Fixnum] from_date_day
Day of month. Must be from 1 to 31 and valid for the year and month.
@param [Fixnum] from_date_month
Month of date. Must be from 1 to 12.
@param [Fixnum] from_date_year
Year of date. Must be from 1 to 9999.
@param [Fixnum] to_date_day
Day of month. Must be from 1 to 31 and valid for the year and month.
@param [Fixnum] to_date_month
Month of date. Must be from 1 to 12.
@param [Fixnum] to_date_year
Year of date. Must be from 1 to 9999.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::GetSearchApplicationQueryStatsResponse] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::GetSearchApplicationQueryStatsResponse]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 1717 def get_stat_query_searchapplication(name, from_date_day: nil, from_date_month: nil, from_date_year: nil, to_date_day: nil, to_date_month: nil, to_date_year: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/stats/query/{+name}', options) command.response_representation = Google::Apis::CloudsearchV1::GetSearchApplicationQueryStatsResponse::Representation command.response_class = Google::Apis::CloudsearchV1::GetSearchApplicationQueryStatsResponse command.params['name'] = name unless name.nil? command.query['fromDate.day'] = from_date_day unless from_date_day.nil? command.query['fromDate.month'] = from_date_month unless from_date_month.nil? command.query['fromDate.year'] = from_date_year unless from_date_year.nil? command.query['toDate.day'] = to_date_day unless to_date_day.nil? command.query['toDate.month'] = to_date_month unless to_date_month.nil? command.query['toDate.year'] = to_date_year unless to_date_year.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Get the # of search sessions, % of successful sessions with a click query statistics for customer. Note: This API requires a standard end user account to execute. @param [Fixnum] from_date_day
Day of month. Must be from 1 to 31 and valid for the year and month.
@param [Fixnum] from_date_month
Month of date. Must be from 1 to 12.
@param [Fixnum] from_date_year
Year of date. Must be from 1 to 9999.
@param [Fixnum] to_date_day
Day of month. Must be from 1 to 31 and valid for the year and month.
@param [Fixnum] to_date_month
Month of date. Must be from 1 to 12.
@param [Fixnum] to_date_year
Year of date. Must be from 1 to 9999.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::GetCustomerSessionStatsResponse] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::GetCustomerSessionStatsResponse]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 1572 def get_stat_session(from_date_day: nil, from_date_month: nil, from_date_year: nil, to_date_day: nil, to_date_month: nil, to_date_year: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/stats/session', options) command.response_representation = Google::Apis::CloudsearchV1::GetCustomerSessionStatsResponse::Representation command.response_class = Google::Apis::CloudsearchV1::GetCustomerSessionStatsResponse command.query['fromDate.day'] = from_date_day unless from_date_day.nil? command.query['fromDate.month'] = from_date_month unless from_date_month.nil? command.query['fromDate.year'] = from_date_year unless from_date_year.nil? command.query['toDate.day'] = to_date_day unless to_date_day.nil? command.query['toDate.month'] = to_date_month unless to_date_month.nil? command.query['toDate.year'] = to_date_year unless to_date_year.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Get the # of search sessions, % of successful sessions with a click query statistics for search application. Note: This API requires a standard end user account to execute. @param [String] name
The resource id of the search application session stats, in the following format: searchapplications/`application_id`
@param [Fixnum] from_date_day
Day of month. Must be from 1 to 31 and valid for the year and month.
@param [Fixnum] from_date_month
Month of date. Must be from 1 to 12.
@param [Fixnum] from_date_year
Year of date. Must be from 1 to 9999.
@param [Fixnum] to_date_day
Day of month. Must be from 1 to 31 and valid for the year and month.
@param [Fixnum] to_date_month
Month of date. Must be from 1 to 12.
@param [Fixnum] to_date_year
Year of date. Must be from 1 to 9999.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::GetSearchApplicationSessionStatsResponse] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::GetSearchApplicationSessionStatsResponse]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 1768 def get_stat_session_searchapplication(name, from_date_day: nil, from_date_month: nil, from_date_year: nil, to_date_day: nil, to_date_month: nil, to_date_year: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/stats/session/{+name}', options) command.response_representation = Google::Apis::CloudsearchV1::GetSearchApplicationSessionStatsResponse::Representation command.response_class = Google::Apis::CloudsearchV1::GetSearchApplicationSessionStatsResponse command.params['name'] = name unless name.nil? command.query['fromDate.day'] = from_date_day unless from_date_day.nil? command.query['fromDate.month'] = from_date_month unless from_date_month.nil? command.query['fromDate.year'] = from_date_year unless from_date_year.nil? command.query['toDate.day'] = to_date_day unless to_date_day.nil? command.query['toDate.month'] = to_date_month unless to_date_month.nil? command.query['toDate.year'] = to_date_year unless to_date_year.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Get the users statistics for customer. Note: This API requires a standard end user account to execute. @param [Fixnum] from_date_day
Day of month. Must be from 1 to 31 and valid for the year and month.
@param [Fixnum] from_date_month
Month of date. Must be from 1 to 12.
@param [Fixnum] from_date_year
Year of date. Must be from 1 to 9999.
@param [Fixnum] to_date_day
Day of month. Must be from 1 to 31 and valid for the year and month.
@param [Fixnum] to_date_month
Month of date. Must be from 1 to 12.
@param [Fixnum] to_date_year
Year of date. Must be from 1 to 9999.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::GetCustomerUserStatsResponse] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::GetCustomerUserStatsResponse]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 1618 def get_stat_user(from_date_day: nil, from_date_month: nil, from_date_year: nil, to_date_day: nil, to_date_month: nil, to_date_year: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/stats/user', options) command.response_representation = Google::Apis::CloudsearchV1::GetCustomerUserStatsResponse::Representation command.response_class = Google::Apis::CloudsearchV1::GetCustomerUserStatsResponse command.query['fromDate.day'] = from_date_day unless from_date_day.nil? command.query['fromDate.month'] = from_date_month unless from_date_month.nil? command.query['fromDate.year'] = from_date_year unless from_date_year.nil? command.query['toDate.day'] = to_date_day unless to_date_day.nil? command.query['toDate.month'] = to_date_month unless to_date_month.nil? command.query['toDate.year'] = to_date_year unless to_date_year.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Get the users statistics for search application. Note: This API requires a standard end user account to execute. @param [String] name
The resource id of the search application session stats, in the following format: searchapplications/`application_id`
@param [Fixnum] from_date_day
Day of month. Must be from 1 to 31 and valid for the year and month.
@param [Fixnum] from_date_month
Month of date. Must be from 1 to 12.
@param [Fixnum] from_date_year
Year of date. Must be from 1 to 9999.
@param [Fixnum] to_date_day
Day of month. Must be from 1 to 31 and valid for the year and month.
@param [Fixnum] to_date_month
Month of date. Must be from 1 to 12.
@param [Fixnum] to_date_year
Year of date. Must be from 1 to 9999.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::GetSearchApplicationUserStatsResponse] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::GetSearchApplicationUserStatsResponse]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 1818 def get_stat_user_searchapplication(name, from_date_day: nil, from_date_month: nil, from_date_year: nil, to_date_day: nil, to_date_month: nil, to_date_year: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/stats/user/{+name}', options) command.response_representation = Google::Apis::CloudsearchV1::GetSearchApplicationUserStatsResponse::Representation command.response_class = Google::Apis::CloudsearchV1::GetSearchApplicationUserStatsResponse command.params['name'] = name unless name.nil? command.query['fromDate.day'] = from_date_day unless from_date_day.nil? command.query['fromDate.month'] = from_date_month unless from_date_month.nil? command.query['fromDate.year'] = from_date_year unless from_date_year.nil? command.query['toDate.day'] = to_date_day unless to_date_day.nil? command.query['toDate.month'] = to_date_month unless to_date_month.nil? command.query['toDate.year'] = to_date_year unless to_date_year.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Updates Item
ACL, metadata, and content. It will insert the Item
if it does not exist. This method does not support partial updates. Fields with no provided values are cleared out in the Cloud Search index. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. @param [String] name
Name of the Item. Format: datasources/`source_id`/items/`item_id` This is a required field. The maximum length is 1536 characters.
@param [Google::Apis::CloudsearchV1::IndexItemRequest] index_item_request_object @param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::Operation] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::Operation]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 519 def index_item(name, index_item_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/indexing/{+name}:index', options) command.request_representation = Google::Apis::CloudsearchV1::IndexItemRequest::Representation command.request_object = index_item_request_object command.response_representation = Google::Apis::CloudsearchV1::Operation::Representation command.response_class = Google::Apis::CloudsearchV1::Operation command.params['name'] = name unless name.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
List all unmapped identities for a specific item. Note: This API requires an admin account to execute. @param [String] parent
The name of the item, in the following format: datasources/`source_id`/items/` ID`
@param [Boolean] debug_options_enable_debugging
If you are asked by Google to help with debugging, set this field. Otherwise, ignore this field.
@param [Fixnum] page_size
Maximum number of items to fetch in a request. Defaults to 100.
@param [String] page_token
The next_page_token value returned from a previous List request, if any.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::ListUnmappedIdentitiesResponse] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::ListUnmappedIdentitiesResponse]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 155 def list_debug_datasource_item_unmappedids(parent, debug_options_enable_debugging: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/debug/{+parent}/unmappedids', options) command.response_representation = Google::Apis::CloudsearchV1::ListUnmappedIdentitiesResponse::Representation command.response_class = Google::Apis::CloudsearchV1::ListUnmappedIdentitiesResponse command.params['parent'] = parent unless parent.nil? command.query['debugOptions.enableDebugging'] = debug_options_enable_debugging unless debug_options_enable_debugging.nil? command.query['pageSize'] = page_size unless page_size.nil? command.query['pageToken'] = page_token unless page_token.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Lists names of items associated with an unmapped identity. Note: This API requires an admin account to execute. @param [String] parent
The name of the identity source, in the following format: identitysources/` source_id``
@param [Boolean] debug_options_enable_debugging
If you are asked by Google to help with debugging, set this field. Otherwise, ignore this field.
@param [String] group_resource_name @param [Fixnum] page_size
Maximum number of items to fetch in a request. Defaults to 100.
@param [String] page_token
The next_page_token value returned from a previous List request, if any.
@param [String] user_resource_name @param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::ListItemNamesForUnmappedIdentityResponse] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::ListItemNamesForUnmappedIdentityResponse]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 199 def list_debug_identitysource_item_forunmappedidentity(parent, debug_options_enable_debugging: nil, group_resource_name: nil, page_size: nil, page_token: nil, user_resource_name: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/debug/{+parent}/items:forunmappedidentity', options) command.response_representation = Google::Apis::CloudsearchV1::ListItemNamesForUnmappedIdentityResponse::Representation command.response_class = Google::Apis::CloudsearchV1::ListItemNamesForUnmappedIdentityResponse command.params['parent'] = parent unless parent.nil? command.query['debugOptions.enableDebugging'] = debug_options_enable_debugging unless debug_options_enable_debugging.nil? command.query['groupResourceName'] = group_resource_name unless group_resource_name.nil? command.query['pageSize'] = page_size unless page_size.nil? command.query['pageToken'] = page_token unless page_token.nil? command.query['userResourceName'] = user_resource_name unless user_resource_name.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Lists unmapped user identities for an identity source. Note: This API requires an admin account to execute. @param [String] parent
The name of the identity source, in the following format: identitysources/` source_id`
@param [Boolean] debug_options_enable_debugging
If you are asked by Google to help with debugging, set this field. Otherwise, ignore this field.
@param [Fixnum] page_size
Maximum number of items to fetch in a request. Defaults to 100.
@param [String] page_token
The next_page_token value returned from a previous List request, if any.
@param [String] resolution_status_code
Limit users selection to this status.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::ListUnmappedIdentitiesResponse] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::ListUnmappedIdentitiesResponse]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 245 def list_debug_identitysource_unmappedids(parent, debug_options_enable_debugging: nil, page_size: nil, page_token: nil, resolution_status_code: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/debug/{+parent}/unmappedids', options) command.response_representation = Google::Apis::CloudsearchV1::ListUnmappedIdentitiesResponse::Representation command.response_class = Google::Apis::CloudsearchV1::ListUnmappedIdentitiesResponse command.params['parent'] = parent unless parent.nil? command.query['debugOptions.enableDebugging'] = debug_options_enable_debugging unless debug_options_enable_debugging.nil? command.query['pageSize'] = page_size unless page_size.nil? command.query['pageToken'] = page_token unless page_token.nil? command.query['resolutionStatusCode'] = resolution_status_code unless resolution_status_code.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Lists all or a subset of Item
resources. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. @param [String] name
Name of the Data Source to list Items. Format: datasources/`source_id`
@param [Boolean] brief
When set to true, the indexing system only populates the following fields: name, version, queue. metadata.hash, metadata.title, metadata. sourceRepositoryURL, metadata.objectType, metadata.createTime, metadata. updateTime, metadata.contentLanguage, metadata.mimeType, structured_data.hash, content.hash, itemType, itemStatus.code, itemStatus.processingError.code, itemStatus.repositoryError.type, If this value is false, then all the fields are populated in Item.
@param [String] connector_name
Name of connector making this call. Format: datasources/`source_id`/connectors/ `ID`
@param [Boolean] debug_options_enable_debugging
If you are asked by Google to help with debugging, set this field. Otherwise, ignore this field.
@param [Fixnum] page_size
Maximum number of items to fetch in a request. The max value is 1000 when brief is true. The max value is 10 if brief is false. The default value is 10
@param [String] page_token
The next_page_token value returned from a previous List request, if any.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::ListItemsResponse] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::ListItemsResponse]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 572 def list_indexing_datasource_items(name, brief: nil, connector_name: nil, debug_options_enable_debugging: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/indexing/{+name}/items', options) command.response_representation = Google::Apis::CloudsearchV1::ListItemsResponse::Representation command.response_class = Google::Apis::CloudsearchV1::ListItemsResponse command.params['name'] = name unless name.nil? command.query['brief'] = brief unless brief.nil? command.query['connectorName'] = connector_name unless connector_name.nil? command.query['debugOptions.enableDebugging'] = debug_options_enable_debugging unless debug_options_enable_debugging.nil? command.query['pageSize'] = page_size unless page_size.nil? command.query['pageToken'] = page_token unless page_token.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to override the binding to use different resource name schemes, such as `users/*/operations`. To override the binding, API services can add a binding such as `“/v1/`name=users/*`/operations”` to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id. @param [String] name
The name of the operation's parent resource.
@param [String] filter
The standard list filter.
@param [Fixnum] page_size
The standard list page size.
@param [String] page_token
The standard list page token.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::ListOperationsResponse] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::ListOperationsResponse]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 858 def list_operation_lros(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/{+name}/lro', options) command.response_representation = Google::Apis::CloudsearchV1::ListOperationsResponse::Representation command.response_class = Google::Apis::CloudsearchV1::ListOperationsResponse command.params['name'] = name unless name.nil? command.query['filter'] = filter unless filter.nil? command.query['pageSize'] = page_size unless page_size.nil? command.query['pageToken'] = page_token unless page_token.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Returns list of sources that user can use for Search and Suggest APIs. *Note:
-
This API requires a standard end user account to execute. A service account
can't perform Query API requests directly; to use a service account to perform queries, set up [Google Workspace domain-wide delegation of authority](https:// developers.google.com/cloud-search/docs/guides/delegation/). @param [String] page_token
Number of sources to return in the response.
@param [Boolean] request_options_debug_options_enable_debugging
If you are asked by Google to help with debugging, set this field. Otherwise, ignore this field.
@param [String] request_options_language_code
The BCP-47 language code, such as "en-US" or "sr-Latn". For more information, see http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. For translations. Set this field using the language set in browser or for the page. In the event that the user's language preference is known, set this field to the known user language. When specified, the documents in search results are biased towards the specified language. The suggest API does not use this parameter. Instead, suggest autocompletes only based on characters in the query.
@param [String] request_options_search_application_id
The ID generated when you create a search application using the [admin console] (https://support.google.com/a/answer/9043922).
@param [String] request_options_time_zone
Current user's time zone id, such as "America/Los_Angeles" or "Australia/ Sydney". These IDs are defined by [Unicode Common Locale Data Repository (CLDR) ](http://cldr.unicode.org/) project, and currently available in the file [ timezone.xml](http://unicode.org/repos/cldr/trunk/common/bcp47/timezone.xml). This field is used to correctly interpret date and time queries. If this field is not specified, the default time zone (UTC) is used.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::ListQuerySourcesResponse] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::ListQuerySourcesResponse]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 988 def list_query_sources(page_token: nil, request_options_debug_options_enable_debugging: nil, request_options_language_code: nil, request_options_search_application_id: nil, request_options_time_zone: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/query/sources', options) command.response_representation = Google::Apis::CloudsearchV1::ListQuerySourcesResponse::Representation command.response_class = Google::Apis::CloudsearchV1::ListQuerySourcesResponse command.query['pageToken'] = page_token unless page_token.nil? command.query['requestOptions.debugOptions.enableDebugging'] = request_options_debug_options_enable_debugging unless request_options_debug_options_enable_debugging.nil? command.query['requestOptions.languageCode'] = request_options_language_code unless request_options_language_code.nil? command.query['requestOptions.searchApplicationId'] = request_options_search_application_id unless request_options_search_application_id.nil? command.query['requestOptions.timeZone'] = request_options_time_zone unless request_options_time_zone.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Lists datasources. Note: This API requires an admin account to execute. @param [Boolean] debug_options_enable_debugging
If you are asked by Google to help with debugging, set this field. Otherwise, ignore this field.
@param [Fixnum] page_size
Maximum number of datasources to fetch in a request. The max value is 100. The default value is 10
@param [String] page_token
Starting index of the results.
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::ListDataSourceResponse] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::ListDataSourceResponse]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 1190 def list_setting_datasources(debug_options_enable_debugging: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/settings/datasources', options) command.response_representation = Google::Apis::CloudsearchV1::ListDataSourceResponse::Representation command.response_class = Google::Apis::CloudsearchV1::ListDataSourceResponse command.query['debugOptions.enableDebugging'] = debug_options_enable_debugging unless debug_options_enable_debugging.nil? command.query['pageSize'] = page_size unless page_size.nil? command.query['pageToken'] = page_token unless page_token.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Lists all search applications. Note: This API requires an admin account to execute. @param [Boolean] debug_options_enable_debugging
If you are asked by Google to help with debugging, set this field. Otherwise, ignore this field.
@param [Fixnum] page_size
The maximum number of items to return.
@param [String] page_token
The next_page_token value returned from a previous List request, if any. The default value is 10
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::ListSearchApplicationsResponse] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::ListSearchApplicationsResponse]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 1365 def list_setting_searchapplications(debug_options_enable_debugging: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/settings/searchapplications', options) command.response_representation = Google::Apis::CloudsearchV1::ListSearchApplicationsResponse::Representation command.response_class = Google::Apis::CloudsearchV1::ListSearchApplicationsResponse command.query['debugOptions.enableDebugging'] = debug_options_enable_debugging unless debug_options_enable_debugging.nil? command.query['pageSize'] = page_size unless page_size.nil? command.query['pageToken'] = page_token unless page_token.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Polls for unreserved items from the indexing queue and marks a set as reserved, starting with items that have the oldest timestamp from the highest priority ItemStatus
. The priority order is as follows: ERROR MODIFIED NEW_ITEM ACCEPTED Reserving items ensures that polling from other threads cannot create overlapping sets. After handling the reserved items, the client should put items back into the unreserved state, either by calling index, or by calling push with the type REQUEUE. Items automatically become available (unreserved) after 4 hours even if no update or push method is called. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. @param [String] name
Name of the Data Source to poll items. Format: datasources/`source_id`
@param [Google::Apis::CloudsearchV1::PollItemsRequest] poll_items_request_object @param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::PollItemsResponse] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::PollItemsResponse]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 617 def poll_items(name, poll_items_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/indexing/{+name}/items:poll', options) command.request_representation = Google::Apis::CloudsearchV1::PollItemsRequest::Representation command.request_object = poll_items_request_object command.response_representation = Google::Apis::CloudsearchV1::PollItemsResponse::Representation command.response_class = Google::Apis::CloudsearchV1::PollItemsResponse command.params['name'] = name unless name.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Pushes an item onto a queue for later polling and updating. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. @param [String] name
Name of the item to push into the indexing queue. Format: datasources/` source_id`/items/`ID` This is a required field. The maximum length is 1536 characters.
@param [Google::Apis::CloudsearchV1::PushItemRequest] push_item_request_object @param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::Item] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::Item]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 654 def push_item(name, push_item_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/indexing/{+name}:push', options) command.request_representation = Google::Apis::CloudsearchV1::PushItemRequest::Representation command.request_object = push_item_request_object command.response_representation = Google::Apis::CloudsearchV1::Item::Representation command.response_class = Google::Apis::CloudsearchV1::Item command.params['name'] = name unless name.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Resets a search application to default settings. This will return an empty response. Note: This API requires an admin account to execute. @param [String] name
The name of the search application to be reset. Format: applications/` application_id`.
@param [Google::Apis::CloudsearchV1::ResetSearchApplicationRequest] reset_search_application_request_object @param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::Operation] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::Operation]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 1400 def reset_searchapplication_search_application(name, reset_search_application_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/settings/{+name}:reset', options) command.request_representation = Google::Apis::CloudsearchV1::ResetSearchApplicationRequest::Representation command.request_object = reset_search_application_request_object command.response_representation = Google::Apis::CloudsearchV1::Operation::Representation command.response_class = Google::Apis::CloudsearchV1::Operation command.params['name'] = name unless name.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Fetches the item whose viewUrl exactly matches that of the URL provided in the request. Note: This API requires an admin account to execute. @param [String] name
Source name, format: datasources/`source_id`
@param [Google::Apis::CloudsearchV1::SearchItemsByViewUrlRequest] search_items_by_view_url_request_object @param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::SearchItemsByViewUrlResponse] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::SearchItemsByViewUrlResponse]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 114 def search_debug_datasource_item_by_view_url(name, search_items_by_view_url_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/debug/{+name}/items:searchByViewUrl', options) command.request_representation = Google::Apis::CloudsearchV1::SearchItemsByViewUrlRequest::Representation command.request_object = search_items_by_view_url_request_object command.response_representation = Google::Apis::CloudsearchV1::SearchItemsByViewUrlResponse::Representation command.response_class = Google::Apis::CloudsearchV1::SearchItemsByViewUrlResponse command.params['name'] = name unless name.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
The Cloud Search Query API provides the search method, which returns the most relevant results from a user query. The results can come from Google
Workspace apps, such as Gmail or Google
Drive, or they can come from data that you have indexed from a third party. Note: This API requires a standard end user account to execute. A service account can't perform Query API requests directly; to use a service account to perform queries, set up [Google Workspace domain-wide delegation of authority](developers.google.com/ cloud-search/docs/guides/delegation/). @param [Google::Apis::CloudsearchV1::SearchRequest] search_request_object @param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::SearchResponse] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::SearchResponse]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 897 def search_query(search_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/query/search', options) command.request_representation = Google::Apis::CloudsearchV1::SearchRequest::Representation command.request_object = search_request_object command.response_representation = Google::Apis::CloudsearchV1::SearchResponse::Representation command.response_class = Google::Apis::CloudsearchV1::SearchResponse command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Provides suggestions for autocompleting the query. Note: This API requires a standard end user account to execute. A service account can't perform Query API requests directly; to use a service account to perform queries, set up [ Google
Workspace domain-wide delegation of authority](developers. google.com/cloud-search/docs/guides/delegation/). @param [Google::Apis::CloudsearchV1::SuggestRequest] suggest_request_object @param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::SuggestResponse] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::SuggestResponse]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 931 def suggest_query(suggest_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/query/suggest', options) command.request_representation = Google::Apis::CloudsearchV1::SuggestRequest::Representation command.request_object = suggest_request_object command.response_representation = Google::Apis::CloudsearchV1::SuggestResponse::Representation command.response_class = Google::Apis::CloudsearchV1::SuggestResponse command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Unreserves all items from a queue, making them all eligible to be polled. This method is useful for resetting the indexing queue after a connector has been restarted. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. @param [String] name
Name of the Data Source to unreserve all items. Format: datasources/`source_id`
@param [Google::Apis::CloudsearchV1::UnreserveItemsRequest] unreserve_items_request_object @param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::Operation] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::Operation]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 690 def unreserve_items(name, unreserve_items_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/indexing/{+name}/items:unreserve', options) command.request_representation = Google::Apis::CloudsearchV1::UnreserveItemsRequest::Representation command.request_object = unreserve_items_request_object command.response_representation = Google::Apis::CloudsearchV1::Operation::Representation command.response_class = Google::Apis::CloudsearchV1::Operation command.params['name'] = name unless name.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Updates a datasource. Note: This API requires an admin account to execute. @param [String] name
Name of the datasource resource. Format: datasources/`source_id`. The name is ignored when creating a datasource.
@param [Google::Apis::CloudsearchV1::UpdateDataSourceRequest] update_data_source_request_object @param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::Operation] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::Operation]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 1224 def update_datasource_data_source(name, update_data_source_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:put, 'v1/settings/{+name}', options) command.request_representation = Google::Apis::CloudsearchV1::UpdateDataSourceRequest::Representation command.request_object = update_data_source_request_object command.response_representation = Google::Apis::CloudsearchV1::Operation::Representation command.response_class = Google::Apis::CloudsearchV1::Operation command.params['name'] = name unless name.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Updates the schema of a data source. This method does not perform incremental updates to the schema. Instead, this method updates the schema by overwriting the entire schema. Note: This API requires an admin or service account to execute. @param [String] name
Name of the data source to update Schema. Format: datasources/`source_id`
@param [Google::Apis::CloudsearchV1::UpdateSchemaRequest] update_schema_request_object @param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::Operation] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::Operation]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 353 def update_datasource_schema(name, update_schema_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:put, 'v1/indexing/{+name}/schema', options) command.request_representation = Google::Apis::CloudsearchV1::UpdateSchemaRequest::Representation command.request_object = update_schema_request_object command.response_representation = Google::Apis::CloudsearchV1::Operation::Representation command.response_class = Google::Apis::CloudsearchV1::Operation command.params['name'] = name unless name.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Update customer settings. Note: This API requires an admin account to execute. @param [Google::Apis::CloudsearchV1::CustomerSettings] customer_settings_object @param [String] update_mask
Update mask to control which fields get updated. If you specify a field in the update_mask but don't specify its value here, that field will be cleared. If the mask is not present or empty, all fields will be updated. Currently supported field paths: vpc_settings and audit_logging_settings
@param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::Operation] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::Operation]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 1054 def update_setting_customer(customer_settings_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:patch, 'v1/settings/customer', options) command.request_representation = Google::Apis::CloudsearchV1::CustomerSettings::Representation command.request_object = customer_settings_object command.response_representation = Google::Apis::CloudsearchV1::Operation::Representation command.response_class = Google::Apis::CloudsearchV1::Operation command.query['updateMask'] = update_mask unless update_mask.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Updates a search application. Note: This API requires an admin account to execute. @param [String] name
Name of the Search Application. Format: searchapplications/`application_id`.
@param [Google::Apis::CloudsearchV1::SearchApplication] search_application_object @param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::Operation] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::Operation]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 1434 def update_setting_searchapplication(name, search_application_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:put, 'v1/settings/{+name}', options) command.request_representation = Google::Apis::CloudsearchV1::SearchApplication::Representation command.request_object = search_application_object command.response_representation = Google::Apis::CloudsearchV1::Operation::Representation command.response_class = Google::Apis::CloudsearchV1::Operation command.params['name'] = name unless name.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Creates an upload session for uploading item content. For items smaller than 100 KB, it's easier to embed the content inline within an index request. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source. @param [String] name
Name of the Item to start a resumable upload. Format: datasources/`source_id`/ items/`item_id`. The maximum length is 1536 bytes.
@param [Google::Apis::CloudsearchV1::StartUploadItemRequest] start_upload_item_request_object @param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::UploadItemRef] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::UploadItemRef]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 727 def upload_indexing_datasource_item(name, start_upload_item_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/indexing/{+name}:upload', options) command.request_representation = Google::Apis::CloudsearchV1::StartUploadItemRequest::Representation command.request_object = start_upload_item_request_object command.response_representation = Google::Apis::CloudsearchV1::UploadItemRef::Representation command.response_class = Google::Apis::CloudsearchV1::UploadItemRef command.params['name'] = name unless name.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Uploads media for indexing. The upload endpoint supports direct and resumable upload protocols and is intended for large items that can not be [inlined during index requests](developers.google.com/cloud-search/docs/ reference/rest/v1/indexing.datasources.items#itemcontent). To index large content: 1. Call indexing.datasources.items.upload with the item name to begin an upload session and retrieve the UploadItemRef
. 1. Call media.upload to upload the content, as a streaming request, using the same resource name from the UploadItemRef
from step 1. 1. Call indexing.datasources.items.index to index the item. Populate the [ItemContent](/cloud-search/docs/reference/rest/ v1/indexing.datasources.items#ItemContent) with the UploadItemRef
from step 1. For additional information, see [Create a content connector using the REST API] (developers.google.com/cloud-search/docs/guides/content-connector#rest) . Note: This API requires a service account to execute. @param [String] resource_name
Name of the media that is being downloaded. See ReadRequest.resource_name.
@param [Google::Apis::CloudsearchV1::Media] media_object @param [String] fields
Selector specifying which fields to include in a partial response.
@param [String] quota_user
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
@param [IO, String] upload_source
IO stream or filename containing content to upload
@param [String] content_type
Content type of the uploaded content.
@param [Google::Apis::RequestOptions] options
Request-specific options
@yield [result, err] Result & error if block supplied @yieldparam result [Google::Apis::CloudsearchV1::Media] parsed result object @yieldparam err [StandardError] error object if request failed
@return [Google::Apis::CloudsearchV1::Media]
@raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification @raise [Google::Apis::AuthorizationError] Authorization is required
# File lib/google/apis/cloudsearch_v1/service.rb, line 776 def upload_medium(resource_name, media_object = nil, fields: nil, quota_user: nil, upload_source: nil, content_type: nil, options: nil, &block) if upload_source.nil? command = make_simple_command(:post, 'v1/media/{+resourceName}', options) else command = make_upload_command(:post, 'v1/media/{+resourceName}', options) command.upload_source = upload_source command.upload_content_type = content_type end command.request_representation = Google::Apis::CloudsearchV1::Media::Representation command.request_object = media_object command.response_representation = Google::Apis::CloudsearchV1::Media::Representation command.response_class = Google::Apis::CloudsearchV1::Media command.params['resourceName'] = resource_name unless resource_name.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end
Protected Instance Methods
# File lib/google/apis/cloudsearch_v1/service.rb, line 1836 def apply_command_defaults(command) command.query['key'] = key unless key.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? end