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

object ( Price )

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

highPrice

object ( Price )

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

headlineOfferPrice

object ( Price )

Основная цена продукта CSS.

headlineOfferShippingPrice

object ( Price )

Основная цена продукта CSS.

productTypes[]

string

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

sizeTypes[]

string

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

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 .

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 для индивидуальной группировки товаров в торговой кампании.

Цена

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

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 "

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

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

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

string

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

authority

string

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

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

CustomAttribute

Сообщение, представляющее пользовательские атрибуты. Ровно одно из 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 альфа-2), в которых одобрен продукт CSS.

pendingCountries[]

string

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

disapprovedCountries[]

string

Список кодов стран (ISO 3166-1 альфа-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 альфа-2), в которых проблема относится к продукту CSS.

Методы

get

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

list

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