以下是 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 个部分组成,各个部分之间用英文冒号分隔开:- 渠道(“在线”或“本地”)
- 内容语言(使用 2 个字母表示,例如
en
或fr
) - Feed 标签(可以是 Feed 的目标国家/地区的两个字母的代码,例如
US
或FR
) - 优惠 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 个字符。区分大小写。接受数字以及特殊字符 _、-、. 和 ~。 |