TestAdSelectionManager
public
class
TestAdSelectionManager
extends Object
java.lang.Object | |
↳ | android.adservices.adselection.TestAdSelectionManager |
TestAdSelectionManager
为应用和广告 SDK 提供用于测试广告选择流程的 API。
这些 API 旨在用于端到端测试。只有在搭载已启用开发者选项的可调试操作系统 build 的手机上,可调试应用才会启用这些功能。
摘要
继承的方法 | |
---|---|
公共方法
overrideAdSelectionConfigRemoteInfo
public void overrideAdSelectionConfigRemoteInfo (AddAdSelectionOverrideRequest request, Executor executor, OutcomeReceiver<Object, Exception> receiver)
替换给定 AdSelectionConfig
的 AdSelection API,以避免从远程服务器提取数据,并改用 AddAdSelectionOverrideRequest
中提供的数据。AddAdSelectionOverrideRequest
由 Google Ads SDK 提供。
此方法旨在用于端到端测试。此 API 仅适用于处于调试模式且启用了开发者选项的应用。
需要 AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE
参数 | |
---|---|
request |
AddAdSelectionOverrideRequest :此值不能为 null 。 |
executor |
Executor :此值不能为 null 。
回调和监听器事件通过此 Executor 进行分派,便于您控制使用哪个线程。如需通过应用的主线程分派事件,可以使用 Context.getMainExecutor() 。
否则,请提供一个分派到适当线程的 Executor 。 |
receiver |
OutcomeReceiver :此值不能为 null 。 |
抛出 | |
---|---|
IllegalStateException |
如果未为调用方启用此 API
接收器会返回 |
覆盖 AdSelectionFromOutcomesConfigRemoteInfo
public void overrideAdSelectionFromOutcomesConfigRemoteInfo (AddAdSelectionFromOutcomesOverrideRequest request, Executor executor, OutcomeReceiver<Object, Exception> receiver)
替换了 AdSelectionFromOutcomesConfig
的 AdSelection API,以避免从远程服务器提取数据,而是改用 AddAdSelectionFromOutcomesOverrideRequest
中提供的数据。AddAdSelectionFromOutcomesOverrideRequest
由 Google Ads SDK 提供。
此方法旨在用于端到端测试。系统仅会为处于调试模式且启用了开发者选项的应用启用此 API。
需要 AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE
参数 | |
---|---|
request |
AddAdSelectionFromOutcomesOverrideRequest :此值不能为 null 。 |
executor |
Executor :此值不能为 null 。
通过此 Executor 分派回调和监听器事件,从而让您能够轻松控制要使用的线程。如需通过应用的主线程分派事件,可以使用 Context.getMainExecutor() 。
否则,请提供一个分派到适当线程的 Executor 。 |
receiver |
OutcomeReceiver :此值不能为 null 。 |
抛出 | |
---|---|
IllegalStateException |
如果没有为调用方启用此 API,则会发生此错误
接收器会返回 |
removeAdSelectionConfigRemoteInfoOverride
public void removeAdSelectionConfigRemoteInfoOverride (RemoveAdSelectionOverrideRequest request, Executor executor, OutcomeReceiver<Object, Exception> receiver)
移除 Ad Selection API 中与 RemoveAdSelectionOverrideRequest
中关联的数据对应的 AdSelectionConfig
替换项。RemoveAdSelectionOverrideRequest
由广告 SDK 提供。
此方法旨在用于端到端测试。此 API 仅适用于处于调试模式且启用了开发者选项的应用。
需要 AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE
参数 | |
---|---|
request |
RemoveAdSelectionOverrideRequest :此值不能为 null 。 |
executor |
Executor :此值不能为 null 。
通过此 Executor 分派回调和监听器事件,从而让您能够轻松控制要使用的线程。如需通过应用的主线程分派事件,可以使用 Context.getMainExecutor() 。
否则,请提供一个分派到适当线程的 Executor 。 |
receiver |
OutcomeReceiver :此值不能为 null 。 |
抛出 | |
---|---|
IllegalStateException |
如果没有为调用方启用此 API,则会发生此错误
接收器会返回 |
removeAdSelectionFromOutcomesConfigRemoteInfoOverride
public void removeAdSelectionFromOutcomesConfigRemoteInfoOverride (RemoveAdSelectionFromOutcomesOverrideRequest request, Executor executor, OutcomeReceiver<Object, Exception> receiver)
移除了 Ad Selection API 中与 RemoveAdSelectionOverrideRequest
中关联的数据的 AdSelectionFromOutcomesConfig
替换项。RemoveAdSelectionOverrideRequest
由 Google Ads SDK 提供。
此方法旨在用于端到端测试。此 API 仅适用于处于调试模式且启用了开发者选项的应用。
需要 AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE
参数 | |
---|---|
request |
RemoveAdSelectionFromOutcomesOverrideRequest :此值不能为 null 。 |
executor |
Executor :此值不能为 null 。
通过此 Executor 分派回调和监听器事件,从而让您能够轻松控制要使用的线程。如需通过应用的主线程分派事件,可以使用 Context.getMainExecutor() 。
否则,请提供一个分派到适当线程的 Executor 。 |
receiver |
OutcomeReceiver :此值不能为 null 。 |
抛出 | |
---|---|
IllegalStateException |
如果未为调用方启用此 API
接收器会在运行成功时返回 |
resetAllAdSelectionConfigRemoteOverrides
public void resetAllAdSelectionConfigRemoteOverrides (Executor executor, OutcomeReceiver<Object, Exception> receiver)
移除 Ad Selection API 中 AdSelectionConfig
的所有替换数据。
此方法旨在用于端到端测试。系统仅会为处于调试模式且启用了开发者选项的应用启用此 API。
需要 AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE
参数 | |
---|---|
executor |
Executor :此值不能为 null 。
通过此 Executor 分派回调和监听器事件,从而让您能够轻松控制要使用的线程。如需通过应用的主线程分派事件,可以使用 Context.getMainExecutor() 。
否则,请提供一个分派到适当线程的 Executor 。 |
receiver |
OutcomeReceiver :此值不能为 null 。 |
抛出 | |
---|---|
IllegalStateException |
如果未为调用方启用此 API
接收器会在运行成功时返回 |
resetAllAdSelectionFromOutcomesConfigRemoteOverrides
public void resetAllAdSelectionFromOutcomesConfigRemoteOverrides (Executor executor, OutcomeReceiver<Object, Exception> receiver)
移除 Ad Selection API 中 AdSelectionFromOutcomesConfig
的所有替换数据。
此方法旨在用于端到端测试。此 API 仅适用于处于调试模式且启用了开发者选项的应用。
需要 AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE
参数 | |
---|---|
executor |
Executor :此值不能为 null 。
通过此 Executor 分派回调和监听器事件,从而让您能够轻松控制要使用的线程。如需通过应用的主线程分派事件,可以使用 Context.getMainExecutor() 。
否则,请提供分派给相应线程的 Executor 。 |
receiver |
OutcomeReceiver :此值不能为 null 。 |
抛出 | |
---|---|
IllegalStateException |
如果未为调用方启用此 API
接收器会在运行成功时返回 |