Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [Ad Services Extensions 4](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/topics/GetTopicsRequest.Builder#pubctors) \| [Methods](https://developer.android.com/reference/android/adservices/topics/GetTopicsRequest.Builder#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/adservices/topics/GetTopicsRequest.Builder#inhmethods)

# GetTopicsRequest.Builder

*** ** * ** ***

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

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

<br />

*** ** * ** ***

<br />

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

The Rubidium (Rb) Relevance APIs, including those in android.adservices.topics, 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 `https://developer.android.com/reference/android/adservices/topics/GetTopicsRequest` objects.

## Summary

| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/android/adservices/topics/GetTopicsRequest.Builder#Builder()() ` Creates a `https://developer.android.com/reference/android/adservices/topics/GetTopicsRequest.Builder` for `https://developer.android.com/reference/android/adservices/topics/GetTopicsRequest` objects. |

| ### Public methods ||
|---|---|
| ` https://developer.android.com/reference/android/adservices/topics/GetTopicsRequest` | ` https://developer.android.com/reference/android/adservices/topics/GetTopicsRequest.Builder#build()() ` Builds a `https://developer.android.com/reference/android/adservices/topics/GetTopicsRequest` instance. |
| ` https://developer.android.com/reference/android/adservices/topics/GetTopicsRequest.Builder` | ` https://developer.android.com/reference/android/adservices/topics/GetTopicsRequest.Builder#setAdsSdkName(java.lang.String)(https://developer.android.com/reference/java/lang/String adsSdkName) ` Set Ads Sdk Name. |
| ` https://developer.android.com/reference/android/adservices/topics/GetTopicsRequest.Builder` | ` https://developer.android.com/reference/android/adservices/topics/GetTopicsRequest.Builder#setShouldRecordObservation(boolean)(boolean recordObservation) ` Set the Record Observation. |

### 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 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [Ad Services Extensions 4](https://developer.android.com/sdkExtensions)

```
public Builder ()
```

Creates a `https://developer.android.com/reference/android/adservices/topics/GetTopicsRequest.Builder` for `https://developer.android.com/reference/android/adservices/topics/GetTopicsRequest` objects.

<br />

## Public methods

### build

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

```
public GetTopicsRequest build ()
```

Builds a `https://developer.android.com/reference/android/adservices/topics/GetTopicsRequest` instance.

<br />

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

### setAdsSdkName

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

```
public GetTopicsRequest.Builder setAdsSdkName (String adsSdkName)
```

Set Ads Sdk Name.

This must be called by SDKs running outside of the Sandbox. Other clients must not call it.

<br />

| Parameters ||
|---|---|
| `adsSdkName` | `String`: the Ads Sdk Name. This value cannot be `null`. <br /> |

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

### setShouldRecordObservation

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

```
public GetTopicsRequest.Builder setShouldRecordObservation (boolean recordObservation)
```

Set the Record Observation.

<br />

| Parameters ||
|---|---|
| `recordObservation` | `boolean`: whether to record that the caller has observed the topics of the host app or not. This will be used to determine if the caller can receive the topic in the next epoch. <br /> |

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