Added in API level 31

Builder

class Builder
kotlin.Any
   ↳ android.app.appsearch.PutDocumentsRequest.Builder

Builder for PutDocumentsRequest objects.

Summary

Public constructors

Public methods
PutDocumentsRequest.Builder

Adds one or more GenericDocument objects to the request.

PutDocumentsRequest.Builder

Adds a collection of GenericDocument objects to the request.

PutDocumentsRequest.Builder
addTakenActionGenericDocuments(vararg takenActionGenericDocuments: GenericDocument!)

Adds one or more GenericDocument objects containing taken action metrics to the request.

PutDocumentsRequest.Builder

Adds a collection of GenericDocument objects containing taken action metrics to the request.

PutDocumentsRequest

Creates a new PutDocumentsRequest object.

Public constructors

Builder

Added in API level 31
Builder()

Public methods

addGenericDocuments

Added in API level 31
fun addGenericDocuments(vararg documents: GenericDocument!): PutDocumentsRequest.Builder

Adds one or more GenericDocument objects to the request.

Parameters
documents GenericDocument!: This value cannot be null.
Return
PutDocumentsRequest.Builder This value cannot be null.

addGenericDocuments

Added in API level 31
fun addGenericDocuments(documents: MutableCollection<out GenericDocument!>): PutDocumentsRequest.Builder

Adds a collection of GenericDocument objects to the request.

Parameters
documents MutableCollection<out GenericDocument!>: This value cannot be null.
Return
PutDocumentsRequest.Builder This value cannot be null.

addTakenActionGenericDocuments

fun addTakenActionGenericDocuments(vararg takenActionGenericDocuments: GenericDocument!): PutDocumentsRequest.Builder

Adds one or more GenericDocument objects containing taken action metrics to the request.

Metrics to be collected by AppSearch:

  • name: STRING, the name of the taken action.

    Name is an optional custom field that allows the client to tag and categorize taken action GenericDocument.

  • referencedQualifiedId: STRING, the qualified id of the SearchResult document that the user takes action on.

    A qualified id is a string generated by package, database, namespace, and document id. See android.app.appsearch.util.DocumentIdUtil#createQualifiedId for more details.

  • previousQueries: REPEATED STRING, the list of all previous user-entered search inputs, without any operators or rewriting, collected during this search session in chronological order.
  • finalQuery: STRING, the final user-entered search input (without any operators or rewriting) that yielded the SearchResult on which the user took action.
  • resultRankInBlock: LONG, the rank of the SearchResult document among the user-defined block.

    The client can define its own custom definition for block, e.g. corpus name, group, etc.

    For example, a client defines the block as corpus, and AppSearch returns 5 documents with corpus = ["corpus1", "corpus1", "corpus2", "corpus3", "corpus2"]. Then the block ranks of them = [1, 2, 1, 1, 2].

    If the client is not presenting the results in multiple blocks, they should set this value to match resultRankGlobal.

  • resultRankGlobal: LONG, the global rank of the SearchResult document.

    Global rank reflects the order of SearchResult documents returned by AppSearch.

    For example, AppSearch returns 2 pages with 10 SearchResult documents for each page. Then the global ranks of them will be 1 to 10 for the first page, and 11 to 20 for the second page.

  • timeStayOnResultMillis: LONG, the time in milliseconds that user stays on the SearchResult document after clicking it.

Certain anonymized information about actions reported using this API may be uploaded using statsd and may be used to improve the quality of the search algorithms. Most of the information in this class is already non-identifiable, such as durations and its position in the result set. Identifiable information which you choose to provide, such as the query string, will be anonymized using techniques like Federated Analytics to ensure only the most frequently searched terms across the whole user population are retained and available for study.

You can alternatively use the addGenericDocuments(android.app.appsearch.GenericDocument...) API to retain the benefits of joining and using it on-device, without triggering any of the anonymized stats uploading described above.

Parameters
takenActionGenericDocuments GenericDocument!: one or more GenericDocument objects containing taken action metric fields. This value cannot be null.
Return
PutDocumentsRequest.Builder This value cannot be null.

addTakenActionGenericDocuments

fun addTakenActionGenericDocuments(takenActionGenericDocuments: MutableCollection<out GenericDocument!>): PutDocumentsRequest.Builder

Adds a collection of GenericDocument objects containing taken action metrics to the request.

Parameters
takenActionGenericDocuments MutableCollection<out GenericDocument!>: a collection of GenericDocument objects containing taken action metric fields. This value cannot be null.
Return
PutDocumentsRequest.Builder This value cannot be null.

build

Added in API level 31
fun build(): PutDocumentsRequest

Creates a new PutDocumentsRequest object.

Return
PutDocumentsRequest This value cannot be null.
Exceptions
java.lang.IllegalArgumentException if there is any id collision between normal and action documents.