API 级别 34 中添加
也在广告服务扩展 4 中添加

TestCustomAudienceManager

public class TestCustomAudienceManager
extends Object

java.lang.Object
   ↳ android.adservices.customaudience.TestCustomAudienceManager


TestCustomAudienceManager 为应用和广告 SDK 提供用于测试自定义受众群体的 API。

总结

公共方法

void overrideCustomAudienceRemoteInfo(AddCustomAudienceOverrideRequest request, Executor executor, OutcomeReceiver<ObjectException> receiver)

替换 Custom Audience API 以避免从远程服务器提取数据,并改用 AddCustomAudienceOverrideRequest 中提供的数据。

void removeCustomAudienceRemoteInfoOverride(RemoveCustomAudienceOverrideRequest request, Executor executor, OutcomeReceiver<ObjectException> receiver)

移除 Custom Audience API 中与 RemoveCustomAudienceOverrideRequest 中关联的数据的替换项。

void resetAllCustomAudienceOverrides(Executor executor, OutcomeReceiver<ObjectException> receiver)

移除 Custom Audience API 中的所有替换数据。

继承的方法

公共方法

覆盖 CustomAudienceRemoteInfo

API 级别 34 中添加
也在广告服务扩展 4 中添加
public void overrideCustomAudienceRemoteInfo (AddCustomAudienceOverrideRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

替换 Custom Audience API 以避免从远程服务器提取数据,并改用 AddCustomAudienceOverrideRequest 中提供的数据。AddCustomAudienceOverrideRequest 由广告 SDK 提供。

此方法旨在用于端到端测试。系统仅针对处于调试模式并启用开发者选项的应用启用此 API。

如果 request 中的 owner 不是发起调用的应用的软件包名称,此调用将静默失败。
需要 AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

参数
request AddCustomAudienceOverrideRequest:此值不能为 null

executor Executor:此值不能为 null。 回调和监听器事件通过此 Executor 进行分派,从而提供了一种简单的方法来控制使用哪个线程。如需通过应用的主线程分派事件,您可以使用 Context.getMainExecutor()。 否则,请提供可分派给适当线程的 Executor

receiver OutcomeReceiver:此值不能为 null

抛出
IllegalStateException 如果没有为调用方启用此 API,

如果运行成功,接收器会返回 void;如果返回 Exception,则表示出现了错误。

removeCustomAudienceRemoteInfoOverride

API 级别 34 中添加
也在广告服务扩展 4 中添加
public void removeCustomAudienceRemoteInfoOverride (RemoveCustomAudienceOverrideRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

移除了 Custom Audience API 中与 RemoveCustomAudienceOverrideRequest 中关联的数据的替换项。

此方法旨在用于端到端测试。系统仅针对处于调试模式并启用开发者选项的应用启用此 API。
需要 AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

参数
request RemoveCustomAudienceOverrideRequest:此值不能为 null

executor Executor:此值不能为 null。 回调和监听器事件通过此 Executor 进行分派,从而提供了一种简单的方法来控制使用哪个线程。如需通过应用的主线程分派事件,您可以使用 Context.getMainExecutor()。 否则,请提供可分派给适当线程的 Executor

receiver OutcomeReceiver:此值不能为 null

抛出
IllegalStateException 如果没有为调用方启用此 API,

RemoveCustomAudienceOverrideRequest 由广告 SDK 提供。如果运行成功,接收器会返回 void;如果返回 Exception,则表示出现了错误。

resetAllCustomAudienceOverrides

API 级别 34 中添加
也在广告服务扩展 4 中添加
public void resetAllCustomAudienceOverrides (Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

移除 Custom Audience API 中的所有替换数据。

此方法旨在用于端到端测试。系统仅针对处于调试模式并启用开发者选项的应用启用此 API。
需要 AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

参数
executor Executor:此值不能为 null。 回调和监听器事件通过此 Executor 进行分派,从而提供了一种简单的方法来控制使用哪个线程。如需通过应用的主线程分派事件,您可以使用 Context.getMainExecutor()。 否则,请提供可分派给适当线程的 Executor

receiver OutcomeReceiver:此值不能为 null

抛出
IllegalStateException 如果没有为调用方启用此 API,

如果运行成功,接收器会返回 void;如果返回 Exception,则表示出现了错误。