已添加于 API 级别 34
也包含于 广告服务扩展程序 4

TestCustomAudienceManager

public class TestCustomAudienceManager
extends Object

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


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

摘要

公共方法

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 中的所有替代数据。

继承的方法

公共方法

overrideCustomAudienceRemoteInfo

已添加于 API 级别 34
也包含于 广告服务扩展程序 4
public void overrideCustomAudienceRemoteInfo (AddCustomAudienceOverrideRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

替换 Custom Audience API,以避免从远程服务器获取数据,而是使用 AddCustomAudienceOverrideRequest 中提供的数据。AddCustomAudienceOverrideRequest 由 Ads 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 由 Ads 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 表示错误。