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

仅限输出。商品的 Feed 标签。
attributes

object (Attributes)

仅限输出。商品属性列表。
customAttributes[]

object (CustomAttribute)

仅限输出。自定义（由 CSS 提供）属性的列表。它还可用于以通用形式提交 Feed 规范的任何属性（例如 { "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 中加入了默认平台，否则将始终为定位目标添加默认平台。

支持的值包括：- css_ads_experiences - css_organic_experiences
excludedDestinations[]

string

为此定位目标排除的平台列表（对应于 Merchant Center 中未选中的复选框）。

支持的值包括：- css_ads_experiences - css_organic_experiences
headlineOfferInstallment

object (HeadlineOfferInstallment)

购买商品所需支付的分期付款期数和金额。
headlineOfferSubscriptionCost

object (HeadlineOfferSubscriptionCost)

具有关联订阅合约的商品的期数（月数或年数）和每期付款金额。
cppAdsRedirect

string

允许广告客户在产品广告中展示产品时覆盖产品网址。
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 商品类目）。查询商品时，此字段将包含用户提供的值。目前无法通过 API 恢复自动分配的 Google 商品类别。
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)

以微单位表示的价格（100 万微单位相当于一个货币标准单位，例如，1 美元 = 1000000 微单位）。
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

认证代码。例如，对于链接为 https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456 的 EPREL 认证，代码为 123456。欧洲能效标识要求必须提供此代码。

HeadlineOfferInstallment

表示分期付款的消息。

JSON 表示法 
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  }
}
字段
months

string (int64 format)

买家必须支付的分期付款期数。
amount

object (Price)

买家每月需要支付的金额。
downpayment

object (Price)

买家必须支付的预付首付款金额。

HeadlineOfferSubscriptionCost

商品的 SubscriptionCost。

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

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 格式。

DestinationStatus

商品状态的目标平台状态。

JSON 表示法 
{
  "destination": string,
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
字段
destination

string

目的地名称
approvedCountries[]

string

CSS 商品获得批准的国家/地区代码 (ISO 3166-1 alpha-2) 列表。
pendingCountries[]

string

CSS 商品正在等待批准的国家/地区代码 (ISO 3166-1 alpha-2) 列表。
disapprovedCountries[]

string

CSS 商品未获批准的国家/地区代码 (ISO 3166-1 alpha-2) 列表。

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

帮助解决此问题的网页的网址。
applicableCountries[]

string

问题适用于 CSS 商品的国家/地区代码 (ISO 3166-1 alpha-2) 列表。

方法

get

 从您的 CSS Center 账号中检索已处理的 CSS 商品。

list

 列出您的 CSS Center 账号中已处理的 CSS 商品。