REST Resource: customers.ads

Финалапурл

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 Операционная система Андроид.

Пользовательский параметр

Сопоставление, которое может использоваться тегами пользовательских параметров в trackingUrlTemplate , finalUrls или mobile_final_urls .

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

string

Ключ, соответствующий имени тега параметра.

value

string

Значение, подлежащее замене.

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

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

Перечисления
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_OUTSTREAM_AD Видеообъявление Out-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 Видеообъявление в ленте.
DISCOVERY_MULTI_ASSET_AD Объявление Discovery с несколькими объектами.
TRAVEL_AD Реклама путешествия.
DISCOVERY_VIDEO_RESPONSIVE_AD Адаптивное видеообъявление Discovery.

Устройство

Перечисляет устройства Google Рекламы, доступные для таргетинга.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN В этой версии значение неизвестно.
MOBILE Мобильные устройства с полнофункциональными браузерами.
TABLET Планшеты с полнофункциональными браузерами.
DESKTOP Компьютеры.
CONNECTED_TV Смарт-телевизоры и игровые приставки.
OTHER Другие типы устройств.

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 . Необязательный.

Коллконверсиярепортингстате

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

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
DISABLED Действие-конверсия по телефону отключено.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION В действии-конверсии «Звонок» будет использоваться тип конверсии «Звонок», установленный на уровне аккаунта.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION В действии-конверсии «Звонок» будет использоваться тип конверсии «Звонок», заданный на уровне ресурса (объявления только с номером телефона/расширения).

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:
  "mediaFile": string,
  "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 может быть только одним из следующих:
mediaFile

string

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

data

string ( bytes format)

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

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

adIdToCopyImageFrom

string ( int64 format)

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

Миметип

Тип мима

Перечисления
UNSPECIFIED Тип mime не указан.
UNKNOWN

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

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

IMAGE_JPEG MIME-тип изображения/jpeg.
IMAGE_GIF MIME-тип изображения/гифа.
IMAGE_PNG MIME-тип изображения/png.
FLASH MIME-тип приложения/x-shockwave-flash.
TEXT_HTML MIME-тип текста/html.
PDF MIME-тип приложения/pdf.
MSWORD MIME-тип приложения/мсворда.
MSEXCEL MIME-тип приложения/vnd.ms-excel.
RTF MIME-тип приложения/rtf.
AUDIO_WAV MIME-тип аудио/wav.
AUDIO_MP3 MIME-тип аудио/mp3.
HTML5_AD_ZIP MIME-тип приложения/x-html5-ad-zip.

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

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

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
}
Поля
asset

string

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

Видео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 )

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

AdImageAsset

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

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

string

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

ВидеоБамперИн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.

AdTextAsset

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

JSON-представление
{
  "pinnedField": enum (ServedAssetFieldType),
  "assetPerformanceLabel": enum (AssetPerformanceLabel),
  "policySummaryInfo": {
    object (AdAssetPolicySummary)
  },
  "text": string
}
Поля
pinnedField

enum ( ServedAssetFieldType )

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

assetPerformanceLabel

enum ( AssetPerformanceLabel )

Ярлык эффективности этого текстового объекта.

policySummaryInfo

object ( AdAssetPolicySummary )

Сводная информация о политике этого текстового актива.

text

string

Текст актива.

Обслуживаемыйассетфилдтипе

Возможные типы полей актива.

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

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

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

HEADLINE_1 Актив используется в заголовке 1.
HEADLINE_2 Актив используется в заголовке 2.
HEADLINE_3 Актив используется в заголовке 3.
DESCRIPTION_1 Актив используется в описании 1.
DESCRIPTION_2 Актив используется в описании 2.
CALL Этот актив используется как звонок.
MOBILE_APP Этот ресурс используется как мобильное приложение.
CALLOUT Этот объект используется в качестве выноски.
STRUCTURED_SNIPPET Этот ресурс используется как структурированный фрагмент.
PRICE Этот актив используется в качестве цены.
PROMOTION Этот актив используется в качестве рекламной акции.
AD_IMAGE Этот ресурс используется в качестве изображения.
LEAD_FORM Актив используется в качестве формы для потенциальных клиентов.

Метка производительности актива

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

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
PENDING Для этого объекта еще нет информации о производительности. Возможно, это связано с тем, что он все еще находится на рассмотрении.
LEARNING Объект начал получать показы, но статистика недостаточно статистически значима, чтобы получить оценку эффективности объекта.
LOW Худшие активы.
GOOD Хорошие эксплуатационные активы.
BEST Наиболее эффективные активы.

Сводная информация по политике AdAssetPolicy

Содержит информацию о политике для объекта внутри объявления.

JSON-представление
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
Поля
policyTopicEntries[]

object ( PolicyTopicEntry )

Список результатов политики для этого актива.

reviewStatus

enum ( PolicyReviewStatus )

На каком этапе процесса проверки находится этот актив.

