REST Resource: accounts.cssProducts

Источник: CssProduct

Обработанный CSS-продукт.

JSON-представление 
{
  "name": string,
  "rawProvidedId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "cssProductStatus": {
    object (CssProductStatus)
  }
}
Поля
name

string

Название CSS-продукта. Формат: "accounts/{account}/cssProducts/{css_product}"

rawProvidedId

string

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

contentLanguage

string

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

feedLabel

string

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

attributes

object ( Attributes )

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

customAttributes[]

object ( CustomAttribute )

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

cssProductStatus

object ( CssProductStatus )

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

Атрибуты

Атрибуты для CSS-кода товара.

JSON-представление 
{
  "lowPrice": {
    object (Price)
  },
  "highPrice": {
    object (Price)
  },
  "headlineOfferPrice": {
    object (Price)
  },
  "headlineOfferShippingPrice": {
    object (Price)
  },
  "additionalImageLinks": [
    string
  ],
  "productTypes": [
    string
  ],
  "sizeTypes": [
    string
  ],
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productWeight": {
    object (ProductWeight)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productHighlights": [
    string
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "expirationDate": string,
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "headlineOfferInstallment": {
    object (HeadlineOfferInstallment)
  },
  "headlineOfferSubscriptionCost": {
    object (HeadlineOfferSubscriptionCost)
  },
  "cppLink": string,
  "cppMobileLink": string,
  "cppAdsRedirect": string,
  "numberOfOffers": string,
  "headlineOfferCondition": string,
  "headlineOfferLink": string,
  "headlineOfferMobileLink": string,
  "title": string,
  "imageLink": string,
  "description": string,
  "brand": string,
  "mpn": string,
  "gtin": string,
  "googleProductCategory": string,
  "adult": boolean,
  "multipack": string,
  "isBundle": boolean,
  "ageGroup": string,
  "color": string,
  "gender": string,
  "material": string,
  "pattern": string,
  "size": string,
  "sizeSystem": string,
  "itemGroupId": string,
  "pause": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "reviewCount": string,
  "minRating": string,
  "maxRating": string,
  "rating": number
}
Поля
lowPrice

object ( Price )

Низкая цена продукта CSS.

highPrice

object ( Price )

Высокая цена продукта CSS.

headlineOfferPrice

object ( Price )

Цена продукта CSS, указанная в заголовке.

headlineOfferShippingPrice

object ( Price )

Цена продукта CSS, указанная в заголовке.

productTypes[]

string

Категории товара (отформатированы в соответствии со спецификацией данных о товарах ).

sizeTypes[]

string

Крой изделия. Он может использоваться для обозначения комбинированных типов размеров для предметов одежды. Можно указать максимум два типа размеров (см. тип размера ).

productDetails[]

object ( ProductDetail )

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

productWeight

object ( ProductWeight )

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

productLength

object ( ProductDimension )

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

productWidth

object ( ProductDimension )

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

productHeight

object ( ProductDimension )

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

productHighlights[]

string

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

certifications[]

object ( Certification )

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

expirationDate

string ( Timestamp format)

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

includedDestinations[]

string

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

excludedDestinations[]

string

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

headlineOfferInstallment

object ( HeadlineOfferInstallment )

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

headlineOfferSubscriptionCost

object ( HeadlineOfferSubscriptionCost )

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

cppAdsRedirect

string

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

numberOfOffers

string ( int64 format)

Количество товаров CSS.

headlineOfferCondition

string

Условия основного предложения.

title

string

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

description

string

Описание товара.

brand

string

Характеристики, связанные с товаром.[14-36] Бренд товара.

mpn

string

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

gtin

string

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

googleProductCategory

string

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

adult

boolean

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

multipack

string ( int64 format)

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

isBundle

boolean

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

ageGroup

string

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

color

string

Цвет изделия.

gender

string

Целевой пол для данного товара.

material

string

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

pattern

string

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

size

string

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

sizeSystem

string

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

itemGroupId

string

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

pause

string

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

customLabel0

string

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

customLabel1

string

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

customLabel2

string

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

customLabel3

string

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

customLabel4

string

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

reviewCount

string ( int64 format)

Количество отзывов о товаре. Обязательно для заполнения, если указана rating . Это поле предназначено для будущей функции и пока не используется.

