Ad

Реклама.

JSON-представление 
{
  "resourceName": string,
  "finalUrls": [
    string
  ],
  "finalAppUrls": [
    {
      object (FinalAppUrl)
    }
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "type": enum (AdType),
  "devicePreference": enum (Device),
  "urlCollections": [
    {
      object (UrlCollection)
    }
  ],
  "systemManagedResourceSource": enum (SystemManagedResourceSource),
  "id": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "displayUrl": string,
  "addedByGoogleAds": boolean,
  "name": string,

  // Union field ad_data can be only one of the following:
  "textAd": {
    object (TextAdInfo)
  },
  "expandedTextAd": {
    object (ExpandedTextAdInfo)
  },
  "callAd": {
    object (CallAdInfo)
  },
  "expandedDynamicSearchAd": {
    object (ExpandedDynamicSearchAdInfo)
  },
  "hotelAd": {
    object (HotelAdInfo)
  },
  "shoppingSmartAd": {
    object (ShoppingSmartAdInfo)
  },
  "shoppingProductAd": {
    object (ShoppingProductAdInfo)
  },
  "imageAd": {
    object (ImageAdInfo)
  },
  "videoAd": {
    object (VideoAdInfo)
  },
  "videoResponsiveAd": {
    object (VideoResponsiveAdInfo)
  },
  "responsiveSearchAd": {
    object (ResponsiveSearchAdInfo)
  },
  "legacyResponsiveDisplayAd": {
    object (LegacyResponsiveDisplayAdInfo)
  },
  "appAd": {
    object (AppAdInfo)
  },
  "legacyAppInstallAd": {
    object (LegacyAppInstallAdInfo)
  },
  "responsiveDisplayAd": {
    object (ResponsiveDisplayAdInfo)
  },
  "localAd": {
    object (LocalAdInfo)
  },
  "displayUploadAd": {
    object (DisplayUploadAdInfo)
  },
  "appEngagementAd": {
    object (AppEngagementAdInfo)
  },
  "shoppingComparisonListingAd": {
    object (ShoppingComparisonListingAdInfo)
  },
  "smartCampaignAd": {
    object (SmartCampaignAdInfo)
  },
  "appPreRegistrationAd": {
    object (AppPreRegistrationAdInfo)
  },
  "demandGenMultiAssetAd": {
    object (DemandGenMultiAssetAdInfo)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAdInfo)
  },
  "demandGenVideoResponsiveAd": {
    object (DemandGenVideoResponsiveAdInfo)
  },
  "demandGenProductAd": {
    object (DemandGenProductAdInfo)
  },
  "travelAd": {
    object (TravelAdInfo)
  }
  // End of list of possible types for union field ad_data.
}
Поля
resourceName

string

Неизменяемый. Имя ресурса объявления. Имена рекламных ресурсов имеют вид:

customers/{customerId}/ads/{ad_id}

finalUrls[]

string

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

finalAppUrls[]

object ( FinalAppUrl )

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

finalMobileUrls[]

string

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

urlCustomParameters[]

object ( CustomParameter )

Список сопоставлений, которые можно использовать для замены тегов пользовательских параметров в trackingUrlTemplate , finalUrls или mobile_final_urls . Для изменения используйте операции с пользовательскими параметрами URL.

type

enum ( AdType )

Только вывод. Тип объявления.

devicePreference

enum ( Device )

Предпочтение устройства для объявления. Вы можете указать предпочтения только для мобильных устройств. Если этот параметр установлен, реклама будет иметь преимущество перед другими объявлениями при отображении на мобильном устройстве. Объявление по-прежнему может отображаться на устройствах других типов, например, если другие объявления недоступны. Если не указано (нет предпочтений устройства), целевыми будут все устройства. Это поддерживается только некоторыми типами объявлений.

urlCollections[]

object ( UrlCollection )

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

systemManagedResourceSource

enum ( SystemManagedResourceSource )

Только вывод. Если это объявление управляется системой, то в этом поле будет указан источник. Это поле доступно только для чтения.

id

string ( int64 format)

Только вывод. Идентификатор объявления.

trackingUrlTemplate

string

Шаблон URL-адреса для создания URL-адреса отслеживания.

finalUrlSuffix

string

Суффикс, используемый при создании конечного URL.

displayUrl

string

URL-адрес, который отображается в описании объявления для некоторых форматов объявлений.

addedByGoogleAds

boolean

Только вывод. Указывает, было ли это объявление добавлено автоматически Google Рекламой, а не пользователем. Например, это может произойти, когда объявления автоматически создаются в качестве предложений для новых объявлений на основе данных об эффективности существующих объявлений.

name

string

Неизменяемый. Название объявления. Это используется только для идентификации объявления. Он не обязательно должен быть уникальным и не влияет на отображаемое объявление. Поле имени в настоящее время поддерживается только для DisplayUploadAd, ImageAd, ShoppingComparisonListingAd и VideoAd.

Поле объединения ad_data . Подробности, относящиеся к типу объявления. Должно быть установлено ровно одно значение. ad_data может быть только одним из следующих:
textAd

object ( TextAdInfo )

Неизменяемый. Подробности, относящиеся к текстовому объявлению.

expandedTextAd

object ( ExpandedTextAdInfo )

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

callAd

object ( CallAdInfo )

Подробности, относящиеся к объявлению с номером телефона.

expandedDynamicSearchAd

object ( ExpandedDynamicSearchAdInfo )

