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)
    }
  ],
  "dcmTrackingInfo": {
    object (DcmTrackingInfo)
  },

  // 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)
  },
  "demandGenVideoAd": {
    object (DemandGenVideoAd)
  },
  "demandGenImageAd": {
    object (DemandGenImageAd)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAd)
  },
  "demandGenProductAd": {
    object (DemandGenProductAd)
  }
  // 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-адресов, используемых в рекламе.

dcmTrackingInfo

object ( DcmTrackingInfo )

Необязательно. Информация об отслеживании рекламы DCM. Действительна только для рекламы, генерирующей спрос.

Чтобы удалить информацию о рекламном отслеживании DCM, оставьте это поле пустым.

Поле объединения ad_details . Подробности объявления. ad_details может принимать только одно из следующих значений:
displayVideoSourceAd

object ( DisplayVideoSourceAd )

Только для вывода. Подробности рекламного объявления, полученные из креатива Display & Video 360.

mastheadAd

object ( MastheadAd )

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

inStreamAd

object ( InStreamAd )

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

nonSkippableAd

object ( NonSkippableAd )

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

bumperAd

object ( BumperAd )

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

audioAd

object ( AudioAd )

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

videoDiscoverAd

object ( VideoDiscoveryAd )

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

videoPerformanceAd

object ( VideoPerformanceAd )

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

demandGenVideoAd

object ( DemandGenVideoAd )

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

demandGenImageAd

object ( DemandGenImageAd )

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

demandGenProductAd

object ( DemandGenProductAd )

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

Политика рекламы

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

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

enum ( AdPolicyApprovalStatus )

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

adPolicyReviewStatus

enum ( AdPolicyReviewStatus )

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

adPolicyTopicEntry[]

object ( AdPolicyTopicEntry )

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

Статус одобрения политики рекламы

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

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

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

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

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

AdPolicyEnforcementMeans

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

Перечисления
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 профсоюзного поля. Доказательством принятия политического решения может служить только одно из следующих 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 привели к нарушению политики компании.

Текстовый список

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

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

Подробности жалобы в соответствии с Законом об авторском праве в цифровую эпоху (DMCA).

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

string

Организация, подавшая юридическую жалобу.

LocalLegal

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

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

string

Тип права, к которому относится юридическое уведомление.

AdPolicyTopicEvidenceLegalRemovalComplainTip

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

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

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

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

COURT_ORDER

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

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

Подделка

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

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

string

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

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

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

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 )

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

AdPolicyCountryConstraintList

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

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)

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

Заголовок

Информация для рекламного объявления в заголовке.

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 в заголовке.

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),
  "videoAssetId": string
}
Поля
id

string

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

unavailableReason

enum ( VideoUnavailableReason )

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

videoAssetId

string ( int64 format)

Обязательно. Идентификатор видеоресурса YouTube. Это adAssetId ресурса AdAsset .

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

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

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

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

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

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

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,
  "assetId": string
}
Поля
mimeType

string

Только для вывода. MIME-тип графического файла.

fullSize

object ( Dimensions )

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

fileSize

string ( int64 format)

Только для вывода. Размер файла изображения в байтах.

assetId

string ( int64 format)

Обязательно. Уникальный идентификатор актива.

Непропускаемая реклама

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

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

Бампер-реклама

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

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

Подробности для рекламного объявления в разделе «Поиск видео».

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 )

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

Миниатюра

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

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

ВидеоПоказыЭффективностьРекламы

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

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 )

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

DemandGenVideoAd

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

JSON-представление 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": enum (CallToAction),
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanner": {
    object (ImageAsset)
  },
  "logo": {
    object (ImageAsset)
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string
}
Поля
finalUrl

string

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

trackingUrl

string

Только для вывода. URL-адрес загружается в фоновом режиме в целях отслеживания.

userSpecifiedTrackingUrl

string

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

callToAction

enum ( CallToAction )

Обязательно. Кнопка призыва к действию, отображаемая в объявлении.

Поддерживаемые значения:

  • AUTOMATED
  • LEARN_MORE
  • GET_QUOTE
  • APPLY_NOW
  • SIGN_UP
  • CONTACT_US
  • SUBSCRIBE
  • DOWNLOAD
  • BOOK_NOW
  • SHOP_NOW
  • BUY_NOW
  • DONATE_NOW
  • ORDER_NOW
  • PLAY_NOW
  • SEE_MORE
  • START_NOW
  • VISIT_SITE
  • WATCH_NOW
headlines[]

string

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

longHeadlines[]

string

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

descriptions[]

string

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

displayUrlBreadcrumb1

string

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

displayUrlBreadcrumb2

string

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

videos[]

object ( YoutubeVideoDetails )

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

customParameters

map (key: string, value: string)

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

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

companionBanner

object ( ImageAsset )

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

finalMobileUrl

string

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

finalUrlSuffix

string

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

businessName

string

Обязательно. Название компании, указанное в объявлении.

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

Призыв к действию

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

