REST Resource: advertisers.adGroups

Ресурс: Группа объявлений

Отдельная группа объявлений, связанная с позицией.

JSON-представление
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "adGroupFormat": enum (AdGroupFormat),
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "entityStatus": enum (EntityStatus),
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "productFeedData": {
    object (ProductFeedData)
  }
}
Поля
name

string

Имя ресурса группы объявлений.

advertiserId

string ( int64 format)

Уникальный идентификатор рекламодателя, которому принадлежит группа объявлений.

adGroupId

string ( int64 format)

Уникальный идентификатор группы объявлений. Назначается системой.

lineItemId

string ( int64 format)

Уникальный идентификатор позиции, к которой принадлежит группа объявлений.

displayName

string

Отображаемое название группы объявлений.

Должен быть в кодировке UTF-8 с максимальным размером 255 байт.

adGroupFormat

enum ( AdGroupFormat )

Формат объявлений в группе объявлений.

bidStrategy

object ( BiddingStrategy )

Стратегия назначения ставок, используемая в группе объявлений. В стратегии назначения ставок можно использовать только поле youtubeAndPartnersBid .

entityStatus

enum ( EntityStatus )

Определяет, может ли группа объявлений расходовать свой бюджет и делать ставки на инвентарь.

Если родительская позиция группы объявлений неактивна, группа объявлений не сможет расходовать свой бюджет, даже если ее собственный статус — ENTITY_STATUS_ACTIVE .

targetingExpansion

object ( TargetingExpansionConfig )

Оптимизированные настройки таргетинга группы объявлений.

productFeedData

object ( ProductFeedData )

Настройки фида товаров в этой группе объявлений.

Формат группы объявлений

Формат группы объявлений.

Перечисления
AD_GROUP_FORMAT_UNSPECIFIED Значение формата не указано или неизвестно в этой версии.
AD_GROUP_FORMAT_IN_STREAM Потоковая реклама.
AD_GROUP_FORMAT_VIDEO_DISCOVERY Реклама в ленте.
AD_GROUP_FORMAT_BUMPER Рекламные заставки.
AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM Объявления In-Stream без возможности пропуска.
AD_GROUP_FORMAT_AUDIO Аудиообъявления In-Stream без возможности пропуска.
AD_GROUP_FORMAT_RESPONSIVE Адаптивная реклама.
AD_GROUP_FORMAT_REACH Группы объявлений с эффективным охватом , включая объявления In-Stream и объявления-заставки.
AD_GROUP_FORMAT_MASTHEAD Объявление в шапке, которое отображается в верхней части главной страницы YouTube.

ProductFeedData

Подробная информация о товарном фиде.

JSON-представление
{
  "productMatchType": enum (ProductMatchType),
  "productMatchDimensions": [
    {
      object (ProductMatchDimension)
    }
  ],
  "isFeedDisabled": boolean
}
Поля
productMatchType

enum ( ProductMatchType )

Как товары выбираются в фиде товаров.

productMatchDimensions[]

object ( ProductMatchDimension )

Список размеров, используемых для сопоставления продуктов.

isFeedDisabled

boolean

Отключен ли в фиде товаров показ товаров.

Тип соответствия продукта

Виды способов сопоставления товаров.

Перечисления
PRODUCT_MATCH_TYPE_UNSPECIFIED Не указано или неизвестно.
PRODUCT_MATCH_TYPE_ALL_PRODUCTS Все товары совпадают.
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS Выбираются конкретные продукты.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL Сопоставляйте продукты по их индивидуальным этикеткам.

ProductMatchDimension

Параметр, используемый для сопоставления продуктов.

JSON-представление
{

  // Union field dimension can be only one of the following:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of list of possible types for union field dimension.
}
Поля
dimension поля объединения. Размерность и значение, по которым сопоставляется продукт. dimension может быть только одной из следующих:
productOfferId

string

Идентификатор предложения продукта, который соответствует продукту с тем же идентификатором предложения.

customLabel

object ( CustomLabel )

Пользовательская этикетка, соответствующая всем продуктам с этой этикеткой.

CustomLabel

Ключ и значение пользовательской метки.

JSON-представление
{
  "key": enum (CustomLabelKey),
  "value": string
}
Поля
key

enum ( CustomLabelKey )

Ключ этикетки.

value

string

Стоимость этикетки.

CustomLabelKey

Ключ пользовательской этикетки

Перечисления
CUSTOM_LABEL_KEY_UNSPECIFIED Не указано или неизвестно.
CUSTOM_LABEL_KEY_0 Ключевой индекс 0.
CUSTOM_LABEL_KEY_1 Ключевой индекс 1.
CUSTOM_LABEL_KEY_2 Ключевой индекс 2.
CUSTOM_LABEL_KEY_3 Ключевой индекс 3.
CUSTOM_LABEL_KEY_4 Ключевой индекс 4.

Методы

bulkListAdGroupAssignedTargetingOptions

Перечисляет назначенные параметры таргетинга для нескольких групп объявлений по типам таргетинга.

get

Получает группу объявлений.

list

Перечисляет группы объявлений.