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

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

CustomAudience.Builder

public static final class CustomAudience.Builder
extends Object

java.lang.Object
↳	android.adservices.customaudience.CustomAudience.Builder

---

CustomAudience 对象的构建器。

摘要

公共构造函数
Builder()

公共方法
CustomAudience	build() 构建 CustomAudience 的实例。
CustomAudience.Builder	setActivationTime(Instant activationTime) 设置时间（截断至毫秒），之后 CustomAudience 将 投放广告。
CustomAudience.Builder	setAds(List<AdData> ads) 设置自定义受众群体投放的初始再营销广告。
CustomAudience.Builder	setBiddingLogicUri(Uri biddingLogicUri) 设置要从中提取出价逻辑以用于广告选择流程的 URI。
CustomAudience.Builder	setBuyer(AdTechIdentifier buyer) 设置买方 AdTechIdentifier。
CustomAudience.Builder	setDailyUpdateUri(Uri dailyUpdateUri) 设置每日更新 URI。
CustomAudience.Builder	setExpirationTime(Instant expirationTime) 设置时间（截断至毫秒），达到该时间后 CustomAudience 应 删除。
CustomAudience.Builder	setName(String name) 设置 CustomAudience 对象的名称。
CustomAudience.Builder	setTrustedBiddingData(TrustedBiddingData trustedBiddingData) 设置要在广告选择流程中查询和使用的可信出价数据。
CustomAudience.Builder	setUserBiddingSignals(AdSelectionSignals userBiddingSignals) 设置在广告选择流程中使用的用户出价信号。

继承的方法

继承自 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() 导致当前线程处于等待状态，直到其被唤醒，这通常是 通知或中断。

公共构造函数

Builder

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

public Builder ()

公共方法

build

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

public CustomAudience build ()

构建 CustomAudience 的实例。

返回
CustomAudience	此值不能为 null。

抛出
NullPointerException	如果任何非 null 参数为 null
IllegalArgumentException	如果到期时间早于激活时间
IllegalArgumentException	如果到期时间设置在当前时间之前

setActivationTime

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

public CustomAudience.Builder setActivationTime (Instant activationTime)

设置时间（截断至毫秒），之后 CustomAudience 将 投放广告。

设置为“null”即可立即激活此“CustomAudience” 以及参与广告选择。

如需了解详情，请参阅 CustomAudience.getActivationTime()。

参数
activationTime	Instant：此值可以为 null。

返回
CustomAudience.Builder

setAds

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

public CustomAudience.Builder setAds (List<AdData> ads)

设置自定义受众群体投放的初始再营销广告。分配的 为空列表。

如需了解详情，请参阅 CustomAudience.getAds()。

参数
ads	List：此值可以为 null。

返回值
CustomAudience.Builder	此值不能为 null。

setBidLogicUri

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

public CustomAudience.Builder setBiddingLogicUri (Uri biddingLogicUri)

设置要从中提取出价逻辑以用于广告选择流程的 URI。URI 必须使用 HTTPS。

如需了解详情，请参阅 CustomAudience.getBiddingLogicUri()。

参数
biddingLogicUri	Uri：此值不能为 null。

返回值
CustomAudience.Builder	此值不能为 null。

setBuyer

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

public CustomAudience.Builder setBuyer (AdTechIdentifier buyer)

设置买方 AdTechIdentifier。

如需了解详情，请参阅 CustomAudience.getBuyer()。

参数
buyer	AdTechIdentifier：此值不能为 null。

返回值
CustomAudience.Builder	此值不能为 null。

setDailyUpdateUri

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

public CustomAudience.Builder setDailyUpdateUri (Uri dailyUpdateUri)

设置每日更新 URI。URI 必须使用 HTTPS。

如需了解详情，请参阅 CustomAudience.getDailyUpdateUri()。

参数
dailyUpdateUri	Uri：此值不能为 null。

返回值
CustomAudience.Builder	此值不能为 null。

setExpirationTime

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

public CustomAudience.Builder setExpirationTime (Instant expirationTime)

设置时间（截断至毫秒），达到该时间后 CustomAudience 应 删除。

如需了解详情，请参阅 CustomAudience.getExpirationTime()。

参数
expirationTime	Instant：此值可以为 null。

返回值
CustomAudience.Builder	此值不能为 null。

setName

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

public CustomAudience.Builder setName (String name)

设置 CustomAudience 对象的名称。

如需了解详情，请参阅 CustomAudience.getName()。

参数
name	String：此值不能为 null。

返回值
CustomAudience.Builder	此值不能为 null。

setTrustedBiddingData

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

public CustomAudience.Builder setTrustedBiddingData (TrustedBiddingData trustedBiddingData)

设置要在广告选择流程中查询和使用的可信出价数据。

如需了解详情，请参阅 CustomAudience.getTrustedBiddingData()。

参数
trustedBiddingData	TrustedBiddingData：此值可以为 null。

返回值
CustomAudience.Builder	此值不能为 null。

setUserBiddingSignals

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

public CustomAudience.Builder setUserBiddingSignals (AdSelectionSignals userBiddingSignals)

设置在广告选择流程中使用的用户出价信号。

如需了解详情，请参阅 CustomAudience.getUserBiddingSignals()。

参数
userBiddingSignals	AdSelectionSignals：此值可以为 null。

返回值
CustomAudience.Builder	此值不能为 null。