TestAdSelectionManager

public class TestAdSelectionManager
extends Object

java.lang.Object
↳	android.adservices.adselection.TestAdSelectionManager

TestAdSelectionManager 可為應用程式和廣告 SDK 提供 API，用於測試廣告選擇程序。

這些 API 用於端對端測試。這些功能僅會在手機上啟用偵錯應用程式，且該手機必須搭載可偵錯的 OS 版本，並已啟用開發人員選項。

摘要

公用方法
`void`	`overrideAdSelectionConfigRemoteInfo(AddAdSelectionOverrideRequest request, Executor executor, OutcomeReceiver<Object, Exception> receiver)` 為特定 `AdSelectionConfig` 覆寫 AdSelection API，避免從遠端伺服器擷取資料，並改為使用 `AddAdSelectionOverrideRequest` 提供的資料。
`void`	`overrideAdSelectionFromOutcomesConfigRemoteInfo(AddAdSelectionFromOutcomesOverrideRequest request, Executor executor, OutcomeReceiver<Object, Exception> receiver)` 為 `AdSelectionFromOutcomesConfig` 覆寫 AdSelection API，避免從遠端伺服器擷取資料，並改為使用 `AddAdSelectionFromOutcomesOverrideRequest` 提供的資料。
`void`	`removeAdSelectionConfigRemoteInfoOverride(RemoveAdSelectionOverrideRequest request, Executor executor, OutcomeReceiver<Object, Exception> receiver)` 移除 Ad Selection API 中 `AdSelectionConfig` 的覆寫值，並與 `RemoveAdSelectionOverrideRequest` 中的相關資料建立關聯。
`void`	`removeAdSelectionFromOutcomesConfigRemoteInfoOverride(RemoveAdSelectionFromOutcomesOverrideRequest request, Executor executor, OutcomeReceiver<Object, Exception> receiver)` 移除 Ad Selection API 中 `AdSelectionFromOutcomesConfig` 的覆寫值，並與 `RemoveAdSelectionOverrideRequest` 中的相關資料建立關聯。
`void`	`resetAllAdSelectionConfigRemoteOverrides(Executor executor, OutcomeReceiver<Object, Exception> receiver)` 移除 Ad Selection API 中 `AdSelectionConfig` 的所有覆寫資料。
`void`	`resetAllAdSelectionFromOutcomesConfigRemoteOverrides(Executor executor, OutcomeReceiver<Object, Exception> receiver)` 移除 Ad Selection API 中 `AdSelectionFromOutcomesConfig` 的所有覆寫資料。

繼承方法

來自類別：


        
          java.lang.Object

`Object`	`clone()` 建立並傳回此物件的副本。
`boolean`	`equals(Object obj)` 指出是否有其他物件「等於」這個物件。
`void`	`finalize()` 當垃圾收集判定物件沒有其他參照，垃圾收集器會針對該物件呼叫。
`final Class<?>`	`getClass()` 傳回此 `Object` 的執行階段類別。
`int`	`hashCode()` 傳回該物件的雜湊碼值。
`final void`	`notify()` 喚醒單個等待此物件監控器的執行緒。
`final void`	`notifyAll()` 喚醒所有等待此物件監控器的執行緒。
`String`	`toString()` 傳回該物件的字串表示法。
`final void`	`wait(long timeoutMillis, int nanos)` 讓目前的執行緒等待，直到遭到喚醒或經過一定的實際時間長度為止。喚醒方式通常是收到「通知」或遭到「中斷」。
`final void`	`wait(long timeoutMillis)` 讓目前的執行緒等待，直到遭到喚醒或經過一定的實際時間長度為止。喚醒方式通常是收到「通知」或遭到「中斷」。
`final void`	`wait()` 讓目前的執行緒等待，直到遭到喚醒為止。喚醒方式通常是收到「通知」或遭到「中斷」。

公用方法

overrideAdSelectionConfigRemoteInfo

已加至 API 級別 34
也已納入 Ad Services Extensions 4

