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

摘要： 常量 | 构造函数 | 方法 | 继承的方法

应用集 ID

public class AppSetId
extends Object

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

---

对于未启用创收功能的广告用例，是每台设备、每个开发者帐号的唯一 ID，可由用户重置。

表示来自 AppSetIdManager.getAppSetId(Executor, OutcomeReceiver) API 的 appSetID 和此 appSetId 的范围。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 中添加
也在广告服务扩展 4 中添加

public static final int SCOPE_APP

appSetId 的作用域限定为某个应用。设备上的所有应用都具有不同的 appSetId。

常量值： 1 (0x00000001)

SCOPE_DEVELOPER

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

public static final int SCOPE_DEVELOPER

appSetId 的范围限定为应用商店中的开发者账号。同一设备上来自同一开发者的所有应用将具有相同的开发者级范围的 appSetId。

常量值： 2 (0x00000002)

公共构造函数

应用集 ID

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

public AppSetId (String appSetId, 
                int appSetIdScope)

创建 AppSetId 的实例

参数
appSetId	String：由提供程序服务生成。此值不能为 null。
appSetIdScope	int：appSetId 的范围。 值为 SCOPE_APP 或 SCOPE_DEVELOPER

公共方法

equals

在 API 级别 34 中引入

public boolean equals (Object o)

指示某个其他对象是否“等于”此对象。

equals 方法可针对非 null 对象引用实现等价关系：

• 该方法具有自反性：对于任何非 null 引用值 x，x.equals(x) 应返回 true。
• 该方法具有对称性：对于任何非 null 引用值 x 和 y，当且仅当 y.equals(x) 返回 true 时，x.equals(y) 才应返回 true。
• 该方法具有传递性：对于任何非 null 引用值 x、y 和 z，如果 x.equals(y) 返回 true 且 y.equals(z) 返回 true，则 x.equals(z) 应返回 true。
• 该方法具有一致性：对于任何非 null 引用值 x 和 y，多次调用 x.equals(y) 时，只要没有修改对象的 equals 比较中使用的任何信息，就会一致地返回 true 或 false。
• 对于任何非 null 引用值 x，x.equals(null) 应返回 false。

Object 类的 equals 方法可对对象实现最具辨别性的等价关系；也就是说，对于任何非 null 引用值 x 和 y，当且仅当 x 和 y 引用同一对象时，此方法才会返回 true（x == y 时值为 true）。

请注意，一般而言，每次替换此方法时，都需要替换 hashCode 方法，以便维持 hashCode 方法的通用协定，该协定规定相等的对象必须具有相等的哈希代码。

参数
o	Object：用来进行比较的参照对象。

返回值
boolean	如果此对象与 obj 参数相同，则返回 true，否则返回 false。

获取 ID

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

public String getId ()

检索 appSetId。该 API 始终返回非空 appSetId。

开球回攻次数
String	此值不能为 null。

getScope

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

public int getScope ()

检索 appSetId 的范围。

开球回攻次数
int	值为 SCOPE_APP 或 SCOPE_DEVELOPER

hashCode

在 API 级别 34 中引入

public int hashCode ()

返回对象的哈希代码值。之所以支持此方法，是为了支持哈希表（例如由 HashMap 提供的表）。

hashCode 的通用协定如下：

• 每当在 Java 应用执行期间在同一个对象上多次调用该方法时，只要没有修改对象的 equals 比较中使用的任何信息，hashCode 方法都必须始终返回相同的整数。在应用的不同执行之间，此整数无需保持一致。
• 如果根据 equals(Object) 方法判断两个对象相等，则对这两个对象分别调用 hashCode 方法必须产生相同的整数结果。
• 而如果根据 equals(java.lang.Object) 方法判断两个对象不相等，将不要求对这两个对象分别调用 hashCode 方法必须产生不同的整数结果。但是，程序员应注意，为不相等的对象产生不同的整数结果可能会提高哈希表的性能。

在合理可行的前提下，由 Object 类定义的 hashCode 方法确实会针对不同的对象返回不同的整数。（hashCode 不一定会在某个时间点作为对象内存地址的某个函数实现。）

开球回攻次数
int	此对象的哈希代码值。