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 提供）属性的列表。它还可用于以通用形式（例如 { "name": "size type", "value": "regular" }）提交 Feed 规范的任何属性。这对于提交 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

允许广告客户在商品广告的上下文中展示商品时替换商品网址。
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 美元 = 100 万个微单位）。
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

商品的 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 商品。