1924 lines
122 KiB
Ruby
1924 lines
122 KiB
Ruby
# Copyright 2020 Google LLC
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
|
|
require 'google/apis/core/base_service'
|
|
require 'google/apis/core/json_representation'
|
|
require 'google/apis/core/hashable'
|
|
require 'google/apis/errors'
|
|
|
|
module Google
|
|
module Apis
|
|
module CloudsearchV1
|
|
# 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
|
|
#
|
|
# @see https://developers.google.com/cloud-search/docs/guides/
|
|
class CloudSearchService < Google::Apis::Core::BaseService
|
|
# @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.
|
|
attr_accessor :key
|
|
|
|
# @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.
|
|
attr_accessor :quota_user
|
|
|
|
def initialize
|
|
super('https://cloudsearch.googleapis.com/', '',
|
|
client_name: 'google-apis-cloudsearch_v1',
|
|
client_version: Google::Apis::CloudsearchV1::GEM_VERSION)
|
|
@batch_path = 'batch'
|
|
end
|
|
|
|
# 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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
|
|
# 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. For information
|
|
# on how item version affects the deletion process, refer to [Handle revisions
|
|
# after manual deletes](https://developers.google.com/cloud-search/docs/guides/
|
|
# operations).
|
|
# @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
|
|
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 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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
|
|
# 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
|
|
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](https://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]
|
|
# (https://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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
|
|
# 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](https://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
|
|
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](https://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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
|
|
# 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 1000.
|
|
# The default value is 1000.
|
|
# @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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
|
|
# 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
|
|
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 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
|
|
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 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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
|
|
# 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
|
|
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
|
|
|
|
# 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
|
|
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 search application stats for customer. **Note:** This API requires a
|
|
# standard end user account to execute.
|
|
# @param [Fixnum] end_date_day
|
|
# Day of month. Must be from 1 to 31 and valid for the year and month.
|
|
# @param [Fixnum] end_date_month
|
|
# Month of date. Must be from 1 to 12.
|
|
# @param [Fixnum] end_date_year
|
|
# Year of date. Must be from 1 to 9999.
|
|
# @param [Fixnum] start_date_day
|
|
# Day of month. Must be from 1 to 31 and valid for the year and month.
|
|
# @param [Fixnum] start_date_month
|
|
# Month of date. Must be from 1 to 12.
|
|
# @param [Fixnum] start_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::GetCustomerSearchApplicationStatsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::CloudsearchV1::GetCustomerSearchApplicationStatsResponse]
|
|
#
|
|
# @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
|
|
def get_stat_searchapplication(end_date_day: nil, end_date_month: nil, end_date_year: nil, start_date_day: nil, start_date_month: nil, start_date_year: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/stats/searchapplication', options)
|
|
command.response_representation = Google::Apis::CloudsearchV1::GetCustomerSearchApplicationStatsResponse::Representation
|
|
command.response_class = Google::Apis::CloudsearchV1::GetCustomerSearchApplicationStatsResponse
|
|
command.query['endDate.day'] = end_date_day unless end_date_day.nil?
|
|
command.query['endDate.month'] = end_date_month unless end_date_month.nil?
|
|
command.query['endDate.year'] = end_date_year unless end_date_year.nil?
|
|
command.query['startDate.day'] = start_date_day unless start_date_day.nil?
|
|
command.query['startDate.month'] = start_date_month unless start_date_month.nil?
|
|
command.query['startDate.year'] = start_date_year unless start_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
|
|
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 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
|
|
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
|
|
|
|
# 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
|
|
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 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
|
|
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 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
|
|
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 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
|
|
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
|
|
|
|
# Enables `third party` support in Google Cloud Search. **Note:** This API
|
|
# requires an admin account to execute.
|
|
# @param [Google::Apis::CloudsearchV1::InitializeCustomerRequest] initialize_customer_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
|
|
def initialize_customer(initialize_customer_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1:initializeCustomer', options)
|
|
command.request_representation = Google::Apis::CloudsearchV1::InitializeCustomerRequest::Representation
|
|
command.request_object = initialize_customer_request_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
|
|
|
|
protected
|
|
|
|
def apply_command_defaults(command)
|
|
command.query['key'] = key unless key.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
end
|
|
end
|
|
end
|
|
end
|
|
end
|