REST Resource: advertisers.adGroupAds

Ресурс: AdGroupAd

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

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

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

string

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

advertiserId

string ( int64 format)

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

adGroupAdId

string ( int64 format)

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

adGroupId

string ( int64 format)

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

displayName

string

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

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

adPolicy

object ( AdPolicy )

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

entityStatus

enum ( EntityStatus )

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

adUrls[]

object ( AdUrl )

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

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

ad_details может быть только одним из следующих:

displayVideoSourceAd

object ( DisplayVideoSourceAd )

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

mastheadAd

object ( MastheadAd )

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

inStreamAd

object ( InStreamAd )

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

nonSkippableAd

object ( NonSkippableAd )

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

bumperAd

object ( BumperAd )

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

audioAd

object ( AudioAd )

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

videoDiscoverAd

object ( VideoDiscoveryAd )

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

videoPerformanceAd

object ( VideoPerformanceAd )

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

AdPolicy

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

JSON-представление 
{
  "adPolicyApprovalStatus": enum (AdPolicyApprovalStatus),
  "adPolicyReviewStatus": enum (AdPolicyReviewStatus),
  "adPolicyTopicEntry": [
    {
      object (AdPolicyTopicEntry)
    }
  ]
}
Поля
adPolicyApprovalStatus

enum ( AdPolicyApprovalStatus )

Статус одобрения политики объявления, указывающий решение об одобрении.

adPolicyReviewStatus

enum ( AdPolicyReviewStatus )

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

adPolicyTopicEntry[]

object ( AdPolicyTopicEntry )

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

AdPolicyApprovalStatus

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

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

AdPolicyReviewStatus

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

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

AdPolicyTopicEntry

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

JSON-представление 
{
  "policyTopic": string,
  "policyLabel": string,
  "policyTopicDescription": string,
  "policyTopicType": enum (AdPolicyTopicEntryType),
  "policyDecisionType": enum (AdPolicyDecisionType),
  "policyEnforcementMeans": enum (AdPolicyEnforcementMeans),
  "policyTopicEvidences": [
    {
      object (AdPolicyTopicEvidence)
    }
  ],
  "policyTopicConstraints": [
    {
      object (AdPolicyTopicConstraint)
    }
  ],
  "helpCenterLink": string,
  "appealInfo": {
    object (AdPolicyTopicAppealInfo)
  }
}
Поля
policyTopic

string

Тема политики.

Примерами могут служить «ТОРГОВЫЕ МАРКИ», «АЛКОГОЛЬ» и т. д.

policyLabel

string

Локализованный текст этикетки для политики.

Примеры включают «Торговые марки в тексте», «Содержит алкоголь» и т. д.

policyTopicDescription

string

Краткое описание темы политики.

policyTopicType

enum ( AdPolicyTopicEntryType )

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

policyDecisionType

enum ( AdPolicyDecisionType )

Источник политического решения.

policyEnforcementMeans

enum ( AdPolicyEnforcementMeans )

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

policyTopicEvidences[]

object ( AdPolicyTopicEvidence )

Доказательства, использованные при принятии политического решения.

policyTopicConstraints[]

object ( AdPolicyTopicConstraint )

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

appealInfo

object ( AdPolicyTopicAppealInfo )

Информация о том, как обжаловать решение по политике.

AdPolicyTopicEntryType

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

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

AdPolicyDecisionType

Возможные источники политического решения.

Перечисления
AD_POLICY_DECISION_TYPE_UNKNOWN Неизвестно или не указано.
PURSUANT_TO_NOTICE Решение принимается на основании юридического уведомления, постановления суда или жалобы владельца товарного знака и т. д.
GOOGLE_INVESTIGATION Решение было принято по результатам расследования, проведенного компанией Google.

Средства обеспечения соблюдения рекламной политики

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

Перечисления
AD_POLICY_ENFORCEMENT_MEANS_UNKNOWN Неизвестно или не указано.
AUTOMATED Процесс принуждения был полностью автоматизирован.
HUMAN_REVIEW В процессе исполнения решения частично или полностью участвовал человек.

AdPolicyTopicEvidence

Доказательственная информация, использованная при принятии политического решения.

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

  // Union field value can be only one of the following:
  "textList": {
    object (TextList)
  },
  "websiteList": {
    object (WebsiteList)
  },
  "httpCode": integer,
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  },
  "trademark": {
    object (Trademark)
  },
  "legalRemoval": {
    object (LegalRemoval)
  },
  "counterfeit": {
    object (Counterfeit)
  },
  "regionalRequirements": {
    object (RegionalRequirements)
  }
  // End of list of possible types for union field value.
}
Поля
value поля Union. Доказательство для принятия решения о политике. value может быть только одним из следующих:
textList

object ( TextList )

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

websiteList

object ( WebsiteList )

Список веб-сайтов, связанных с объявлением.

httpCode

integer

