REST Resource: accounts.cssProducts

Ресурс: CssProduct

Обработанный товар ССЦ.

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

string

Название товара ССЦ. Формат: "accounts/{account}/cssProducts/{css_product}"
rawProvidedId

string

Только для вывода. Уникальный необработанный идентификатор товара.
contentLanguage

string

Только для вывода. Двухбуквенный код языка, на котором представлено описание и другие атрибуты товара. Значение должно соответствовать стандарту ISO 639-1.
feedLabel

string

Только для вывода. Ярлык фида для товара.
attributes

object (Attributes)

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

object (CustomAttribute)

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

object (CssProductStatus)

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

Атрибуты

Атрибуты для товаров ССЦ.

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)

Минимальная цена товара в ССЦ.
highPrice

object (Price)

Максимальная цена товара в ССЦ.
headlineOfferPrice

object (Price)

Основная цена товара в ССЦ.
headlineOfferShippingPrice

object (Price)

Основная цена товара в ССЦ.
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)

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

string (Timestamp format)

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

string

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

Допустимые значения: - css_ads_experiences - css_organic_experiences
excludedDestinations[]

string

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

Допустимые значения: - css_ads_experiences - css_organic_experiences
headlineOfferInstallment

object (HeadlineOfferInstallment)

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

object (HeadlineOfferSubscriptionCost)

Количество периодов (месяцев или лет) и сумма платежа за период для товара, связанного с договором подписки.
cppAdsRedirect

string

Позволяет рекламодателям переопределять URL товара, когда он показывается в товарных объявлениях.
numberOfOffers

string (int64 format)

Количество товаров ССЦ.
headlineOfferCondition

string

Состояние основного предложения.
title

string

Название позиции.
description

string

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

string

Атрибуты, связанные с товаром [14–36]. Бренд товара.
mpn

string

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

string

Код GTIN (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.

ProductDetail

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

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

string

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

string

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

string

Значение информации о товаре.

ProductWeight

Вес товара.

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

number

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

string

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

ProductDimension

Размер товара.

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

number

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

string

Обязательно. Единицы измерения. Возможные значения: * "in" * "cm"

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

Сертификат товара. Используйте этот атрибут, чтобы указать класс энергоэффективности и другие сертификаты товара.

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. Этот код обязателен для отметок маркировки энергоэффективности по классификации ЕС,

HeadlineOfferInstallment

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

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

string (int64 format)

Количество ежемесячных взносов.
amount

object (Price)

Сумма ежемесячного платежа.
downpayment

object (Price)

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

HeadlineOfferSubscriptionCost

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

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

enum (SubscriptionPeriod)

Тип периода подписки. Допустимые значения: * "month" * "year"
periodLength

string (int64 format)

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

object (Price)

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

SubscriptionPeriod

Период подписки на товар.

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

CustomAttribute

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

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

object (CustomAttribute)

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

string

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

string

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

CssProductStatus

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

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.

DestinationStatus

Статус целевого сервиса для статуса товара.

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

string

Название пункта назначения.
approvedCountries[]

string

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

string

Список кодов стран (ISO 3166-1 alpha-2), в которых товар ССЦ ожидает одобрения.
disapprovedCountries[]

string

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

ItemLevelIssue

Проблема на уровне товара, связанная со статусом товара.

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

string

Код ошибки.
servability

string

Как эта проблема влияет на показ товара в ССЦ.
resolution

string

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

string

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

string

Целевой сервис, в котором возникла проблема.
description

string

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

string

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

string

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

string

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

Методы

get

 Получает обработанный товар, размещенный в ССЦ, из вашего аккаунта CSS Center.

list

 Возвращает список обработанных товаров ССЦ в аккаунте CSS Center.