Package google.shopping.merchant.products.v1beta

Индекс

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

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

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

rpc DeleteProductInput( DeleteProductInputRequest ) returns ( Empty )

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

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

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

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

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

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

rpc InsertProductInput( InsertProductInputRequest ) returns ( ProductInput )

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

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

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

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

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

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

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

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

rpc GetProduct( GetProductRequest ) returns ( Product )

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

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

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

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

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

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

rpc ListProducts( ListProductsRequest ) returns ( ListProductsResponse )

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

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

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

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

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

Атрибуты

Атрибуты.

Поля
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 .

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 ), гарантирующая чтобы скидки на предложения торговцев не опускались ниже этого значения, тем самым сохраняя ценность и прибыльность предложения.

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.

gtin

string

Глобальный номер предмета торговли ( GTIN ) предмета.

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

data_source

string

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

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

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

Поля
country

string

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

price_threshold

Price

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

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

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

Поля
name

string

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

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

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

Поля
parent

string

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

product_input

ProductInput

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

data_source

string

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

Рассрочка

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

Поля
months

int64

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

amount

Price

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

downpayment

Price

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

credit_type

string

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

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

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

Поля
parent

string

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

page_size

int32

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

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

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

Продукт

Обработанный продукт, созданный на основе нескольких [входных данных продукта][[google.shopping.content.bundles.Products.ProductInput] после применения правил и дополнительных источников данных. Этот обработанный продукт соответствует тому, что отображается в вашем аккаунте Merchant Center, а также в товарных объявлениях и на других платформах Google. Каждый продукт состоит ровно из одного входного продукта основного источника данных и нескольких входных дополнительных источников данных. После вставки, обновления или удаления ввода продукта может пройти несколько минут, прежде чем можно будет получить обновленный обработанный продукт.

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

Поля
name

string

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

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. Входные данные о продукте, правила и дополнительные данные источника данных объединяются для создания обработанного [продукта][google.shopping.content.bundles.Products.Product].

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

Обязательны следующие атрибуты: [feedLabel][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] и [offerId][google.shopping.content. Bundles.Products.offer_id].

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

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

Поля
name

string

Идентификатор. Имя входного продукта. Формат: "{productinput.name=accounts/{account}/productInputs/{productinput}}"

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

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][google.shopping.content.bundles.Products.Shipping.min_handling_time] может присутствовать только вместе с [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time]; но это не требуется, если присутствует [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time].

max_handling_time

int64

Максимальное время обработки (включительно) между получением заказа и отправкой в ​​рабочих днях. 0 означает, что заказ будет отправлен в тот же день, когда он был получен, если это произошло до истечения установленного времени. Оба значения [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] и [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] необходимы, если указана скорость доставки. [minHandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] является необязательным, если присутствует [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time].

min_transit_time

int64

Минимальное время доставки (включительно) между отправкой заказа и доставкой в ​​рабочие дни. 0 означает, что заказ доставляется в тот же день, когда он будет отправлен. [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] может присутствовать только вместе с [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]; но это не требуется, если присутствует [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time].

max_transit_time

int64

Максимальное время доставки (включительно) между отправкой заказа и доставкой в ​​рабочих днях. 0 означает, что заказ доставляется в тот же день, когда он будет отправлен. Оба значения [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] и [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] необходимы, если указана скорость доставки. [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] является необязательным, если присутствует [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time].

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

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

Поля
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

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