Неизменяемый. Подробная информация о расширенном динамическом поисковом объявлении. Заголовок этого типа объявления, конечные URL-адреса и отображаемый URL-адрес автоматически генерируются во время показа в соответствии с конкретной информацией о доменном имени, предоставленной dynamicSearchAdsSetting , связанной на уровне кампании.

hotelAd

object ( HotelAdInfo )

Подробности, относящиеся к рекламе отеля.

shoppingSmartAd

object ( ShoppingSmartAdInfo )

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

shoppingProductAd

object ( ShoppingProductAdInfo )

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

imageAd

object ( ImageAdInfo )

Неизменяемый. Подробности, относящиеся к графическому объявлению.

videoAd

object ( VideoAdInfo )

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

videoResponsiveAd

object ( VideoResponsiveAdInfo )

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

responsiveSearchAd

object ( ResponsiveSearchAdInfo )

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

legacyResponsiveDisplayAd

object ( LegacyResponsiveDisplayAdInfo )

Подробная информация о устаревшем адаптивном медийном объявлении.

appAd

object ( AppAdInfo )

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

legacyAppInstallAd

object ( LegacyAppInstallAdInfo )

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

responsiveDisplayAd

object ( ResponsiveDisplayAdInfo )

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

localAd

object ( LocalAdInfo )

Подробности, относящиеся к местному объявлению.

displayUploadAd

object ( DisplayUploadAdInfo )

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

appEngagementAd

object ( AppEngagementAdInfo )

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

shoppingComparisonListingAd

object ( ShoppingComparisonListingAdInfo )

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

smartCampaignAd

object ( SmartCampaignAdInfo )

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

appPreRegistrationAd

object ( AppPreRegistrationAdInfo )

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

demandGenMultiAssetAd

object ( DemandGenMultiAssetAdInfo )

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

demandGenVideoResponsiveAd

object ( DemandGenVideoResponsiveAdInfo )

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

demandGenProductAd

object ( DemandGenProductAdInfo )

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

travelAd

object ( TravelAdInfo )

Подробности, относящиеся к туристической рекламе.

Финалапурл

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

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

enum ( AppUrlOperatingSystemType )

Операционная система, на которую нацелен этот URL-адрес. Необходимый.

url

string

URL-адрес глубокой ссылки приложения. Глубокие ссылки указывают местоположение в приложении, соответствующее содержимому, которое вы хотите показать, и должны иметь вид {scheme}://{host_path}. Схема определяет, какое приложение открывать. Для своего приложения вы можете использовать собственную схему, которая начинается с имени приложения. Хост и путь указывают уникальное местоположение в приложении, где находится ваш контент. Пример: «exampleapp://productid_1234». Необходимый.

AppUrlOperatingSystemType

Операционная система

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
IOS Операционная система Apple IOS.
ANDROID Операционная система Андроид.

Тип объявления

Возможные типы объявления.

Перечисления
UNSPECIFIED Значение не указано.
UNKNOWN

Полученное значение в этой версии неизвестно.

Это значение только для ответа.

TEXT_AD Рекламное объявление представляет собой текстовое объявление.
EXPANDED_TEXT_AD Это развернутое текстовое объявление.
EXPANDED_DYNAMIC_SEARCH_AD Это расширенное динамическое поисковое объявление.
HOTEL_AD Реклама представляет собой рекламу отеля.
SHOPPING_SMART_AD Это умное товарное объявление.
SHOPPING_PRODUCT_AD Это стандартное товарное объявление.
VIDEO_AD Реклама представляет собой видеорекламу.
IMAGE_AD Это объявление является графическим.
RESPONSIVE_SEARCH_AD Это адаптивное поисковое объявление.
LEGACY_RESPONSIVE_DISPLAY_AD Это устаревшее адаптивное медийное объявление.
APP_AD Это реклама приложения.
LEGACY_APP_INSTALL_AD Это устаревшее объявление, ориентированное на установку приложения.
RESPONSIVE_DISPLAY_AD Это адаптивное медийное объявление.
LOCAL_AD Это местное объявление.
HTML5_UPLOAD_AD Это медийное объявление с загрузкой и типом продукта HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD Это медийное объявление с загрузкой и содержит один из типов продуктов DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD Это объявление ориентировано на взаимодействие с приложением.
SHOPPING_COMPARISON_LISTING_AD Это объявление представляет собой объявление для сравнения цен.
VIDEO_BUMPER_AD Видеореклама-заставка.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Видеореклама In-Stream без возможности пропуска.
VIDEO_TRUEVIEW_IN_STREAM_AD Видеореклама TrueView In-Stream.
VIDEO_RESPONSIVE_AD Адаптивная видеореклама.
SMART_CAMPAIGN_AD Умная рекламная кампания.
CALL_AD Звонок по объявлению.
APP_PRE_REGISTRATION_AD Универсальное объявление о предварительной регистрации приложения.
IN_FEED_VIDEO_AD Видеообъявление в ленте.
DEMAND_GEN_MULTI_ASSET_AD Мультиобъектное объявление, создающее спрос.
TRAVEL_AD Реклама путешествия.
DEMAND_GEN_VIDEO_RESPONSIVE_AD Адаптивное видеообъявление, создающее спрос.
DEMAND_GEN_PRODUCT_AD Реклама продукта, создающая спрос.

URL-коллекция

Коллекция URL-адресов, помеченных уникальным идентификатором.

JSON-представление 
{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}
Поля
finalUrls[]

string

Список возможных конечных URL.

finalMobileUrls[]

string

Список возможных конечных мобильных URL-адресов.

urlCollectionId

string

Уникальный идентификатор этого экземпляра UrlCollection.