approvalStatus

enum ( PolicyApprovalStatus )

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

ПолитикаТемаЗапись

Вывод о политике, прикрепленный к ресурсу (например, политика в отношении алкоголя, связанная с сайтом, на котором продается алкоголь).

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

JSON-представление
{
  "type": enum (PolicyTopicEntryType),
  "evidences": [
    {
      object (PolicyTopicEvidence)
    }
  ],
  "constraints": [
    {
      object (PolicyTopicConstraint)
    }
  ],
  "topic": string
}
Поля
type

enum ( PolicyTopicEntryType )

Описывает негативное или положительное влияние этой политики на обслуживание.

evidences[]

object ( PolicyTopicEvidence )

Дополнительная информация, объясняющая обнаружение политики (например, название бренда для обнаружения товарного знака).

constraints[]

object ( PolicyTopicConstraint )

Указывает, как это может повлиять на обслуживание этого ресурса (например, отсутствие обслуживания в какой-либо стране).

topic

string

Политическая тема, к которой относится этот вывод. Например, «АЛКОГОЛЬ», «TRADEMARKS_IN_AD_TEXT» или «DESTINATION_NOT_WORKING». Набор возможных тем политики не фиксирован для конкретной версии API и может измениться в любое время.

Политикеметритипе

Возможные типы записей в теме политики.

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

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

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

PROHIBITED Ресурс не будет обслуживаться.
LIMITED Ресурс не будет обслуживаться при некоторых обстоятельствах.
FULLY_LIMITED Ресурс вообще не может быть показан из-за текущих критериев таргетинга.
DESCRIPTIVE Может представлять интерес, но не ограничивает способ обслуживания ресурса.
BROADENING Может увеличить охват сверх обычного.
AREA_OF_INTEREST_ONLY Ограничено для всех целевых стран, но может работать в других странах в зависимости от области интересов.

ПолитикаТемаДоказательства

Дополнительная информация, объясняющая выводы политики.

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

  // Union field value can be only one of the following:
  "websiteList": {
    object (WebsiteList)
  },
  "textList": {
    object (TextList)
  },
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  }
  // End of list of possible types for union field value.
}
Поля
value поля объединения. Информация о конкретных доказательствах в зависимости от типа доказательств. value может быть только одним из следующих:
websiteList

object ( WebsiteList )

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

textList

object ( TextList )

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

languageCode

string

Язык, на котором был обнаружен ресурс. Это языковой тег IETF, например «en-US».

destinationTextList

object ( DestinationTextList )

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

destinationMismatch

object ( DestinationMismatch )

Несоответствие между назначениями URL-адресов ресурсов.

destinationNotWorking

object ( DestinationNotWorking )

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

Список веб-сайтов

Список веб-сайтов, которые стали причиной обнаружения политики. Используется, например, для темы политики ONE_WEBSITE_PER_AD_GROUP. Если веб-сайтов более пяти, здесь будут перечислены только пять лучших (те, которые чаще всего появляются в ресурсах).

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

string

Веб-сайты, которые послужили причиной принятия решения о политике.

Текстлист

Список фрагментов текста, нарушающих политику.

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

string

Фрагменты текста с ресурса, вызвавшего обнаружение политики.

Список назначениятекста

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

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

string

Список текста, найденного на целевой странице ресурса.

Несоответствие пункта назначения

Доказательства несоответствия URL-адресов ресурса.

