REST Resource: accounts.products

Ресурс: Продукт

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

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

JSON-представление
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
Поля
name

string

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

channel

enum ( ChannelEnum )

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

offerId

string

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

contentLanguage

string

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

feedLabel

string

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

dataSource

string

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

attributes

object ( Attributes )

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

customAttributes[]

object ( CustomAttribute )

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

productStatus

object ( ProductStatus )

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

versionNumber

string ( int64 format)

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

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

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

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

Атрибуты

Атрибуты.

JSON-представление
{
  "additionalImageLinks": [
    string
  ],
  "expirationDate": string,
  "disclosureDate": string,
  "availabilityDate": string,
  "price": {
    object (Price)
  },
  "installment": {
    object (Installment)
  },
  "subscriptionCost": {
    object (SubscriptionCost)
  },
  "loyaltyPoints": {
    object (LoyaltyPoints)
  },
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "productTypes": [
    string
  ],
  "salePrice": {
    object (Price)
  },
  "salePriceEffectiveDate": {
    object (Interval)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productWeight": {
    object (ProductWeight)
  },
  "shipping": [
    {
      object (Shipping)
    }
  ],
  "freeShippingThreshold": [
    {
      object (FreeShippingThreshold)
    }
  ],
  "shippingWeight": {
    object (ShippingWeight)
  },
  "shippingLength": {
    object (ShippingDimension)
  },
  "shippingWidth": {
    object (ShippingDimension)
  },
  "shippingHeight": {
    object (ShippingDimension)
  },
  "sizeTypes": [
    string
  ],
  "taxes": [
    {
      object (Tax)
    }
  ],
  "unitPricingMeasure": {
    object (UnitPricingMeasure)
  },
  "unitPricingBaseMeasure": {
    object (UnitPricingBaseMeasure)
  },
  "adsLabels": [
    string
  ],
  "costOfGoodsSold": {
    object (Price)
  },
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productHighlights": [
    string
  ],
  "displayAdsSimilarIds": [
    string
  ],
  "promotionIds": [
    string
  ],
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "shoppingAdsExcludedCountries": [
    string
  ],
  "lifestyleImageLinks": [
    string
  ],
  "cloudExportAdditionalProperties": [
    {
      object (CloudExportAdditionalProperties)
    }
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "autoPricingMinPrice": {
    object (Price)
  },
  "identifierExists": boolean,
  "isBundle": boolean,
  "title": string,
  "description": string,
  "link": string,
  "mobileLink": string,
  "canonicalLink": string,
  "imageLink": string,
  "adult": boolean,
  "ageGroup": string,
  "availability": string,
  "brand": string,
  "color": string,
  "condition": string,
  "gender": string,
  "googleProductCategory": string,
  "gtin": string,
  "itemGroupId": string,
  "material": string,
  "mpn": string,
  "pattern": string,
  "sellOnGoogleQuantity": string,
  "maxHandlingTime": string,
  "minHandlingTime": string,
  "shippingLabel": string,
  "transitTimeLabel": string,
  "size": string,
  "sizeSystem": string,
  "taxCategory": string,
  "energyEfficiencyClass": string,
  "minEnergyEfficiencyClass": string,
  "maxEnergyEfficiencyClass": string,
  "multipack": string,
  "adsGrouping": string,
  "adsRedirect": string,
  "displayAdsId": string,
  "displayAdsTitle": string,
  "displayAdsLink": string,
  "displayAdsValue": number,
  "pickupMethod": string,
  "pickupSla": string,
  "linkTemplate": string,
  "mobileLinkTemplate": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "externalSellerId": string,
  "pause": string,
  "virtualModelLink": string,
  "structuredTitle": {
    object (ProductStructuredTitle)
  },
  "structuredDescription": {
    object (ProductStructuredDescription)
  }
}
Поля
expirationDate

string ( Timestamp format)

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

disclosureDate

string ( Timestamp format)

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

availabilityDate