HTTP-код, возвращаемый при сканировании конечного URL.

languageCode

string

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

В этом поле используются языковые теги IETF, например «en-US».

destinationTextList

object ( DestinationTextList )

Текст в целевой рекламе, который нарушает политику.

destinationMismatch

object ( DestinationMismatch )

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

destinationNotWorking

object ( DestinationNotWorking )

Информация об ошибках HTTP или DNS, связанных с местом назначения рекламы.

trademark

object ( Trademark )

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

legalRemoval

object ( LegalRemoval )

Правовое регулирование, приведшее к нарушению политики.

counterfeit

object ( Counterfeit )

Правоприменение мошеннических действий, приведшее к нарушению политики.

regionalRequirements

object ( RegionalRequirements )

Проактивное применение T&S, приведшее к нарушению политики.

TextList

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

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

string

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

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

Список веб-сайтов, нарушивших политику.

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

string

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

DestinationTextList

Список текстов назначения, нарушающих политику.

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

string

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

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

Подробная информация о несоответствии типов целевых URL-адресов.

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

enum ( AdPolicyTopicEvidenceDestinationMismatchUrlType )

Набор несовпадающих URL-адресов. Список может включать один или несколько типов URI.

Пример 1: [ DISPLAY_URL , FINAL_URL ] означает, что отображаемый URL-адрес объявления не совпадает с конечным URL-адресом объявления.

Пример 2: [ FINAL_URL ] означает, что конечный URL объявления не соответствует просканированному URL, что также считается несоответствием назначения.

AdPolicyTopicEvidenceDestinationMismatchUrlType

Возможные типы URL.

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

Пункт назначения не работает

Подробная информация об ошибках HTTP или DNS, связанных с назначением объявления.

JSON-представление 
{
  "expandedUri": string,
  "device": enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType),
  "lastCheckedTime": string,

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

string

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

device

enum ( AdPolicyTopicEvidenceDestinationNotWorkingDeviceType )

Устройство, на котором при посещении URL возникла ошибка.

lastCheckedTime

string ( Timestamp format)

В последний раз ошибка наблюдалась при переходе по URL.

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

reason поля объединения. Ошибка HTTP или DNS. reason может быть только одной из следующих:
dnsErrorType

enum ( AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType )

Тип ошибки DNS.

httpErrorCode

string ( int64 format)

Код ошибки HTTP.

AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType

Возможные типы ошибок DNS.

Перечисления
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DNS_ERROR_TYPE_UNKNOWN Не указано или неизвестно.
HOSTNAME_NOT_FOUND Имя хоста не найдено в DNS при загрузке целевой страницы.
GOOGLE_CRAWLER_DNS_ISSUE Google не смог просканировать целевую страницу при взаимодействии с DNS.

AdPolicyTopicEvidenceDestinationNotWorkingDeviceType

Возможные устройства, на которых возникла ошибка при посещении URL-адреса.

Перечисления
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN Не указано или неизвестно.
DESKTOP Настольное устройство.
ANDROID Android-устройство.
IOS iOS-устройство.

Торговая марка

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

JSON-представление 
{
  "owner": string,
  "term": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Поля
owner

string

Владелец контента торговой марки.

term

string

Термин товарного знака.

countryRestrictions[]

object ( AdPolicyCriterionRestriction )

Страны, в которых нарушение политики имеет значение.

AdPolicyCriterionRestriction

Представляет собой ограничение страны.

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

string ( int64 format)

Идентификатор критерия страны.

countryLabel

string

Локализованное название страны. Может быть пустым.

LegalRemoval

Обеспечение соблюдения правовых норм, как в соответствии с DMCA, так и местными правовыми нормами.

JSON-представление 
{
  "complaintType": enum (AdPolicyTopicEvidenceLegalRemovalComplaintType),
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ],
  "restrictedUris": [
    string
  ],

  // Union field type can be only one of the following:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of list of possible types for union field type.
}
Поля
complaintType

enum ( AdPolicyTopicEvidenceLegalRemovalComplaintType )

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

countryRestrictions[]

object ( AdPolicyCriterionRestriction )

Страны, в которые были введены ограничения в связи с юридическим удалением.

restrictedUris[]

string

URL-адреса ограничены в связи с юридическим удалением.

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

object ( Dmca )

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

ДМКА

Подробности жалобы DMCA.

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

string

Субъект, подавший юридическую жалобу.

LocalLegal

Подробности местного правового регулирования.

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

string

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

РекламнаяПолитикаТемаДоказательстваЮридическаяУдалениеЖалобаТип

Возможные типы жалоб для законного удаления.

Перечисления
COPYRIGHT

Авторские права.

Применимо только к DMCA.

COURT_ORDER

Постановление суда.

Применимо только к местным юридическим лицам.

Подделка

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

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

string

Владельцы контента или продукта, подавшие жалобу.

Региональные требования

