本地商品目录服务

借助本地商品目录服务，您可以创建和更新本地商品目录资源的实例，其中包含的字段可针对不同的实体店位置具有不同的值。每个本地商品目录实例都是现有商品资源的子项，并会继承父级资源中的商品数据字段。例如，您可能有一件商品在不同商店中的价格和数量不同，但在所有商店中都具有相同的 ID、说明和其他商品数据。本地商品目录数据用于本地 Google 平台呈现和本地商品目录广告计划。

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

前提条件

  • 如需使用本地商品目录服务，您必须创建商家资料、将商家资料与 Merchant Center 账号相关联、验证您的商家，以及设置商家资料实体店代码。

  • 您的 Merchant Center 账号必须已注册本地计划：Google 各平台上的本地展示位置或本地商品目录广告。如需详细了解如何通过 Content API 使用本地商品目录广告，请参阅本地商品目录广告使用入门。

  • 本地商品目录服务会为现有本地商品创建本地商品目录实例。您必须先使用 Content API products 服务或 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，您可以为多个商店中的单个本地商品创建多个本地商品目录实例，也可以为多个本地商品创建本地商品目录实例。