string ( Timestamp format)

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

price

object ( Price )

Цена товара.

installment

object ( Installment )

Количество и сумма платежей за товар.

subscriptionCost

object ( SubscriptionCost )

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

loyaltyPoints

object ( LoyaltyPoints )

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

loyaltyPrograms[]

object ( LoyaltyProgram )

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

productTypes[]

string

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

salePrice

object ( Price )

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

salePriceEffectiveDate

object ( Interval )

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

productHeight

object ( ProductDimension )

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

productLength

object ( ProductDimension )

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

productWidth

object ( ProductDimension )

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

productWeight

object ( ProductWeight )

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

shipping[]

object ( Shipping )

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

freeShippingThreshold[]

object ( FreeShippingThreshold )

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

shippingWeight

object ( ShippingWeight )

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

shippingLength

object ( ShippingDimension )

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

shippingWidth

object ( ShippingDimension )

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

shippingHeight

object ( ShippingDimension )

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

sizeTypes[]

string

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

taxes[]

object ( Tax )

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

unitPricingMeasure

object ( UnitPricingMeasure )

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

unitPricingBaseMeasure

object ( UnitPricingBaseMeasure )

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

adsLabels[]

string

Аналогично группе объявлений, но работает только с ценой за клик.

costOfGoodsSold

object ( Price )

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

productDetails[]

object ( ProductDetail )

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

productHighlights[]

string

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

displayAdsSimilarIds[]

string

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

promotionIds[]

string

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

includedDestinations[]

string

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

excludedDestinations[]

string

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

shoppingAdsExcludedCountries[]

string

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

cloudExportAdditionalProperties[]

object ( CloudExportAdditionalProperties )

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

certifications[]

object ( Certification )

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

autoPricingMinPrice

object ( Price )

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

identifierExists

boolean

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

isBundle

boolean

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

title

string

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

description

string

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

adult

boolean

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

ageGroup

string

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

availability

string

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

brand

string

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

color

string

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

condition

string

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

gender

string

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

googleProductCategory

string

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

gtin

string

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

itemGroupId

string

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

material

string

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

mpn

string

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

pattern

string

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

sellOnGoogleQuantity

string ( int64 format)

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

maxHandlingTime

string ( int64 format)

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

minHandlingTime

string ( int64 format)

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

shippingLabel

string

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

transitTimeLabel

string

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

size

string

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

sizeSystem

string

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

taxCategory

string

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

energyEfficiencyClass

string

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

minEnergyEfficiencyClass

string

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

maxEnergyEfficiencyClass

string

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

multipack

string ( int64 format)

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

adsGrouping

string

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

adsRedirect

string

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

displayAdsId

string

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

displayAdsTitle

string

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

displayAdsValue

number

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

pickupMethod

string

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

pickupSla

string

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

customLabel0

string

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

customLabel1

string

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

customLabel2

string

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

customLabel3

string

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

customLabel4

string

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

externalSellerId

string

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

pause

string

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

structuredTitle

object ( ProductStructuredTitle )

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

structuredDescription

object ( ProductStructuredDescription )

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

Рассрочка

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

JSON-представление
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  },
  "creditType": string
}
Поля
months

string ( int64 format)

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

amount

object ( Price )

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

downpayment

object ( Price )

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

creditType

string

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

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

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

JSON-представление
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
Поля
period

enum ( SubscriptionPeriod )

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

periodLength

string ( int64 format)

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

amount

object ( Price )

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

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

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

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

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

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

JSON-представление
{
  "name": string,
  "pointsValue": string,
  "ratio": number
}
Поля
name

string

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

pointsValue

string ( int64 format)

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

ratio

number

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

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

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

JSON-представление
{
  "programLabel": string,
  "tierLabel": string,
  "price": {
    object (Price)
  },
  "cashbackForFutureUse": {
    object (Price)
  },
  "loyaltyPoints": string
}
Поля
programLabel

string

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

tierLabel

string

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

