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)
  },
  "adGroupInventoryControl": {
    object (AdGroupInventoryControl)
  }
}
Поля
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 и demandGenBid .

entityStatus

enum ( EntityStatus )

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

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

targetingExpansion

object ( TargetingExpansionConfig )

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

productFeedData

object ( ProductFeedData )

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

adGroupInventoryControl

object ( AdGroupInventoryControl )

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

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 Рекламное объявление, отображаемое в верхней части главной страницы YouTube.
AD_GROUP_FORMAT_DEMAND_GEN

Реклама для генерации спроса.

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 )

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

Пользовательская метка

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

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.

AdGroupInventoryControl

Управление запасами рекламной группы.

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

  // Union field inventory_controls can be only one of the following:
  "adGroupInventoryStrategy": enum (AdGroupInventoryStrategy),
  "selectedInventories": {
    object (SelectedInventories)
  }
  // End of list of possible types for union field inventory_controls.
}
Поля
Поле объединения inventory_controls . Элемент управления инвентаризацией группы объявлений. inventory_controls может принимать только одно из следующих значений:
adGroupInventoryStrategy

enum ( AdGroupInventoryStrategy )

Стратегия управления запасами.

selectedInventories

object ( SelectedInventories )

Выбранные запасы.

AdGroupInventoryStrategy

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

Перечисления
AD_GROUP_INVENTORY_STRATEGY_UNSPECIFIED Не указано или неизвестно.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_AND_DISPLAY_NETWORK_INVENTORY Группа пользователей, давших согласие на получение всех рекламных мест в Google и контекстно-медийной сети, включена в рекламную сеть.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_INVENTORY Группа пользователей, давших согласие на получение всей рекламы в Google, соглашается на ее показ.

Выбранные товары

Управление запасами рекламной группы.

JSON-представление 
{
  "allowYoutubeStream": boolean,
  "allowYoutubeShorts": boolean,
  "allowYoutubeFeed": boolean,
  "allowDiscover": boolean,
  "allowGmail": boolean,
  "allowGoogleDisplayNetwork": boolean
}
Поля
allowYoutubeStream

boolean

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

allowYoutubeShorts

boolean

Утверждено ли, что рекламная группа подключилась к рекламному инвентарю YouTube Shorts.

allowYoutubeFeed

boolean

Утверждена ли группа рекламных объявлений для показа рекламы в ленте YouTube.

allowDiscover

boolean

Указывается, включена ли группа объявлений в программу Discover.

allowGmail

boolean

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

allowGoogleDisplayNetwork

boolean

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

Методы

bulkEditAssignedTargetingOptions

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

bulkListAssignedTargetingOptions

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

create

 Создает новую группу объявлений.

delete

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

get

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

list

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

patch

 Обновляет существующую группу объявлений.