trackingUrlTemplate

string

Шаблон URL-адреса для создания URL-адреса отслеживания.

Системманажересурцесаурце

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

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
AD_VARIATIONS Экспериментальное объявление созданных вариантов объявлений.

ТекстАдИнфо

Текстовое объявление.

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

string

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

description1

string

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

description2

string

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

ExpandedTextAdInfo

Развернутое текстовое объявление.

JSON-представление 
{
  "headlinePart1": string,
  "headlinePart2": string,
  "headlinePart3": string,
  "description": string,
  "description2": string,
  "path1": string,
  "path2": string
}
Поля
headlinePart1

string

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

headlinePart2

string

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

headlinePart3

string

Третья часть заголовка объявления.

description

string

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

description2

string

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

path1

string

Текст, который может отображаться рядом с отображаемым URL-адресом объявления.

path2

string

Дополнительный текст, который может отображаться рядом с отображаемым URL-адресом объявления.

КаллАдИнфо

Объявление о звонке.

JSON-представление 
{
  "countryCode": string,
  "phoneNumber": string,
  "businessName": string,
  "headline1": string,
  "headline2": string,
  "description1": string,
  "description2": string,
  "callTracked": boolean,
  "disableCallConversion": boolean,
  "phoneNumberVerificationUrl": string,
  "conversionAction": string,
  "conversionReportingState": enum (CallConversionReportingState),
  "path1": string,
  "path2": string
}
Поля
countryCode

string

Код страны в объявлении.

phoneNumber

string

Телефон в объявлении.

businessName

string

Название компании в объявлении.

headline1

string

Первый заголовок в объявлении.

headline2

string

Второй заголовок в объявлении.

description1

string

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

description2

string

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

callTracked

boolean

Включить ли отслеживание звонков для креатива. Включение отслеживания звонков также обеспечивает конверсию звонков.

disableCallConversion

boolean

Следует ли отключить конверсию звонков для креатива. Если установлено значение true , преобразование вызовов отключается, даже если callTracked равно true . Если callTracked имеет значение false , это поле игнорируется.

phoneNumberVerificationUrl

string

URL-адрес, который будет использоваться для проверки номера телефона.

conversionAction

string

Действие-конверсия, которому будет присвоен звонок-конверсия. Если этот параметр не установлен, используется действие-конверсия по умолчанию. Это поле действует только в том случае, если для callTracked установлено значение true . В противном случае это поле игнорируется.

conversionReportingState

enum ( CallConversionReportingState )

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

path1

string

Первая часть текста, которую можно добавить к URL в объявлении. Необязательный.

path2

string

Вторая часть текста, которую можно добавить к URL в объявлении. Это поле можно задать только в том случае, если также задан path1 . Необязательный.

ExpandedDynamicSearchAdInfo

Расширенное динамическое поисковое объявление.

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

string

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

description2

string

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

Информация об отеле

Этот тип не имеет полей.

Реклама отеля.

ПокупкиSmartAdИнформация

Этот тип не имеет полей.

Умная товарная реклама.

ПокупкиПродуктРекламаИнформация

Этот тип не имеет полей.

Стандартное товарное объявление.

ИзображениеAdInfo

Имиджевое объявление.

JSON-представление 
{
  "mimeType": enum (MimeType),
  "pixelWidth": string,
  "pixelHeight": string,
  "imageUrl": string,
  "previewPixelWidth": string,
  "previewPixelHeight": string,
  "previewImageUrl": string,
  "name": string,

  // Union field image can be only one of the following:
  "imageAsset": {
    object (AdImageAsset)
  },
  "data": string,
  "adIdToCopyImageFrom": string
  // End of list of possible types for union field image.
}
Поля
mimeType

enum ( MimeType )

Мимический тип изображения.

pixelWidth

string ( int64 format)

Ширина полноразмерного изображения в пикселях.

pixelHeight

string ( int64 format)

Высота полноразмерного изображения в пикселях.

imageUrl

string

URL полноразмерного изображения.

previewPixelWidth

string ( int64 format)

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

previewPixelHeight

string ( int64 format)

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

previewImageUrl

string

URL-адрес изображения размера предварительного просмотра.

name

string

Название изображения. Если изображение было создано из MediaFile, это имя MediaFile. Если изображение было создано из байтов, оно пусто.

image поля объединения. Изображение, на основе которого создается имиджевое объявление. Это можно указать одним из двух способов. 1. Существующий ресурс MediaFile. 2. Необработанные данные изображения в байтах. image может быть только одним из следующих:
imageAsset

object ( AdImageAsset )

Ресурсы изображений, используемые для объявления.

data

string ( bytes format)

Необработанные данные изображения в байтах.

Строка в кодировке Base64.

adIdToCopyImageFrom

string ( int64 format)

Идентификатор объявления, из которого нужно скопировать изображение.

AdImageAsset

Ресурс изображения, используемый в объявлении.

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

string

Имя ресурса ресурса этого изображения.

ВидеоРекламаИнформация

Видеореклама.

JSON-представление 
{
  "video": {
    object (AdVideoAsset)
  },

  // Union field format can be only one of the following:
  "inStream": {
    object (VideoTrueViewInStreamAdInfo)
  },
  "bumper": {
    object (VideoBumperInStreamAdInfo)
  },
  "outStream": {
    object (VideoOutstreamAdInfo)
  },
  "nonSkippable": {
    object (VideoNonSkippableInStreamAdInfo)
  },
  "inFeed": {
    object (InFeedVideoAdInfo)
  }
  // End of list of possible types for union field format.
}
Поля
video

