* The Google Cloud Search API defines an application interface to index * documents that contain structured data and to search those indexes. It * supports full text search.

* *

* For more information about this service, see the API * Documentation *

* * @author Google, Inc. */ class Google_Service_Cloudsearch extends Google_Service { /** View and manage your data across Google Cloud Platform services. */ const CLOUD_PLATFORM = "https://www.googleapis.com/auth/cloud-platform"; /** FOR TESTING ONLY. */ const CLOUDSEARCH = "https://www.googleapis.com/auth/cloudsearch"; /** View your email address. */ const USERINFO_EMAIL = "https://www.googleapis.com/auth/userinfo.email"; public $projects_indexes; public $projects_indexes_documents; /** * Constructs the internal representation of the Cloudsearch service. * * @param Google_Client $client */ public function __construct(Google_Client $client) { parent::__construct($client); $this->servicePath = ''; $this->version = 'v1'; $this->serviceName = 'cloudsearch'; $this->projects_indexes = new Google_Service_Cloudsearch_ProjectsIndexes_Resource( $this, $this->serviceName, 'indexes', array( 'methods' => array( 'list' => array( 'path' => 'v1/projects/{projectId}/indexes', 'httpMethod' => 'GET', 'parameters' => array( 'projectId' => array( 'location' => 'path', 'type' => 'string', 'required' => true, ), 'indexNamePrefix' => array( 'location' => 'query', 'type' => 'string', ), 'pageSize' => array( 'location' => 'query', 'type' => 'integer', ), 'pageToken' => array( 'location' => 'query', 'type' => 'string', ), 'view' => array( 'location' => 'query', 'type' => 'string', ), ), ),'search' => array( 'path' => 'v1/projects/{projectId}/indexes/{indexId}/search', 'httpMethod' => 'GET', 'parameters' => array( 'projectId' => array( 'location' => 'path', 'type' => 'string', 'required' => true, ), 'indexId' => array( 'location' => 'path', 'type' => 'string', 'required' => true, ), 'query' => array( 'location' => 'query', 'type' => 'string', ), 'fieldExpressions' => array( 'location' => 'query', 'type' => 'string', 'repeated' => true, ), 'pageSize' => array( 'location' => 'query', 'type' => 'integer', ), 'pageToken' => array( 'location' => 'query', 'type' => 'string', ), 'offset' => array( 'location' => 'query', 'type' => 'integer', ), 'matchedCountAccuracy' => array( 'location' => 'query', 'type' => 'integer', ), 'orderBy' => array( 'location' => 'query', 'type' => 'string', ), 'scorer' => array( 'location' => 'query', 'type' => 'string', ), 'scorerSize' => array( 'location' => 'query', 'type' => 'integer', ), 'returnFields' => array( 'location' => 'query', 'type' => 'string', 'repeated' => true, ), ), ), ) ) ); $this->projects_indexes_documents = new Google_Service_Cloudsearch_ProjectsIndexesDocuments_Resource( $this, $this->serviceName, 'documents', array( 'methods' => array( 'create' => array( 'path' => 'v1/projects/{projectId}/indexes/{indexId}/documents', 'httpMethod' => 'POST', 'parameters' => array( 'projectId' => array( 'location' => 'path', 'type' => 'string', 'required' => true, ), 'indexId' => array( 'location' => 'path', 'type' => 'string', 'required' => true, ), ), ),'delete' => array( 'path' => 'v1/projects/{projectId}/indexes/{indexId}/documents/{docId}', 'httpMethod' => 'DELETE', 'parameters' => array( 'projectId' => array( 'location' => 'path', 'type' => 'string', 'required' => true, ), 'indexId' => array( 'location' => 'path', 'type' => 'string', 'required' => true, ), 'docId' => array( 'location' => 'path', 'type' => 'string', 'required' => true, ), ), ),'get' => array( 'path' => 'v1/projects/{projectId}/indexes/{indexId}/documents/{docId}', 'httpMethod' => 'GET', 'parameters' => array( 'projectId' => array( 'location' => 'path', 'type' => 'string', 'required' => true, ), 'indexId' => array( 'location' => 'path', 'type' => 'string', 'required' => true, ), 'docId' => array( 'location' => 'path', 'type' => 'string', 'required' => true, ), ), ),'list' => array( 'path' => 'v1/projects/{projectId}/indexes/{indexId}/documents', 'httpMethod' => 'GET', 'parameters' => array( 'projectId' => array( 'location' => 'path', 'type' => 'string', 'required' => true, ), 'indexId' => array( 'location' => 'path', 'type' => 'string', 'required' => true, ), 'pageSize' => array( 'location' => 'query', 'type' => 'integer', ), 'pageToken' => array( 'location' => 'query', 'type' => 'string', ), 'view' => array( 'location' => 'query', 'type' => 'string', ), ), ), ) ) ); } } /** * The "projects" collection of methods. * Typical usage is: * * $cloudsearchService = new Google_Service_Cloudsearch(...); * $projects = $cloudsearchService->projects; * */ class Google_Service_Cloudsearch_Projects_Resource extends Google_Service_Resource { } /** * The "indexes" collection of methods. * Typical usage is: * * $cloudsearchService = new Google_Service_Cloudsearch(...); * $indexes = $cloudsearchService->indexes; * */ class Google_Service_Cloudsearch_ProjectsIndexes_Resource extends Google_Service_Resource { /** * Lists search indexes belonging to the specified project. * (indexes.listProjectsIndexes) * * @param string $projectId The project from which to retrieve indexes. It * cannot be the empty string. * @param array $optParams Optional parameters. * * @opt_param string indexNamePrefix The prefix of the index name. It is used to * list all indexes with names that have this prefix. * @opt_param int pageSize The maximum number of indexes to return per page. If * not specified, 100 indexes are returned per page. * @opt_param string pageToken A `nextPageToken` returned from previous list * indexes call as the starting point for this call. If not specified, list * indexes from the beginning. * @opt_param string view Specifies which parts of the IndexInfo resource is * returned in the response. If not specified, `ID_ONLY` is used. * @return Google_Service_Cloudsearch_ListIndexesResponse */ public function listProjectsIndexes($projectId, $optParams = array()) { $params = array('projectId' => $projectId); $params = array_merge($params, $optParams); return $this->call('list', array($params), "Google_Service_Cloudsearch_ListIndexesResponse"); } /** * Lists the documents in the named index that match the query. (indexes.search) * * @param string $projectId The project associated with the index for searching * document. It cannot be the empty string. * @param string $indexId The index to search. It cannot be the empty string. * @param array $optParams Optional parameters. * * @opt_param string query The query string in search query syntax. If the query * is missing or empty, all documents are returned. * @opt_param string fieldExpressions Customized expressions used in `orderBy` * or `returnFields`. The expression can contain fields in `Document`, the * built-in fields ( `_rank`, the document rank, and `_score` if scoring is * enabled) and fields defined in `fieldExpressions`. Each field expression is * represented in a json object with the following fields: * `name`: the name of * the field expression in string. * `expression`: the expression to be * computed. It can be a combination of supported functions encoded in string. * Expressions involving number fields can use the arithmetical operators (`+`, * `-`, `*`, `/`) and the built-in numeric functions (`max`, `min`, `pow`, * `count`, `log`, `abs`). Expressions involving geopoint fields can use the * `geopoint` and `distance` functions. Expressions for text and html fields can * use the `snippet` function. For example: ``` fieldExpressions={name: * "TotalPrice", expression: "(Price+Tax)"} ``` ``` fieldExpressions={name: * "snippet", expression: "snippet('good times', content)"} ``` The field * expression names can be used in `orderBy` and `returnFields` after they are * defined in `fieldExpressions`. * @opt_param int pageSize The maximum number of search results to return per * page. Searches perform best when the `pageSize` is kept as small as possible. * If not specified, 10 results are returned per page. * @opt_param string pageToken A `nextPageToken` returned from previous Search * call as the starting point for this call. Pagination tokens provide better * performance and consistency than offsets, and they cannot be used in * combination with offsets. * @opt_param int offset Offset is used to move to an arbitrary result, * independent of the previous results. Offsets are inefficient when compared to * `pageToken`. `pageToken` and `offset` cannot be both set. The default value * of `offset` is 0. * @opt_param int matchedCountAccuracy Minimum accuracy requirement for * `matchedCount` in search response. If specified, `matchedCount` will be * accurate up to at least that number. For example, when set to 100, any * `matchedCount <= 100` is accurate. This option may add considerable * latency/expense. By default (when it is not specified or set to 0), the * accuracy is the same as `pageSize`. * @opt_param string orderBy Comma-separated list of fields for sorting on the * search result, including fields from `Document`, the built-in fields (`_rank` * and `_score`), and fields defined in `fieldExpressions`. For example: * `orderBy="foo,bar"`. The default sorting order is ascending. To specify * descending order for a field, a suffix `" desc"` should be appended to the * field name. For example: `orderBy="foo desc,bar"`. The default value for text * sort is the empty string, and the default value for numeric sort is 0. If not * specified, the search results are automatically sorted by descending `_rank`. * Sorting by ascending `_rank` is not allowed. * @opt_param string scorer The scoring function to invoke on a search result * for this query. If `scorer` is not set, scoring is disabled and `_score` is 0 * for all documents in the search result. To enable document relevancy score * based on term frequency, set `"scorer=generic"`. * @opt_param int scorerSize Maximum number of top retrieved results to score. * It is valid only when `scorer` is set. If not specified, 100 retrieved * results are scored. * @opt_param string returnFields List of fields to return in `SearchResult` * objects. It can be fields from `Document`, the built-in fields `_rank` and * `_score`, and fields defined in `fieldExpressions`. Use `"*"` to return all * fields from `Document`. * @return Google_Service_Cloudsearch_SearchResponse */ public function search($projectId, $indexId, $optParams = array()) { $params = array('projectId' => $projectId, 'indexId' => $indexId); $params = array_merge($params, $optParams); return $this->call('search', array($params), "Google_Service_Cloudsearch_SearchResponse"); } } /** * The "documents" collection of methods. * Typical usage is: * * $cloudsearchService = new Google_Service_Cloudsearch(...); * $documents = $cloudsearchService->documents; * */ class Google_Service_Cloudsearch_ProjectsIndexesDocuments_Resource extends Google_Service_Resource { /** * Inserts a document for indexing or updates an indexed document. The returned * document contains only the ID of the new document. When `docId` is absent * from the document, it is provided by the server. (documents.create) * * @param string $projectId The project associated with the index for adding * document. It cannot be the empty string. * @param string $indexId The index to add document to. It cannot be the empty * string. * @param Google_Document $postBody * @param array $optParams Optional parameters. * @return Google_Service_Cloudsearch_Document */ public function create($projectId, $indexId, Google_Service_Cloudsearch_Document $postBody, $optParams = array()) { $params = array('projectId' => $projectId, 'indexId' => $indexId, 'postBody' => $postBody); $params = array_merge($params, $optParams); return $this->call('create', array($params), "Google_Service_Cloudsearch_Document"); } /** * Deletes a document from an index. (documents.delete) * * @param string $projectId The project associated with the index for deleting * document. It cannot be the empty string. * @param string $indexId The index from which to delete the document. It cannot * be the empty string. * @param string $docId The document to be deleted. It cannot be the empty * string. * @param array $optParams Optional parameters. * @return Google_Service_Cloudsearch_Empty */ public function delete($projectId, $indexId, $docId, $optParams = array()) { $params = array('projectId' => $projectId, 'indexId' => $indexId, 'docId' => $docId); $params = array_merge($params, $optParams); return $this->call('delete', array($params), "Google_Service_Cloudsearch_Empty"); } /** * Retrieves a document from an index. (documents.get) * * @param string $projectId The project associated with the index for retrieving * the document. It cannot be the empty string. * @param string $indexId The index from which to retrieve the document. It * cannot be the empty string. * @param string $docId The identifier of the document to retrieve. It cannot be * the empty string. * @param array $optParams Optional parameters. * @return Google_Service_Cloudsearch_Document */ public function get($projectId, $indexId, $docId, $optParams = array()) { $params = array('projectId' => $projectId, 'indexId' => $indexId, 'docId' => $docId); $params = array_merge($params, $optParams); return $this->call('get', array($params), "Google_Service_Cloudsearch_Document"); } /** * Lists documents in the specified search index. Intended for batch processing. * (documents.listProjectsIndexesDocuments) * * @param string $projectId The project associated with the index for listing * documents. It cannot be the empty string. * @param string $indexId The index from which to list the documents. It cannot * be the empty string. * @param array $optParams Optional parameters. * * @opt_param int pageSize The maximum number of documents to return per page. * If not specified, 100 documents are returned per page. * @opt_param string pageToken A `nextPageToken` returned from previous list * documents call as the starting point for this call. If not specified, list * documents from the beginning. * @opt_param string view Specifies which part of the document resource is * returned in the response. If not specified, `ID_ONLY` is used. * @return Google_Service_Cloudsearch_ListDocumentsResponse */ public function listProjectsIndexesDocuments($projectId, $indexId, $optParams = array()) { $params = array('projectId' => $projectId, 'indexId' => $indexId); $params = array_merge($params, $optParams); return $this->call('list', array($params), "Google_Service_Cloudsearch_ListDocumentsResponse"); } } class Google_Service_Cloudsearch_Document extends Google_Model { protected $internal_gapi_mappings = array( ); public $docId; protected $fieldsType = 'Google_Service_Cloudsearch_FieldValueList'; protected $fieldsDataType = 'map'; public $rank; public function setDocId($docId) { $this->docId = $docId; } public function getDocId() { return $this->docId; } public function setFields($fields) { $this->fields = $fields; } public function getFields() { return $this->fields; } public function setRank($rank) { $this->rank = $rank; } public function getRank() { return $this->rank; } } class Google_Service_Cloudsearch_DocumentFields extends Google_Model { } class Google_Service_Cloudsearch_Empty extends Google_Model { } class Google_Service_Cloudsearch_FieldNames extends Google_Collection { protected $collection_key = 'textFields'; protected $internal_gapi_mappings = array( ); public $atomFields; public $dateFields; public $geoFields; public $htmlFields; public $numberFields; public $textFields; public function setAtomFields($atomFields) { $this->atomFields = $atomFields; } public function getAtomFields() { return $this->atomFields; } public function setDateFields($dateFields) { $this->dateFields = $dateFields; } public function getDateFields() { return $this->dateFields; } public function setGeoFields($geoFields) { $this->geoFields = $geoFields; } public function getGeoFields() { return $this->geoFields; } public function setHtmlFields($htmlFields) { $this->htmlFields = $htmlFields; } public function getHtmlFields() { return $this->htmlFields; } public function setNumberFields($numberFields) { $this->numberFields = $numberFields; } public function getNumberFields() { return $this->numberFields; } public function setTextFields($textFields) { $this->textFields = $textFields; } public function getTextFields() { return $this->textFields; } } class Google_Service_Cloudsearch_FieldValue extends Google_Model { protected $internal_gapi_mappings = array( ); public $geoValue; public $lang; public $numberValue; public $stringFormat; public $stringValue; public $timestampValue; public function setGeoValue($geoValue) { $this->geoValue = $geoValue; } public function getGeoValue() { return $this->geoValue; } public function setLang($lang) { $this->lang = $lang; } public function getLang() { return $this->lang; } public function setNumberValue($numberValue) { $this->numberValue = $numberValue; } public function getNumberValue() { return $this->numberValue; } public function setStringFormat($stringFormat) { $this->stringFormat = $stringFormat; } public function getStringFormat() { return $this->stringFormat; } public function setStringValue($stringValue) { $this->stringValue = $stringValue; } public function getStringValue() { return $this->stringValue; } public function setTimestampValue($timestampValue) { $this->timestampValue = $timestampValue; } public function getTimestampValue() { return $this->timestampValue; } } class Google_Service_Cloudsearch_FieldValueList extends Google_Collection { protected $collection_key = 'values'; protected $internal_gapi_mappings = array( ); protected $valuesType = 'Google_Service_Cloudsearch_FieldValue'; protected $valuesDataType = 'array'; public function setValues($values) { $this->values = $values; } public function getValues() { return $this->values; } } class Google_Service_Cloudsearch_IndexInfo extends Google_Model { protected $internal_gapi_mappings = array( ); public $indexId; protected $indexedFieldType = 'Google_Service_Cloudsearch_FieldNames'; protected $indexedFieldDataType = ''; public $projectId; public function setIndexId($indexId) { $this->indexId = $indexId; } public function getIndexId() { return $this->indexId; } public function setIndexedField(Google_Service_Cloudsearch_FieldNames $indexedField) { $this->indexedField = $indexedField; } public function getIndexedField() { return $this->indexedField; } public function setProjectId($projectId) { $this->projectId = $projectId; } public function getProjectId() { return $this->projectId; } } class Google_Service_Cloudsearch_ListDocumentsResponse extends Google_Collection { protected $collection_key = 'documents'; protected $internal_gapi_mappings = array( ); protected $documentsType = 'Google_Service_Cloudsearch_Document'; protected $documentsDataType = 'array'; public $nextPageToken; public function setDocuments($documents) { $this->documents = $documents; } public function getDocuments() { return $this->documents; } public function setNextPageToken($nextPageToken) { $this->nextPageToken = $nextPageToken; } public function getNextPageToken() { return $this->nextPageToken; } } class Google_Service_Cloudsearch_ListIndexesResponse extends Google_Collection { protected $collection_key = 'indexes'; protected $internal_gapi_mappings = array( ); protected $indexesType = 'Google_Service_Cloudsearch_IndexInfo'; protected $indexesDataType = 'array'; public $nextPageToken; public function setIndexes($indexes) { $this->indexes = $indexes; } public function getIndexes() { return $this->indexes; } public function setNextPageToken($nextPageToken) { $this->nextPageToken = $nextPageToken; } public function getNextPageToken() { return $this->nextPageToken; } } class Google_Service_Cloudsearch_SearchResponse extends Google_Collection { protected $collection_key = 'results'; protected $internal_gapi_mappings = array( ); public $matchedCount; protected $resultsType = 'Google_Service_Cloudsearch_SearchResult'; protected $resultsDataType = 'array'; public function setMatchedCount($matchedCount) { $this->matchedCount = $matchedCount; } public function getMatchedCount() { return $this->matchedCount; } public function setResults($results) { $this->results = $results; } public function getResults() { return $this->results; } } class Google_Service_Cloudsearch_SearchResult extends Google_Model { protected $internal_gapi_mappings = array( ); public $docId; protected $fieldsType = 'Google_Service_Cloudsearch_FieldValueList'; protected $fieldsDataType = 'map'; public $nextPageToken; public function setDocId($docId) { $this->docId = $docId; } public function getDocId() { return $this->docId; } public function setFields($fields) { $this->fields = $fields; } public function getFields() { return $this->fields; } public function setNextPageToken($nextPageToken) { $this->nextPageToken = $nextPageToken; } public function getNextPageToken() { return $this->nextPageToken; } } class Google_Service_Cloudsearch_SearchResultFields extends Google_Model { }