此页面由 Cloud Translation API 翻译。

AbstractAdRequestBuilder

Kotlin |Java

public abstract class AbstractAdRequestBuilder<T extends AbstractAdRequestBuilder<T>>

已知的直接子类

`AdManagerAdRequest.Builder`	构建 `AdManagerAdRequest`。
`AdRequest.Builder`	构建 `AdRequest`。

用于帮助构建广告请求的基准构建器类。

摘要

公共方法
`T`	`@CanIgnoreReturnValue addCustomEventExtrasBundle( Class<CustomEvent> adapterClass, Bundle customEventExtras )` 此方法已废弃。请改用 `addNetworkExtrasBundle`。
`T`	`@CanIgnoreReturnValue addCustomTargeting(String key, String value)` 添加自定义定位参数。
`T`	`@CanIgnoreReturnValue addCustomTargeting(String key, List<String> values)` 添加具有多个值的自定义定位参数。
`T`	`@CanIgnoreReturnValue addKeyword(String keyword)` 添加用于定位的关键字。
`T`	`@CanIgnoreReturnValue addNetworkExtrasBundle( Class<MediationExtrasReceiver> adapterClass, Bundle networkExtras )` 添加要传递给特定广告联盟适配器的额外参数。
`T`	`@CanIgnoreReturnValue setAdString(String adString)` 设置表示广告响应的广告字符串。
`T`	`@CanIgnoreReturnValue setContentUrl(String contentUrl)` 为内容与应用的主要内容相符的网站设置内容网址。
`T`	`@CanIgnoreReturnValue setHttpTimeoutMillis(int httpTimeoutMillis)` 为 Google 移动广告 SDK 在广告请求期间发出的 HTTPS 调用设置自定义超时。
`T`	`@CanIgnoreReturnValue setNeighboringContentUrls(List<String> neighboringContentUrls)` 设置代表广告附近网络内容的网址。
`T`	`@CanIgnoreReturnValue setRequestAgent(String requestAgent)` 设置请求代理字符串，以标识广告请求的来源。

受保护的方法
`abstract T`	`self()` 返回指定子类型的 self 实例。

@CanIgnoreReturnValue
public T addCustomEventExtrasBundle(
    Class<CustomEvent> adapterClass,
    Bundle customEventExtras
)

添加要传递给特定自定义事件适配器的额外参数。

参数
`Class<CustomEvent> adapterClass`	您要为其提供 extra 的自定义事件适配器的 `Class`。
`Bundle customEventExtras`	要传递给自定义事件适配器的额外信息的 `Bundle`。

@CanIgnoreReturnValue
public T addCustomTargeting(String key, String value)

添加自定义定位参数。如果使用相同的键再次调用此方法，则会覆盖旧值。

@CanIgnoreReturnValue
public T addCustomTargeting(String key, List<String> values)

添加包含多个值的自定义定位参数。如果使用相同的键再次调用此方法，则会覆盖旧值。

@CanIgnoreReturnValue
public T addKeyword(String keyword)

添加用于定位的关键字。

@CanIgnoreReturnValue
public T addNetworkExtrasBundle(
    Class<MediationExtrasReceiver> adapterClass,
    Bundle networkExtras
)

添加要传递给特定广告联盟适配器的额外参数。

参数
`Class<MediationExtrasReceiver> adapterClass`	应接收 extra 的适配器的 `Class`。
`Bundle networkExtras`	要传递给中介适配器的额外信息的 `Bundle`。

@CanIgnoreReturnValue
public T setAdString(String adString)

设置表示广告响应的广告字符串。如果设置了此属性，SDK 将呈现此广告，并忽略在此请求中设置的所有其他定位信息。

@CanIgnoreReturnValue
public T setContentUrl(String contentUrl)

为内容与应用的主要内容匹配的网站设置内容网址。此网站内容用于定位和品牌保障目的。

抛出
`java.lang.NullPointerException`	如果 contentUrl 为 {code null}。
`java.lang.IllegalArgumentException`	如果 contentUrl 为空，或者其长度超过 512。

@CanIgnoreReturnValue
public T setHttpTimeoutMillis(int httpTimeoutMillis)

为 Google 移动广告 SDK 在广告请求期间发出的 HTTPS 调用设置自定义超时。

如果您的应用使用中介功能，此超时设置不适用于第三方广告联盟 SDK 进行的网络调用。

参数
`int httpTimeoutMillis`	一个整数，用于指定 HTTPS 超时（以毫秒为单位）。低于 `5000`（5 秒）的任何值都将被忽略。默认值为 `60000`（60 秒）。

@CanIgnoreReturnValue
public T setNeighboringContentUrls(List<String> neighboringContentUrls)

设置代表广告附近网络内容的网址。提升品牌保障能力，并允许展示的广告具有更适合相邻内容的应用级分级（MA、T、PG 等）。

参数
`List<String> neighboringContentUrls`	要附加到现有相邻内容网址的相邻内容网址列表。

@CanIgnoreReturnValue
public T setRequestAgent(String requestAgent)

设置请求代理字符串，以标识广告请求的来源。引用移动广告 SDK 的第三方库应调用此方法，以指明广告请求的来源平台。例如，如果名为“CoolAds 广告联盟”的第三方广告联盟负责中介向移动广告 SDK 发出的请求，则应使用“CoolAds”调用此方法。

protected abstract T self()

返回指定子类型的 self 实例。