本地商品目录服务

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

本指南介绍了开始使用本地商品目录服务之前需要完成的准备工作,并介绍了可用的字段和方法,还提供了一个服务请求示例。

前提条件

  • 如需使用本地商品目录服务,您必须创建商家资料将商家资料与 Merchant Center 账号相关联验证商家,并设置商家资料实体店代码
  • 您的 Merchant Center 账号必须加入本地计划:在 Google 各平台上展示本地商品详情本地商品目录广告。如需详细了解如何通过 Content API 使用本地商品目录广告,请参阅本地商品目录广告使用入门

  • 本地商品目录服务会为现有的本地商品创建本地商品目录实例。您必须先使用 Content API products 服务或 Merchant Center datafeeds,通过将 channel 字段设置为 local 来创建本地商品。然后,您可以使用本地商品目录服务为销售该商品的每个商家资料 storecode 创建本地商品目录实例。

字段

每个本地商品目录实例都包含一组字段,这些字段通过 storeCode 字段(您在商家资料中定义)与特定实体店营业地点相关联。对于所有请求,只有 storecodeproductId 是必需的。所有其他字段均为选填:

  • 所有请求的必需参数:storeCodeproductId(位于网址中)
  • 可选:quantitypricesalePricesalePriceEffectiveDateavailabilitypickupMethodpickupSlainstoreProductLocation

如需查看本地商品目录字段及其说明的完整列表,请参阅 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 可让您为多个商店中的单个本地商品创建多个本地商品目录实例,或为多个本地商品创建本地商品目录实例。