Перечисления
CALL_TO_ACTION_UNSPECIFIED Не указано или неизвестно.
AUTOMATED Автоматизировано.
LEARN_MORE Узнать больше.
GET_QUOTE Получить ценовое предложение.
APPLY_NOW Подайте заявку прямо сейчас.
SIGN_UP Зарегистрироваться.
CONTACT_US Связаться с нами.
SUBSCRIBE Подписаться.
DOWNLOAD Скачать.
BOOK_NOW Забронируйте сейчас.
SHOP_NOW Купить сейчас.
BUY_NOW Купить сейчас.
DONATE_NOW Сделайте пожертвование прямо сейчас.
ORDER_NOW Закажите прямо сейчас.
PLAY_NOW Играйте прямо сейчас.
SEE_MORE Смотрите больше.
START_NOW Начните прямо сейчас.
VISIT_SITE Посетите сайт.
WATCH_NOW Смотрите прямо сейчас.

DemandGenImageAd

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

JSON-представление 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": string,
  "headlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "customParameters": {
    string: string,
    ...
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string,
  "marketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "logoImages": [
    {
      object (ImageAsset)
    }
  ]
}
Поля
finalUrl

string

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

trackingUrl

string

Только для вывода. URL-адрес загружается в фоновом режиме в целях отслеживания.

userSpecifiedTrackingUrl

string

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

callToAction

string

Обязательно. Кнопка призыва к действию, отображаемая в объявлении.

headlines[]

string

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

descriptions[]

string

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

customParameters

map (key: string, value: string)

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

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

finalMobileUrl

string

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

finalUrlSuffix

string

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

businessName

string

Обязательно. Название компании, указанное в объявлении.

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

marketingImages[]

object ( ImageAsset )

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

squareMarketingImages[]

object ( ImageAsset )

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

portraitMarketingImages[]

object ( ImageAsset )

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

logoImages[]

object ( ImageAsset )

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

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

DemandGenCarouselAd

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

JSON-представление 
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "cards": [
    {
      object (CarouselCard)
    }
  ],
  "finalUrlSuffix": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  }
}
Поля
finalUrl

string

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

headline

string

Обязательно. Заголовок объявления.

description

string

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

cards[]

object ( CarouselCard )

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

finalUrlSuffix

string

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

trackingUrl

string

Только для вывода. URL-адрес загружается в фоновом режиме в целях отслеживания.

userSpecifiedTrackingUrl

string

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

businessName

string

Обязательно. Название компании, указанное в объявлении.

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

customParameters

map (key: string, value: string)

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

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

CarouselCard

Подробная информация о карусельной карте Demand Gen.

JSON-представление 
{
  "finalUrl": string,
  "finalMobileUrl": string,
  "headline": string,
  "callToAction": string,
  "marketingImage": {
    object (ImageAsset)
  },
  "squareMarketingImage": {
    object (ImageAsset)
  },
  "portraitMarketingImage": {
    object (ImageAsset)
  }
}
Поля
finalUrl

string

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

finalMobileUrl

string

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

headline

string

Обязательно. Заголовок карточки.

callToAction

string

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

Необходимо использовать не более 10 символов.

marketingImage

object ( ImageAsset )

Необязательно. Рекламное изображение, показанное на карточке.

squareMarketingImage

object ( ImageAsset )

Дополнительно. Квадратное рекламное изображение, показанное на карточке.

portraitMarketingImage

object ( ImageAsset )

Дополнительно. Рекламное изображение, представленное на карточке.

DemandGenProductAd

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

JSON-представление 
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "finalUrlSuffix": string,
  "callToAction": enum (CallToAction),
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  },
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string
}
Поля
finalUrl

string

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

headline

string

Обязательно. Заголовок объявления.

description

string

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

finalUrlSuffix

string

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

callToAction

enum ( CallToAction )

Обязательно. Кнопка призыва к действию, отображаемая в объявлении.

Поддерживаемые значения:

  • AUTOMATED
  • APPLY_NOW
  • BOOK_NOW
  • CONTACT_US
  • DOWNLOAD
  • GET_QUOTE
  • LEARN_MORE
  • SHOP_NOW
  • SIGN_UP
  • SUBSCRIBE
trackingUrl

string

Только для вывода. URL-адрес загружается в фоновом режиме в целях отслеживания.

userSpecifiedTrackingUrl

string

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

businessName

string

Обязательно. Название компании, указанное в объявлении.

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

customParameters

map (key: string, value: string)

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

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

displayUrlBreadcrumb1

string

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

displayUrlBreadcrumb2

string

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

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-адреса для проверки доступности при срабатывании события клика.
AD_URL_TYPE_BEACON_SKIP Отслеживание URL-адреса для проверки доступности страницы при срабатывании события пропуска.

DcmTrackingInfo

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

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

string ( int64 format)

Обязательно. Идентификатор размещения DCM.

trackingAdId

string ( int64 format)

Обязательно. Идентификатор рекламного объявления отслеживания DCM.

creativeId

string ( int64 format)

Обязательно. Идентификатор креатива DCM.

Методы

create

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

delete

 Удаляет объявление из группы объявлений.

get

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

list

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

patch

 Обновляет объявление в группе объявлений.