Package google.shopping.merchant.products.v1beta

Индекс

ПродуктВходыСервис

Сервис для использования ресурса ProductInput. Эта услуга работает только для продуктов с онлайн-каналом.

Удалитьпродуктинпут

rpc DeleteProductInput( DeleteProductInputRequest ) returns ( Empty )

Удаляет данные о продукте из вашего аккаунта Merchant Center.

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

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Для получения дополнительной информации см.OAuth 2.0 Overview .

Вставкапродуктинпут

rpc InsertProductInput( InsertProductInputRequest ) returns ( ProductInput )

Загружает информацию о продукте в ваш аккаунт Merchant Center. Если входные данные с тем же ContentLanguage, OfferId и DataSource уже существуют, этот метод заменяет эту запись.

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

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Для получения дополнительной информации см.OAuth 2.0 Overview .

ПродукцияСервис

Сервис для использования ресурса продукта. Эта услуга работает только для продуктов с онлайн-каналом.

Получитьпродукт

rpc GetProduct( GetProductRequest ) returns ( Product )

Получает обработанный продукт из вашей учетной записи Merchant Center.

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

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Для получения дополнительной информации см.OAuth 2.0 Overview .

СписокПродуктов

rpc ListProducts( ListProductsRequest ) returns ( ListProductsResponse )

Перечисляет обработанные продукты в вашем аккаунте Merchant Center. Ответ может содержать меньше элементов, чем указано в параметре pageSize. Положитесь на pageToken, чтобы определить, есть ли еще элементы, которые нужно запросить.

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

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Для получения дополнительной информации см.OAuth 2.0 Overview .

Атрибуты

Атрибуты.

Поля
expiration_ date

Timestamp

Дата истечения срока действия элемента, указанная при вставке, в формате ISO 8601 . Фактическая дата истечения срока действия отображается в productstatuses как googleExpirationDate и может быть раньше, если expirationDate находится слишком далеко в будущем.

disclosure_ date

Timestamp