minRating

string ( int64 format)

Минимальный рейтинг продукта. Обязательно, если rating указан. Это поле предназначено для будущей функции и пока не используется.

maxRating

string ( int64 format)

Максимальный рейтинг продукта. Обязательно, если rating указан. Это поле предназначено для будущей функции и пока не используется.

rating

number

Средний рейтинг товара. Значение должно находиться в диапазоне [ minRating , maxRating ] включительно. При отображении на странице товара этот рейтинг нормализуется по шкале [1, 5] с одним десятичным знаком. Если указано, reviewCount , minRating и maxRating также обязательны. Это поле предназначено для будущей функции и пока не используется.

Цена

Цена представлена ​​в виде числа и валюты.

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

string ( int64 format)

Цена, выраженная числом в микросах (1 миллион микрос эквивалентен стандартной денежной единице, например, 1 доллар США = 1 000 000 микрос).

currencyCode

string

Цена указывается в валюте с использованием трехбуквенных аббревиатур в соответствии со стандартом ISO 4217 .

Информация о товаре

Подробная информация о товаре.

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

string

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

attributeName

string

Название товара и его характеристики.

attributeValue

string

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

Вес продукта

Вес товара.

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

number

Обязательно. Вес должен быть представлен числом. Максимальная точность значения веса — четыре знака после запятой.

unit

string

Обязательно. Единица измерения веса. Допустимые значения: * g * kg * oz * lb

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

Габариты изделия.

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

number

Обязательно. Значение параметра представлено в виде числа. Максимальная точность значения — четыре знака после запятой.

unit

string

Обязательно. Единицы измерения. Допустимые значения: * in * cm

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

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

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

string

Название сертификата. В настоящее время наиболее распространенным является "EPREL", обозначающее сертификаты энергоэффективности в базе данных Европейского реестра энергетической маркировки ЕС (EPREL).

authority

string

Орган или сертификационный орган, ответственный за выдачу сертификата. В настоящее время наиболее распространенным значением для энергетических этикеток в ЕС является «EC» или «European_Commission».

code

string

Код сертификации. Например, для сертификата EPREL по ссылке https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456 код — 123456. Этот код необходим для получения европейской энергетической маркировки.

ЗаголовокПредложениеРассрочка

Сообщение, обозначающее рассрочку.

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

string ( int64 format)

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

amount

object ( Price )

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

downpayment

object ( Price )

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

ЗаголовокПредложениеСтоимостьПодписки

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

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 Указывает, что период подписки составляет год.

Пользовательский атрибут

Сообщение, представляющее пользовательские атрибуты. Не должно быть ни одного пустого значения из value или groupValues .

JSON-представление 
{
  "groupValues": [
    {
      object (CustomAttribute)
    }
  ],
  "name": string,
  "value": string
}
Поля
groupValues[]

object ( CustomAttribute )

Вспомогательные атрибуты в рамках этой группы атрибутов. Если groupValues ​​не пустое значение, value должно быть пустым.

name

string

Название атрибута.

value

string

Значение атрибута. Если value не пустое, groupValues ​​должно быть пустым.

CssProductStatus

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

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-представление 
{
  "destination": string,
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Поля
destination

string

Название пункта назначения

approvedCountries[]

string

Список кодов стран (ISO 3166-1 alpha-2), в которых одобрен продукт CSS.

pendingCountries[]

string

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

disapprovedCountries[]

string

Список кодов стран (ISO 3166-1 alpha-2), в которых продукт CSS не одобрен.

ItemLevelIssue

ItemLevelIssue — это статус товара.

JSON-представление 
{
  "code": string,
  "servability": string,
  "resolution": string,
  "attribute": string,
  "destination": string,
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Поля
code

string

Код ошибки, вызвавшей проблему.

servability

string

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

resolution

string

Может ли продавец решить эту проблему?

attribute

string

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

destination

string

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

description

string

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

detail

string

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

documentation

string

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

applicableCountries[]

string

Список кодов стран (ISO 3166-1 alpha-2), к которым относится данная проблема, связанная с продуктом CSS.

Методы

get

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

list

 Отображает список обработанных товаров CSS в вашем аккаунте CSS Center.