您可以使用 feedLabel
字段向产品和数据 Feed 添加标签。
Feed 标签可以采用以下格式:
- 类型字符串
- 少于或等于 20 个字符
- 大写字母 (A-Z)
- 数字 (0-9)
- 短划线 (-)
您可以在以下资源中找到“feedLabel
”:
REST ID
对于新产品,feedLabel
取代了 REST ID 中的 targetCountry
。
对于新产品,REST ID 现在会形成 online:language:feedLabel:offerId
,而不是 online:language:targetCountry:offerId
。这不会更改现有商品的 REST ID。
获取并列出商品
对于所有返回的商品,系统始终会填充 feedLabel
字段。
如果 feedLabel
是有效的 CLDR 地区代码,我们会自动回填 targetCountry
字段以确保兼容性。如果 feedLabel
不是有效的 CLDR 地区代码,我们会将 targetCountry
留空。
同样的更改也适用于 productstatuses
端点。
对于 feedLabel
不是 CLDR 地区代码的商品,特定于国家/地区的字段为空。
插入和更新商品
必须提供 feedLabel
或 targetCountry
才能插入新商品。如果您插入或更新具有 feedLabel
和 targetCountry
的商品,则它们的值必须匹配。
如果这两个字段都为空或它们的值不匹配,您会收到来自 API 的错误消息。
如需了解详情,请参阅使用 Feed 标签来宣传特定 Feed 中的商品。
指定国家/地区
请使用以下选项之一来确保您的商品定位到正确的国家/地区:
products
资源的shipping
字段datafeeds
资源的targetCountries
字段
产品
products
的 targetCountry
字段已弃用。而应使用 shipping
字段来指定您的目标国家/地区。
如果您想定位多个国家/地区,可以继续使用 shipping
添加其他国家/地区。
如需了解详情,请参阅定位到多个国家/地区。
数据 Feed
现在,您可以在 targets
中查看 datafeed
明确定位的国家/地区。当您在 datafeedtarget
配置中使用 feedLabel
(而非 country
)时,就会出现这种情况。
我们还为 datafeeds
添加了 targetCountries
字段,因此您可以直接为 datafeeds
配置定位。您仍然可以在 Feed 之外配置定位,例如通过设置商品资源的 shipping
属性。
英制换算为 GB
我们目前允许 targetCountry
字段使用 UK
值,即使它不是有效的国家/地区代码。我们会自动将 UK
转换为 GB
。以 UK
作为 targetCountry
的产品使用 GB
存储在其 REST ID 和 offerId
中。
如果您将 UK
设置为 feedLabel
的值,则它不会自动转换为 GB
。UK
和 GB
是 feedLabel
的不同字符串,将创建不同的优惠。
如果您插入 UK
的 targetCountry
,并且我们将其转换为 GB
,则必须更新商品的 REST ID 以包含 GB
而不是 UK
,以便使用 get
方法检索商品。