kotlin-components-docs/mozilla.appservices.search/SearchEngineUrl

SearchEngineUrl

data class SearchEngineUrl(var base: String, var method: String, var params: List<SearchUrlParam>, var searchTermParamName: String?, var displayName: String? = null, var isNewUntil: String? = null, var excludePartnerCodeFromTelemetry: Boolean = false, var acceptedContentTypes: List<String>? = null)

Defines an individual search engine URL.

Constructors

SearchEngineUrl

constructor(base: String, method: String, params: List<SearchUrlParam>, searchTermParamName: String?, displayName: String? = null, isNewUntil: String? = null, excludePartnerCodeFromTelemetry: Boolean = false, acceptedContentTypes: List<String>? = null)

Types

Companion

object Companion

Properties

acceptedContentTypes

var acceptedContentTypes: List<String>?

If this URL performs searches only for certain MIME types, they should be listed here. If None, it's assumed the content type is text or not relevant. This field is intended to be used for URLs like visual search, which might support certain image types and not others. Consumers can use it to determine whether search UI corresponding to the URL should be shown to the user in a given context.

base

var base: String

The PrePath and FilePath of the URL. May include variables for engines which have a variable FilePath, e.g. {searchTerms} for when a search term is within the path of the url.

displayName

var displayName: String?

The display name of the URL, if any. This is useful if the URL corresponds to a brand name distinct from the engine's brand name.

excludePartnerCodeFromTelemetry

var excludePartnerCodeFromTelemetry: Boolean

Whether the engine's partner code should be excluded from telemetry when this URL is visited.

isNewUntil

var isNewUntil: String?

Indicates the date until which the URL is considered new (format: YYYY-MM-DD).

method

var method: String

The HTTP method to use to send the request (GET or POST). If the engine definition has not specified the method, it defaults to GET.

params

var params: List<SearchUrlParam>

The parameters for this URL.

searchTermParamName

var searchTermParamName: String?

The name of the query parameter for the search term. Automatically appended to the end of the query. This may be skipped if {searchTerms} is included in the base.