Индекс
-
PromotionsService
(интерфейс) -
Attributes
(сообщение) -
CouponValueType
(перечисление) -
GetPromotionRequest
(сообщение) -
InsertPromotionRequest
(сообщение) -
ListPromotionsRequest
(сообщение) -
ListPromotionsResponse
(сообщение) -
OfferType
(перечисление) -
ProductApplicability
(перечисление) -
Promotion
(сообщение) -
PromotionStatus
(сообщение) -
PromotionStatus.DestinationStatus
(сообщение) -
PromotionStatus.DestinationStatus.State
(перечисление) -
PromotionStatus.ItemLevelIssue
(сообщение) -
PromotionStatus.ItemLevelIssue.Severity
(перечисление) -
RedemptionChannel
(перечисление) -
StoreApplicability
(перечисление)
АкцииСервис
Сервис для управления продвижением товаров.
Получить повышение |
---|
Получает промоакцию из вашего аккаунта Merchant Center. После вставки или обновления рекламной акции может пройти несколько минут, прежде чем обновленную рекламную акцию можно будет получить.
|
ВставитьПродвижение |
---|
Добавляет рекламную акцию для вашего аккаунта Merchant Center. Если акция уже существует, вместо этого она обновляется.
|
СписокАкции |
---|
Список промоакций в вашем аккаунте Merchant Center. Ответ может содержать меньше элементов, чем указано в После вставки или обновления промоакции может пройти несколько минут, прежде чем обновленную обработанную акцию можно будет получить.
|
Атрибуты
Атрибуты.
Поля | |
---|---|
product_applicability | Необходимый. Применимость акции ко всем продуктам или только к определенным продуктам . |
offer_type | Необходимый. Тип акции. Используйте этот атрибут, чтобы указать, нужен ли клиентам код купона для активации вашей акции. |
generic_redemption_code | Необязательный. Общий код активации для акции. Используется с полем |
long_title | Необходимый. Длинное название акции. |
coupon_value_type | Необходимый. Атрибут типа значения купона , указывающий тип проводимой вами рекламной акции. В зависимости от типа выбранного значения купона обязательны некоторые атрибуты . |
promotion_destinations[] | Необходимый. Список направлений, на которые распространяется акция. Если вы не укажете пункт назначения, включив поддерживаемое значение в источник данных, ваше продвижение будет по умолчанию отображаться в товарных объявлениях и бесплатных предложениях. Возможно, вы ранее указали следующие значения в качестве мест назначения для своих продуктов: «Действия покупок», «Поверхности в Google», «Локальные поверхности в Google». Для представления этих значений используйте |
item_id_inclusion[] | Необязательный. Фильтр товаров по идентификатору товара для акции. Атрибуты фильтра продуктов применяются только в том случае, если для продуктов, подпадающих под действие рекламной акции, атрибут Product Applicability |
brand_inclusion[] | Необязательный. Фильтр товаров по брендам для продвижения. Атрибуты фильтра продуктов применяются только в том случае, если для продуктов, подпадающих под действие рекламной акции, атрибут Product Applicability |
item_group_id_inclusion[] | Необязательный. Фильтр товаров по идентификатору группы товаров для акции. Атрибуты фильтра продуктов применяются только в том случае, если для продуктов, подпадающих под действие рекламной акции, атрибут применимости продукта [product_applicability] установлен на specific_products . |
product_type_inclusion[] | Необязательный. Фильтр товаров по типу товара для акции. Атрибуты фильтра продуктов применяются только в том случае, если для продуктов, имеющих право на рекламную акцию, атрибут Product Applicability |
item_id_exclusion[] | Необязательный. Фильтр товаров по исключению идентификатора товара для акции. Атрибуты фильтра продуктов применяются только в том случае, если для продуктов, имеющих право на рекламную акцию, атрибут Product Applicability |
brand_exclusion[] | Необязательный. Фильтр товаров по исключению брендов для продвижения. Атрибуты фильтра продуктов применяются только в том случае, если для продуктов, имеющих право на рекламную акцию, атрибут Product Applicability |
item_group_id_exclusion[] | Необязательный. Фильтр товаров по идентификатору группы товаров . Атрибуты фильтра продуктов применяются только в том случае, если для продуктов, имеющих право на рекламную акцию, атрибут Product Applicability |
product_type_exclusion[] | Необязательный. Фильтр товаров по исключению типов товаров для акции. Атрибуты фильтра продуктов применяются только в том случае, если для продуктов, имеющих право на рекламную акцию, атрибут Product Applicability |
minimum_purchase_amount | Необязательный. Минимальная сумма покупки по акции. |
minimum_purchase_quantity | Необязательный. Минимальный объем закупки по акции. |
limit_quantity | Необязательный. Максимальный объем покупки по акции. |
limit_value | Необязательный. Максимальная цена товара по акции. |
percent_off | Необязательный. Процентная скидка , предлагаемая в рамках акции. |
money_off_amount | Необязательный. Сумма денежной скидки , предлагаемая в рамках акции. |
get_this_quantity_discounted | Необязательный. Количество товаров со скидкой в рамках акции. Атрибут устанавливается, когда |
free_gift_value | Необязательный. Стоимость бесплатного подарка по акции. |
free_gift_description | Необязательный. Бесплатное описание подарка по акции. |
free_gift_item_id | Необязательный. Бесплатный идентификатор подарочного товара по акции. |
promotion_effective_time_period | Необходимый. |
promotion_display_time_period | Необязательный. Представление |
store_applicability | Необязательный. Распространяется ли акция на все магазины или только на определенные магазины . Реклама местного ассортимента выдает ошибку, если не указана применимость к магазину. Ошибка |
store_codes_inclusion[] | Необязательный. Коды магазинов для участия в акции. Атрибуты фильтра магазина применяются только в том случае, если для атрибута Код магазина (идентификатор магазина из профиля вашей компании) физического магазина, в котором продается товар. Дополнительную информацию см . в спецификации данных о местном ассортименте . |
store_codes_exclusion[] | Необязательный. Коды магазинов, которые следует исключить из акции. Атрибуты фильтра магазина применяются только в том случае, если для атрибута |
promotion_url | Необязательный. URL-адрес страницы сайта продавца, на которой отображается промоакция. При продвижении рекламы местного ассортимента выдается ошибка, если |
Тип значения купона
Тип стоимости купона для акции.
Перечисления | |
---|---|
COUPON_VALUE_TYPE_UNSPECIFIED | Указывает, что тип значения купона не указан. |
MONEY_OFF | Тип значения купона «Деньги на скидку». |
PERCENT_OFF | Тип значения процентной скидки купона. |
BUY_M_GET_N_MONEY_OFF | Купите количество M, получите N денег со скидки по типу стоимости купона. minimum_purchase_quantity и get_this_quantity_discounted должны присутствовать. money_off_amount также должен присутствовать. |
BUY_M_GET_N_PERCENT_OFF | Купите количество M, получите скидку N процентов на тип стоимости купона. minimum_purchase_quantity и get_this_quantity_discounted должны присутствовать. percent_off_percentage также должен присутствовать. |
BUY_M_GET_MONEY_OFF | Купите количество M, получите скидку. minimum_purchase_quantity и money_off_amount должны присутствовать. |
BUY_M_GET_PERCENT_OFF | Купите количество M, получите скидку. minimum_purchase_quantity и percent_off_percentage должны присутствовать. |
FREE_GIFT | Бесплатный подарок только с описанием. |
FREE_GIFT_WITH_VALUE | Бесплатный подарок с денежной оценкой. |
FREE_GIFT_WITH_ITEM_ID | Бесплатный подарок с указанием идентификатора товара. |
FREE_SHIPPING_STANDARD | Тип значения стандартного купона на бесплатную доставку. |
FREE_SHIPPING_OVERNIGHT | Тип значения купона на бесплатную доставку на ночь. |
FREE_SHIPPING_TWO_DAY | Тип значения купона на двухдневную бесплатную доставку. |
Получить запрос на продвижение
Сообщение запроса для метода GetPromotion
.
Поля | |
---|---|
name | Необходимый. Название рекламной акции, которую нужно получить. Формат: |
ВставкаPromotionRequest
Сообщение запроса для метода InsertPromotion
.
Поля | |
---|---|
parent | Необходимый. Аккаунт, в который будет добавлена акция. Формат: аккаунты/{аккаунт} |
promotion | Необходимый. Продвижение для вставки. |
data_source | Необходимый. Источник данных формата продвижения : |
СписокАкцииЗапрос
Сообщение запроса для метода ListPromotions
.
Поля | |
---|---|
parent | Необходимый. Аккаунт, для которого нужно перечислить обработанные рекламные акции. Формат: |
page_size | Только вывод. Максимальное количество акций для возврата. Служба может возвращать меньшее значение, чем это значение. Максимальное значение — 1000; значения выше 1000 будут сокращены до 1000. Если не указано, будет возвращено максимальное количество рекламных акций. |
page_token | Только вывод. Токен страницы, полученный в результате предыдущего вызова При разбиении на страницы все остальные параметры, предоставляемые |
Список рекламных акцийОтвет
Ответное сообщение для метода ListPromotions
.
Поля | |
---|---|
promotions[] | Обработанные акции с указанного аккаунта. |
next_page_token | Токен, который можно отправить как |
Тип предложения
Тип акции.
Перечисления | |
---|---|
OFFER_TYPE_UNSPECIFIED | Неизвестный тип предложения. |
NO_CODE | Тип предложения без кода. |
GENERIC_CODE | Тип предложения с кодом. Общий код активации для акции требуется, если offerType = GENERIC_CODE . |
ПродуктПрименимость
На какой товар или список товаров распространяется акция.
Перечисления | |
---|---|
PRODUCT_APPLICABILITY_UNSPECIFIED | На какие товары распространяется акция, неизвестно. |
ALL_PRODUCTS | Применимо ко всем продуктам. |
SPECIFIC_PRODUCTS | Применимо только к одному продукту или списку продуктов. |
Повышение
Представляет собой продвижение по службе. Более подробную информацию можно найти в следующих статьях.
Требуемые входные атрибуты продвижения для прохождения проверок достоверности данных в основном определены ниже:
После вставки и обновления входных данных о промо-акции может пройти несколько минут, прежде чем можно будет получить окончательную рекламную акцию.
Поля | |
---|---|
name | Идентификатор. Название акции. Формат: |
promotion_id | Необходимый. Пользователь предоставил идентификатор акции, чтобы однозначно идентифицировать ее. Соблюдайте минимальные требования , чтобы избежать отклонения рекламных акций. |
content_language | Необходимый. Двухбуквенный языковой код ISO 639-1 для рекламной акции. Акции доступны только для выбранных языков . |
target_country | Необходимый. Целевая страна используется как часть уникального идентификатора. Представлен в виде кода территории CLDR . Промоакции доступны только в некоторых странах. Бесплатные предложения и товарная реклама, реклама местного ассортимента. |
redemption_channel[] | Необходимый. Канал выкупа для продвижения. Требуется хотя бы один канал. |
data_source | Только вывод. Основной источник данных промоакции. |
attributes | Необязательный. Список атрибутов продвижения. |
custom_attributes[] | Необязательный. Список пользовательских атрибутов (предоставленных продавцом). Его также можно использовать для отправки любого атрибута спецификации данных в его общей форме (например, |
promotion_status | Только вывод. Статус акции , вопросы проверки данных, то есть информация о акции вычисляется асинхронно. |
version_number | Необязательный. Представляет существующую версию (свежесть) рекламной акции, которую можно использовать для сохранения правильного порядка при одновременном выполнении нескольких обновлений. Если этот параметр установлен, вставка предотвращается, если номер версии меньше текущего номера версии существующего рекламного мероприятия. Повторную вставку (например, обновление акции через 30 дней) можно выполнить с текущим Если операция предотвращена, будет выброшено прерванное исключение. |
Статус продвижения
Статус акции.
Поля | |
---|---|
destination_statuses[] | Только вывод. Целевые направления продвижения. |
item_level_issues[] | Только вывод. Перечень вопросов, связанных с продвижением. |
creation_date | Только вывод. Дата создания рекламного мероприятия в формате ISO 8601 : дата, время и смещение, например |
last_update_date | Только вывод. Дата последнего обновления статуса продвижения в формате ISO 8601 : дата, время и смещение, например |
Статус назначения
Статус указанного пункта назначения.
Поля | |
---|---|
reporting_context | Только вывод. Название места проведения акции. |
status | Только вывод. Статус указанного пункта назначения. |
Состояние
Текущее состояние продвижения.
Перечисления | |
---|---|
STATE_UNSPECIFIED | Неизвестный статус продвижения. |
IN_REVIEW | Акция находится на рассмотрении. |
REJECTED | Продвижение отклонено. |
LIVE | Акция одобрена и активна. |
STOPPED | Акция остановлена продавцом. |
EXPIRED | Акция больше не активна. |
PENDING | Акция не остановлена, все отзывы одобрены, но дата активации находится в будущем. |
ItemLevelIssue
Вопрос связан с продвижением.
Поля | |
---|---|
code | Только вывод. Код ошибки проблемы. |
severity | Только вывод. Как эта проблема влияет на показ промоакции. |
resolution | Только вывод. Может ли проблема быть решена продавцом. |
attribute | Только вывод. Имя атрибута, если проблема вызвана одним атрибутом. |
reporting_context | Только вывод. Пункт назначения, к которому относится проблема. |
description | Только вывод. Краткое описание проблемы на английском языке. |
detail | Только вывод. Подробное описание проблемы на английском языке. |
documentation | Только вывод. URL-адрес веб-страницы, которая поможет решить эту проблему. |
applicable_countries[] | Только вывод. Список кодов стран (ISO 3166-1 альфа-2), в которых проблема применима к предложению. |
Строгость
Серьезность проблемы.
Перечисления | |
---|---|
SEVERITY_UNSPECIFIED | Не указан. |
NOT_IMPACTED | Данная проблема представляет собой предупреждение и не оказывает прямого влияния на продвижение. |
DEMOTED | Продвижение понижено в рейтинге и, скорее всего, будет иметь ограниченную эффективность в результатах поиска. |
DISAPPROVED | Проблема не одобряет продвижение. |
Канал погашения
Канал продвижения.
Перечисления | |
---|---|
REDEMPTION_CHANNEL_UNSPECIFIED | Указывает, что канал не указан. |
IN_STORE | Указывает, что канал доступен. Это то же самое, что и local канал, используемый для products . |
ONLINE | Указывает, что канал онлайн. |
МагазинПрименимость
Коды магазинов или список кодов магазинов, на которые распространяется акция. Только для рекламы местного ассортимента.
Перечисления | |
---|---|
STORE_APPLICABILITY_UNSPECIFIED | На какие коды магазинов распространяется акция, неизвестно. |
ALL_STORES | Акция распространяется на все магазины. |
SPECIFIC_STORES | Акция распространяется только на указанные магазины. |