改用 Feed 标签

您可以使用 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 地区代码的商品,特定于国家/地区的字段为空。

插入和更新商品

必须提供 feedLabeltargetCountry 才能插入新商品。如果您插入或更新具有 feedLabeltargetCountry 的商品,则它们的值必须匹配。

如果这两个字段都为空或它们的值不匹配,您会收到来自 API 的错误消息。

如需了解详情,请参阅使用 Feed 标签来宣传特定 Feed 中的商品

指定国家/地区

请使用以下选项之一来确保您的商品定位到正确的国家/地区:

产品

productstargetCountry 字段已弃用。而应使用 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 的值,则它不会自动转换为 GBUKGBfeedLabel 的不同字符串,将创建不同的优惠。

如果您插入 UKtargetCountry,并且我们将其转换为 GB,则必须更新商品的 REST ID 以包含 GB 而不是 UK,以便使用 get 方法检索商品。