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

CallConversionReportingState

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

Перечисления
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:
  "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)

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

Миметип

Тип мима

Перечисления
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.

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

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

ВидеоБамперИн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.
HEADLINE Объект был использован в заголовке. Используйте это, только если в объявлении только один заголовок. В противном случае используйте перечисления HEADLINE_1, HEADLINE_2 или HEADLINE_3.
HEADLINE_IN_PORTRAIT Объект использовался в качестве заголовка в портретном изображении.
LONG_HEADLINE Ресурс использовался в длинном заголовке (используется в MultiAssetResponsiveAd).
DESCRIPTION Актив использовался в описании. Используйте это, только если в объявлении только одно описание. В противном случае используйте перечисления DESCRIPTION_1 или DESCRIPTION_@.
DESCRIPTION_IN_PORTRAIT Объект использовался в качестве описания в портретном изображении.
BUSINESS_NAME_IN_PORTRAIT Актив использовался в качестве названия компании в портретном изображении.
BUSINESS_NAME Актив использовался в качестве названия компании.
MARKETING_IMAGE Ресурс использовался в качестве маркетингового изображения.
MARKETING_IMAGE_IN_PORTRAIT Ресурс использовался в качестве маркетингового изображения в портретном изображении.
SQUARE_MARKETING_IMAGE Актив использовался как квадратное маркетинговое изображение.
PORTRAIT_MARKETING_IMAGE Ресурс использовался в качестве портретного маркетингового изображения.
CALL_TO_ACTION Актив использовался как призыв к действию.
YOU_TUBE_VIDEO Ресурс использовался в качестве видео на YouTube.
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 также установлен.

DisplayUploadDinfo

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

Представление 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 )

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

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

object ( AdMediaBundleAsset )

Активы СМИ, который будет использоваться в объявлении. Для получения информации о комплекте медиа-пакета для html5_upload_ad , см. . См. Https://support.google.com/webdesigner/answer/7543898 для получения дополнительной информации.

DisplayUploadProductType

Перечислители отображают загрузку типов продуктов.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Значение неизвестно в этой версии.
HTML5_UPLOAD_AD Html5 загрузить объявление. Этот тип продукта требует для установки поля upload_media_bundle в DisplayUploadDinfo.
DYNAMIC_HTML5_EDUCATION_AD Dynamic HTML5 ОБРАЗОВАНИЕ AD. Этот тип продукта требует для установки поля upload_media_bundle в DisplayUploadDinfo. Может использоваться только в образовательной кампании.
DYNAMIC_HTML5_FLIGHT_AD Dynamic HTML5 Flight Ad. Этот тип продукта требует для установки поля upload_media_bundle в DisplayUploadDinfo. Может использоваться только в летной кампании.
DYNAMIC_HTML5_HOTEL_RENTAL_AD Dynamic HTML5 Hotel и Adment Ad. Этот тип продукта требует для установки поля upload_media_bundle в DisplayUploadDinfo. Может использоваться только в гостиничной кампании.
DYNAMIC_HTML5_JOB_AD Динамическая html5. Этот тип продукта требует для установки поля upload_media_bundle в DisplayUploadDinfo. Может использоваться только в рабочих кампании.
DYNAMIC_HTML5_LOCAL_AD Динамическая локальная реклама HTML5. Этот тип продукта требует для установки поля upload_media_bundle в DisplayUploadDinfo. Может использоваться только в местной кампании.
DYNAMIC_HTML5_REAL_ESTATE_AD Dynamic HTML5 Real Estate Ad. Этот тип продукта требует для установки поля upload_media_bundle в DisplayUploadDinfo. Может использоваться только в кампании по недвижимости.
DYNAMIC_HTML5_CUSTOM_AD Dynamic HTML5 Custom Ad. Этот тип продукта требует для установки поля upload_media_bundle в DisplayUploadDinfo. Может использоваться только в пользовательской кампании.
DYNAMIC_HTML5_TRAVEL_AD Dynamic HTML5 Travel Ad. Этот тип продукта требует для установки поля upload_media_bundle в DisplayUploadDinfo. Может использоваться только в туристической кампании.
DYNAMIC_HTML5_HOTEL_AD Dynamic HTML5 Hotel Ad. Этот тип продукта требует для установки поля upload_media_bundle в DisplayUploadDinfo. Может использоваться только в гостиничной кампании.

AppengageAdinfo

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

Представление 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 )

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

Shopping -Comparisonlistingadinfo

Сравнение покупок в списке объявлений.

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

string

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

SmartCampaignfo

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

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

object ( AdTextAsset )

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

descriptions[]

object ( AdTextAsset )

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

AppPrereGistrationAdinfo

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

Представление 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 Multi Asset Ad.

Представление 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%). Требуется, если SquareMarketingImage не присутствует. В сочетании с squareMarketingImages и portraitMarketingImages максимум - 20.

squareMarketingImages[]

object ( AdImageAsset )

Квадратные маркетинговые активы, которые будут использоваться в рекламе. Допустимыми типами изображений являются GIF, JPEG и PNG. Минимальный размер составляет 300x300, а соотношение сторон должно составлять 1: 1 (+-1%). Требуется, если MarketingImage не присутствует. В сочетании с 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 и максимальные заголовки могут быть указаны.

descriptions[]

object ( AdTextAsset )

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

businessName

string

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

callToActionText

string

Призовите текст действия.

leadFormOnly

boolean

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

DiscoveryCarouseLadinfo

Открытие Carousel Ad.

Представление 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.

Addiscoverycarouselcardasset

Активы Carousel Card Discovery, используемый в рекламе.

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

string

Название ресурса активов этой карты Carousel Discovery.

DiscoveryVideorPonsiveadinfo

Видео отзывчиво открытия.

Представление 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, используемые для кнопки «Вызов к действию».

AdcalltoActionAsset

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

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

string

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

Traveladinfo

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

Ad Travel Ad.

Методы

get

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

mutate

 Обновления рекламы.