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

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