Google Mobile Ads SDK находится в режиме технического обслуживания. Для получения последних обновлений и новых функций выполните миграцию и настройку GMA Next-Gen SDK .

Эта страница переведена с помощью Cloud Translation API.

AbstractAdRequestBuilder

Kotlin | Java

abstract class AbstractAdRequestBuilder<T : AbstractAdRequestBuilder<T!>?>

Известные прямые подклассы: AdManagerAdRequest.Builder , AdRequest.Builder

`AdManagerAdRequest.Builder`	Создает объект `AdManagerAdRequest` .
`AdRequest.Builder`	Создаёт `AdRequest` .

Базовый класс-конструктор, помогающий формировать запросы на показ рекламы.

Краткое содержание

Общественные функции
`T!`	`@ CanIgnoreReturnValue addCustomEventExtrasBundle ( adapterClass: Class < CustomEvent !>!, customEventExtras: Bundle ! )` Эта функция устарела. Вместо этого используйте `addNetworkExtrasBundle` .
`T!`	`@ CanIgnoreReturnValue addCustomTargeting (key: String !, value: String !)` Добавляет пользовательский параметр таргетинга.
`T!`	`@ CanIgnoreReturnValue addCustomTargeting (key: String !, values: ( Mutable ) List < String !>!)` Добавляет пользовательский параметр таргетинга с несколькими значениями.
`T!`	`@ CanIgnoreReturnValue addKeyword (keyword: String !)` Добавляет ключевое слово для целей таргетинга.
`T!`	`@ CanIgnoreReturnValue addNetworkExtrasBundle ( adapterClass: Class < MediationExtrasReceiver !>!, networkExtras: Bundle ! )` Добавляет дополнительные параметры для передачи конкретному адаптеру рекламной сети.
`T!`	`@ CanIgnoreReturnValue setAdString (adString: String !)` Задает текстовую строку объявления, представляющую собой ответ на объявление.
`T!`	`@ CanIgnoreReturnValue setContentUrl (contentUrl: String !)` Задает URL-адрес контента для веб-сайта, контент которого соответствует основному контенту приложения.
`T!`	`@ CanIgnoreReturnValue setHttpTimeoutMillis (httpTimeoutMillis: Int )` Устанавливает настраиваемый тайм-аут для HTTPS-запросов, выполняемых SDK Google Mobile Ads во время запроса рекламы.
`T!`	`@ CanIgnoreReturnValue setNeighboringContentUrls ( neighboringContentUrls: ( Mutable ) List < String !>! )` Задает URL-адреса, представляющие веб-контент, расположенный рядом с рекламным объявлением.
`T!`	`@ CanIgnoreReturnValue setPlacementId (placementId: Long )` Устанавливает идентификатор места размещения по умолчанию для загруженного объявления.
`T!`	`@ CanIgnoreReturnValue setRequestAgent (requestAgent: String !)` Задает строку агента запроса для идентификации источника запроса на рекламу.

Защищенные функции
`abstract T!`	`self ()` Возвращает экземпляр указанного подтипа.

Общественные функции

addCustomEventExtrasBundle

@CanIgnoreReturnValue
fun addCustomEventExtrasBundle(
    adapterClass: Class<CustomEvent!>!,
    customEventExtras: Bundle!
): T!

Добавляет дополнительные параметры для передачи в конкретный пользовательский адаптер событий.

Параметры
`adapterClass: Class < CustomEvent !>!`	`Class` пользовательского адаптера событий, для которого вы предоставляете дополнительные возможности.
`customEventExtras: Bundle !`	`Bundle` дополнительной информации для передачи в пользовательский адаптер событий.

addCustomTargeting

@CanIgnoreReturnValue
fun addCustomTargeting(key: String!, value: String!): T!

Добавляет пользовательский параметр таргетинга. Повторный вызов с тем же ключом перезапишет старые значения.

addCustomTargeting

@CanIgnoreReturnValue
fun addCustomTargeting(key: String!, values: (Mutable)List<String!>!): T!

