REST Resource: advertisers.adGroupAds

Ресурс: AdGroupAd

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

JSON-представление 
{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "adUrls": [
    {
      object (AdUrl)
    }
  ],

  // Union field ad_details can be only one of the following:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  }
  // End of list of possible types for union field ad_details.
}
Поля
name

string

Название ресурса объявления.

advertiserId

string ( int64 format)

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

adGroupAdId

string ( int64 format)

Уникальный идентификатор объявления. Присваивается системой.

adGroupId

string ( int64 format)

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

displayName

string

Отображаемое название объявления.

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

entityStatus

enum ( EntityStatus )

Статус объекта объявления.

adUrls[]

object ( AdUrl )

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

Поле ad_details . Подробная информация об объявлении. ad_details может быть только одним из следующих:
displayVideoSourceAd

object ( DisplayVideoSourceAd )

Подробная информация о рекламе, полученной из креатива Display & Video 360.

mastheadAd

object ( MastheadAd )

Подробная информация о рекламе, размещенной на главной странице YouTube .

inStreamAd

object ( InStreamAd )

Подробная информация о рекламе in-stream, которую можно пропустить через 5 секунд , используемой для повышения узнаваемости бренда или достижения маркетинговых целей.

nonSkippableAd

object ( NonSkippableAd )

Подробная информация о коротком рекламном видеоролике In-Stream без возможности пропуска , продолжительностью от 6 до 15 секунд, используемом для достижения маркетинговых целей.

bumperAd

object ( BumperAd )

Подробная информация о коротком видеоролике без возможности пропуска , продолжительностью не более 6 секунд, используемом для охвата.

audioAd

object ( AudioAd )

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

videoDiscoverAd

object ( VideoDiscoveryAd )

Подробная информация о рекламе видеоролика , демонстрируемого в местах открытий.

videoPerformanceAd

object ( VideoPerformanceAd )

Подробная информация о рекламе, используемой в видеокампании для стимулирования действий в отношении бизнеса, услуги или продукта.

DisplayVideoSourceAd

Реклама взята из креатива DV360.

JSON-представление 
{
  "creativeId": string
}
Поля
creativeId

string ( int64 format)

Идентификатор исходного креатива.

MastheadAd

Подробная информация о рекламном объявлении Masthead.

JSON-представление 
{
  "video": {
    object (YoutubeVideoDetails)
  },
  "headline": string,
  "description": string,
  "videoAspectRatio": enum (VideoAspectRatio),
  "autoplayVideoStartMillisecond": string,
  "autoplayVideoDuration": string,
  "callToActionButtonLabel": string,
  "callToActionFinalUrl": string,
  "callToActionTrackingUrl": string,
  "showChannelArt": boolean,
  "companionYoutubeVideos": [
    {
      object (YoutubeVideoDetails)
    }
  ]
}
Поля
video

object ( YoutubeVideoDetails )

Видео YouTube, использованное в рекламе.

headline

string

Заголовок объявления.

description

string

Описание объявления.

videoAspectRatio

enum ( VideoAspectRatio )

Соотношение сторон автоматически воспроизводимого видео YouTube на Masthead.

autoplayVideoStartMillisecond

string ( int64 format)

Количество времени в миллисекундах, по истечении которого начнется воспроизведение видео.

autoplayVideoDuration

string ( Duration format)

Продолжительность автоматического воспроизведения видео.

Длительность в секундах, содержащая до девяти знаков после запятой, заканчивается на « s ». Пример: "3.5s" .

callToActionButtonLabel

string

Текст на кнопке призыва к действию.

callToActionFinalUrl

string

Целевой URL для кнопки призыва к действию.

callToActionTrackingUrl

string

URL-адрес отслеживания для кнопки призыва к действию.

showChannelArt

boolean

Показывать ли фон или баннер в верхней части страницы YouTube.

companionYoutubeVideos[]

object ( YoutubeVideoDetails )

Видеоролики, которые отображаются рядом с рекламным баннером на компьютере. Может быть не более двух.

YoutubeВидеоПодробности

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

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

string

Идентификатор видео YouTube, который можно найти на веб-странице YouTube.

unavailableReason

enum ( VideoUnavailableReason )

Причина, по которой видеоданные недоступны.

ВидеоНедоступноПричина

Возможные причины, по которым видео может быть недоступно.

Перечисления
VIDEO_UNAVAILABLE_REASON_UNSPECIFIED Неизвестно или не указано.
VIDEO_UNAVAILABLE_REASON_PRIVATE Видео является личным.
VIDEO_UNAVAILABLE_REASON_DELETED Видео удалено.

ВидеоСоотношение сторон

Возможные соотношения сторон видео на YouTube.

Перечисления
VIDEO_ASPECT_RATIO_UNSPECIFIED Не указано или неизвестно.
VIDEO_ASPECT_RATIO_WIDESCREEN Видео растянуто, а верх и низ обрезаны.
VIDEO_ASPECT_RATIO_FIXED_16_9 Видео использует фиксированное соотношение сторон 16:9.

InStreamAd

Подробная информация о рекламе in-stream.

JSON-представление 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
Поля
commonInStreamAttribute

object ( CommonInStreamAttribute )