object ( AdVideoAsset )

Видеоресурсы YouTube, используемые для рекламы.

format поля объединения. Схема, специфичная для разных форматов видео. format может быть только одним из следующих:
inStream

object ( VideoTrueViewInStreamAdInfo )

Формат видеорекламы TrueView In-Stream.

bumper

object ( VideoBumperInStreamAdInfo )

Формат объявлений In-Stream с видеозаставками.

outStream

object ( VideoOutstreamAdInfo )

Формат видеорекламы Out-Stream.

nonSkippable

object ( VideoNonSkippableInStreamAdInfo )

Формат видеорекламы In-Stream без возможности пропуска.

inFeed

object ( InFeedVideoAdInfo )

Формат видеорекламы в ленте.

ОбъявлениеВидеоАссет

Видеоресурс, используемый в рекламе.

JSON-представление 
{
  "asset": string,
  "adVideoAssetInfo": {
    object (AdVideoAssetInfo)
  }
}
Поля
asset

string

Имя ресурса ресурса этого видео.

adVideoAssetInfo

object ( AdVideoAssetInfo )

Содержит информационные поля для этого AdVideoAsset.

AdVideoAssetInfo

Содержит информационные поля для AdVideoAssets.

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

object ( AdVideoAssetInventoryPreferences )

Список настроек инвентаря для этого AdVideoAsset. Это поле можно задать только для DiscoveryVideoResponsiveAd. Видеоресурсы с установленными предпочтениями ресурсов инвентаря будут иметь преимущество перед другими видео из того же объявления во время показа. Например, предположим, что это объявление показывается для определенного ресурса. Сервер сначала попытается сопоставить подходящее видео с предпочтениями соответствия для этого инвентаря. Видео без предпочтений выбираются только в том случае, если можно найти видео с совпадающими предпочтениями, подходящее для данного рекламного места.

AdVideoAssetInventoryPreferences

Настройки инвентаря видеообъектов YouTube.

JSON-представление 
{
  "inFeedPreference": boolean,
  "inStreamPreference": boolean,
  "shortsPreference": boolean
}
Поля
inFeedPreference

boolean

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

inStreamPreference

boolean

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

shortsPreference

boolean

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

ВидеоTrueViewInStreamAdInfo

Представление формата видеорекламы TrueView In-Stream (реклама, показываемая во время воспроизведения видео, часто в начале, с кнопкой пропуска через несколько секунд после начала видео).

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

string

Надпись на кнопке CTA (призыв к действию), направляющая пользователя на конечный URL-адрес видеообъявления. Требуется для кампаний TrueView for Action, в противном случае необязательно.

actionHeadline

string

Дополнительный текст, отображаемый вместе с кнопкой CTA (призыв к действию), дает контекст и побуждает нажать на кнопку.

companionBanner

object ( AdImageAsset )

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

ВидеоБамперИнStreamAdInfo

Представление формата рекламы In-Stream с видеозаставками (очень короткое видеообъявление In-Stream без возможности пропуска).

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

object ( AdImageAsset )

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

actionButtonLabel

string

Ярлык на кнопке «Призыв к действию» направляет пользователя на конечный URL видеообъявления.

actionHeadline

string

Дополнительный текст, отображаемый вместе с кнопкой CTA (призыв к действию), дает контекст и побуждает нажать на кнопку.

ВидеоOutstreamAdInfo

Представление формата видеорекламы Out-Stream (реклама, показываемая рядом с фидом с автоматическим воспроизведением, без звука).

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

string

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

description

string

Строка описания.

ВидеоNonSkippableInStreamAdInfo

Представление формата видеорекламы In-Stream без возможности пропуска (15-секундная видеореклама In-Stream без возможности пропуска).

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

object ( AdImageAsset )

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

actionButtonLabel

string

Ярлык на кнопке «Призыв к действию» направляет пользователя на конечный URL видеообъявления.

actionHeadline

string

Дополнительный текст, отображаемый вместе с кнопкой «Призыв к действию», дает контекст и побуждает нажать на кнопку.

InFeedVideoAdИнформация

Представление формата видеорекламы в ленте.

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

string

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

description1

string

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

description2

string

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

thumbnail

enum ( VideoThumbnail )

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

ВидеоМиниатюра

Перечисление, перечисляющее возможные типы миниатюр видео.

Перечисления
UNSPECIFIED Тип не указан.
UNKNOWN Полученное значение в этой версии неизвестно. Это значение только для ответа.
DEFAULT_THUMBNAIL Миниатюра по умолчанию. Может быть создано автоматически или загружено пользователем.
THUMBNAIL_1 Миниатюра 1, созданная на основе видео.
THUMBNAIL_2 Миниатюра 2, созданная на основе видео.
THUMBNAIL_3 Миниатюра 3, созданная на основе видео.

ВидеоАдаптивноеОбъявлениеИнформация

Адаптивная видеореклама.

JSON-представление 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}
Поля
headlines[]

object ( AdTextAsset )

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

longHeadlines[]

object ( AdTextAsset )

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

descriptions[]

object ( AdTextAsset )

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

callToActions[]

object ( AdTextAsset )

Список текстовых ресурсов, используемых для кнопки, например кнопка «Призыв к действию». В настоящее время поддерживается только одно значение для кнопки.

videos[]

object ( AdVideoAsset )

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

companionBanners[]

object ( AdImageAsset )

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

breadcrumb1

string

Первая часть текста, которая появляется в объявлении с отображаемым URL.

breadcrumb2

string

