REST Resource: advertisers.youtubeAdGroups

Ресурс: YoutubeAdGroup

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

JSON-представление
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "youtubeAdIds": [
    string
  ],
  "adGroupFormat": enum (YoutubeAndPartnersAdGroupFormat),
  "biddingStrategy": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "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 байт.

youtubeAdIds[]

string ( int64 format)

Идентификаторы ресурсов [youtube_ad_group_ad][], связанных с группой объявлений.

adGroupFormat

enum ( YoutubeAndPartnersAdGroupFormat )

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

biddingStrategy

object ( YoutubeAndPartnersBiddingStrategy )

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

entityStatus

enum ( EntityStatus )

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

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

targetingExpansion

object ( TargetingExpansionConfig )

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

Эта конфигурация применима только в том случае, если группе объявлений назначен таргетинг на список подходящей аудитории.

productFeedData

object ( ProductFeedData )

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

YoutubeAndPartnersAdGroupFormat

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

Перечисления
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_UNSPECIFIED Значение формата не указано или неизвестно в этой версии.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM Потоковая реклама.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_VIDEO_DISCOVERY Реклама в ленте.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_BUMPER Рекламные заставки.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM Объявления In-Stream без возможности пропуска.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_AUDIO Аудиообъявления In-Stream без возможности пропуска.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_ACTION Адаптивные объявления для кампаний Video Action .
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_REACH Эффективные группы объявлений для охвата , включая объявления In-Stream и объявления-заставки.
YOUTUBE_AND_PARTNERS_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

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

get

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

list

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