ContactPoint.Builder


@Document.BuilderProducer
public final class ContactPoint.Builder


Builder for ContactPoint.

Summary

Public constructors

Builder(@NonNull ContactPoint contactPoint)

Constructor for Builder with all the existing values of a ContactPoint.

Builder(@NonNull String namespace, @NonNull String id, @NonNull String label)

Constructor for ContactPoint.Builder.

Public methods

@NonNull T

Adds an alias for the item.

@NonNull T

Add a new action to the list of potential actions for this document.

@NonNull ContactPoint

Builds the ContactPoint.

@NonNull Thing

Builds a Thing object.

@NonNull T

Clears the aliases, if any, for the item.

@NonNull T

Clear all the potential actions for this document.

@NonNull T

Sets the flattened postal addresses.

@NonNull T

Sets a list of aliases for the item.

@NonNull T
setCreationTimestampMillis(long creationTimestampMillis)

Sets the creation timestamp for the current AppSearch entity, in milliseconds using the currentTimeMillis time base.

@NonNull T

Sets the description for the item.

@NonNull T
setDocumentScore(int documentScore)

Sets the user-provided opaque document score of the current AppSearch document, which can be used for ranking using RANKING_STRATEGY_DOCUMENT_SCORE.

@NonNull T
setDocumentTtlMillis(long documentTtlMillis)

Sets the time-to-live (TTL) for the current AppSearch document as a duration in milliseconds.

@NonNull T

Sets the email addresses.

@NonNull T

Sets the URL for an image of the item.

@NonNull T

Sets the name of the item.

@NonNull T

Sets a list of potential actions for this document.

@NonNull T

Sets the telephone numbers.

@NonNull T

Sets the deeplink URL of the item.

Protected fields

mAlternateNames

protected List<StringmAlternateNames

mCreationTimestampMillis

protected long mCreationTimestampMillis

mDescription

protected String mDescription

mDocumentScore

protected int mDocumentScore

mDocumentTtlMillis

protected long mDocumentTtlMillis

mId

protected final String mId

mImage

protected String mImage

mName

protected String mName

mNamespace

protected final String mNamespace

mPotentialActions

protected List<PotentialActionmPotentialActions

mUrl

protected String mUrl

Public constructors

Builder

Added in 1.1.0-alpha07
public Builder(@NonNull ContactPoint contactPoint)

Constructor for Builder with all the existing values of a ContactPoint.

Builder

Added in 1.1.0-alpha07
public Builder(@NonNull String namespace, @NonNull String id, @NonNull String label)

Constructor for ContactPoint.Builder.

Parameters
@NonNull String namespace

Namespace for the ContactPoint Document. See Document.Namespace.

@NonNull String id

Unique identifier for the ContactPoint Document. See Document.Id.

@NonNull String label

Label of this ContactPoint document. It could be "Home", "Work" or anything user defined.

Public methods

addAlternateName

Added in 1.1.0-alpha07
public @NonNulladdAlternateName(@NonNull String alternateName)

Adds an alias for the item.

addPotentialAction

Added in 1.1.0-alpha07
@ExperimentalAppSearchApi
public @NonNulladdPotentialAction(@NonNull PotentialAction newPotentialAction)

Add a new action to the list of potential actions for this document.

build

Added in 1.1.0-alpha07
public @NonNull ContactPoint build()

Builds the ContactPoint.

build

Added in 1.1.0-alpha07
public @NonNull Thing build()

Builds a Thing object.

clearAlternateNames

Added in 1.1.0-alpha07
public @NonNullclearAlternateNames()

Clears the aliases, if any, for the item.

clearPotentialActions

Added in 1.1.0-alpha07
@ExperimentalAppSearchApi
public @NonNullclearPotentialActions()

Clear all the potential actions for this document.

setAddresses

Added in 1.1.0-alpha07
public @NonNullsetAddresses(@NonNull List<String> addresses)

Sets the flattened postal addresses.

setAlternateNames

Added in 1.1.0-alpha07
public @NonNullsetAlternateNames(@Nullable List<String> alternateNames)

Sets a list of aliases for the item.

setCreationTimestampMillis

Added in 1.1.0-alpha07
public @NonNullsetCreationTimestampMillis(long creationTimestampMillis)

Sets the creation timestamp for the current AppSearch entity, in milliseconds using the currentTimeMillis time base.

This timestamp refers to the creation time of the AppSearch entity, not when the document is written into AppSearch.

If not set, then the current timestamp will be used.

See androidx.appsearch.annotation.Document.CreationTimestampMillis for more information on creation timestamp.

setDescription

Added in 1.1.0-alpha07
public @NonNullsetDescription(@Nullable String description)

Sets the description for the item.

setDocumentScore

Added in 1.1.0-alpha07
public @NonNullsetDocumentScore(int documentScore)

Sets the user-provided opaque document score of the current AppSearch document, which can be used for ranking using RANKING_STRATEGY_DOCUMENT_SCORE.

See androidx.appsearch.annotation.Document.Score for more information on score.

setDocumentTtlMillis

Added in 1.1.0-alpha07
public @NonNullsetDocumentTtlMillis(long documentTtlMillis)

Sets the time-to-live (TTL) for the current AppSearch document as a duration in milliseconds.

The document will be automatically deleted when the TTL expires.

If not set, then the document will never expire.

See androidx.appsearch.annotation.Document.TtlMillis for more information on TTL.

setEmails

Added in 1.1.0-alpha07
public @NonNullsetEmails(@NonNull List<String> emails)

Sets the email addresses.

setImage

Added in 1.1.0-alpha07
@ExperimentalAppSearchApi
public @NonNullsetImage(@Nullable String image)

Sets the URL for an image of the item.

setName

Added in 1.1.0-alpha07
public @NonNullsetName(@Nullable String name)

Sets the name of the item.

setPotentialActions

Added in 1.1.0-alpha07
@ExperimentalAppSearchApi
public @NonNullsetPotentialActions(@Nullable List<PotentialAction> newPotentialActions)

Sets a list of potential actions for this document.

setTelephones

Added in 1.1.0-alpha07
public @NonNullsetTelephones(@NonNull List<String> telephones)

Sets the telephone numbers.

setUrl

Added in 1.1.0-alpha07
public @NonNullsetUrl(@Nullable String url)

Sets the deeplink URL of the item.

If this item can be displayed by any system UI surface, or can be read by another Android package, through one of the androidx.appsearch.app.SetSchemaRequest.Builder methods, this url should act as a deeplink into the activity that can open it. Callers should be able to construct an ACTION_VIEW intent with the url as the setData to view the item inside your application.

See Allowing Other Apps to Start Your Activity for more details on how to make activities in your app open for use by other apps by defining intent filters.