产品 ID

以下是 Content API for Shopping 中的不同商品 ID:

优惠 ID
offerId 是商家分配给商品的字符串。此 ID 代表一个产品。
offerId 是 Merchant Center 数据库中的一组商品独有的,通常是数字序列号。
offerId 可以是商家分配给商品的内部 SKU 编号。
REST ID
REST ID 是 Google 所分配商品的唯一标识符。
REST ID 是 REST API 调用的 productId

REST ID 是采用 online:en:label:1111111111 格式的汇总。REST ID 由以下 4 个部分组成,各个部分之间用英文冒号分隔开:

  1. 渠道(“在线”或“本地”)
  2. 内容语言(使用 2 个字母表示,例如 enfr
  3. Feed 标签(可以是 Feed 的目标国家/地区的两个字母的代码,例如 USFR
  4. 优惠 ID

将以下代码作为 channel:contentLanguage:feedLabel:offerId 组合在一起,例如 online:en:US:1111111111

外部卖家 ID(购物平台)

购物平台必须为上传到多卖家帐号的优惠分配 external_seller_id。此字段表示个人卖家。

external_seller_id 值区分大小写,且必须满足以下条件:

  • 1-50 个字符
  • 只有字母数字字符 ASCII 字符、下划线 (_)、连字符 (-)、英文句点 (.) 和波浪线 (~)

这与内部 seller_id 字段不同。

下表总结了可与商品相关联的部分 ID:

属性 说明 示例 备注
offerId 商家分配给商品的 ID。 1111111111 字符串数据类型,商品优惠的唯一标识符。
REST ID Google 分配给商品的 ID。格式为 channel:contentLanguage:feedLabel:offerId online:en:label:1111111111 完整 ID,包括 offerId
productId 用于在 API 调用中引用 REST ID。 online:en:label:1111111111 这是产品的 REST ID。
id 与 REST ID 和 productId 的值相同。 online:en:label:1111111111 在商品的 JSON 正文内使用,用于引用其 productId
external_seller_id 由市场选择的卖方 ID。 example-Seller1 如果是多卖家帐号,则必须提供此属性。必须为 1-50 个字符。区分大小写。接受数字以及特殊字符 _、-、. 和 ~。