Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [Ad Services Extensions 8](https://developer.android.com/sdkExtensions)   
Deprecated in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Ctors](https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters.Builder#pubctors) \| [Methods](https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters.Builder#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters.Builder#inhmethods)

# FrequencyCapFilters.Builder

*** ** * ** ***

` public static final class FrequencyCapFilters.Builder `   
` extends https://developer.android.com/reference/java/lang/Object ` ` `

|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.adservices.common.FrequencyCapFilters.Builder |

<br />

*** ** * ** ***

<br />

**This class was deprecated in API level 37.**   

The Rubidium (Rb) Relevance APIs, including those in android.adservices.common, are being deprecated. Relevance APIs have no direct replacement. Developers should stop using them, as calls will be rejected in future Android releases. Please refer to official Privacy Sandbox documentation for deprecation and roadmap details: https://privacysandbox.com/news/update-on-plans-for-privacy-sandbox-technologies/

Builder for creating `https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters` objects.

## Summary

| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters.Builder#Builder()() ` |

| ### Public methods ||
|---|---|
| ` https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters` | ` https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters.Builder#build()() ` Builds and returns a `https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters` instance. |
| ` https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters.Builder` | ` https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters.Builder#setKeyedFrequencyCapsForClickEvents(java.util.List<android.adservices.common.KeyedFrequencyCap>)(https://developer.android.com/reference/java/util/List<https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap> keyedFrequencyCapsForClickEvents) ` Sets the list of `https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap` objects that will filter on the `https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters#AD_EVENT_TYPE_CLICK` event type. |
| ` https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters.Builder` | ` https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters.Builder#setKeyedFrequencyCapsForImpressionEvents(java.util.List<android.adservices.common.KeyedFrequencyCap>)(https://developer.android.com/reference/java/util/List<https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap> keyedFrequencyCapsForImpressionEvents) ` Sets the list of `https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap` objects that will filter on the `https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters#AD_EVENT_TYPE_IMPRESSION` event type. |
| ` https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters.Builder` | ` https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters.Builder#setKeyedFrequencyCapsForViewEvents(java.util.List<android.adservices.common.KeyedFrequencyCap>)(https://developer.android.com/reference/java/util/List<https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap> keyedFrequencyCapsForViewEvents) ` Sets the list of `https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap` objects that will filter on the `https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters#AD_EVENT_TYPE_VIEW` event type. |
| ` https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters.Builder` | ` https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters.Builder#setKeyedFrequencyCapsForWinEvents(java.util.List<android.adservices.common.KeyedFrequencyCap>)(https://developer.android.com/reference/java/util/List<https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap> keyedFrequencyCapsForWinEvents) ` Sets the list of `https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap` objects that will filter on the `https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters#AD_EVENT_TYPE_WIN` event type. |

### 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

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [Ad Services Extensions 8](https://developer.android.com/sdkExtensions)

```
public Builder ()
```

<br />

<br />

## Public methods

### build

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [Ad Services Extensions 8](https://developer.android.com/sdkExtensions)   
Deprecated in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FrequencyCapFilters build ()
```

Builds and returns a `https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters` instance.

No more than 20 frequency cap filters may be associated with a single ad. If more total filters than the limit have been set, an `https://developer.android.com/reference/java/lang/IllegalArgumentException` will be thrown.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters` | This value cannot be `null`. <br /> |

### setKeyedFrequencyCapsForClickEvents

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [Ad Services Extensions 8](https://developer.android.com/sdkExtensions)   
Deprecated in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FrequencyCapFilters.Builder setKeyedFrequencyCapsForClickEvents (List<KeyedFrequencyCap> keyedFrequencyCapsForClickEvents)
```

Sets the list of `https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap` objects that will filter on the `https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters#AD_EVENT_TYPE_CLICK` event type.

See `https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters#getKeyedFrequencyCapsForClickEvents()` for more information.

<br />

| Parameters ||
|---|---|
| `keyedFrequencyCapsForClickEvents` | `List`: This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters.Builder` | This value cannot be `null`. <br /> |

### setKeyedFrequencyCapsForImpressionEvents

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [Ad Services Extensions 8](https://developer.android.com/sdkExtensions)   
Deprecated in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FrequencyCapFilters.Builder setKeyedFrequencyCapsForImpressionEvents (List<KeyedFrequencyCap> keyedFrequencyCapsForImpressionEvents)
```

Sets the list of `https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap` objects that will filter on the `https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters#AD_EVENT_TYPE_IMPRESSION` event type.

See `https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters#getKeyedFrequencyCapsForImpressionEvents()` for more information.

<br />

| Parameters ||
|---|---|
| `keyedFrequencyCapsForImpressionEvents` | `List`: This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters.Builder` | This value cannot be `null`. <br /> |

### setKeyedFrequencyCapsForViewEvents

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [Ad Services Extensions 8](https://developer.android.com/sdkExtensions)   
Deprecated in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FrequencyCapFilters.Builder setKeyedFrequencyCapsForViewEvents (List<KeyedFrequencyCap> keyedFrequencyCapsForViewEvents)
```

Sets the list of `https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap` objects that will filter on the `https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters#AD_EVENT_TYPE_VIEW` event type.

See `https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters#getKeyedFrequencyCapsForViewEvents()` for more information.

<br />

| Parameters ||
|---|---|
| `keyedFrequencyCapsForViewEvents` | `List`: This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters.Builder` | This value cannot be `null`. <br /> |

### setKeyedFrequencyCapsForWinEvents

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [Ad Services Extensions 8](https://developer.android.com/sdkExtensions)   
Deprecated in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FrequencyCapFilters.Builder setKeyedFrequencyCapsForWinEvents (List<KeyedFrequencyCap> keyedFrequencyCapsForWinEvents)
```

Sets the list of `https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap` objects that will filter on the `https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters#AD_EVENT_TYPE_WIN` event type.

See `https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters#getKeyedFrequencyCapsForWinEvents()` for more information.

<br />

| Parameters ||
|---|---|
| `keyedFrequencyCapsForWinEvents` | `List`: This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/adservices/common/FrequencyCapFilters.Builder` | This value cannot be `null`. <br /> |