# GetTopicsRequest.Builder

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

# Builder

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/android/adservices/topics/GetTopicsRequest.Builder "View this page in Java")  

```
class Builder
```

|---|----------------------------------------------------------------------------------------------------------------------------------------------------------|
| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)                                                                           ||
| ↳ | [android.adservices.topics.GetTopicsRequest.Builder](https://developer.android.com/reference/kotlin/android/adservices/topics/GetTopicsRequest.Builder#) |

Builder for[GetTopicsRequest](https://developer.android.com/reference/kotlin/android/adservices/topics/GetTopicsRequest)objects.

## Summary

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

|                                                                                                                                                                                                                   Public methods                                                                                                                                                                                                                    ||
|--------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [GetTopicsRequest](https://developer.android.com/reference/kotlin/android/adservices/topics/GetTopicsRequest)                  | [build](https://developer.android.com/reference/kotlin/android/adservices/topics/GetTopicsRequest.Builder#build())`()` Builds a[GetTopicsRequest](https://developer.android.com/reference/kotlin/android/adservices/topics/GetTopicsRequest)instance.                                                               |
| [GetTopicsRequest.Builder](https://developer.android.com/reference/kotlin/android/adservices/topics/GetTopicsRequest.Builder#) | [setAdsSdkName](https://developer.android.com/reference/kotlin/android/adservices/topics/GetTopicsRequest.Builder#setAdsSdkName(kotlin.String))`(`adsSdkName:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)`)` Set Ads Sdk Name.                                               |
| [GetTopicsRequest.Builder](https://developer.android.com/reference/kotlin/android/adservices/topics/GetTopicsRequest.Builder#) | [setShouldRecordObservation](https://developer.android.com/reference/kotlin/android/adservices/topics/GetTopicsRequest.Builder#setShouldRecordObservation(kotlin.Boolean))`(`recordObservation:` `[Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)`)` Set the Record Observation. |

## Public constructors

### Builder

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

```
Builder()
```

Creates a[Builder](https://developer.android.com/reference/kotlin/android/adservices/topics/GetTopicsRequest.Builder#)for[GetTopicsRequest](https://developer.android.com/reference/kotlin/android/adservices/topics/GetTopicsRequest)objects.

## Public methods

### build

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

```
fun build(): GetTopicsRequest
```

Builds a[GetTopicsRequest](https://developer.android.com/reference/kotlin/android/adservices/topics/GetTopicsRequest)instance.

|                                                                   Return                                                                   ||
|---------------------------------------------------------------------------------------------------------------|-----------------------------|
| [GetTopicsRequest](https://developer.android.com/reference/kotlin/android/adservices/topics/GetTopicsRequest) | This value cannot be`null`. |

### setAdsSdkName

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

```
fun setAdsSdkName(adsSdkName: String): GetTopicsRequest.Builder
```

Set Ads Sdk Name.

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

|                                                                  Parameters                                                                  ||
|--------------|--------------------------------------------------------------------------------------------------------------------------------|
| `adsSdkName` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html):the Ads Sdk Name. This value cannot be`null`. |

|                                                                           Return                                                                            ||
|--------------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| [GetTopicsRequest.Builder](https://developer.android.com/reference/kotlin/android/adservices/topics/GetTopicsRequest.Builder#) | This value cannot be`null`. |

### setShouldRecordObservation

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

```
fun setShouldRecordObservation(recordObservation: Boolean): GetTopicsRequest.Builder
```

Set the Record Observation.

|                                                                                                                                   Parameters                                                                                                                                    ||
|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `recordObservation` | [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html):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. |

|                                                                           Return                                                                            ||
|--------------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| [GetTopicsRequest.Builder](https://developer.android.com/reference/kotlin/android/adservices/topics/GetTopicsRequest.Builder#) | This value cannot be`null`. |