Дата и время, когда предложение становится видимым в результатах поиска на YouTube в формате ISO 8601 . Дополнительную информацию см. в разделе [Дата раскрытия информации]( https://support.google.com/merchants/answer/13034208 ).

availability_ date

Timestamp

В тот день, когда предварительно заказанный продукт станет доступен для доставки в формате ISO 8601 .

gtin[]

string

Глобальные номера предметов торговли ( GTIN ) товара. Вы можете указать до 10 номеров GTIN.

price

Price

Цена товара.

installment

Installment

Количество и размер взносов для оплаты товара.

subscription_ cost

SubscriptionCost

Количество периодов (месяцев или лет) и сумма оплаты за период для элемента с соответствующим договором подписки.

loyalty_ points

LoyaltyPoints

Баллы лояльности, которые пользователи получают после покупки товара. Только Япония.

loyalty_ programs[]

LoyaltyProgram

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

product_ types[]

string

Категории товара (в формате, указанном в спецификации товара ).

sale_ price

Price

Объявлена ​​цена продажи товара.

sale_ price_ effective_ date

Interval

Диапазон дат, в течение которого товар находится в продаже (см. спецификацию данных о товаре ).

product_ height

ProductDimension

Высота изделия в предусмотренных единицах. Значение должно находиться в диапазоне от 0 (исключительно) до 3000 (включительно).

product_ length

ProductDimension

Длина изделия в предусмотренных единицах. Значение должно находиться в диапазоне от 0 (исключительно) до 3000 (включительно).

product_ width

ProductDimension

Ширина изделия в предусмотренных единицах. Значение должно находиться в диапазоне от 0 (исключительно) до 3000 (включительно).

product_ weight

ProductWeight

Вес изделия в указанных единицах. Значение должно находиться в диапазоне от 0 (исключая) до 2000 (включительно).

shipping[]

Shipping

Правила доставки.

free_ shipping_ threshold[]

FreeShippingThreshold

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

shipping_ weight

ShippingWeight

Вес товара для отправки.

shipping_ length

ShippingDimension

Длина товара для доставки.

shipping_ width

ShippingDimension

Ширина товара для транспортировки.

shipping_ height

ShippingDimension

Высота товара для транспортировки.

size_ types[]

string

Разрез изделия. Его можно использовать для представления комбинированных типов размеров предметов одежды. Можно указать максимум два типа размера (см. [https://support.google.com/merchants/answer/6324497](тип размера)).

taxes[]

Tax

Налоговая информация.

unit_ pricing_ measure

UnitPricingMeasure

Мера и размер предмета.

unit_ pricing_ base_ measure

UnitPricingBaseMeasure

Предпочтение знаменателя цены единицы продукции.

ads_ labels[]

string

Аналогично ads_grouping, но работает только с ценой за клик.

cost_ of_ goods_ sold

Price

Стоимость проданного товара. Используется для отчетности по валовой прибыли.

product_ details[]

ProductDetail

Техническая спецификация или дополнительные сведения о продукте.

product_ highlights[]

string

Пункты списка, описывающие наиболее важные особенности продукта.

display_ ads_ similar_ ids[]

string

Рекомендации рекламодателя.

promotion_ ids[]

string

Уникальный идентификатор акции.

included_ destinations[]

string

Список направлений, которые необходимо включить в эту цель (соответствует установленным флажкам в Merchant Center). Пункты назначения по умолчанию всегда включаются, если они не указаны в excludedDestinations .

excluded_ destinations[]

string

Список направлений, которые следует исключить для этой цели (соответствует снятым флажкам в Merchant Center).

shopping_ ads_ excluded_ countries[]

string

Список кодов стран (ISO 3166-1 альфа-2), позволяющих исключить предложение из целевой страницы товарной рекламы. Страны из этого списка удаляются из стран, указанных в настройках источника данных.

cloud_ export_ additional_ properties[]

CloudExportAdditionalProperties

Дополнительные поля для экспорта в программу Cloud Retail.

certifications[]

Certification

Сертификация продукции, например, для маркировки энергоэффективности продукции, зарегистрированной в базе данных ЕС EPREL . Дополнительную информацию см. в статье Справочного центра .

auto_ pricing_ min_ price

Price

Гарантия в проектах «Автоматические скидки» ( https://support.google.com/merchants/answer/10295759 ) и «Динамические акции» ( https://support.google.com/merchants/answer/13949249 ), гарантирующая, что скидки на предложения продавцов не упадут ниже этого значения, тем самым сохраняя ценность и прибыльность предложения.

sustainability_ incentives[]

ProductSustainabilityIncentive

Список программ стимулирования устойчивого развития.

identifier_ exists

bool

Установите для этого значения значение false, если товар не имеет уникальных идентификаторов продукта, соответствующих его категории, таких как GTIN, MPN и бренд. По умолчанию — true, если не указано иное.

is_ bundle

bool

Является ли товар набором, определенным продавцом. Пакет – это группа различных товаров, продаваемых продавцом по одной цене.

title

string

Название предмета.

description

string

Описание предмета.

adult

bool

Установите значение true, если элемент предназначен для взрослых.

age_ group

string

Целевая возрастная группа товара.

availability

string

Статус доступности товара.

brand

string

Бренд товара.

color

string

Цвет предмета.

condition

string

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

gender

string

Целевой пол элемента.

google_ product_ category

string

Категория товара Google (см. Таксономию продуктов Google ). При запросе продуктов это поле будет содержать значение, указанное пользователем. В настоящее время невозможно вернуть автоматически назначенные категории продуктов Google через API.

item_ group_ id

string

Общий идентификатор для всех вариантов одного и того же продукта.

material

string

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

mpn

string

Номер детали производителя ( MPN ) изделия.

pattern

string

Узор изделия (например, в горошек).

sell_ on_ google_ quantity

int64

Количество продукта, доступного для продажи в Google. Поддерживается только для онлайн-продуктов.

max_ handling_ time

int64

Максимальный срок обработки товара (в рабочих днях).

min_ handling_ time

int64

Минимальный срок обработки товара (в рабочих днях).

shipping_ label

string

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

transit_ time_ label

string

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

size

string

Размер предмета. Допускается только одно значение. Для вариантов с разными размерами вставьте отдельный товар для каждого размера с одинаковым значением itemGroupId (см. [https://support.google.com/merchants/answer/6324492](определение размера)).

size_ system

string

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

tax_ category

string

Налоговая категория товара.

energy_ efficiency_ class

string

Класс энергоэффективности, определенный в директиве ЕС 2010/30/EU.

min_ energy_ efficiency_ class

string

Класс энергоэффективности, определенный в директиве ЕС 2010/30/EU.

max_ energy_ efficiency_ class

string

Класс энергоэффективности, определенный в директиве ЕС 2010/30/EU.

multipack

int64

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

ads_ grouping

string

Используется для произвольной группировки элементов. Только для CPA%, в противном случае не рекомендуется.

ads_ redirect

string

Позволяет рекламодателям переопределять URL-адрес элемента, когда продукт отображается в контексте рекламы продукта.

display_ ads_ id

string

Идентификатор элемента для кампаний динамического ремаркетинга.

display_ ads_ title

string

Название элемента для кампаний динамического ремаркетинга.

display_ ads_ value

double

Предлагайте маржу для кампаний динамического ремаркетинга.

pickup_ method

string

Вариант получения товара.

pickup_ sla

string

График получения товара из магазина.

custom_ label_ 0

string

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

custom_ label_ 1

string

Специальная метка 1 для индивидуальной группировки товаров в торговой кампании.

custom_ label_ 2

string

Специальная метка 2 для индивидуальной группировки товаров в торговой кампании.

custom_ label_ 3

string

Специальная метка 3 для индивидуальной группировки товаров в торговой кампании.

custom_ label_ 4

string

Специальная метка 4 для индивидуальной группировки товаров в торговой кампании.

external_ seller_ id

string

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

pause

string

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

structured_ title

ProductStructuredTitle

Структурированный заголовок для заголовков, созданных алгоритмически (ИИ).

structured_ description

ProductStructuredDescription

Структурированное описание для описаний, созданных алгоритмически (ИИ).

Сертификация

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

Поля
certification_ authority

string

Центр сертификации, например «Европейская_Комиссия». Максимальная длина — 2000 символов.

certification_ name

string

Название сертификации, например «EPREL». Максимальная длина — 2000 символов.

certification_ code

string

Код сертификации. Максимальная длина — 2000 символов.

certification_ value

string

Сертификационное значение (также известное как класс, уровень или оценка), например «A+», «C», «золото». Максимальная длина — 2000 символов.

Клаудэкспортдополнительные свойства

Свойство продукта для Cloud Retail API. Например, свойства телевизионного продукта могут быть «Разрешение экрана» или «Размер экрана».

Поля
text_ value[]

string

Текстовое значение данного свойства. Например, «8K(UHD)» может быть текстовым значением для телевизионного продукта. Максимальная повторяемость этого значения — 400. Значения хранятся в произвольном, но последовательном порядке. Максимальный размер строки — 256 символов.

int_ value[]

int64

Целочисленные значения данного свойства. Например, 1080 для разрешения экрана телевизора. Максимальная повторяемость этого значения — 400. Значения хранятся в произвольном, но последовательном порядке.

float_ value[]

float

Плавающие значения данного свойства. Например для ТВ-продукта 1.2345. Максимальная повторяемость этого значения — 400. Значения хранятся в произвольном, но последовательном порядке.

property_ name

string

Название данного свойства. Например, «Разрешение экрана» для телевизионного продукта. Максимальный размер строки — 256 символов.

bool_ value

bool

Логическое значение данного свойства. Например, для телевизионного продукта «Верно» или «Неверно», если экран UHD.

min_ value

float

Минимальное плавающее значение данного свойства. Например для телепродукта 1.00.

max_ value

float

Максимальное плавающее значение данного свойства. Например для телепродукта 100.00.

unit_ code

string

Единица данного имущества. Например, «Пиксели» для телепродукта. Максимальный размер строки — 256 байт.

Удалитьпродуктинпутрекуест

Сообщение запроса для метода DeleteProductInput.

Поля
name

string

Необходимый. Имя входного ресурса продукта, который необходимо удалить. Формат: account/{account}/productInputs/{product}, где последний раздел product состоит из 4 частей: Channel~content_language~feed_label~offer_id, пример названия продукта: "accounts/123/productInputs/online~en~US~sku123".

data_ source

string

Необходимый. Основной или дополнительный источник данных, из которого следует удалить входные данные о продукте. Формат: accounts/{account}/dataSources/{datasource} .

Бесплатная доставкаПорог

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

Поля
country

string

Код территории CLDR страны, в которую будет отправлен товар.

price_ threshold

Price

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

Получить запрос продукта

Сообщение запроса для метода GetProduct.

Поля
name

string

Необходимый. Название продукта, который требуется получить. Формат: accounts/{account}/products/{product} , где последний раздел product состоит из 4 частей: канал~content_language~feed_label~offer_id, пример названия продукта: "accounts/123/products/online~en~US~sku123".

Инсертопродуктинпутрекуест

Сообщение запроса для метода InsertProductInput.

Поля
parent

string

Необходимый. Аккаунт, в который будет добавлен этот товар. Формат: аккаунты/{аккаунт}

product_ input

ProductInput

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

data_ source

string

Необходимый. Имя основного или дополнительного источника данных о продукте. Если продукт уже существует и указанный источник данных отличается, продукт будет перемещен в новый источник данных.

Поддерживаются только источники данных API.

Формат: accounts/{account}/dataSources/{datasource} .

Рассрочка

Сообщение, обозначающее взнос.

Поля
months

int64

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

amount

Price

Сумма, которую покупатель должен платить в месяц.

downpayment

Price

Сумма авансового платежа, которую должен заплатить покупатель.

credit_ type

string

Вид рассрочки платежа. Поддерживаемые значения: * « finance » * « lease »

СписокПродукцияЗапрос

Сообщение запроса для метода ListProducts.

Поля
parent

string

Необходимый. Учетная запись, для которой нужно перечислить обработанные продукты. Формат: аккаунты/{аккаунт}

page_ size

int32

Максимальное количество товаров для возврата. Служба может вернуть меньшее значение, чем это значение. Максимальное значение — 250; значения выше 250 будут сокращены до 250. Если не указано, будет возвращено максимальное количество продуктов.

page_ token

string

Токен страницы, полученный в результате предыдущего вызова ListProducts . Предоставьте это, чтобы получить следующую страницу.

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

СписокПродуктовОтвет

Ответное сообщение для метода ListProducts.

Поля
products[]

Product

Продукты переработки с указанного счета. Это ваши обработанные продукты после применения правил и дополнительных источников данных.

next_ page_ token

string

Токен, который можно отправить как page_token для получения следующей страницы. Если это поле опущено, последующие страницы отсутствуют.

Очки лояльности

Сообщение, обозначающее баллы лояльности.

Поля
name

string

Название программы лояльности. Рекомендуется ограничить имя 12 полноширинными символами или 24 латинскими символами.

points_ value

int64

Баллы лояльности ритейлера в абсолютном значении.

ratio

double

Отношение пункта при конвертации в валюту. Google принимает валюту в зависимости от настроек Merchant Center. Если соотношение не указано, по умолчанию оно равно 1,0.

Программа лояльности

Сообщение, представляющее программу лояльности.

Поля
program_ label

string

Ярлык программы лояльности. Это внутренняя метка, которая однозначно идентифицирует отношения между субъектом-торговцем и субъектом программы лояльности. Метка должна быть предоставлена, чтобы система могла связать указанные ниже активы (например, цену и баллы) с продавцом. Соответствующая программа должна быть привязана к мерчант-аккаунту.

tier_ label

string

Ярлык уровня в программе лояльности. Должно соответствовать одному из ярлыков в программе.

price

Price

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

cashback_ for_ future_ use

Price

Кэшбэк, который можно использовать для будущих покупок.

loyalty_ points

int64

Количество баллов лояльности, полученных за покупку.

member_ price_ effective_ date

Interval

Диапазон дат, в течение которого товар имеет право на членскую цену. Если не указано, цена участника всегда применима. Диапазон дат представлен парой дат ISO 8601, разделенных пробелом, запятой или косой чертой.

shipping_ label

string

Этикетка о преимуществах доставки. Если поле имеет значение, это предложение имеет льготу по доставке по программе лояльности. Если значение поля не указано, товар не подлежит доставке по программе лояльности для данного уровня лояльности.

Продукт

Обработанный продукт, созданный на основе нескольких product inputs после применения правил и дополнительных источников данных. Этот обработанный продукт соответствует тому, что отображается в вашем аккаунте Merchant Center, а также в товарных объявлениях и на других платформах Google. Каждый продукт состоит ровно из одного входного продукта основного источника данных и нескольких входных дополнительных источников данных. После вставки, обновления или удаления ввода продукта может пройти несколько минут, прежде чем можно будет получить обновленный обработанный продукт.

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

Поля
name

string

Название продукта. Формат: "{product.name=accounts/{account}/products/{product}}" , где последний раздел product состоит из 4 частей: канал~content_language~feed_label~offer_id, пример названия продукта: "accounts/123/products/online~en~US~sku123".

channel

ChannelEnum

Только вывод. Канал продукта.

offer_ id

string

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

content_ language

string

Только вывод. Двухбуквенный языковой код продукта по стандарту ISO 639-1 .

feed_ label

string

Только вывод. Этикетка фида продукта.

data_ source

string

Только вывод. Основной источник данных о продукте.

attributes

Attributes

Только вывод. Список атрибутов продукта.

custom_ attributes[]

CustomAttribute

Только вывод. Список пользовательских атрибутов (предоставленных продавцом). Его также можно использовать для отправки любого атрибута спецификации данных в его общей форме (например, { "name": "size type", "value": "regular" } ). Это полезно для отправки атрибутов, которые явно не предоставляются API, например дополнительных атрибутов, используемых для покупки через Google.

product_ status

ProductStatus

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

version_ number

int64

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

Если этот параметр установлен, вставка предотвращается, если номер версии меньше текущего номера версии существующего продукта. Повторную установку (например, обновление продукта через 30 дней) можно выполнить с текущим version_number .

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

Если операция предотвращена, будет выброшено прерванное исключение.

Деталь продукта

Детали продукта.

Поля
section_ name

string

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

attribute_ name

string

Название детали товара.

attribute_ value

string

Ценность детали продукта.

Размер продукта

Размерность изделия.

Поля
value

double

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

unit

string

Необходимый. Единицы измерения. Допустимые значения: * " in " * " cm "

ПродуктВвод

Этот ресурс представляет входные данные, которые вы отправляете для продукта, а не обработанный продукт, который вы видите в Merchant Center, в товарных объявлениях или на платформах Google. Входные данные продукта, правила и дополнительные данные источника данных объединяются для создания обработанного Product .

Требуемые входные атрибуты продукта для прохождения проверок достоверности данных в первую очередь определяются в Спецификации данных о продуктах .

Обязательны следующие атрибуты: feedLabel , contentLanguage и offerId .

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

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

Поля
name

string

Идентификатор. Имя входного продукта. Формат: "{productinput.name=accounts/{account}/productInputs/{productinput}}" , где последний раздел productinput состоит из 4 частей: Channel~content_language~feed_label~offer_id. Пример входного имени продукта: "accounts/123/productInputs/online~en~US~sku123".

product

string

Только вывод. Название обрабатываемого продукта. Формат: "{product.name=accounts/{account}/products/{product}}"

channel

ChannelEnum

Неизменяемый. Канал продукта.

offer_ id

string

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

content_ language

string

Необходимый. Неизменяемый. Двухбуквенный языковой код продукта по стандарту ISO 639-1 .

feed_ label

string

Необходимый. Неизменяемый. Этикетка фида продукта.

attributes

Attributes

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

custom_ attributes[]

CustomAttribute

Необязательный. Список пользовательских атрибутов (предоставленных продавцом). Его также можно использовать для отправки любого атрибута спецификации данных в его общей форме (например, { "name": "size type", "value": "regular" } ). Это полезно для отправки атрибутов, которые явно не предоставляются API, например дополнительных атрибутов, используемых для покупки через Google. Максимально допустимое количество символов для каждого настраиваемого атрибута — 10 240 (представляет собой сумму символов имени и значения). Для каждого продукта можно установить максимум 2500 пользовательских атрибутов общим размером 102,4 КБ. При вставке символы подчеркивания в именах пользовательских атрибутов заменяются пробелами.

version_ number

int64

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

Если этот параметр установлен, вставка предотвращается, если номер версии меньше текущего номера версии существующего продукта. Повторную установку (например, обновление продукта через 30 дней) можно выполнить с текущим version_number .

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

Если операция предотвращена, будет выброшено прерванное исключение.

Статус продукта

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

Поля
destination_ statuses[]

DestinationStatus

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

item_ level_ issues[]

ItemLevelIssue

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

creation_ date

Timestamp

Дата создания элемента в формате ISO 8601 .

last_ update_ date

Timestamp

Дата последнего обновления элемента в формате ISO 8601 .

google_ expiration_ date

Timestamp

Дата истечения срока действия элемента в формате ISO 8601 .

Статус назначения

Статус назначения статуса продукта.

Поля
reporting_ context

ReportingContextEnum

Имя контекста отчетности.

approved_ countries[]

string

Список кодов стран (ISO 3166-1 альфа-2), в которых предложение одобрено.

pending_ countries[]

string

Список кодов стран (ISO 3166-1 альфа-2), в которых предложение ожидает утверждения.

disapproved_ countries[]

string

Список кодов стран (ISO 3166-1 альфа-2), в которых предложение отклонено.

ItemLevelIssue

ItemLevelIssue статуса продукта.

Поля
code

string

Код ошибки проблемы.

severity

Severity

Как эта проблема влияет на обслуживание предложения.

resolution

string

Может ли проблема быть решена продавцом.

attribute

string

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

reporting_ context

ReportingContextEnum

Контекст отчетности, к которому относится проблема.

description

string

Краткое описание проблемы на английском языке.

detail

string

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

documentation

string

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

applicable_ countries[]

string

Список кодов стран (ISO 3166-1 альфа-2), в которых проблема применима к предложению.

Серьезность

Как проблема влияет на подачу продукта.

Перечисления
SEVERITY_UNSPECIFIED Не указан.
NOT_IMPACTED Эта проблема представляет собой предупреждение и не оказывает прямого влияния на продукт.
DEMOTED Продукт понижен в рейтинге и, скорее всего, его эффективность в результатах поиска ограничена.
DISAPPROVED Проблема отклоняет продукт.

ПродуктСтруктурированноеОписание

Структурированное описание для описаний, созданных алгоритмически (ИИ).

Поля
digital_ source_ type

string

Тип цифрового источника, например «trained_algorithmic_media». По следам IPTC . Максимальная длина — 40 символов.

content

string

Текст описания Максимальная длина 5000 символов.

ПродуктСтруктурированныйНазвание

Структурированный заголовок для заголовков, созданных алгоритмически (ИИ).

Поля
digital_ source_ type

string

Тип цифрового источника, например «trained_algorithmic_media». По следам IPTC . Максимальная длина — 40 символов.

content

string

Текст заголовка Максимальная длина — 150 символов.

ПродуктУстойчивое развитиеСтимул

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

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

Price

Фиксированная сумма поощрения.

percentage

double

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

type

Type

Программа стимулирования устойчивого развития.

Тип

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

Перечисления
TYPE_UNSPECIFIED Неуказанный или неизвестный тип стимула устойчивого развития.
EV_TAX_CREDIT Программа, предлагающая снижение налоговых обязательств для электромобилей и, в некоторых странах, для подключаемых гибридов. Эти скидки могут основываться на определенной сумме или проценте от продажной цены.
EV_PRICE_DISCOUNT Программа субсидирования, часто называемая экологическим бонусом, предоставляет грант на покупку электромобилей, а в некоторых странах — подключаемых гибридов. Сумма гранта может быть фиксированной суммой или процентом от продажной цены.

ПродуктВес

Вес продукта.

Поля
value

double

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

unit

string

Необходимый. Весовая единица. Допустимые значения: * " g " * " kg " * " oz " * " lb "

Перевозки

Доставка товара.

Поля
price

Price

Фиксированная цена доставки, представленная в виде числа.

country

string

Код территории CLDR страны, в которую будет отправлен товар.

region

string

Географический регион, к которому применяется тариф на доставку. См . регион для получения дополнительной информации.

service

string

Описание в свободной форме класса обслуживания или скорости доставки.

location_ id

int64

Числовой идентификатор местоположения, к которому применяется стоимость доставки, как определено в AdWords API .

location_ group_ name

string

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

postal_ code

string

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

min_ handling_ time

int64

Минимальное время обработки (включительно) между получением заказа и отправкой в ​​рабочих днях. 0 означает, что заказ будет отправлен в тот же день, когда он был получен, если это произошло до истечения установленного времени. minHandlingTime может присутствовать только вместе с maxHandlingTime ; но это не требуется, если присутствует maxHandlingTime .

max_ handling_ time

int64

Максимальное время обработки (включительно) между получением заказа и отправкой в ​​рабочих днях. 0 означает, что заказ будет отправлен в тот же день, когда он был получен, если это произошло до истечения установленного времени. И maxHandlingTime , и maxTransitTime необходимы, если указана скорость доставки. minHandlingTime является необязательным, если присутствует maxHandlingTime .

min_ transit_ time

int64

Минимальное время доставки (включительно) между отправкой заказа и доставкой в ​​рабочие дни. 0 означает, что заказ доставляется в тот же день, когда он будет отправлен. minTransitTime может присутствовать только вместе с maxTransitTime ; но это не требуется, если присутствует maxTransitTime .

max_ transit_ time

int64

Максимальное время доставки (включительно) между отправкой заказа и доставкой в ​​рабочих днях. 0 означает, что заказ доставляется в тот же день, когда он будет отправлен. И maxHandlingTime , и maxTransitTime необходимы, если указана скорость доставки. minTransitTime является необязательным, если присутствует maxTransitTime .

Размер доставки

Размер доставки продукта.

Поля
value

double

Размер продукта, используемый для расчета стоимости доставки товара.

unit

string

Единица стоимости.

ДоставкаВес

Вес доставки товара.

Поля
value

double

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

unit

string

Единица стоимости.

Стоимость подписки

Стоимость подписки на продукт.

Поля
period

SubscriptionPeriod

Тип периода подписки. Поддерживаемые значения: * « month » * « year »

period_ length

int64

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

amount

Price

Сумма, которую покупатель должен заплатить за период подписки.

Период подписки

Срок подписки на продукт.

Перечисления
SUBSCRIPTION_PERIOD_UNSPECIFIED Указывает, что период подписки не указан.
MONTH Указывает, что период подписки составляет месяц.
YEAR Указывает, что период подписки равен году.

Налог

Налог на продукт.

Поля
rate

double

Процент налоговой ставки, который применяется к цене товара.

country

string

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

region

string

Географический регион, к которому применяется налоговая ставка.

tax_ ship

bool

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

location_ id

int64

Числовой идентификатор местоположения, к которому применяется налоговая ставка, как определено в AdWords API .

postal_ code

string

Диапазон почтовых индексов, к которому применяется ставка налога, представленный почтовым индексом, префиксом почтового индекса с подстановочным знаком *, диапазоном между двумя почтовыми индексами или двумя префиксами почтового индекса одинаковой длины. Примеры: 94114, 94*, 94002-95460, 94*-95*.

ЕдиницаЦенообразованиеБазаПоказатель

UnitPricingBaseMeasure продукта.

Поля
value

int64

Знаменатель цены за единицу.

unit

string

Единица знаменателя.

ЕдиницаЦенообразованиеМера

UnitPricingMeasure продукта.

Поля
value

double

Мера предмета.

unit

string

Единица измерения.