TopicsManager

Kotlin |Java

public final class TopicsManager
extends Object

java.lang.Object
↳	android.adservices.topics.TopicsManager

TopicsManager provides APIs for App and Ad-Sdks to get the user interest topics in a privacy preserving way.

The instance of the TopicsManager can be obtained using Context.getSystemService(Class) and TopicsManager class.

Summary

Public methods
`static TopicsManager`	`get(Context context)` Factory method for creating an instance of TopicsManager.
`void`	`getTopics(GetTopicsRequest getTopicsRequest, Executor executor, OutcomeReceiver<GetTopicsResponse, Exception> callback)` Return the topics.

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(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`	`wait(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`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public methods

get

Added in API level 34
Also in Ad Services Extensions 6

public static TopicsManager get (Context context)

Factory method for creating an instance of TopicsManager.

Parameters
`context`	`Context`: The `Context` to use This value cannot be `null`.

Returns
`TopicsManager`	A `TopicsManager` instance This value cannot be `null`.

getTopics

Added in API level 34
Also in Ad Services Extensions 4

public void getTopics (GetTopicsRequest getTopicsRequest, 
                Executor executor, 
                OutcomeReceiver<GetTopicsResponse, Exception> callback)

Return the topics.
Requires AdServicesPermissions.ACCESS_ADSERVICES_TOPICS

Parameters
`getTopicsRequest`	`GetTopicsRequest`: The request for obtaining Topics. This value cannot be `null`.
`executor`	`Executor`: The executor to run callback. This value cannot be `null`. Callback and listener events are dispatched through this `Executor`, providing an easy way to control which thread is used. To dispatch events through the main thread of your application, you can use `Context.getMainExecutor()`. Otherwise, provide an `Executor` that dispatches to an appropriate thread.
`callback`	`OutcomeReceiver`: The callback that's called after topics are available or an error occurs. This value cannot be `null`.

Returns
`void`	This value cannot be `null`.

Throws
`IllegalStateException`	if this API is not available.