Вторая часть текста, появляющаяся в объявлении с отображаемым URL.

АдаптивныйПоискИнформация об объявлении

Адаптивное поисковое объявление.

Адаптивные поисковые объявления позволяют создавать объявления, которые адаптируются так, чтобы показывать вашим клиентам больше текста и более релевантные сообщения. Введите несколько заголовков и описаний при создании адаптивного поискового объявления, и со временем Google Реклама автоматически протестирует различные комбинации и определит, какие комбинации работают лучше всего. Адаптивные поисковые объявления могут повысить эффективность вашей кампании, адаптируя содержание вашего объявления так, чтобы оно более точно соответствовало поисковым запросам потенциальных клиентов.

Дополнительную информацию можно найти на странице https://support.google.com/google-ads/answer/7684791.

JSON-представление 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}
Поля
headlines[]

object ( AdTextAsset )

Список текстовых ресурсов для заголовков. При показе объявления заголовки будут выбраны из этого списка.

descriptions[]

object ( AdTextAsset )

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

path1

string

Первая часть текста, которую можно добавить к URL в объявлении.

path2

string

Вторая часть текста, которую можно добавить к URL в объявлении. Это поле можно задать только в том случае, если также задан path1 .

LegacyАдаптивныйDisplayAdInfo

Устаревшее адаптивное медийное объявление. Объявления этого типа помечены как «Адаптивные объявления» в интерфейсе Google Рекламы.

JSON-представление 
{
  "formatSetting": enum (DisplayAdFormatSetting),
  "shortHeadline": string,
  "longHeadline": string,
  "description": string,
  "businessName": string,
  "allowFlexibleColor": boolean,
  "accentColor": string,
  "mainColor": string,
  "callToActionText": string,
  "logoImage": string,
  "squareLogoImage": string,
  "marketingImage": string,
  "squareMarketingImage": string,
  "pricePrefix": string,
  "promoText": string
}
Поля
formatSetting

enum ( DisplayAdFormatSetting )

Указывает, в каком формате будет показываться объявление. Значение по умолчанию — ALL_FORMATS.

shortHeadline

string

Краткая версия заголовка объявления.

longHeadline

string

Длинная версия заголовка объявления.

description

string

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

businessName

string

Название компании в объявлении.

allowFlexibleColor

boolean

Согласие рекламодателя разрешить гибкий цвет. Если это правда, при необходимости объявление может отображаться в другом цвете. Если установлено значение false, объявление будет отображаться с указанными цветами или нейтральным цветом. Значение по умолчанию — true . Должно быть истинно, если mainColor и accentColor не установлены.

accentColor

string

Акцентный цвет объявления в шестнадцатеричном формате, например #ffffff для белого. Если установлен один из mainColor и accentColor , требуется также другой.

mainColor

string

Основной цвет объявления в шестнадцатеричном формате, например #ffffff — белый. Если установлен один из mainColor и accentColor , требуется также другой.

callToActionText

string

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

logoImage

string

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

squareLogoImage

string

Имя ресурса MediaFile квадратного логотипа, используемого в объявлении.

marketingImage

string

Имя ресурса MediaFile маркетингового изображения, используемого в объявлении.

squareMarketingImage

string

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

pricePrefix

string

Префикс перед ценой. Например, «всего лишь».

promoText

string

Рекламный текст, используемый для динамических форматов адаптивных объявлений. Например, «Бесплатная двухдневная доставка».

Параметр DisplayAdFormatSetting

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

Перечисления
UNSPECIFIED Не указан.
UNKNOWN В этой версии значение неизвестно.
ALL_FORMATS Текст, изображения и собственные форматы.
NON_NATIVE Текстовые и графические форматы.
NATIVE Например, собственный формат: рендеринг формата контролируется издателем, а не Google.

AppAdInfo

Реклама приложения.

JSON-представление 
{
  "mandatoryAdText": {
    object (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ],
  "appDeepLink": {
    object (AdAppDeepLinkAsset)
  }
}
Поля
mandatoryAdText

object ( AdTextAsset )

Обязательный текст объявления.

headlines[]

object ( AdTextAsset )

Список текстовых ресурсов для заголовков. При показе объявления заголовки будут выбраны из этого списка.

descriptions[]

object ( AdTextAsset )

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

images[]

object ( AdImageAsset )

Список графических ресурсов, которые могут отображаться вместе с объявлением.

youtubeVideos[]

object ( AdVideoAsset )

Список видеоресурсов YouTube, которые могут отображаться вместе с рекламой.

html5MediaBundles[]

object ( AdMediaBundleAsset )

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

AdMediaBundleAsset

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

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

string

Имя ресурса актива этого медиа-пакета.

AdAppDeepLinkAsset

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

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

string

Имя ресурса ресурса этой ссылки на контент приложения.

LegacyAppInstallAdInfo

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

JSON-представление 
{
  "appStore": enum (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}
Поля
appStore

enum ( LegacyAppInstallAdAppStore )

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

appId

string

Идентификатор мобильного приложения.

headline

string

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

description1

string

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

description2

string

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

LegacyAppInstallAdAppStore

Тип магазина приложений в устаревшем объявлении, ориентированном на установку приложения.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
APPLE_APP_STORE Apple Айтюнс.
GOOGLE_PLAY Гугл Плей.
WINDOWS_STORE Магазин Windows.
WINDOWS_PHONE_STORE Магазин Windows Phone.
CN_APP_STORE Приложение размещено в китайском магазине приложений.

АдаптивныйDisplayAdInfo

Адаптивное медийное объявление.

JSON-представление 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareLogoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadline": {
    object (AdTextAsset)
  },
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "formatSetting": enum (DisplayAdFormatSetting),
  "controlSpec": {
    object (ResponsiveDisplayAdControlSpec)
  },
  "businessName": string,
  "mainColor": string,
  "accentColor": string,
  "allowFlexibleColor": boolean,
  "callToActionText": string,
  "pricePrefix": string,
  "promoText": string
}
Поля
marketingImages[]

