本頁面由 Cloud Translation API 翻譯而成。

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

應用程式集 ID

public class AppSetId
extends Object

java.lang.Object
↳	android.adservices.appsetid.AppSetId

可供使用者重設的個別開發人員帳戶單部裝置專屬 ID，適用於非營利廣告用途。

代表這個 appSetID 的 appSetID 和來自 AppSetIdManager.getAppSetId(Executor, OutcomeReceiver) API 的範圍。您可以根據個別應用程式或與使用者相關聯的開發人員帳戶，設定 ID 範圍。AppSetId 可針對特定裝置進行分析、垃圾內容偵測、展示頻率上限和詐欺防範用途，系統可能需要將機構擁有的一組應用程式的使用情形或動作建立關聯。

摘要

常數
`int`	`SCOPE_APP` appSetId 的適用範圍是應用程式。
`int`	`SCOPE_DEVELOPER` appSetId 的範圍僅限應用程式商店中的開發人員帳戶。

公用建構函式
`AppSetId(String appSetId, int appSetIdScope)` 建立 `AppSetId` 的執行個體

公用方法
`boolean`	`equals(Object o)` 指出是否有其他物件「等於」這個物件。
`String`	`getId()` 擷取 appSetId。
`int`	`getScope()` 擷取 appSetId 的範圍。
`int`	`hashCode()` 傳回該物件的雜湊碼值。

繼承方法

來自


        
          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()` 讓目前的執行緒等待，直到遭到喚醒為止。喚醒方式通常是收到「通知」或遭到「中斷」。

常數

智慧購物廣告活動

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

public static final int SCOPE_APP

appSetId 的適用範圍是應用程式，裝置上的所有應用程式都會有不同的 appSetId。

常數值：1 (0x00000001)

新手開發人員

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

public static final int SCOPE_DEVELOPER

appSetId 的範圍僅限應用程式商店中的開發人員帳戶，裝置上來自同一開發人員的所有應用程式，都會使用同一個開發人員範圍的 appSetId。

常數值：2 (0x00000002)

公用建構函式

應用程式集 ID

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

public AppSetId (String appSetId, 
                int appSetIdScope)

建立 AppSetId 的執行個體

參數
`appSetId`	`String`：由供應商服務產生。此值不能為 `null`。
`appSetIdScope`	`int`：appSetId 的範圍。這個值可以是 `SCOPE_APP` 或 `SCOPE_DEVELOPER`

公用方法

等於

已在 API 級別 34 中新增。

public boolean equals (Object o)

指出是否有其他物件「等於」這個物件。

equals 方法針對非空值物件參照實作對等關係：

如果是自反關係：針對任何的非空參照值 x，x.equals(x) 應傳回 true。
如果是對稱關係：針對任何非空參照值 x 和 y，x.equals(y) 應傳回 true，前提是 y.equals(x) 必須傳回 true。
而是轉換：針對任何非空值參照值 x、y 和 z，如果 x.equals(y) 傳回 true 且 y.equals(z) 傳回 true，則 x.equals(z) 應傳回 true。
如果是一致的關係：針對任何非空參照值 x 和 y，多次叫用 x.equals(y) 會持續傳回 true 或 false，但前提是，在該物件的 equals 比較中所使用的資訊均未經過修改。
針對任何非空參照值 x，x.equals(null) 應傳回 false。

Object 類別的 equals 方法實作了最大可能的物件相等關係；也就是說，對於任何非空值參照值 x 和 y，這個方法只有在 x 和 y 參照同一個物件 (x == y 具有 true 值) 時，才會傳回 true。

請注意，通常情況下，只要覆寫這個方法，就必須覆寫 hashCode 方法，以便維持 hashCode 方法的通用協定，亦即相等的物件必須有相等的雜湊碼。

參數
`o`	`Object`：要用來比較的參照物件。

傳回
`boolean`	如果此物件與 obj 引數相同，會傳回 `true`，否則傳回 `false`。

getId

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

public String getId ()

擷取 appSetId。API 一律會傳回非空白的 appSetId。

傳回
`String`	此值不能為 `null`。

getScope

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

public int getScope ()

擷取 appSetId 的範圍。

傳回
`int`	這個值可以是 `SCOPE_APP` 或 `SCOPE_DEVELOPER`

hashCode

已在 API 級別 34 中新增。

public int hashCode ()

傳回該物件的雜湊碼值。此方法支援使用雜湊資料表，例如 HashMap 提供的雜湊資料表。

hashCode 的一般約定如下：

在 Java 應用程式執行期間，如果多次叫用同一物件，hashCode 方法必須持續傳回相同的整數；前提是在該物件上用於 equals 比較的資訊均未經修改。在同一個應用程式兩次執行作業之間，此整數無需保持一致。
如果根據 equals(Object) 方法，兩個物件是相同的，則針對兩個物件呼叫 hashCode 方法時，必須產生相同的整數結果。
如果根據 equals(java.lang.Object) 方法，兩個物件不相同，則針對兩個物件呼叫 hashCode 方法時，無需產生不同的整數結果。不過，程式設計人員也應瞭解，如果為不相等的物件產生不同的整數結果，可能會改善雜湊資料表的效能。

只要合理可行，由 Object 類別定義的 hashCode 方法就會為不相同的物件傳回不同的整數 (在某個時間點上，hashCode 不一定會實作為物件記憶體位址的特定函式)。

傳回
`int`	此物件的雜湊碼值。