已新增至 API 級別 34
Ad Services Extensions 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
Ad Services Extensions 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 表示錯誤。

移除 CustomAudienceRemoteInfo 覆寫

已新增至 API 級別 34
Ad Services Extensions 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 表示錯誤。

重設所有 CustomAudienceOverrides

已新增至 API 級別 34
Ad Services Extensions 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 表示錯誤。