object ( AdImageAsset )

Маркетинговые изображения для использования в рекламе. Допустимые типы изображений: GIF, JPEG и PNG. Минимальный размер — 600x314, соотношение сторон — 1,91:1 (+-1%). Требуется хотя бы одно marketingImage . В сочетании с squareMarketingImages максимальное значение равно 15.

squareMarketingImages[]

object ( AdImageAsset )

Квадратные маркетинговые изображения для использования в рекламе. Допустимые типы изображений: GIF, JPEG и PNG. Минимальный размер — 300x300, соотношение сторон — 1:1 (+-1%). Требуется хотя бы одно квадратное marketingImage . В сочетании с marketingImages максимальное количество — 15.

logoImages[]

object ( AdImageAsset )

Изображения логотипов, которые будут использоваться в рекламе. Допустимые типы изображений: GIF, JPEG и PNG. Минимальный размер — 512x128, соотношение сторон — 4:1 (+-1%). В сочетании с squareLogoImages максимальное значение равно 5.

squareLogoImages[]

object ( AdImageAsset )

Квадратные изображения логотипов, которые будут использоваться в объявлении. Допустимые типы изображений: GIF, JPEG и PNG. Минимальный размер — 128x128, соотношение сторон — 1:1 (+-1%). В сочетании с logoImages максимальное значение равно 5.

headlines[]

object ( AdTextAsset )

Короткие заголовки объявления. Максимальная длина — 30 символов. Можно указать от 1 до 5 заголовков.

longHeadline

object ( AdTextAsset )

Обязательный длинный заголовок. Максимальная длина — 90 символов.

descriptions[]

object ( AdTextAsset )

Описательные тексты к объявлению. Максимальная длина — 90 символов. Можно указать от 1 до 5 заголовков.

youtubeVideos[]

object ( AdVideoAsset )

Дополнительные видеоролики на YouTube для рекламы. Можно указать максимум 5 видео.

formatSetting

enum ( DisplayAdFormatSetting )

Указывает, в каком формате будет показываться объявление. Значение по умолчанию — ALL_FORMATS.

controlSpec

object ( ResponsiveDisplayAdControlSpec )

Спецификация для различных творческих элементов управления.

businessName

string

Рекламодатель/торговая марка. Максимальная ширина дисплея — 25.

mainColor

string

Основной цвет объявления в шестнадцатеричном формате, например #ffffff — белый. Если установлен один из mainColor и accentColor , требуется также другой.

accentColor

string

Акцентный цвет объявления в шестнадцатеричном формате, например #ffffff для белого. Если установлен один из mainColor и accentColor , требуется также другой.

allowFlexibleColor

boolean

Согласие рекламодателя разрешить гибкий цвет. Если это правда, при необходимости объявление может отображаться в другом цвете. Если установлено значение false, объявление будет отображаться с указанными цветами или нейтральным цветом. Значение по умолчанию — true . Должно быть истинно, если mainColor и accentColor не установлены.

callToActionText

string

Текст призыва к действию для объявления. Максимальная ширина дисплея — 30.

pricePrefix

string

Префикс перед ценой. Например, «всего лишь».

promoText

string

Рекламный текст, используемый для динамических форматов адаптивных объявлений. Например, «Бесплатная двухдневная доставка».

АдаптивныйDisplayAdControlSpec

Спецификация различных элементов управления креативом для адаптивного медийного объявления.

JSON-представление 
{
  "enableAssetEnhancements": boolean,
  "enableAutogenVideo": boolean
}
Поля
enableAssetEnhancements

boolean

Включил ли рекламодатель функцию улучшения объектов.

enableAutogenVideo

boolean

Включил ли рекламодатель функцию автоматического создания видео.

ЛокалАдИнфо

Местное объявление.

JSON-представление 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}
Поля
headlines[]

object ( AdTextAsset )

Список текстовых ресурсов для заголовков. При показе объявления заголовки будут выбраны из этого списка. Необходимо указать не менее 1 и не более 5 заголовков.

descriptions[]

object ( AdTextAsset )

Список текстовых ресурсов для описаний. При показе объявления описания будут выбраны из этого списка. Необходимо указать минимум 1 и максимум 5 описаний.

callToActions[]

object ( AdTextAsset )

Список текстовых ресурсов для призыва к действию. При показе объявления призыв к действию будет выбран из этого списка. Необходимо указать не менее 1 и не более 5 призывов к действию.

marketingImages[]

object ( AdImageAsset )

Список маркетинговых изображений, которые могут отображаться вместе с объявлением. Изображения должны быть размером 314x600 пикселей или 320x320 пикселей. Необходимо указать от 1 до 20 изображений.

logoImages[]

object ( AdImageAsset )

Список изображений логотипа, которые могут отображаться в объявлении. Изображения должны быть размером 128x128 пикселей и не более 120 КБ. Необходимо указать не менее 1 и не более 5 изображений.

videos[]

object ( AdVideoAsset )

Список видеоресурсов YouTube, которые могут отображаться вместе с рекламой. Необходимо указать от 1 до 20 видеообъектов.

path1

string

Первая часть необязательного текста, который можно добавить к URL в объявлении.