price

object ( Price )

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

cashbackForFutureUse

object ( Price )

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

loyaltyPoints

string ( int64 format)

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

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

Размер изделия.

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

number

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

unit

string

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

Вес изделия

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

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

number

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

unit

string

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

Перевозки

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

JSON-представление
{
  "price": {
    object (Price)
  },
  "country": string,
  "region": string,
  "service": string,
  "locationId": string,
  "locationGroupName": string,
  "postalCode": string,
  "minHandlingTime": string,
  "maxHandlingTime": string,
  "minTransitTime": string,
  "maxTransitTime": string
}
Поля
price

object ( Price )

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

country

string

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

region

string

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

service

string

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

locationId

string ( int64 format)

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

locationGroupName

string

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

postalCode

string

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

minHandlingTime

string ( int64 format)

Минимальное время обработки (включительно) между получением заказа и отправкой в ​​рабочих днях. 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].

maxHandlingTime

string ( int64 format)

Максимальное время обработки (включительно) между получением заказа и отправкой в ​​рабочих днях. 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].

minTransitTime

string ( int64 format)

Минимальное время доставки (включительно) между отправкой заказа и доставкой в ​​рабочие дни. 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].

maxTransitTime

string ( int64 format)

Максимальное время доставки (включительно) между отправкой заказа и доставкой в ​​рабочих днях. 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].

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

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

JSON-представление
{
  "country": string,
  "priceThreshold": {
    object (Price)
  }
}
Поля
country

string

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

priceThreshold

object ( Price )

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

Вес с упаковкой

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

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

number

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

unit

string

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

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

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

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

number

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

unit

string

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

Налог

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

JSON-представление
{
  "rate": number,
  "country": string,
  "region": string,
  "taxShip": boolean,
  "locationId": string,
  "postalCode": string
}
Поля
rate

number

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

country

string

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

region

string

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

taxShip

boolean

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

locationId

string ( int64 format)

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

postalCode

string

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

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

UnitPricingMeasure продукта.

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

number

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

unit

string

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

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

UnitPricingBaseMeasure продукта.

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

string ( int64 format)

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

unit

string

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

Информация о продукте

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

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

string

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

attributeName

string

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

attributeValue

string

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

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

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

JSON-представление
{
  "textValue": [
    string
  ],
  "intValue": [
    string
  ],
  "floatValue": [
    number
  ],
  "propertyName": string,
  "boolValue": boolean,
  "minValue": number,
  "maxValue": number,
  "unitCode": string
}
Поля
textValue[]

string

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

intValue[]

string ( int64 format)

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

floatValue[]

number

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

propertyName

string

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

boolValue

boolean

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

minValue

number

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

maxValue

number

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

unitCode

string

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

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

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

JSON-представление
{
  "certificationAuthority": string,
  "certificationName": string,
  "certificationCode": string,
  "certificationValue": string
}
Поля
certificationAuthority

string

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

certificationName

string

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

certificationCode

string

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

certificationValue

string

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

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

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

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

string

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

content

string

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

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

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

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

string

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

content

string

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

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

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

JSON-представление
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
Поля
destinationStatuses[]

object ( DestinationStatus )

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

itemLevelIssues[]

object ( ItemLevelIssue )

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

creationDate

string ( Timestamp format)

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

lastUpdateDate

string ( Timestamp format)

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

googleExpirationDate

string ( Timestamp format)

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

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

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

JSON-представление
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Поля
reportingContext

enum ( ReportingContextEnum )

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

approvedCountries[]

string

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

pendingCountries[]

string

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

disapprovedCountries[]

string

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

ItemLevelIssue

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

JSON-представление
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Поля
code

string

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

severity

enum ( Severity )

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

resolution

string

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

attribute

string

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

reportingContext

enum ( ReportingContextEnum )

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

description

string

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

detail

string

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

documentation

string

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

applicableCountries[]

string

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

Строгость

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

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

Методы

get

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

list

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