ExtensionFeedItem

Расширенный элемент фида.

JSON-представление
{
  "resourceName": string,
  "extensionType": enum (ExtensionType),
  "adSchedules": [
    {
      object (AdScheduleInfo)
    }
  ],
  "device": enum (FeedItemTargetDevice),
  "targetedKeyword": {
    object (KeywordInfo)
  },
  "status": enum (FeedItemStatus),
  "id": string,
  "startDateTime": string,
  "endDateTime": string,
  "targetedGeoTargetConstant": string,

  // Union field extension can be only one of the following:
  "sitelinkFeedItem": {
    object (SitelinkFeedItem)
  },
  "structuredSnippetFeedItem": {
    object (StructuredSnippetFeedItem)
  },
  "appFeedItem": {
    object (AppFeedItem)
  },
  "callFeedItem": {
    object (CallFeedItem)
  },
  "calloutFeedItem": {
    object (CalloutFeedItem)
  },
  "textMessageFeedItem": {
    object (TextMessageFeedItem)
  },
  "priceFeedItem": {
    object (PriceFeedItem)
  },
  "promotionFeedItem": {
    object (PromotionFeedItem)
  },
  "locationFeedItem": {
    object (LocationFeedItem)
  },
  "affiliateLocationFeedItem": {
    object (AffiliateLocationFeedItem)
  },
  "hotelCalloutFeedItem": {
    object (HotelCalloutFeedItem)
  },
  "imageFeedItem": {
    object (ImageFeedItem)
  }
  // End of list of possible types for union field extension.

  // Union field serving_resource_targeting can be only one of the following:
  "targetedCampaign": string,
  "targetedAdGroup": string
  // End of list of possible types for union field serving_resource_targeting.
}
Поля
resourceName

string

Неизменный. Имя ресурса элемента фида расширения. Имена ресурсов элементов фида расширения имеют вид:

customers/{customerId}/extensionFeedItems/{feed_item_id}

extensionType

enum ( ExtensionType )

Только вывод. Тип расширения элемента фида расширений. Это поле доступно только для чтения.

adSchedules[]

object ( AdScheduleInfo )

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

device

enum ( FeedItemTargetDevice )

Целевое устройство.

targetedKeyword

object ( KeywordInfo )

Целевое ключевое слово.

status

enum ( FeedItemStatus )

Только вывод. Статус элемента фида. Это поле доступно только для чтения.

id

string ( int64 format)

Только вывод. Идентификатор этого элемента фида. Только для чтения.

startDateTime

string

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

endDateTime

string

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

targetedGeoTargetConstant

string

Константа целевой географической цели.

extension поля объединения. Тип расширения. extension может быть только одним из следующих:
structuredSnippetFeedItem

object ( StructuredSnippetFeedItem )

Расширение структурированного описания.

appFeedItem

object ( AppFeedItem )

Расширение приложения.

callFeedItem

object ( CallFeedItem )

Расширение вызова.

calloutFeedItem

object ( CalloutFeedItem )

Расширение выноски.

textMessageFeedItem

object ( TextMessageFeedItem )

Расширение текстового сообщения.

priceFeedItem

object ( PriceFeedItem )

Расширение цены.

promotionFeedItem

object ( PromotionFeedItem )

Продление акции.

locationFeedItem

object ( LocationFeedItem )

Только вывод. Расширение местоположения. Местоположение синхронизируется из профиля компании в фид. Это поле доступно только для чтения.

affiliateLocationFeedItem

object ( AffiliateLocationFeedItem )

Только вывод. Расширение партнерского адреса. Местоположение фида заполняется Google Рекламой на основе идентификатора сети. Это поле доступно только для чтения.

hotelCalloutFeedItem

object ( HotelCalloutFeedItem )

Расширение Hotel Callout.

imageFeedItem

object ( ImageFeedItem )

Неизменный. Рекламодатель предоставил расширение изображения.

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

string

Целевая кампания.

targetedAdGroup

string

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

Структурированный сниппетфидитем

Представляет расширение структурированного фрагмента.

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

string

Значения во фрагменте. Максимальный размер этой коллекции — 10.

header

string

Заголовок фрагмента. Эта строка не должна быть пустой.

AppFeedItem

Представляет расширение приложения.

JSON-представление
{
  "appStore": enum (AppStore),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "linkText": string,
  "appId": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string
}
Поля
appStore

enum ( AppStore )

Магазин приложений, к которому принадлежит целевое приложение. Это поле обязательно к заполнению.

finalUrls[]

string

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

finalMobileUrls[]

string

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

urlCustomParameters[]

object ( CustomParameter )

Список сопоставлений, которые будут использоваться для замены тегов пользовательских параметров URL-адресов в trackUrlTemplate, FinalUrls и/или FinalMobileUrls.

linkText

string

Видимый текст, отображаемый при отображении ссылки в объявлении. Эта строка не должна быть пустой, а длина этой строки должна быть от 1 до 25 включительно.

appId

string

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

trackingUrlTemplate

string

Шаблон URL-адреса для создания URL-адреса отслеживания. Значение по умолчанию — «{lpurl}».

finalUrlSuffix

string

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

Магазин приложений

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

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
APPLE_ITUNES Apple Айтюнс.
GOOGLE_PLAY Гугл игры.

Текстмессажефидитем

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

JSON-представление
{
  "businessName": string,
  "countryCode": string,
  "phoneNumber": string,
  "text": string,
  "extensionText": string
}
Поля
businessName

string