path2

string

Вторая часть необязательного текста, который можно добавить к URL в объявлении. Это поле можно задать только в том случае, если также задан path1 .

DisplayUploadAdInfo

Общий тип медийного объявления. Точный формат объявления определяется полем displayUploadProductType , которое определяет, какие данные необходимо включить в объявление.

JSON-представление 
{
  "displayUploadProductType": enum (DisplayUploadProductType),

  // Union field media_asset can be only one of the following:
  "mediaBundle": {
    object (AdMediaBundleAsset)
  }
  // End of list of possible types for union field media_asset.
}
Поля
displayUploadProductType

enum ( DisplayUploadProductType )

Тип продукта этого объявления. Подробности смотрите в комментариях к перечислению.

Поле объединения media_asset . Данные об объекте, из которого состоит объявление. media_asset может быть только одним из следующих:
mediaBundle

object ( AdMediaBundleAsset )

Ресурс медиапакета, который будет использоваться в объявлении. Информацию о пакете мультимедиа для HTML5_UPLOAD_AD см. в статье https://support.google.com/google-ads/answer/1722096 . Пакеты мультимедиа, являющиеся частью динамических типов продуктов, используют специальный формат, который необходимо создать с помощью Google Web Designer. Дополнительную информацию см. на странице https://support.google.com/webdesigner/answer/7543898 .

DisplayUploadProductType

Перечисляет типы продуктов для загрузки дисплея.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN В этой версии значение неизвестно.
HTML5_UPLOAD_AD Объявление с загрузкой HTML5. Для этого типа продукта необходимо задать поле upload_media_bundle в DisplayUploadAdInfo.
DYNAMIC_HTML5_EDUCATION_AD Динамическое образовательное объявление HTML5. Для этого типа продукта необходимо задать поле upload_media_bundle в DisplayUploadAdInfo. Можно использовать только в образовательной кампании.
DYNAMIC_HTML5_FLIGHT_AD Динамическое рекламное объявление HTML5. Для этого типа продукта необходимо задать поле upload_media_bundle в DisplayUploadAdInfo. Можно использовать только в полетной кампании.
DYNAMIC_HTML5_HOTEL_RENTAL_AD Динамическое HTML5-объявление об отеле и аренде. Для этого типа продукта необходимо задать поле upload_media_bundle в DisplayUploadAdInfo. Можно использовать только в гостиничной кампании.
DYNAMIC_HTML5_JOB_AD Динамическое объявление о работе в формате HTML5. Для этого типа продукта необходимо задать поле upload_media_bundle в DisplayUploadAdInfo. Можно использовать только в кампании по трудоустройству.
DYNAMIC_HTML5_LOCAL_AD Динамическое локальное объявление HTML5. Для этого типа продукта необходимо задать поле upload_media_bundle в DisplayUploadAdInfo. Можно использовать только в локальной кампании.
DYNAMIC_HTML5_REAL_ESTATE_AD Динамическое объявление недвижимости в формате HTML5. Для этого типа продукта необходимо задать поле upload_media_bundle в DisplayUploadAdInfo. Может использоваться только в кампании по недвижимости.
DYNAMIC_HTML5_CUSTOM_AD Динамическое пользовательское объявление HTML5. Для этого типа продукта необходимо задать поле upload_media_bundle в DisplayUploadAdInfo. Можно использовать только в собственной кампании.
DYNAMIC_HTML5_TRAVEL_AD Динамическое туристическое объявление HTML5. Для этого типа продукта необходимо задать поле upload_media_bundle в DisplayUploadAdInfo. Можно использовать только в туристической кампании.
DYNAMIC_HTML5_HOTEL_AD Динамическое объявление гостиницы в формате HTML5. Для этого типа продукта необходимо задать поле upload_media_bundle в DisplayUploadAdInfo. Можно использовать только в гостиничной кампании.

AppEngagementAdInfo

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

JSON-представление 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}
Поля
headlines[]

object ( AdTextAsset )

Список текстовых ресурсов для заголовков. При показе объявления заголовки будут выбраны из этого списка.

descriptions[]

object ( AdTextAsset )

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

images[]

object ( AdImageAsset )

Список графических ресурсов, которые могут отображаться вместе с объявлением.

videos[]

object ( AdVideoAsset )

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

ПокупкиСравнениеИнформация об объявлении

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

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

string

Заголовок объявления. Это поле обязательно к заполнению. Допустимая длина — от 25 до 45 символов.

AppPreRegistrationAdInfo

Объявления о предварительной регистрации приложения ссылаются на ваше приложение или игру в Google Play и могут показываться в Google Play, на YouTube (только In-Stream), а также в других приложениях и мобильных веб-сайтах в контекстно-медийной сети. Это поможет привлечь интерес людей к вашему приложению или игре и создать базу для ранних установок вашего приложения или игры перед запуском.

JSON-представление 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}
Поля
headlines[]

object ( AdTextAsset )

Список текстовых ресурсов для заголовков. При показе объявления заголовки будут выбраны из этого списка.

descriptions[]

object ( AdTextAsset )

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

images[]

object ( AdImageAsset )

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

youtubeVideos[]

object ( AdVideoAsset )

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

СпросGenMultiAssetAdInfo

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

JSON-представление 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "tallPortraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}
Поля
marketingImages[]

object ( AdImageAsset )

