AppSearchClient

Closes theAppSearchClient to persist all schema and document updates, additions, and deletes to disk.

GetsGenericDocument objects by document IDs in a namespace from the specified database.

Retrieves the set of all namespaces in the target database with at least one document.

Retrieves the schema most recently successfully provided to setSchema(SetSchemaRequest, String).

Gets the storage info for the specified database.

This may take time proportional to the number of documents and may be inefficient to call repeatedly.

Indexes documents into the specified database.

EachGenericDocument object must have aschemaTypefield set to anAppSearchSchema type that has been previously registered by calling the setSchema(SetSchemaRequest, String)method.

RemovesGenericDocuments from the index by Query. Documents will be removed if they match the queryExpressionin given namespaces and schemaTypes which is set via SearchSpec.Builder.addFilterNamespaces(String...)and SearchSpec.Builder.addFilterSchemas(String...).

An emptyqueryExpressionmatches all documents.

An empty set of namespaces or schemaTypes matches all namespaces or schemaTypes in the specified database.

RemovesGenericDocument objects by document IDs in a namespace from theAppSearchClient database.

Removed documents will no longer be surfaced by search(String, SearchSpec, String)or getByDocumentId(GetByDocumentIdRequest, String)calls.

Once the database crosses the document count or byte usage threshold, removed documents will be deleted from disk.

Reports usage of a particular document by namespace and ID.

A usage report represents an event in which a user interacted with or viewed a document.

For each call to reportUsage(ReportUsageRequest, String),Google Play services AppSearch updates usage count and usage recency metrics for that particular document. These metrics are used for ordering search(String, SearchSpec, String)results by the SearchSpec.RANKING_STRATEGY_USAGE_COUNTand SearchSpec.RANKING_STRATEGY_USAGE_LAST_USED_TIMESTAMPranking strategies.

Reporting usage of a document is optional.

Retrieves documents from the specified database that match a given query string and type of search provided.

Query strings can be empty, contain one term with no operators, or contain multiple terms and operators.

For query strings that are empty, all documents that match theSearchSpec will be returned.

For query strings with a single term and no operators, documents that match the provided query string andSearchSpec will be returned.

The following operators are supported:

• AND (implicit)

  AND is an operator that matches documents that containallprovided terms.

  NOTE:A space between terms is treated as an "AND" operator. Explicitly including "AND" in a query string will treat "AND" as a term, returning documents that also contain "AND".

  Example: "apple AND banana" matches documents that contain the terms "apple", "and", "banana".

  Example: "apple banana" matches documents that contain both "apple" and "banana".

  Example: "apple banana cherry" matches documents that contain "apple", "banana", and "cherry".

• OR

  OR is an operator that matches documents that containanyprovided term.

  Example: "apple OR banana" matches documents that contain either "apple" or "banana".

  Example: "apple OR banana OR cherry" matches documents that contain any of "apple", "banana", or "cherry".

• Exclusion (-)

  Exclusion (-) is an operator that matches documents thatdo notcontain the provided term.

  Example: "-apple" matches documents that do not contain "apple".

• Grouped Terms

  For queries that require multiple operators and terms, terms can be grouped into subqueries. Subqueries are contained within an open "(" and close ")" parenthesis.

  Example: "(donut OR bagel) (coffee OR tea)" matches documents that contain either "donut" or "bagel" and either "coffee" or "tea".

• Property Restricts

  For queries that require a term to match a specificAppSearchSchema property of a document, a ":" must be included between the property name and the term.

  Example: "subject:important" matches documents that contain the term "important" in the "subject" property.

Additional search specifications, such as filtering byAppSearchSchema type or adding projection, can be set by calling the correspondingSearchSpec.Builder setter.

This method is lightweight. The heavy work will be done inSearchResults.getNextPage().

Retrieves suggested Strings that could be used asqueryExpressionin search(String, SearchSpec, String)API.

ThesuggestionQueryExpressioncan contain one term with no operators, or contain multiple terms and operators. Operators will be considered as a normal term. Please see the operator examples below. ThesuggestionQueryExpressionmust end with a valid term, the suggestions are generated based on the last term. If the inputsuggestionQueryExpressiondoesn't have a valid token, AppSearch will return an empty result list. Please see the invalid examples below.

Example: if there are following documents with content stored in AppSearch.

• document1: "term1"
• document2: "term1 term2"
• document3: "term1 term2 term3"
• document4: "org"

Search suggestions with the single termsuggestionQueryExpression"t", the suggested results are:

• "term1" - Use it to be queryExpression in search(String, SearchSpec, String)could get 3SearchResults, which contains document 1, 2 and 3.
• "term2" - Use it to be queryExpression in search(String, SearchSpec, String)could get 2SearchResults, which contains document 2 and 3.
• "term3" - Use it to be queryExpression in search(String, SearchSpec, String)could get 1SearchResult, which contains document 3.

Search suggestions with the multiple termsuggestionQueryExpression "org t", the suggested result will be "org term1" - The last token is completed by the suggested String.

Operators in search(String, SearchSpec, String)are supported.

NOTE:Exclusion and Grouped Terms in the last term is not supported.

example: "apple -f": This Api will throw an AppSearchExceptionwith AppSearchResult.RESULT_INVALID_ARGUMENT.

example: "apple (f)": This Api will return an empty results.

Invalid example: All these inputsuggestionQueryExpressiondon't have a valid last token, AppSearch will return an empty result list.

• ""- EmptysuggestionQueryExpression.
• "(f)" - Ending in a closed brackets.
• "f:" - Ending in an operator.
• "f" - Ending in trailing space.

Sets the schema that represents the organizational structure of data within the Google Play services AppSearch database.

Upon creating anAppSearchClient, setSchema(SetSchemaRequest, String)should be called. If the schema needs to be updated, or it has not been previously set, then the provided schema will be saved and persisted to disk. Otherwise, setSchema(SetSchemaRequest, String)is handled efficiently as a no-op call.