public void overrideAdSelectionConfigRemoteInfo (AddAdSelectionOverrideRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

為特定 AdSelectionConfig 覆寫 AdSelection API，避免從遠端伺服器擷取資料，並改為使用 AddAdSelectionOverrideRequest 提供的資料。AddAdSelectionOverrideRequest 是由廣告 SDK 提供。

這個方法適用於端對端測試。這個 API 僅會在啟用開發人員選項的偵錯模式中啟用。
需要 AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

參數
`request`	`AddAdSelectionOverrideRequest`：此值不能為 `null`。
`executor`	`Executor`：此值不能為 `null`。回呼和事件監聽器會透過這個 `Executor` 分派，讓您輕鬆控制使用哪一個執行緒。如要透過應用程式的主要執行緒進行事件分派，可以使用 `Context.getMainExecutor()`。否則，請提供 `Executor`，將工作調度至適當的執行緒。
`receiver`	`OutcomeReceiver`：此值不能為 `null`。

擲回
`IllegalStateException`	如果呼叫端未啟用此 API 接收器會在成功執行後傳回 `void`，`Exception` 則表示錯誤。

overrideAdSelectionFromResultsConfigRemoteInfo

已加至 Android UpsideDownCakePrivacySandbox

public void overrideAdSelectionFromOutcomesConfigRemoteInfo (AddAdSelectionFromOutcomesOverrideRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

覆寫 AdSelectionFromOutcomesConfig 的 AdSelection API，以免從遠端伺服器擷取資料，並改用 AddAdSelectionFromOutcomesOverrideRequest 中提供的資料。AddAdSelectionFromOutcomesOverrideRequest 是由廣告 SDK 提供。

這個方法用於端對端測試。這個 API 僅會在啟用開發人員選項的偵錯模式中啟用。
需要 AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

參數
`request`	`AddAdSelectionFromOutcomesOverrideRequest`：此值不能為 `null`。
`executor`	`Executor`：此值不能為 `null`。回呼和事件監聽器會透過這個 `Executor` 分派，讓您輕鬆控制使用哪一個執行緒。如要透過應用程式的主要執行緒進行事件分派，可以使用 `Context.getMainExecutor()`。否則，請提供 `Executor`，將工作調派至適當的執行緒。
`receiver`	`OutcomeReceiver`：此值不能為 `null`。

擲回
`IllegalStateException`	如果呼叫端未啟用此 API 接收器會在成功執行後傳回 `void`，`Exception` 則表示錯誤。

removeAdSelectionConfigRemoteInfoOverride

已加至 API 級別 34
也已納入 Ad Services Extensions 4

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 接收器會傳回 `void` 表示執行成功，或傳回 `Exception` 表示錯誤。

removeAdSelectionFromOutcomesConfigRemoteInfoOverride

已加至 Android UpsideDownCakePrivacySandbox

public void removeAdSelectionFromOutcomesConfigRemoteInfoOverride (RemoveAdSelectionFromOutcomesOverrideRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

移除 Ad Selection API 中 AdSelectionFromOutcomesConfig 的覆寫值，並與 RemoveAdSelectionOverrideRequest 中的相關資料建立關聯。RemoveAdSelectionOverrideRequest 是由 Ads SDK 提供。

這個方法適用於端對端測試。這個 API 僅會在啟用開發人員選項的偵錯模式中啟用。
需要 AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

參數
`request`	`RemoveAdSelectionFromOutcomesOverrideRequest`：此值不能為 `null`。
`executor`	`Executor`：此值不能為 `null`。回呼和事件監聽器會透過這個 `Executor` 分派，讓您輕鬆控制使用哪一個執行緒。如要透過應用程式的主要執行緒進行事件分派，可以使用 `Context.getMainExecutor()`。否則，請提供會調度至適當執行緒的 `Executor`。
`receiver`	`OutcomeReceiver`：此值不能為 `null`。

擲回
`IllegalStateException`	如果呼叫端未啟用此 API 接收器會傳回 `void` 表示執行成功，或是傳回 `Exception` 表示錯誤。

resetAllAdSelectionConfigRemoteOverrides

已加至 API 級別 34
也已納入 Ad Services Extensions 4

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 接收器會在成功執行後傳回 `void`，`Exception` 則表示錯誤。

ResetAllAdSelectionFromOutcomesConfigRemoteOverrides

已加至 Android UpsideDownCakePrivacySandbox

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 接收器會傳回 `void` 表示執行成功，或是傳回 `Exception` 表示錯誤。