本地商品目录服务

欢迎推出 Merchant API 的 Beta 版。这是 Content API for Shopping 及未来。

有关 Merchant API 如何改进您的集成以及如何帮助塑造 请参阅发布 Merchant API Beta 版。

借助本地商品目录服务，您可以创建和更新 本地商品目录资源 该字段中包含的字段可具有不同的值 。每个本地商品目录实例都是一个子级 现有商品资源， 并沿用 父级资源。例如，您的某件商品可能 price 和 quantity [价格和数量]，但 ID、说明和 所有商店的商品数据。本地商品目录数据会用于 本地 Google 平台呈现 和本地产品目录广告 计划。

本指南介绍了在开始使用本地商品目录之前需要满足的条件 说明了可用的字段和方法，还提供了 服务请求

注意 ：在 Content API v2.1 中，本地商品目录服务和补充数据 在 v2 中，Feed 取代了产品目录服务。要执行部分更新， 非本地商品数据，请使用 补充 Feed。 如需进行补充性的本地商品更新，请使用localinventory 服务。

前提条件

• 要使用本地商品目录服务，您必须 创建商家资料， 将您的商家资料与 Merchant Center 账号相关联， 验证您的商家，并且 设置商家资料商店代码。

• 您的 Merchant Center 账号必须已加入本地计划： 本地 Google 平台呈现或本地产品目录广告。有关 如需了解如何通过 Content API 使用本地产品目录广告，请参阅 开始使用本地产品目录广告。

  注意 ：如果您的 Merchant Center 账号未加入本地计划， 将产品的 channel 字段设置为 local， Products.insert 方法，则会导致错误：“channel 无效 channel: local"。

• 本地商品目录服务会为现有商品或服务 本地产品 您必须先创建本地产品，方法是使用内容 API 产品服务或 Merchant Center datafeeds 将 channel 字段设置为 local。然后，您可以使用 服务为每个商家资料创建本地商品目录实例 storecode。

字段

每个本地商品目录实例都包含一组与 storeCode 字段（您在 商家资料）。仅限 storecode 和 productId 都是必需的其他所有字段均为选填：

• 所有请求都必须提供：storeCode、productId（在网址中）
• 可选：quantity、price、salePrice、salePriceEffectiveDate availability，pickupMethod，pickupSla，instoreProductLocation

如需查看本地商品目录字段及其说明的完整列表，请参阅 localinventory 参考 页面。

方法

本地商品目录服务仅包含两种方法：

localinventory.insert

localinventory.insert 可让您为单件本地商品创建本地商品目录实例。

此示例演示了如何使用本地商品目录服务 创建实体店促销活动 2021 年 2 月 24 日下午 1:00 (GMT-8) 至 2021 年 2 月 28 日下午 3:30 (GMT-8)。该请求还会更新本地商品目录的可售数量 实例。取消点赞 补充 Feed 非本地商品数据的正文中不包含的字段， 请求被以下调用覆盖：

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId/localinventory

{
  "storeCode": “1235”,
  "salePrice": {
     "value": “100.00”,
     "currency": “USD”
   },
  "salePriceEffectiveDate": “2021-02-24T13:00-0800/2021-02-28T15:30-0800”,
  "quantity": 200,
}

localinventory.custombatch

localinventory.custombatch 您可以针对单个产品 或为多个实体店创建本地商品目录实例 多款本地商品

注意 ：您无法检索、列出或删除本地商品目录 实例。如需在 Merchant Center 中查看本地商品目录数据，请选择一个本地 所有商品页面中的商品，然后展开本地商品目录 部分。表格中会显示每个商店代码的本地商品目录数据。