Общие атрибуты рекламы.

customParameters

map (key: string, value: string)

Пользовательские параметры для передачи пользовательских значений в шаблон URL-адреса отслеживания.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

CommonInStreamAttribute

Общие атрибуты для in-stream, непереключаемых и заставочных объявлений.

JSON-представление 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
Поля
displayUrl

string

Адрес веб-страницы, который отображается вместе с рекламой.

finalUrl

string

URL-адрес веб-страницы, на которую попадают люди после нажатия на рекламу.

trackingUrl

string

URL-адрес загружается в фоновом режиме для отслеживания.

actionButtonLabel

string

Текст на кнопке призыва к действию.

actionHeadline

string

Заголовок баннера с призывом к действию.

video

object ( YoutubeVideoDetails )

Рекламный ролик на YouTube.

companionBanner

object ( ImageAsset )

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

ImageAsset

Метаданные объекта изображения.

JSON-представление 
{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string
}
Поля
mimeType

string

Тип MIME ресурса изображения.

fullSize

object ( Dimensions )

Метаданные для этого изображения в исходном размере.

fileSize

string ( int64 format)

Размер файла изображения в байтах.

NonSkippableAd

Подробная информация о рекламе, которую нельзя пропустить.

JSON-представление 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
Поля
commonInStreamAttribute

object ( CommonInStreamAttribute )

Общие атрибуты рекламы.

customParameters

map (key: string, value: string)

Пользовательские параметры для передачи пользовательских значений в шаблон URL-адреса отслеживания.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

BumperAd

Подробная информация о рекламном объявлении-заставке.

JSON-представление 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}
Поля
commonInStreamAttribute

object ( CommonInStreamAttribute )

Общие атрибуты рекламы.

Аудиореклама

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

JSON-представление 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
Поля
displayUrl

string

Адрес веб-страницы, который отображается вместе с рекламой.

finalUrl

string

URL-адрес веб-страницы, на которую попадают люди после нажатия на рекламу.

trackingUrl

string

URL-адрес загружается в фоновом режиме для отслеживания.

video

object ( YoutubeVideoDetails )

Рекламный ролик на YouTube.

VideoDiscoveryAd

Подробная информация о рекламе Video Discovery.

JSON-представление 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}
Поля
headline

string

Заголовок объявления.

description1

string

Первая текстовая строка объявления.

description2

string

Вторая текстовая строка объявления.

video

object ( YoutubeVideoDetails )

Видео на YouTube, которое продвигает реклама.

thumbnail

enum ( Thumbnail )

Миниатюрное изображение, использованное в рекламе.

Миниатюра

Возможные варианты миниатюр в Video Discovery Ads.

Перечисления
THUMBNAIL_UNSPECIFIED Неизвестно или не указано.
THUMBNAIL_DEFAULT Миниатюра по умолчанию может быть создана автоматически или загружена пользователем.
THUMBNAIL_1 Миниатюра 1, созданная на основе видео.
THUMBNAIL_2 Миниатюра 2, созданная на основе видео.
THUMBNAIL_3 Миниатюра 3, созданная на основе видео.

VideoPerformanceAd

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

JSON-представление 
{
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabels": [
    string
  ],
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "domain": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanners": [
    {
      object (ImageAsset)
    }
  ]
}
Поля
finalUrl

string

URL-адрес веб-страницы, на которую попадают люди после нажатия на рекламу.

trackingUrl

string

URL-адрес загружается в фоновом режиме для отслеживания.

actionButtonLabels[]

string

Список текстовых ресурсов, отображаемых на кнопке призыва к действию.

headlines[]

string

Список заголовков, показанных на баннере с призывом к действию.

longHeadlines[]

string

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

descriptions[]

string

Список описаний, показанных на баннере с призывом к действию.

displayUrlBreadcrumb1

string

Первая часть после домена в отображаемом URL.

displayUrlBreadcrumb2

string

Вторая часть после домена в отображаемом URL.

domain

string

Домен отображаемого URL.

videos[]

object ( YoutubeVideoDetails )

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

customParameters

map (key: string, value: string)

Пользовательские параметры для передачи пользовательских значений в шаблон URL-адреса отслеживания.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

companionBanners[]

object ( ImageAsset )

Список сопутствующих баннеров, используемых в этом объявлении.

AdUrl

Дополнительные URL-адреса, связанные с рекламой, включая маяки.

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

enum ( AdUrlType )

Тип URL-адреса объявления.

url

string

Строковое значение URL.

AdUrlType

Возможные типы URL-адресов объявлений.

Перечисления
AD_URL_TYPE_UNSPECIFIED Неизвестно или не указано.
AD_URL_TYPE_BEACON_IMPRESSION Пиксель отслеживания размером 1x1, отправляющий сигнал при показе креатива.
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION Расширяемый маяк-отпечаток DCM. Во время обслуживания он расширяется до нескольких маяков.
AD_URL_TYPE_BEACON_CLICK URL-адрес отслеживания для отправки ping-запроса при срабатывании события клика.
AD_URL_TYPE_BEACON_SKIP URL-адрес отслеживания для отправки ping-запроса при срабатывании события пропуска.

Методы

get

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

list

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