Ресурсы маркетингового изображения, которые будут использоваться в объявлении. Допустимые типы изображений: GIF, JPEG и PNG. Минимальный размер — 600x314, соотношение сторон — 1,91:1 (+-1%). Требуется, если SquareMarketingImages отсутствует. В сочетании с squareMarketingImages , portraitMarketingImages и tallPortraitMarketingImages максимальное значение равно 20.

squareMarketingImages[]

object ( AdImageAsset )

Квадратные маркетинговые изображения, которые будут использоваться в объявлении. Допустимые типы изображений: GIF, JPEG и PNG. Минимальный размер — 300x300, соотношение сторон — 1:1 (+-1%). Требуется, если маркетинговые изображения отсутствуют. В сочетании с marketingImages , portraitMarketingImages и tallPortraitMarketingImages максимальное значение равно 20.

portraitMarketingImages[]

object ( AdImageAsset )

Портретные маркетинговые изображения, которые будут использоваться в объявлении. Допустимые типы изображений: GIF, JPEG и PNG. Минимальный размер — 480x600, соотношение сторон — 4:5 (+-1%). В сочетании с marketingImages , squareMarketingImages и tallPortraitMarketingImages максимальное значение равно 20.

tallPortraitMarketingImages[]

object ( AdImageAsset )

Маркетинговые изображения с высоким портретом, которые будут использоваться в объявлении. Допустимые типы изображений: GIF, JPEG и PNG. Минимальный размер — 600x1067, соотношение сторон — 9:16 (+-1%). В сочетании с marketingImages , squareMarketingImages и portraitMarketingImages максимальное значение равно 20.

logoImages[]

object ( AdImageAsset )

Ресурсы изображения логотипа, которые будут использоваться в объявлении. Допустимые типы изображений: GIF, JPEG и PNG. Минимальный размер — 128x128, соотношение сторон — 1:1 (+-1%). Можно указать от 1 до 5 изображений логотипа.

headlines[]

object ( AdTextAsset )

Текст заголовка объявления. Максимальная ширина отображения — 30. Можно указать от 1 до 5 заголовков.

descriptions[]

object ( AdTextAsset )

Описательный текст объявления. Максимальная ширина отображения — 90. Можно указать от 1 до 5 описаний.

businessName

string

Рекламодатель/торговая марка. Максимальная ширина дисплея — 25. Обязательно.

callToActionText

string

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

leadFormOnly

boolean

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

СпросГенКарусельРекламаИнформация

Реклама-карусель для формирования спроса.

JSON-представление 
{
  "businessName": string,
  "logoImage": {
    object (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDemandGenCarouselCardAsset)
    }
  ]
}
Поля
businessName

string

Необходимый. Рекламодатель/торговая марка.

logoImage

object ( AdImageAsset )

Необходимый. Изображение логотипа, которое будет использоваться в объявлении. Минимальный размер — 128x128, соотношение сторон — 1:1 (+-1%).

headline

object ( AdTextAsset )

Необходимый. Заголовок объявления.

description

object ( AdTextAsset )

Необходимый. Описательный текст объявления.

callToActionText

string

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

carouselCards[]

object ( AdDemandGenCarouselCardAsset )

Необходимый. Карточки-карусели, которые будут отображаться вместе с рекламой. Мин 2 максимум 10.

ОбъявлениеСпросГенКарусельКартаАктив

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

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

string

Имя ресурса актива этой карточки карусели обнаружения.

Генерация спросаВидеоАдаптивноеОбъявлениеИнформация

Адаптивная видеореклама, создающая спрос.

JSON-представление 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "callToActions": [
    {
      object (AdCallToActionAsset)
    }
  ]
}
Поля
headlines[]

object ( AdTextAsset )

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

longHeadlines[]

object ( AdTextAsset )

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

descriptions[]

object ( AdTextAsset )

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

videos[]

object ( AdVideoAsset )

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

logoImages[]

object ( AdImageAsset )

Изображение логотипа, которое будет использоваться в объявлении. Допустимые типы изображений: GIF, JPEG и PNG. Минимальный размер — 128x128, соотношение сторон — 1:1 (+-1%).

breadcrumb1

string

Первая часть текста, которая появляется в объявлении с отображаемым URL.

breadcrumb2

string

Вторая часть текста, появляющаяся в объявлении с отображаемым URL.

businessName

object ( AdTextAsset )

Необходимый. Рекламодатель/торговая марка.

callToActions[]

object ( AdCallToActionAsset )

Ресурсы типа CallToActionAsset, используемые для кнопки «Призыв к действию».

Адкаллтоэкшнассет

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

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

string

Имя ресурса актива этого актива призыва к действию.

СпросGenProductAdInfo

Реклама продукта, создающая спрос.

JSON-представление 
{
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "logoImage": {
    object (AdImageAsset)
  },
  "callToAction": {
    object (AdCallToActionAsset)
  }
}
Поля
breadcrumb1

string

Первая часть текста, которая появляется в объявлении с отображаемым URL.

breadcrumb2

string

Вторая часть текста, появляющаяся в объявлении с отображаемым URL.

businessName

object ( AdTextAsset )

Необходимый. Рекламодатель/торговая марка.

headline

object ( AdTextAsset )

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

description

object ( AdTextAsset )

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

logoImage

object ( AdImageAsset )

Необходимый. Изображение логотипа, которое будет использоваться в объявлении. Допустимые типы изображений: GIF, JPEG и PNG. Минимальный размер — 128x128, соотношение сторон — 1:1 (+-1%).

callToAction

object ( AdCallToActionAsset )

Актив типа CallToActionAsset, используемый для кнопки «Призыв к действию».

ПутешествиеAdInfo

Этот тип не имеет полей.

Туристическая реклама.