REST Resource: advertisers.youtubeAdGroupAds

{
  "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.
}

string

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

string ( int64 format)

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

string ( int64 format)

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

string ( int64 format)

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

string

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

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

enum ( EntityStatus )

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

object ( AdUrl )

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

object ( DisplayVideoSourceAd )

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

object ( MastheadAd )

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

object ( InStreamAd )

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

object ( NonSkippableAd )

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

object ( BumperAd )

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

object ( AudioAd )

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

object ( VideoDiscoveryAd )

Подробности объявления, продвигающего видео , которое показывается в местах открытия.

object ( VideoPerformanceAd )

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

{
  "creativeId": string
}

string ( int64 format)

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

{
  "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)
    }
  ]
}

object ( YoutubeVideoDetails )

Видео YouTube, используемое в объявлении.

string

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

string

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

enum ( VideoAspectRatio )

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

string ( int64 format)

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

string ( Duration format)

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

Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « s ». Пример: "3.5s" .

string

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

string

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

string

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

boolean

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

object ( YoutubeVideoDetails )

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

{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason)
}

string

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

enum ( VideoUnavailableReason )

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

{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}

object ( CommonInStreamAttribute )

Общие атрибуты объявления.

map (key: string, value: string)

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

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

{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}

string

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

string

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

string

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

string

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

string

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

object ( YoutubeVideoDetails )

Рекламное видео на YouTube.

object ( ImageAsset )

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

{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string
}

string

MIME-тип изображения.

object ( Dimensions )

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

string ( int64 format)

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

{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}

object ( CommonInStreamAttribute )

Общие атрибуты объявления.

map (key: string, value: string)

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

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

{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}

object ( CommonInStreamAttribute )

Общие атрибуты объявления.

{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}

string

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

string

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

string

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

object ( YoutubeVideoDetails )

Рекламное видео на YouTube.

{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}

string

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

string

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

string

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

object ( YoutubeVideoDetails )

Видео YouTube, рекламируемое в объявлении.

enum ( Thumbnail )

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

{
  "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)
    }
  ]
}

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

object ( YoutubeVideoDetails )

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

map (key: string, value: string)

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

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

object ( ImageAsset )

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

{
  "type": enum (AdUrlType),
  "url": string
}

enum ( AdUrlType )

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

string

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