REST Resource: advertisers.adGroups

Ресурс: AdGroup

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

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 )

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

AdGroupFormat

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

Перечисления
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 Потоковая реклама без возможности пропуска.
AD_GROUP_FORMAT_AUDIO Потоковая аудиореклама без возможности пропуска.
AD_GROUP_FORMAT_RESPONSIVE Адаптивные объявления.
AD_GROUP_FORMAT_REACH Эффективные группы объявлений , включая потоковые и баннерные объявления.
AD_GROUP_FORMAT_MASTHEAD Рекламный баннер Masthead, который отображается в верхней части главной страницы YouTube.

ProductFeedData

Подробная информация о продукте.

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

enum ( ProductMatchType )

Как выбираются продукты с помощью фида продуктов.

productMatchDimensions[]

object ( ProductMatchDimension )

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

isFeedDisabled

boolean

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

ProductMatchType

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

Перечисления
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

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