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/KeyedFrequencyCap.Builder#pubctors) \| [Methods](https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap.Builder#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap.Builder#inhmethods)

# KeyedFrequencyCap.Builder

*** ** * ** ***

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

|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.adservices.common.KeyedFrequencyCap.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/KeyedFrequencyCap` objects.

## Summary

| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap.Builder#Builder(int,%20int,%20java.time.Duration)(int adCounterKey, int maxCount, https://developer.android.com/reference/java/time/Duration interval) ` |

| ### Public methods ||
|---|---|
| ` https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap` | ` https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap.Builder#build()() ` Builds and returns a `https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap` instance. |
| ` https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap.Builder` | ` https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap.Builder#setAdCounterKey(int)(int adCounterKey) ` Sets the ad counter key the frequency cap applies to. |
| ` https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap.Builder` | ` https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap.Builder#setInterval(java.time.Duration)(https://developer.android.com/reference/java/time/Duration interval) ` Sets the interval, as a `https://developer.android.com/reference/java/time/Duration` which will be truncated to the nearest second, over which the frequency cap is calculated. |
| ` https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap.Builder` | ` https://developer.android.com/reference/android/adservices/common/KeyedFrequencyCap.Builder#setMaxCount(int)(int maxCount) ` Sets the maximum count within the time interval for the frequency cap. |

### 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 (int adCounterKey, 
                int maxCount, 
                Duration interval)
```

<br />

<br />

| Parameters ||
|---|---|
| `adCounterKey` | `int` <br /> |
| `maxCount` | `int` <br /> |
| `interval` | `Duration`: This value cannot be `null`. <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 KeyedFrequencyCap build ()
```

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

<br />

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

### setAdCounterKey

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 KeyedFrequencyCap.Builder setAdCounterKey (int adCounterKey)
```

Sets the ad counter key the frequency cap applies to.

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

<br />

| Parameters ||
|---|---|
| `adCounterKey` | `int` <br /> |

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

### setInterval

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 KeyedFrequencyCap.Builder setInterval (Duration interval)
```

Sets the interval, as a `https://developer.android.com/reference/java/time/Duration` which will be truncated to the nearest second, over which the frequency cap is calculated.

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

<br />

| Parameters ||
|---|---|
| `interval` | `Duration`: This value cannot be `null`. <br /> |

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

### setMaxCount

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 KeyedFrequencyCap.Builder setMaxCount (int maxCount)
```

Sets the maximum count within the time interval for the frequency cap.

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

<br />

| Parameters ||
|---|---|
| `maxCount` | `int` <br /> |

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