Название компании, добавляемое к тексту сообщения. Это поле обязательно к заполнению.

countryCode

string

Двухбуквенный код страны в верхнем регистре номера телефона рекламодателя. Это поле обязательно к заполнению.

phoneNumber

string

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

text

string

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

extensionText

string

Расширение сообщенияТекст, заполняемый в приложении обмена сообщениями.

ЦенаFeedItem

Представляет расширение Price.

JSON-представление
{
  "type": enum (PriceExtensionType),
  "priceQualifier": enum (PriceExtensionPriceQualifier),
  "priceOfferings": [
    {
      object (PriceOffer)
    }
  ],
  "trackingUrlTemplate": string,
  "languageCode": string,
  "finalUrlSuffix": string
}
Поля
type

enum ( PriceExtensionType )

Тип ценового расширения этого расширения.

priceQualifier

enum ( PriceExtensionPriceQualifier )

Спецификатор цены для всех предложений этого расширения цен.

priceOfferings[]

object ( PriceOffer )

Ценовые предложения в этом расширении цен.

trackingUrlTemplate

string

Шаблон URL-адреса отслеживания для всех предложений этого расширения цены.

languageCode

string

Код языка, используемого для этого расширения цены.

finalUrlSuffix

string

Шаблон URL-адреса отслеживания для всех предложений этого расширения цены.

Предложение цены

Представляет одно ценовое предложение в расширении цены.

JSON-представление
{
  "price": {
    object (Money)
  },
  "unit": enum (PriceExtensionPriceUnit),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "header": string,
  "description": string
}
Поля
price

object ( Money )

Стоимость данного предложения.

unit

enum ( PriceExtensionPriceUnit )

Цена за единицу данного предложения.

finalUrls[]

string

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

finalMobileUrls[]

string

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

header

string

Текст заголовка данного предложения.

description

string

Текст описания данного предложения.

PromotionFeedItem

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

JSON-представление
{
  "discountModifier": enum (PromotionExtensionDiscountModifier),
  "occasion": enum (PromotionExtensionOccasion),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "promotionTarget": string,
  "promotionStartDate": string,
  "promotionEndDate": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "languageCode": string,

  // Union field discount_type can be only one of the following:
  "percentOff": string,
  "moneyAmountOff": {
    object (Money)
  }
  // End of list of possible types for union field discount_type.

  // Union field promotion_trigger can be only one of the following:
  "promotionCode": string,
  "ordersOverAmount": {
    object (Money)
  }
  // End of list of possible types for union field promotion_trigger.
}
Поля
discountModifier

enum ( PromotionExtensionDiscountModifier )

Перечисление, которое изменяет условия скидки.

occasion

enum ( PromotionExtensionOccasion )

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

finalUrls[]

string

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

finalMobileUrls[]

string

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

urlCustomParameters[]

object ( CustomParameter )

Список сопоставлений, которые будут использоваться для замены тегов пользовательских параметров URL-адресов в trackUrlTemplate, FinalUrls и/или FinalMobileUrls.

promotionTarget

string

Описание в свободной форме того, на что нацелена рекламная акция. Это поле обязательно к заполнению.

promotionStartDate

string

Дата начала, когда акция может быть активирована.

promotionEndDate

string

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

trackingUrlTemplate

string

Шаблон URL-адреса для создания URL-адреса отслеживания.

finalUrlSuffix

string

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

languageCode

string

Язык продвижения. Представлен как языковой тег BCP 47.

Поле объединения discount_type . Тип скидки: может быть процентной или суммовой. discount_type может быть только одним из следующих:
percentOff

string ( int64 format)

Процентная скидка по акции в микронах. Один миллион эквивалентен одному проценту. Требуется либо это, либо Money_off_amount.

moneyAmountOff

object ( Money )

Сумма денег скидка на скидку в акции. Требуется либо это, либо процентВыкл.

Объединённое поле promotion_trigger . Триггер продвижения. Может быть по промокоду или промокоду по подходящей сумме заказа. promotion_trigger может быть только одним из следующих:
promotionCode

string

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

ordersOverAmount

object ( Money )

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

МестоположениеFeedItem

Представляет расширение местоположения.

JSON-представление
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string
}
Поля
businessName

string

Название бизнеса.

addressLine1

string

Строка 1 юридического адреса.

addressLine2

string

Строка 2 юридического адреса.

city

string

Город юридического адреса.

province

string

Провинция делового адреса.

postalCode

string

Почтовый индекс юридического адреса.

countryCode

string

Код страны юридического адреса.

phoneNumber

string

Телефон предприятия.

ФилиалLocationFeedItem

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

JSON-представление
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string,
  "chainId": string,
  "chainName": string
}
Поля
businessName

string

Название бизнеса.

addressLine1

string

Строка 1 юридического адреса.

addressLine2

string

Строка 2 юридического адреса.

city

string

Город юридического адреса.

province

string

Провинция делового адреса.

postalCode

string

Почтовый индекс юридического адреса.

countryCode

string

Код страны юридического адреса.

phoneNumber

string

Телефон предприятия.

chainId

string ( int64 format)

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

chainName

string

Название цепочки.

ОтельCalloutFeedItem

Представляет расширение уточнения отеля.

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

string

Текст выноски. Длина этой строки должна быть от 1 до 25 включительно.

languageCode

string

Язык текста уточнения отеля. Код языка, соответствующий стандарту IETF BCP 47.

ИзображениеFeedItem

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

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

string

Необходимый. Имя ресурса изображения.