REST Resource: projects.locations.products

资源:Product

Product 包含 ReferenceImages。

JSON 表示法
{
  "name": string,
  "displayName": string,
  "description": string,
  "productCategory": string,
  "productLabels": [
    {
      object (KeyValue)
    }
  ]
}
字段
name

string

商品的资源名称。

格式为:projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID

创建 Product 时,此字段会予以忽略。

displayName

string

此 Product 的用户提供名称。不得为空。长度不得超过 4096 个字符。

description

string

与此商品一起存储的用户提供元数据。长度不得超过 4096 个字符。

productCategory

string

由参考图片标识的商品类别。此值应为“homegoods-v2”“apparel-v2”“toys-v2”或“packagedgoods-v1”。 旧版类别“homegoods”“apparel”和“toys”仍受支持,但这些类别将被弃用。对于新商品,请使用“homegoods-v2”“apparel-v2”或“toys-v2”,以提高商品搜索准确性。建议将现有商品也迁移为使用这些类别。

该字段不可更改。

productLabels[]

object (KeyValue)

可以附加到一个商品的的键值对。查询时,可以根据 productLabels 指定限制条件。

请注意,整数值可以使用字符串的形式提供,例如“1199”。只有带有整数值的字符串可以匹配基于范围的限制(将在不久之后推出对这种限制的支持)。

对于同一个键,可以分配多个值。一件商品最多可包含 100 个 productLabels。

KeyValue

以键值对表示的商品标签。

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

string

附加到商品的标签键。不能为空,也不能超过 128 个字节。

value

string

附加到商品的标签值。不能为空,也不能超过 128 个字节。

方法

create

创建并返回新的商品资源。

delete

永久删除一种商品及其参考图片。

get

获取与 Product 关联的信息。

list

以未指定的顺序列出商品。

patch

对一项 Product 资源执行更改。