Добавляет пользовательский параметр таргетинга с несколькими значениями. Повторный вызов с тем же ключом перезапишет старые значения.

addKeyword

@CanIgnoreReturnValue
fun addKeyword(keyword: String!): T!

Добавляет ключевое слово для целей таргетинга.

addNetworkExtrasBundle

@CanIgnoreReturnValue
fun addNetworkExtrasBundle(
    adapterClass: Class<MediationExtrasReceiver!>!,
    networkExtras: Bundle!
): T!

Добавляет дополнительные параметры для передачи конкретному адаптеру рекламной сети.

Параметры
`adapterClass: Class < MediationExtrasReceiver !>!`	`Class` адаптера, для которого следует приобрести дополнительные аксессуары.
`networkExtras: Bundle !`	`Bundle` дополнительной информации для передачи адаптеру медиации.

setAdString

@CanIgnoreReturnValue
fun setAdString(adString: String!): T!

Задает рекламную строку, представляющую собой ответ на объявление. Если задано, SDK отобразит это объявление и проигнорирует всю остальную информацию о таргетинге, указанную в этом запросе.

setContentUrl

@CanIgnoreReturnValue
fun setContentUrl(contentUrl: String!): T!

Задает URL-адрес контента для веб-сайта, содержимое которого соответствует основному содержимому приложения. Содержимое этого веб-сайта используется в целях таргетинга и обеспечения безопасности бренда.

Броски
`java.lang.NullPointerException`	Если contentUrl равен {code null}.
`java.lang.IllegalArgumentException`	Если contentUrl пуст или его длина превышает 512.

setHttpTimeoutMillis

@CanIgnoreReturnValue
fun setHttpTimeoutMillis(httpTimeoutMillis: Int): T!

Устанавливает настраиваемый тайм-аут для HTTPS-запросов, выполняемых SDK Google Mobile Ads во время запроса рекламы.

Если ваше приложение использует посредничество, этот тайм-аут не распространяется на сетевые вызовы, выполняемые сторонними SDK рекламных сетей.

Параметры
`httpTimeoutMillis: Int`	Целое число, указывающее время ожидания HTTPS в миллисекундах. Значения меньше `5000` (5 секунд) будут проигнорированы. Значение по умолчанию — `60000` (60 секунд).

setNeighboringContentUrls

@CanIgnoreReturnValue
fun setNeighboringContentUrls(
    neighboringContentUrls: (Mutable)List<String!>!
): T!

Задает URL-адреса веб-контента, расположенного рядом с рекламой. Способствует повышению безопасности бренда и позволяет присваивать отображаемой рекламе рейтинг уровня приложения (MA, T, PG и т. д.), более соответствующий соседнему контенту.

Параметры
`neighboringContentUrls: ( Mutable ) List < String !>!`	Список соседних URL-адресов контента, которые будут добавлены к существующим соседним URL-адресам контента.

setPlacementId

@CanIgnoreReturnValue
fun setPlacementId(placementId: Long): T!

Устанавливает идентификатор места размещения по умолчанию для загруженного объявления.

Для баннерной рекламы рекомендуется использовать setPlacementId . Вызов loadAd с запросом, устанавливающим идентификатор размещения, имеет тот же эффект, что и вызов setPlacementId

Параметры
`placementId: Long`	Длинное целое число, предоставляемое пользовательским интерфейсом AdMob для настроенного размещения.

setRequestAgent

@CanIgnoreReturnValue
fun setRequestAgent(requestAgent: String!): T!

Устанавливает строку агента запроса для идентификации источника запроса рекламы. Сторонние библиотеки, которые ссылаются на SDK мобильной рекламы, должны вызывать этот метод, чтобы указать платформу, с которой поступил запрос рекламы. Например, если сторонняя рекламная сеть под названием "CoolAds network" выступает посредником в запросах к SDK мобильной рекламы, она должна вызывать этот метод с параметром "CoolAds".

Защищенные функции

себя

protected abstract fun self(): T!

Возвращает экземпляр указанного подтипа.