通过本地商品目录服务,您可以创建和更新本地商品目录资源的实例,其中包含的字段对于不同的实体店位置可以具有不同的值。每个本地商品目录实例都是现有商品资源的子级,并且沿用父级资源的商品数据字段。例如,您的某件商品在不同商店的价格和数量可能不同,但所有商店都共用一个 ID、说明和其他商品数据。本地商品目录数据可用于本地 Google 平台呈现和本地产品目录广告计划。
本指南介绍了在开始使用本地商品目录服务之前需要完成哪些准备工作,介绍了可用的字段和方法,并提供了服务请求的示例。
前提条件
- 若要使用本地商品目录服务,您必须创建商家资料、将您的商家资料与 Merchant Center 帐号相关联、验证您的商家并设置商家资料商店代码。
您的 Merchant Center 帐号必须已加入本地计划:本地 Google 平台呈现或本地商品目录广告。如需详细了解如何通过 Content API 使用本地产品目录广告,请参阅本地产品目录广告使用入门。
本地商品目录服务会为现有的本地商品创建本地商品目录实例。您必须先将
channel
字段设置为local
,使用 Content API products 服务或 Merchant Center datafeeds 创建本地商品。然后,您可以使用本地商品目录服务为销售该商品的每个商家资料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
,您可以为多个商店中的单件本地商品创建多个本地商品目录实例,或者为多个本地商品创建本地商品目录实例。