Проактивное применение политики доверия и безопасности (T&S) для соблюдения региональных требований. Это считается расследованием, проводимым Google, а не уведомлением о регулировании, поскольку это проактивное применение T&S.

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

object ( RegionalRequirementsEntry )

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

Региональные требованияВход

Подробности региональных правонарушений на уровне политики.

JSON-представление 
{
  "legalPolicy": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Поля
legalPolicy

string

Правовая политика, которая нарушается.

countryRestrictions[]

object ( AdPolicyCriterionRestriction )

Страны, в которые наложены ограничения в связи с правовой политикой.

AdPolicyTopicConstraint

Подробная информация об ограничениях при показе рекламы.

JSON-представление 
{
  "requestCertificateFormLink": string,

  // Union field constraint can be only one of the following:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of list of possible types for union field constraint.
}
Поля
constraint поля объединения. Ограничение обслуживания. constraint может быть только одним из следующих:
countryConstraint

object ( AdPolicyCountryConstraintList )

Страны, в которых показ рекламы невозможен.

resellerConstraint

object ( AdPolicyResellerConstraint )

Ограничение для реселлеров.

certificateMissingCountryList

object ( AdPolicyCountryConstraintList )

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

certificateDomainMismatchCountryList

object ( AdPolicyCountryConstraintList )

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

globalCertificateMissing

object ( AdPolicyGlobalCertificateMissingConstraint )

Сертификат необходим для работы в любой стране.

globalCertificateDomainMismatch

object ( AdPolicyGlobalCertificateDomainMismatchConstraint )

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

Список ограничений AdPolicyCountry

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

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

object ( AdPolicyCriterionRestriction )

Страны, в которых показ рекламы невозможен.

AdPolicyResellerConstraint

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

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

AdPolicyGlobalCertificateMissingConstraint

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

Сертификат необходим для работы в любой стране.

AdPolicyGlobalCertificateDomainMismatchConstraint

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

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

AdPolicyTopicAppealInfo

Информация о том, как подать апелляцию на решение по политике.

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

enum ( AdPolicyAppealType )

Можно ли обжаловать решение посредством самостоятельной подачи апелляции или с помощью формы апелляции.

AdPolicyAppealType

Возможные виды апелляции.

Перечисления
AD_POLICY_APPEAL_TYPE_UNKNOWN Неизвестно или не указано.
SELF_SERVICE_APPEAL Решение может быть обжаловано путем подачи апелляции в порядке самостоятельной подачи апелляции.
APPEAL_FORM Решение может быть обжаловано с помощью формы апелляции.

DisplayVideoSourceAd

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

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

string ( int64 format)

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

MastheadAd

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

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

object ( YoutubeVideoDetails )

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

headline

string

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

description

string

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

videoAspectRatio

enum ( VideoAspectRatio )

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

autoplayVideoStartMillisecond

string ( int64 format)

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

autoplayVideoDuration

string ( Duration format)

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

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

callToActionButtonLabel

string

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

callToActionFinalUrl

string

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

callToActionTrackingUrl

string

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

showChannelArt

boolean

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

companionYoutubeVideos[]

object ( YoutubeVideoDetails )

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

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

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

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

string

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

unavailableReason

enum ( VideoUnavailableReason )

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

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

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

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

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

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

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

InStreamAd

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

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

object ( CommonInStreamAttribute )

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

customParameters

map (key: string, value: string)

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

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

CommonInStreamAttribute

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

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

string

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

finalUrl

string

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

trackingUrl

string

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

actionButtonLabel

string

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

actionHeadline

string

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

video

object ( YoutubeVideoDetails )

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

companionBanner

object ( ImageAsset )

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

ImageAsset

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

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

string

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

fullSize

object ( Dimensions )

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

fileSize

string ( int64 format)

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

NonSkippableAd

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

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

object ( CommonInStreamAttribute )

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

customParameters

map (key: string, value: string)

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

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

BumperAd

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

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

object ( CommonInStreamAttribute )

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

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

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

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

string

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

finalUrl

string

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

trackingUrl

string

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

video

object ( YoutubeVideoDetails )

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

VideoDiscoveryAd

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

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

string

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

description1

string

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

description2

string

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

video

object ( YoutubeVideoDetails )

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

thumbnail

enum ( Thumbnail )

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

Миниатюра

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

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

VideoPerformanceAd

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

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

string

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

trackingUrl

string

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

actionButtonLabels[]

string

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

headlines[]

string

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

longHeadlines[]

string

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

descriptions[]

string

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

displayUrlBreadcrumb1

string

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

displayUrlBreadcrumb2

string

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

domain

string

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

videos[]

object ( YoutubeVideoDetails )

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

customParameters

map (key: string, value: string)

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

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

companionBanners[]

object ( ImageAsset )

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

AdUrl

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

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

enum ( AdUrlType )

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

url

string

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

AdUrlType

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

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

Методы

get

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

list

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