已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入

摘要： 嵌套类 |继承的常量 |字段 |方法 |继承的方法

广告选择配置

public final class AdSelectionConfig
extends Object implements Parcelable

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

---

包含广告选择流程的配置。

此类的实例由 SDK 创建，将作为参数提供给 AdSelectionManager 中的 AdSelectionManager.selectAds(AdSelectionConfig, Executor, OutcomeReceiver) 和 AdSelectionManager#reportImpression 方法。

摘要

嵌套类
class	AdSelectionConfig.Builder AdSelectionConfig 对象的构建器。

继承的常量
继承自接口 android.os.Parcelable int CONTENTS_FILE_DESCRIPTOR 与 describeContents() 一起使用的描述符位：表示 Parcelable 对象的扁平化表示中包含一个文件描述符。 int PARCELABLE_WRITE_RETURN_VALUE 与 writeToParcel(Parcel, int) 搭配使用的标志：正在写入的对象 是一个返回值，该值是如下函数的结果： “Parcelable someFunction()”、 “void someFunction(out Parcelable)”或 “void someFunction(inout Parcelable)”。

字段
public static final Creator<AdSelectionConfig>	CREATOR

公共方法
int	describeContents() 描述此 Parcelable 中包含的特殊对象的种类。 实例的编排表示法。
boolean	equals(Object o) 指示某个其他对象是否“等于”这个。
AdSelectionSignals	getAdSelectionSignals()
List<AdTechIdentifier>	getCustomAudienceBuyers()
Uri	getDecisionLogicUri()
Map<AdTechIdentifier, AdSelectionSignals>	getPerBuyerSignals()
AdTechIdentifier	getSeller()
AdSelectionSignals	getSellerSignals()
Uri	getTrustedScoringSignalsUri()
int	hashCode() 返回对象的哈希代码值。
void	writeToParcel(Parcel dest, int flags) 将此对象展平为 Parcel。

继承的方法
继承自 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() 导致当前线程处于等待状态，直到其被唤醒，这通常是 通知或中断。
继承自 android.os.Parcelable 接口 abstract int describeContents() 描述此 Parcelable 中包含的特殊对象的种类。 实例的编排表示法。 abstract void writeToParcel(Parcel dest, int flags) 将此对象展平为 Parcel。

字段

CREATOR

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入

public static final Creator<AdSelectionConfig> CREATOR

公共方法

describeContents

在 API 级别 34 中引入

public int describeContents ()

描述此 Parcelable 实例的编排表示中包含的特殊对象的种类。例如，如果对象将在 writeToParcel(android.os.Parcel, int) 的输出中添加一个文件描述符，那么此方法的返回值就必须包含 CONTENTS_FILE_DESCRIPTOR 位。

返回
int	一个位掩码，表示编组的特殊对象类型集 。 值为 0 或 CONTENTS_FILE_DESCRIPTOR

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。

getAdSelectionSignals

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入

public AdSelectionSignals getAdSelectionSignals ()

返回
AdSelectionSignals	AdSelectionSignals 对象中的 JSON，从 AdSelectionConfig 提取并使用 从 DSP 中提取的 JS 逻辑表示发送给参与竞价的 买方可以参与广告选择和报告流程。 此值不能为 null。

getCustomAudienceBuyers

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入

public List<AdTechIdentifier> getCustomAudienceBuyers ()

返回
List<AdTechIdentifier>	SSP 允许参与广告的自定义受众群体买方的列表 选择过程 此值不能为 null。

getDecisionLogicUri

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入

public Uri getDecisionLogicUri ()

返回
Uri	用于检索 JS 代码的 URI，该代码包含所用的 sellers/SSP scoreAd 函数 （包括广告选择和报告流程） 此值不能为 null。

getPerBuyerSignals

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入

public Map<AdTechIdentifier, AdSelectionSignals> getPerBuyerSignals ()

返回
Map<AdTechIdentifier, AdSelectionSignals>	从 AdSelectionConfig 中提取的买方和 AdSelectionSignals 的映射， 从 DSP 中提取的 JS 逻辑所用的资源，表示每个 买方在广告选择过程中向参与者提供的内容（如出价下限、广告选择） 类型等） 此值不能为 null。

getSeller

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入

public AdTechIdentifier getSeller ()

返回
AdTechIdentifier	卖方的 AdTechIdentifier，例如“www.example-ssp.com” 此值不能为 null。

getSellerSignals

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入

public AdSelectionSignals getSellerSignals ()

返回
AdSelectionSignals	AdSelectionSignals 对象中的 JSON，由 SSP 提供并由 JS 使用 从 SSP 中提取的逻辑，表示 SSP 在广告中使用的任何信息 用于调整广告选择流程结果（例如品牌保障 排除的内容相关广告）。 此值不能为 null。

getTrustedScoringSignalsUri

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入

public Uri getTrustedScoringSignalsUri ()

返回
Uri	卖方可信信号的 URI 端点，用于实时获取广告素材特定信号 可提取的信息。 此值不能为 null。

hashCode

在 API 级别 34 中引入

public int hashCode ()

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

hashCode 的通用协定如下：

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

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

返回值
int	此对象的哈希代码值。

writeToParcel

在 API 级别 34 中引入

public void writeToParcel (Parcel dest, 
                int flags)

将此对象扁平化为 Parcel。

参数
dest	Parcel：此值不能为 null。
flags	int：关于如何写入对象的其他标志。可为 0 或 Parcelable.PARCELABLE_WRITE_RETURN_VALUE。 值为 0 或 Parcelable.PARCELABLE_WRITE_RETURN_VALUE 和 android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES 的组合