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”。旧版类别“homegoods”“apparel”和“toys”仍受支持,但不应将其用于新商品。

productLabels[]

object (KeyValue)

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

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

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

请注意,一个商品集中的所有商品的 productLabels 总数不得超过 100 万个,否则商品搜索流水线将拒绝处理 ProductSet。

KeyValue

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

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

string

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

value

string

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

方法

create

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

delete

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

get

获取与 Product 关联的信息。

list

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

patch

对一项 Product 资源执行更改。

purge

此异步 API 可删除 ProductSet 中的所有 Product 或不在 ProductSet 中的所有 Product。