Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Ctors](https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#pubctors) \| [Methods](https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#inhmethods)

# FillResponse.Builder

*** ** * ** ***

[Kotlin](https://developer.android.com/reference/kotlin/android/service/autofill/FillResponse.Builder "View this page in Kotlin") \|Java


`
public
static
final

class
FillResponse.Builder
`


`

extends https://developer.android.com/reference/java/lang/Object


`

`


`

|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.service.autofill.FillResponse.Builder |

<br />

*** ** * ** ***

Builder for `https://developer.android.com/reference/android/service/autofill/FillResponse` objects. You must to provide at least
one dataset or set an authentication intent with a presentation view.

## Summary

| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#Builder()() ` |

| ### Public methods ||
|---|---|
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#addDataset(android.service.autofill.Dataset)(https://developer.android.com/reference/android/service/autofill/Dataset dataset) ` Adds a new `https://developer.android.com/reference/android/service/autofill/Dataset` to this response. |
| ` https://developer.android.com/reference/android/service/autofill/FillResponse` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#build()() ` Builds a new `https://developer.android.com/reference/android/service/autofill/FillResponse` instance. |
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#disableAutofill(long)(long duration) ` Disables autofill for the app or activity. |
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setAuthentication(android.view.autofill.AutofillId[],%20android.content.IntentSender,%20android.widget.RemoteViews,%20android.service.autofill.InlinePresentation)(https://developer.android.com/reference/android/view/autofill/AutofillId ids, https://developer.android.com/reference/android/content/IntentSender authentication, https://developer.android.com/reference/android/widget/RemoteViews presentation, https://developer.android.com/reference/android/service/autofill/InlinePresentation inlinePresentation) ` *This method was deprecated in API level 33. Use `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setAuthentication(android.view.autofill.AutofillId[],%20android.content.IntentSender,%20android.service.autofill.Presentations)` instead.* |
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setAuthentication(android.view.autofill.AutofillId[],%20android.content.IntentSender,%20android.service.autofill.Presentations)(https://developer.android.com/reference/android/view/autofill/AutofillId ids, https://developer.android.com/reference/android/content/IntentSender authentication, https://developer.android.com/reference/android/service/autofill/Presentations presentations) ` Triggers a custom UI before autofilling the screen with any data set in this response. |
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setAuthentication(android.view.autofill.AutofillId[],%20android.content.IntentSender,%20android.widget.RemoteViews)(https://developer.android.com/reference/android/view/autofill/AutofillId ids, https://developer.android.com/reference/android/content/IntentSender authentication, https://developer.android.com/reference/android/widget/RemoteViews presentation) ` *This method was deprecated in API level 33. Use `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setAuthentication(android.view.autofill.AutofillId[],%20android.content.IntentSender,%20android.service.autofill.Presentations)` instead.* |
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setAuthentication(android.view.autofill.AutofillId[],%20android.content.IntentSender,%20android.widget.RemoteViews,%20android.service.autofill.InlinePresentation,%20android.service.autofill.InlinePresentation)(https://developer.android.com/reference/android/view/autofill/AutofillId ids, https://developer.android.com/reference/android/content/IntentSender authentication, https://developer.android.com/reference/android/widget/RemoteViews presentation, https://developer.android.com/reference/android/service/autofill/InlinePresentation inlinePresentation, https://developer.android.com/reference/android/service/autofill/InlinePresentation inlineTooltipPresentation) ` *This method was deprecated in API level 33. Use `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setAuthentication(android.view.autofill.AutofillId[],%20android.content.IntentSender,%20android.service.autofill.Presentations)` instead.* |
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setClientState(android.os.Bundle)(https://developer.android.com/reference/android/os/Bundle clientState) ` Sets a bundle with state that is passed to subsequent APIs that manipulate this response. |
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setDetectedFieldClassifications(java.util.Set<android.service.assist.classification.FieldClassification>)(https://developer.android.com/reference/java/util/Set<https://developer.android.com/reference/android/service/assist/classification/FieldClassification> fieldInfos) ` Adds a new `https://developer.android.com/reference/android/service/assist/classification/FieldClassification` to this response, to help the platform provide more accurate detection results. |
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setDialogHeader(android.widget.RemoteViews)(https://developer.android.com/reference/android/widget/RemoteViews header) ` Sets the presentation of header in fill dialog UI. |
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setFieldClassificationIds(android.view.autofill.AutofillId[])(https://developer.android.com/reference/android/view/autofill/AutofillId ids) ` Sets which fields are used for [field classification](https://developer.android.com/reference/android/service/autofill/AutofillService#FieldClassification) **Note:** This method automatically adds the `https://developer.android.com/reference/android/service/autofill/FillResponse#FLAG_TRACK_CONTEXT_COMMITED` to the `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setFlags(int)`. |
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setFillDialogTriggerIds(android.view.autofill.AutofillId[])(https://developer.android.com/reference/android/view/autofill/AutofillId ids) ` Sets which fields are used for the fill dialog UI. |
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setFlags(int)(int flags) ` Sets flags changing the response behavior. |
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setFooter(android.widget.RemoteViews)(https://developer.android.com/reference/android/widget/RemoteViews footer) ` Sets a footer to be shown as the last element in the list of datasets. |
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setHeader(android.widget.RemoteViews)(https://developer.android.com/reference/android/widget/RemoteViews header) ` Sets a header to be shown as the first element in the list of datasets. |
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setIconResourceId(int)(int id) ` Overwrites Save/Fill dialog header icon with a specific one specified by resource id. |
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setIgnoredIds(android.view.autofill.AutofillId[])(https://developer.android.com/reference/android/view/autofill/AutofillId ids) ` Specifies views that should not trigger new `https://developer.android.com/reference/android/service/autofill/AutofillService#onFillRequest(android.service.autofill.FillRequest,%20android.os.CancellationSignal,%20android.service.autofill.FillCallback)` requests. |
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setPresentationCancelIds(int[])(int[] ids) ` Sets target resource IDs of the child view in `https://developer.android.com/reference/android/widget/RemoteViews` which will cancel the session when clicked. |
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setSaveInfo(android.service.autofill.SaveInfo)(https://developer.android.com/reference/android/service/autofill/SaveInfo saveInfo) ` Sets the `https://developer.android.com/reference/android/service/autofill/SaveInfo` associated with this response. |
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setServiceDisplayNameResourceId(int)(int id) ` Overrides the service name in the Save Dialog header with a specific string defined in the service provider's manifest.xml |
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setShowFillDialogIcon(boolean)(boolean show) ` Whether or not to show the Autofill provider icon inside of the Fill Dialog |
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setShowSaveDialogIcon(boolean)(boolean show) ` Whether or not to show the Autofill provider icon inside of the Save Dialog |
| ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | ` https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setUserData(android.service.autofill.UserData)(https://developer.android.com/reference/android/service/autofill/UserData userData) ` Sets a specific `https://developer.android.com/reference/android/service/autofill/UserData` for field classification for this request only. |

| ### Inherited methods |
|---|---|
| From class ` https://developer.android.com/reference/java/lang/Object ` |---|---| | ` https://developer.android.com/reference/java/lang/Object` | ` https://developer.android.com/reference/java/lang/Object#clone()() ` Creates and returns a copy of this object. | | ` boolean` | ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` https://developer.android.com/reference/java/lang/Object#finalize()() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final https://developer.android.com/reference/java/lang/Class<?>` | ` https://developer.android.com/reference/java/lang/Object#getClass()() ` Returns the runtime class of this `Object`. | | ` int` | ` https://developer.android.com/reference/java/lang/Object#hashCode()() ` Returns a hash code value for the object. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#notify()() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#notifyAll()() ` Wakes up all threads that are waiting on this object's monitor. | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/lang/Object#toString()() ` Returns a string representation of the object. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait()() ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*. | ||

## Public constructors

### Builder

```
public Builder ()
```

<br />

<br />

## Public methods

### addDataset

Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse.Builder addDataset (Dataset dataset)
```

Adds a new `https://developer.android.com/reference/android/service/autofill/Dataset` to this response.

**Note:** on Android `https://developer.android.com/reference/android/os/Build.VERSION_CODES#O`, the total number of
datasets is limited by the Binder transaction size, so it's recommended to keep it
small (in the range of 10-20 at most) and use pagination by adding a fake
`https://developer.android.com/reference/android/service/autofill/Dataset.Builder#setAuthentication(android.content.IntentSender)` at the end
with a presentation string like "Next 10" that would return a new `https://developer.android.com/reference/android/service/autofill/FillResponse`
with the next 10 datasets, and so on. This limitation was lifted on
Android `https://developer.android.com/reference/android/os/Build.VERSION_CODES#O_MR1`, although the Binder transaction
size can still be reached if each dataset itself is too big.

<br />

| Parameters ||
|---|---|
| `dataset` | `Dataset`: This value may be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | This builder. This value cannot be `null`. <br /> |

### build

Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse build ()
```

Builds a new `https://developer.android.com/reference/android/service/autofill/FillResponse` instance.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse` | A built response. This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalStateException` | if any of the following conditions occur: 1. `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#build()` was already called. 2. No call was made to `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#addDataset(android.service.autofill.Dataset)`, `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setAuthentication(android.view.autofill.AutofillId[],%20android.content.IntentSender,%20android.service.autofill.Presentations)`, `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setSaveInfo(android.service.autofill.SaveInfo)`, `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#disableAutofill(long)`, `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setClientState(android.os.Bundle)`, or `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setFieldClassificationIds(android.view.autofill.AutofillId[])`. 3. `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setHeader(android.widget.RemoteViews)` or `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setFooter(android.widget.RemoteViews)` is called without any previous calls to `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#addDataset(android.service.autofill.Dataset)`. |

### disableAutofill

Added in [API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse.Builder disableAutofill (long duration)
```

Disables autofill for the app or activity.

This method is useful to optimize performance in cases where the service knows it
can not autofill an app---for example, when the service has a list of "denylisted"
apps such as office suites.

By default, it disables autofill for all activities in the app, unless the response is
`https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setFlags(int)` with `https://developer.android.com/reference/android/service/autofill/FillResponse#FLAG_DISABLE_ACTIVITY_ONLY`.

Autofill for the app or activity is automatically re-enabled after any of the
following conditions:

1. `duration` milliseconds have passed.
2. The autofill service for the user has changed.
3. The device has rebooted.

**Note:** Activities that are running when autofill is re-enabled remain
disabled for autofill until they finish and restart.

<br />

| Parameters ||
|---|---|
| `duration` | `long`: duration to disable autofill, in milliseconds. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | this builder. This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if `duration` is not a positive number. |
| `https://developer.android.com/reference/java/lang/IllegalStateException` | if either `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#addDataset(android.service.autofill.Dataset)`, `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setAuthentication(android.view.autofill.AutofillId[],%20android.content.IntentSender,%20android.service.autofill.Presentations)`, `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setSaveInfo(android.service.autofill.SaveInfo)`, `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setClientState(android.os.Bundle)`, or `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setFieldClassificationIds(android.view.autofill.AutofillId[])` was already called. |

### setAuthentication

Added in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)   
Deprecated in [API level
33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse.Builder setAuthentication (AutofillId[] ids, 
                IntentSender authentication, 
                RemoteViews presentation, 
                InlinePresentation inlinePresentation)
```


**This method was deprecated
in API level 33.**   

Use
`https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setAuthentication(android.view.autofill.AutofillId[],%20android.content.IntentSender,%20android.service.autofill.Presentations)`
instead.

Triggers a custom UI before autofilling the screen with any data set in this
response.

**Note:** Although the name of this method suggests that it should be used just for
authentication flow, it can be used for other advanced flows; see `https://developer.android.com/reference/android/service/autofill/AutofillService`
for examples.

This method is similar to
`https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setAuthentication(android.view.autofill.AutofillId[],%20android.content.IntentSender,%20android.widget.RemoteViews)`, but also accepts
an `https://developer.android.com/reference/android/service/autofill/InlinePresentation` presentation which is required for authenticating through
the inline autofill flow.

**Note:** `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setHeader(android.widget.RemoteViews)` or `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setFooter(android.widget.RemoteViews)` does
not work with `https://developer.android.com/reference/android/service/autofill/InlinePresentation`.

<br />

<br />

| Parameters ||
|---|---|
| `ids` | `AutofillId`: id of Views that when focused will display the authentication UI. This value cannot be `null`. <br /> |
| `authentication` | `IntentSender`: Intent to an activity with your authentication flow. This value may be `null`. <br /> |
| `presentation` | `RemoteViews`: The presentation to visualize the response. This value may be `null`. <br /> |
| `inlinePresentation` | `InlinePresentation`: The inlinePresentation to visualize the response inline. This value may be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | This builder. This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if any of the following occurs: - `ids` is `null` - `ids` is empty - `ids` contains a `null` element - both `authentication` and `presentation` are `null` - both `authentication` and `presentation` are non-`null` - both `authentication` and `inlinePresentation` are `null` - both `authentication` and `inlinePresentation` are non-`null` |
| `https://developer.android.com/reference/java/lang/IllegalStateException` | if a `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setHeader(android.widget.RemoteViews)` or a `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setFooter(android.widget.RemoteViews)` are already set for this builder. |

**See also:**

- `https://developer.android.com/reference/android/app/PendingIntent#getIntentSender()`

### setAuthentication

Added in [API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse.Builder setAuthentication (AutofillId[] ids, 
                IntentSender authentication, 
                Presentations presentations)
```

Triggers a custom UI before autofilling the screen with any data set in this
response.

**Note:** Although the name of this method suggests that it should be used just for
authentication flow, it can be used for other advanced flows; see `https://developer.android.com/reference/android/service/autofill/AutofillService`
for examples.

This is typically useful when a user interaction is required to unlock their
data vault if you encrypt the data set labels and data set data. It is recommended
to encrypt only the sensitive data and not the data set labels which would allow
auth on the data set level leading to a better user experience. Note that if you
use sensitive data as a label, for example an email address, then it should also
be encrypted. The provided `https://developer.android.com/reference/android/app/PendingIntent` must be an
`https://developer.android.com/reference/android/app/Activity` which implements your authentication flow. Also if you provide an auth
intent you also need to specify the presentation view to be shown in the fill UI
for the user to trigger your authentication flow.

When a user triggers autofill, the system launches the provided intent
whose extras will have the
`https://developer.android.com/reference/android/view/autofill/AutofillManager#EXTRA_ASSIST_STRUCTURE` and your `https://developer.android.com/reference/android/view/autofill/AutofillManager#EXTRA_CLIENT_STATE`. Once you complete your authentication flow you should set the
`https://developer.android.com/reference/android/app/Activity` result to `https://developer.android.com/reference/android/app/Activity#RESULT_OK` and set the
`https://developer.android.com/reference/android/view/autofill/AutofillManager#EXTRA_AUTHENTICATION_RESULT` extra
with the fully populated `https://developer.android.com/reference/android/service/autofill/FillResponse` (or `null` if the screen
cannot be autofilled).

For example, if you provided an empty `https://developer.android.com/reference/android/service/autofill/FillResponse` because the
user's data was locked and marked that the response needs an authentication then
in the response returned if authentication succeeds you need to provide all
available data sets some of which may need to be further authenticated, for
example a credit card whose CVV needs to be entered.

If you provide an authentication intent you must also provide a presentation
which is used to visualize the response for triggering the authentication
flow.

**Note:** Do not make the provided pending intent
immutable by using `https://developer.android.com/reference/android/app/PendingIntent#FLAG_IMMUTABLE` as the
platform needs to fill in the authentication arguments.

**Note:** `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setHeader(android.widget.RemoteViews)` or `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setFooter(android.widget.RemoteViews)` does
not work with `https://developer.android.com/reference/android/service/autofill/InlinePresentation`.

<br />

<br />

| Parameters ||
|---|---|
| `ids` | `AutofillId`: id of Views that when focused will display the authentication UI. This value cannot be `null`. <br /> |
| `authentication` | `IntentSender`: Intent to an activity with your authentication flow. This value may be `null`. <br /> |
| `presentations` | `Presentations`: The presentations to visualize the response. This value may be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | This builder. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if any of the following occurs: - `ids` is `null` - `ids` is empty - `ids` contains a `null` element - `authentication` is `null`, but either or both of `presentations.getPresentation()` and `presentations.getInlinePresentation()` is non-`null` - `authentication` is non-{`null`, but both `presentations.getPresentation()` and `presentations.getInlinePresentation()` are `null` |
| `https://developer.android.com/reference/java/lang/IllegalStateException` | if a `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setHeader(android.widget.RemoteViews)` or a `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setFooter(android.widget.RemoteViews)` are already set for this builder. |

### setAuthentication

Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)   
Deprecated in [API level
33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse.Builder setAuthentication (AutofillId[] ids, 
                IntentSender authentication, 
                RemoteViews presentation)
```


**This method was deprecated
in API level 33.**   

Use
`https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setAuthentication(android.view.autofill.AutofillId[],%20android.content.IntentSender,%20android.service.autofill.Presentations)`
instead.

Triggers a custom UI before autofilling the screen with any data set in this
response.

**Note:** Although the name of this method suggests that it should be used just for
authentication flow, it can be used for other advanced flows; see `https://developer.android.com/reference/android/service/autofill/AutofillService`
for examples.

This is typically useful when a user interaction is required to unlock their
data vault if you encrypt the data set labels and data set data. It is recommended
to encrypt only the sensitive data and not the data set labels which would allow
auth on the data set level leading to a better user experience. Note that if you
use sensitive data as a label, for example an email address, then it should also
be encrypted. The provided `https://developer.android.com/reference/android/app/PendingIntent` must be an
`https://developer.android.com/reference/android/app/Activity` which implements your authentication flow. Also if you provide an auth
intent you also need to specify the presentation view to be shown in the fill UI
for the user to trigger your authentication flow.

When a user triggers autofill, the system launches the provided intent
whose extras will have the
`https://developer.android.com/reference/android/view/autofill/AutofillManager#EXTRA_ASSIST_STRUCTURE` and your `https://developer.android.com/reference/android/view/autofill/AutofillManager#EXTRA_CLIENT_STATE`. Once you complete your authentication flow you should set the
`https://developer.android.com/reference/android/app/Activity` result to `https://developer.android.com/reference/android/app/Activity#RESULT_OK` and set the
`https://developer.android.com/reference/android/view/autofill/AutofillManager#EXTRA_AUTHENTICATION_RESULT` extra
with the fully populated `https://developer.android.com/reference/android/service/autofill/FillResponse` (or `null` if the screen
cannot be autofilled).

**IMPORTANT** : Extras must be non-null on the intent being set for Android 12
otherwise it will cause a crash. Do not use `https://developer.android.com/reference/android/app/Activity#setResult(int)`, instead use
`https://developer.android.com/reference/android/app/Activity#setResult(int,%20android.content.Intent)` with non-null extras. Consider setting
`https://developer.android.com/reference/android/view/autofill/AutofillManager#EXTRA_AUTHENTICATION_RESULT` to null or use
`https://developer.android.com/reference/android/os/Bundle#EMPTY` with `https://developer.android.com/reference/android/content/Intent#putExtras(android.os.Bundle)` on the intent when
finishing activity to avoid crash).

For example, if you provided an empty `https://developer.android.com/reference/android/service/autofill/FillResponse` because the
user's data was locked and marked that the response needs an authentication then
in the response returned if authentication succeeds you need to provide all
available data sets some of which may need to be further authenticated, for
example a credit card whose CVV needs to be entered.

If you provide an authentication intent you must also provide a presentation
which is used to visualize the response for triggering the authentication
flow.

**Note:** Do not make the provided pending intent
immutable by using `https://developer.android.com/reference/android/app/PendingIntent#FLAG_IMMUTABLE` as the
platform needs to fill in the authentication arguments.

Theme does not work with RemoteViews layout. Avoid hardcoded text color
or background color: Autofill on different platforms may have different themes.

<br />

| Parameters ||
|---|---|
| `ids` | `AutofillId`: id of Views that when focused will display the authentication UI. This value cannot be `null`. <br /> |
| `authentication` | `IntentSender`: Intent to an activity with your authentication flow. This value may be `null`. <br /> |
| `presentation` | `RemoteViews`: The presentation to visualize the response. This value may be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | This builder. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if any of the following occurs: - `ids` is `null` - `ids` is empty - `ids` contains a `null` element - both `authentication` and `presentation` are `null` - both `authentication` and `presentation` are non-`null` |
| `https://developer.android.com/reference/java/lang/IllegalStateException` | if a `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setHeader(android.widget.RemoteViews)` or a `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setFooter(android.widget.RemoteViews)` are already set for this builder. |

**See also:**

- `https://developer.android.com/reference/android/app/PendingIntent#getIntentSender()`

### setAuthentication

Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)   
Deprecated in [API level
33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse.Builder setAuthentication (AutofillId[] ids, 
                IntentSender authentication, 
                RemoteViews presentation, 
                InlinePresentation inlinePresentation, 
                InlinePresentation inlineTooltipPresentation)
```


**This method was deprecated
in API level 33.**   

Use
`https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setAuthentication(android.view.autofill.AutofillId[],%20android.content.IntentSender,%20android.service.autofill.Presentations)`
instead.

Triggers a custom UI before autofilling the screen with any data set in this
response.

This method like
`https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setAuthentication(android.view.autofill.AutofillId[],%20android.content.IntentSender,%20android.widget.RemoteViews,%20android.service.autofill.InlinePresentation)`
but allows setting an `https://developer.android.com/reference/android/service/autofill/InlinePresentation` for the inline suggestion tooltip.

<br />

| Parameters ||
|---|---|
| `ids` | `AutofillId`: This value cannot be `null`. <br /> |
| `authentication` | `IntentSender`: This value may be `null`. <br /> |
| `presentation` | `RemoteViews`: This value may be `null`. <br /> |
| `inlinePresentation` | `InlinePresentation`: This value may be `null`. <br /> |
| `inlineTooltipPresentation` | `InlinePresentation`: This value may be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | This value cannot be `null`. <br /> |

### setClientState

Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse.Builder setClientState (Bundle clientState)
```

Sets a bundle with state that is passed to subsequent APIs that manipulate this response.

You can use this bundle to store intermediate state that is passed to subsequent calls
to `https://developer.android.com/reference/android/service/autofill/AutofillService#onFillRequest(android.service.autofill.FillRequest,%20android.os.CancellationSignal,%20android.service.autofill.FillCallback)` and `https://developer.android.com/reference/android/service/autofill/AutofillService#onSaveRequest(android.service.autofill.SaveRequest,%20android.service.autofill.SaveCallback)`, and
you can also retrieve it by calling `https://developer.android.com/reference/android/service/autofill/FillEventHistory.Event#getClientState()`.

If this method is called on multiple `https://developer.android.com/reference/android/service/autofill/FillResponse` objects for the same
screen, just the latest bundle is passed back to the service.

<br />

| Parameters ||
|---|---|
| `clientState` | `Bundle`: The custom client state. This value may be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | This builder. This value cannot be `null`. <br /> |

### setDetectedFieldClassifications

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse.Builder setDetectedFieldClassifications (Set<FieldClassification> fieldInfos)
```

Adds a new `https://developer.android.com/reference/android/service/assist/classification/FieldClassification` to this response, to
help the platform provide more accurate detection results.

Call this when a field has been detected with a type.

Altough similiarly named with `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setFieldClassificationIds(android.view.autofill.AutofillId[])`,
it provides a different functionality - setFieldClassificationIds should
be used when a field is only suspected to be Autofillable.
This method should be used when a field is certainly Autofillable
with a certain type.

<br />

| Parameters ||
|---|---|
| `fieldInfos` | `Set`: This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | This value cannot be `null`. <br /> |

### setDialogHeader

Added in [API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse.Builder setDialogHeader (RemoteViews header)
```

Sets the presentation of header in fill dialog UI. The header should have
a prompt for what datasets are shown in the dialog. If this is not set,
the dialog only shows your application icon.

More details about the fill dialog, see
[fill dialog UI](https://developer.android.com/reference/android/service/autofill/Dataset#FillDialogUI)

<br />

| Parameters ||
|---|---|
| `header` | `RemoteViews`: This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | This value cannot be `null`. <br /> |

### setFieldClassificationIds

Added in [API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse.Builder setFieldClassificationIds (AutofillId... ids)
```

Sets which fields are used for
[field classification](https://developer.android.com/reference/android/service/autofill/AutofillService#FieldClassification)

**Note:** This method automatically adds the
`https://developer.android.com/reference/android/service/autofill/FillResponse#FLAG_TRACK_CONTEXT_COMMITED` to the `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setFlags(int)`.

<br />

| Parameters ||
|---|---|
| `ids` | `AutofillId`: This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | is length of `ids` args is more than `https://developer.android.com/reference/android/service/autofill/UserData#getMaxFieldClassificationIdsSize()`. |
| `https://developer.android.com/reference/java/lang/IllegalStateException` | if `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#build()` or `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#disableAutofill(long)` was already called. |
| `https://developer.android.com/reference/java/lang/NullPointerException` | if `ids` or any element on it is `null`. |

### setFillDialogTriggerIds

Added in [API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse.Builder setFillDialogTriggerIds (AutofillId... ids)
```

Sets which fields are used for the fill dialog UI.

More details about the fill dialog, see
[fill dialog UI](https://developer.android.com/reference/android/service/autofill/Dataset#FillDialogUI)

<br />

| Parameters ||
|---|---|
| `ids` | `AutofillId`: This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalStateException` | if `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#build()` was already called. |
| `https://developer.android.com/reference/java/lang/NullPointerException` | if `ids` or any element on it is `null`. |

### setFlags

Added in [API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse.Builder setFlags (int flags)
```

Sets flags changing the response behavior.

<br />

| Parameters ||
|---|---|
| `flags` | `int`: a combination of `https://developer.android.com/reference/android/service/autofill/FillResponse#FLAG_TRACK_CONTEXT_COMMITED` and `https://developer.android.com/reference/android/service/autofill/FillResponse#FLAG_DISABLE_ACTIVITY_ONLY`, or `0`. Value is either `0` or a combination of the following: - `https://developer.android.com/reference/android/service/autofill/FillResponse#FLAG_TRACK_CONTEXT_COMMITED` - `https://developer.android.com/reference/android/service/autofill/FillResponse#FLAG_DISABLE_ACTIVITY_ONLY` - `https://developer.android.com/reference/android/service/autofill/FillResponse#FLAG_DELAY_FILL` |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | This builder. This value cannot be `null`. <br /> |

### setFooter

Added in [API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse.Builder setFooter (RemoteViews footer)
```

Sets a footer to be shown as the last element in the list of datasets.

When this method is called, you must also `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#addDataset(android.service.autofill.Dataset)`,
otherwise `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#build()` throws an `https://developer.android.com/reference/java/lang/IllegalStateException`. Similarly, this
method should only be used on `https://developer.android.com/reference/android/service/autofill/FillResponse` that do not require
authentication (as the footer could have been set directly in the main presentation in
these cases).

Theme does not work with RemoteViews layout. Avoid hardcoded text color
or background color: Autofill on different platforms may have different themes.

<br />

| Parameters ||
|---|---|
| `footer` | `RemoteViews`: a presentation to represent the footer. This presentation is not clickable ---calling `https://developer.android.com/reference/android/widget/RemoteViews#setOnClickPendingIntent(int,%20android.app.PendingIntent)` on it would have no effect. This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | this builder. This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalStateException` | if the FillResponse `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setAuthentication(android.view.autofill.AutofillId[],%20android.content.IntentSender,%20android.service.autofill.Presentations)`. |

### setHeader

Added in [API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse.Builder setHeader (RemoteViews header)
```

Sets a header to be shown as the first element in the list of datasets.

When this method is called, you must also `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#addDataset(android.service.autofill.Dataset)`,
otherwise `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#build()` throws an `https://developer.android.com/reference/java/lang/IllegalStateException`. Similarly, this
method should only be used on `https://developer.android.com/reference/android/service/autofill/FillResponse` that do not require
authentication (as the header could have been set directly in the main presentation in
these cases).

Theme does not work with RemoteViews layout. Avoid hardcoded text color
or background color: Autofill on different platforms may have different themes.

<br />

| Parameters ||
|---|---|
| `header` | `RemoteViews`: a presentation to represent the header. This presentation is not clickable ---calling `https://developer.android.com/reference/android/widget/RemoteViews#setOnClickPendingIntent(int,%20android.app.PendingIntent)` on it would have no effect. This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | this builder. This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalStateException` | if an `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setAuthentication(android.view.autofill.AutofillId[],%20android.content.IntentSender,%20android.service.autofill.Presentations)` was already set for this builder. |

### setIconResourceId

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse.Builder setIconResourceId (int id)
```

Overwrites Save/Fill dialog header icon with a specific one specified by resource id.
The image is pulled from the package, so id should be defined in the manifest.

<br />

| Parameters ||
|---|---|
| `id` | `int`: `https://developer.android.com/reference/android/graphics/drawable/Drawable` resource id of the icon to be used. A value of 0 indicates to use the default header icon. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | this builder. This value cannot be `null`. <br /> |

### setIgnoredIds

Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse.Builder setIgnoredIds (AutofillId... ids)
```

Specifies views that should not trigger new
`https://developer.android.com/reference/android/service/autofill/AutofillService#onFillRequest(android.service.autofill.FillRequest,%20android.os.CancellationSignal,%20android.service.autofill.FillCallback)` requests.

This is typically used when the service cannot autofill the view; for example, a
text field representing the result of a Captcha challenge.

<br />

| Parameters ||
|---|---|
| `ids` | `AutofillId` <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | This value cannot be `null`. <br /> |

### setPresentationCancelIds

Added in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse.Builder setPresentationCancelIds (int[] ids)
```

Sets target resource IDs of the child view in `https://developer.android.com/reference/android/widget/RemoteViews`
which will cancel the session when clicked.
Those targets will be respectively applied to a child of the header, footer and
each `https://developer.android.com/reference/android/service/autofill/Dataset`.

<br />

| Parameters ||
|---|---|
| `ids` | `int`: array of the resource id. Empty list or non-existing id has no effect. This value may be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | this builder. This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalStateException` | if `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#build()` was already called. |

### setSaveInfo

Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse.Builder setSaveInfo (SaveInfo saveInfo)
```

Sets the `https://developer.android.com/reference/android/service/autofill/SaveInfo` associated with this response.

<br />

| Parameters ||
|---|---|
| `saveInfo` | `SaveInfo`: This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | This builder. This value cannot be `null`. <br /> |

### setServiceDisplayNameResourceId

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse.Builder setServiceDisplayNameResourceId (int id)
```

Overrides the service name in the Save Dialog header with a specific string defined
in the service provider's manifest.xml

<br />

| Parameters ||
|---|---|
| `id` | `int`: Resoure Id of the custom string defined in the provider's manifest. If set to 0, the default name will be used. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | this builder. This value cannot be `null`. <br /> |

### setShowFillDialogIcon

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse.Builder setShowFillDialogIcon (boolean show)
```

Whether or not to show the Autofill provider icon inside of the Fill Dialog

<br />

| Parameters ||
|---|---|
| `show` | `boolean`: True to show, false to hide. Defaults to true. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | this builder. This value cannot be `null`. <br /> |

### setShowSaveDialogIcon

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse.Builder setShowSaveDialogIcon (boolean show)
```

Whether or not to show the Autofill provider icon inside of the Save Dialog

<br />

| Parameters ||
|---|---|
| `show` | `boolean`: True to show, false to hide. Defaults to true. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | this builder. This value cannot be `null`. <br /> |

### setUserData

Added in [API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FillResponse.Builder setUserData (UserData userData)
```

Sets a specific `https://developer.android.com/reference/android/service/autofill/UserData` for field classification for this request only.

Any fields in this UserData will override corresponding fields in the generic
UserData object

<br />

| Parameters ||
|---|---|
| `userData` | `UserData`: This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder` | this builder. This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalStateException` | if the FillResponse `https://developer.android.com/reference/android/service/autofill/FillResponse.Builder#setAuthentication(android.view.autofill.AutofillId[],%20android.content.IntentSender,%20android.service.autofill.Presentations)`. |