JSON-представление
{
  "urlTypes": [
    enum (PolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
Поля
urlTypes[]

enum ( PolicyTopicEvidenceDestinationMismatchUrlType )

Набор URL-адресов, которые не совпадают.

PolicyTopicEvidenceDestinationMismatchUrlType

Возможная тема политики свидетельствует о несоответствии типов целевых URL.

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

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

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

DISPLAY_URL Отображаемый URL.
FINAL_URL Конечный URL.
FINAL_MOBILE_URL Конечный мобильный URL.
TRACKING_URL Шаблон URL-адреса отслеживания с замененным URL-адресом рабочего стола.
MOBILE_TRACKING_URL Шаблон URL-адреса отслеживания с замененным мобильным URL-адресом.

НазначениеНеРаботает

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

JSON-представление
{
  "device": enum (PolicyTopicEvidenceDestinationNotWorkingDevice),
  "expandedUrl": string,
  "lastCheckedDateTime": string,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}
Поля
device

enum ( PolicyTopicEvidenceDestinationNotWorkingDevice )

Тип устройства, которому не удалось загрузить URL-адрес.

expandedUrl

string

Полный URL-адрес, который не сработал.

lastCheckedDateTime

string

Время последней проверки URL-адреса. Формат: «ГГГГ-ММ-ДД ЧЧ:ММ:СС». Примеры: «2018-03-05 09:15:00» или «2018-02-01 14:34:30».

reason поля Союза. Указывает причину обнаружения политики DESTINATION_NOT_WORKING. reason может быть только одна из следующих:
dnsErrorType

enum ( PolicyTopicEvidenceDestinationNotWorkingDnsErrorType )

Тип ошибки DNS.

httpErrorCode

string ( int64 format)

Код ошибки HTTP.

ПолитикаТемаEvidenceDestinationNotWorkingDevice

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

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

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

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

DESKTOP Целевая страница не работает на настольном устройстве.
ANDROID Целевая страница не работает на устройстве Android.
IOS Целевая страница не работает на устройстве iOS.

PolicyTopicEvidenceDestinationNotWorkingDnsErrorType

Возможная тема политики указывает на то, что пункт назначения не работает. Типы ошибок DNS.

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

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

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

HOSTNAME_NOT_FOUND Имя хоста не найдено в DNS при получении целевой страницы.
GOOGLE_CRAWLER_DNS_ISSUE Внутренняя проблема сканера Google при взаимодействии с DNS. Эта ошибка не означает, что целевая страница не работает. Google повторно просканирует целевую страницу.

ПолитикаТемаОграничение

Описывает влияние на обслуживание записи в теме политики.

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

  // Union field value can be only one of the following:
  "countryConstraintList": {
    object (CountryConstraintList)
  },
  "resellerConstraint": {
    object (ResellerConstraint)
  },
  "certificateMissingInCountryList": {
    object (CountryConstraintList)
  },
  "certificateDomainMismatchInCountryList": {
    object (CountryConstraintList)
  }
  // End of list of possible types for union field value.
}
Поля
value поля объединения. Конкретная информация об ограничении. value может быть только одним из следующих:
countryConstraintList

object ( CountryConstraintList )

Страны, где ресурс не может служить.

resellerConstraint

object ( ResellerConstraint )

Ограничение реселлера.

certificateMissingInCountryList

object ( CountryConstraintList )

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

certificateDomainMismatchInCountryList

object ( CountryConstraintList )

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

СтранаConstraintList

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

JSON-представление
{
  "countries": [
    {
      object (CountryConstraint)
    }
  ],
  "totalTargetedCountries": integer
}
Поля
countries[]

object ( CountryConstraint )

Страны, в которых обслуживание ограничено.

totalTargetedCountries

integer

Общее количество стран, на которые ориентирован ресурс.

СтранаОграничение

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

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

string

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

Ограничение реселлера

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

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

Статус проверки политики

Возможные статусы проверки политики.

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

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

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

REVIEW_IN_PROGRESS В настоящее время находится на рассмотрении.
REVIEWED Первичная проверка завершена. Другие обзоры могут продолжаться.
UNDER_APPEAL Ресурс был повторно отправлен на утверждение, или его политическое решение было обжаловано.
ELIGIBLE_MAY_SERVE Ресурс соответствует критериям и может обслуживаться, но может пройти дополнительную проверку.

Статус утверждения политики

Возможные статусы утверждения политики. Если доступно несколько статусов одобрения, будет использоваться наиболее строгий. Порядок серьезности: DISAPPROVED, AREA_OF_INTEREST_ONLY, APPROVED_LIMITED и APPROVED.

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

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

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

DISAPPROVED Не будет служить.
APPROVED_LIMITED Служит с ограничениями.
APPROVED Обслуживает без ограничений.
AREA_OF_INTEREST_ONLY Не будет обслуживаться в целевых странах, но может обслуживаться пользователями, которые ищут информацию о целевых странах.

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

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

Адаптивные поисковые объявления позволяют создавать объявления, которые адаптируются так, чтобы показывать вашим клиентам больше текста и более релевантные сообщения. Введите несколько заголовков и описаний при создании адаптивного поискового объявления, и со временем 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)
    }
  ]
}
Поля
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

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

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 символов.

SmartCampaignAdInfo

Умная рекламная кампания.

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

object ( AdTextAsset )

Список текстовых ресурсов, каждый из которых соответствует заголовку при показе объявления. Этот список состоит минимум из 3 и до 15 текстовых ресурсов.

descriptions[]

object ( AdTextAsset )

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

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, видео которых могут отображаться вместе с рекламой.

DiscoveryMultiAssetAdInfo

Объявление с несколькими объектами Discovery.

JSON-представление
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      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 максимальное значение равно 20.

squareMarketingImages[]

object ( AdImageAsset )

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

portraitMarketingImages[]

object ( AdImageAsset )

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

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

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

Рекламная карусель Discovery.

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

string

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

logoImage

object ( AdImageAsset )

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

headline

object ( AdTextAsset )

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

description

object ( AdTextAsset )

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

callToActionText

string

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

carouselCards[]

object ( AdDiscoveryCarouselCardAsset )

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

AdDiscoveryCarouselКарточкаАктив

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

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

string

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

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

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

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

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

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

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

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

Методы

get

 Возвращает запрошенное объявление с полной информацией.

mutate

 Обновляет рекламу.