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
}
字段
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)

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，用于自定义购物广告系列中的商品分组。

价格

价格以数字和币种表示。

JSON 表示法 
{
  "amountMicros": string,
  "currencyCode": string
}
字段
amountMicros

string (int64 format)

价格以微单位表示的数字（100 万微单位等于 1 个货币标准单位，例如 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

必需。权重，以数字表示。权重最多可精确到小数点后 4 位。
unit

string

必需。重量单位。可接受的值包括：* "g" * "kg" * "oz" * "lb"

ProductDimension

商品的尺寸。

JSON 表示法 
{
  "value": number,
  "unit": string
}
字段
value

number

必需。以数字表示的维度值。值最多可精确到小数点后 4 位。
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 商品。