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

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

advertiser Id

string ( int64 format)

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

ad Group Id

string ( int64 format)

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

line Item Id

string ( int64 format)

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

display Name

string

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

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

ad Group Format

enum ( AdGroupFormat )

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

bid Strategy

object ( BiddingStrategy )

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

entity Status

enum ( EntityStatus )

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

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

targeting Expansion

object ( TargetingExpansionConfig )

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

product Feed Data

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
}
Поля
product Match Type

enum ( ProductMatchType )

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

product Match Dimensions[]

object ( ProductMatchDimension )

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

is Feed Disabled

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 может быть только одной из следующих:
product Offer Id

string

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

custom Label

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.

Методы

bulk List Ad Group Assigned Targeting Options

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

get

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

list

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