借助本地商品目录服务,您可以创建和更新 本地商品目录资源 该字段中包含的字段可具有不同的值 。每个本地商品目录实例都是一个子级 现有商品资源, 并沿用 父级资源。例如,您的某件商品可能 price 和 quantity [价格和数量],但 ID、说明和 所有商店的商品数据。本地商品目录数据会用于 本地 Google 平台呈现 和本地产品目录广告 计划。
本指南介绍了在开始使用本地商品目录之前需要满足的条件 说明了可用的字段和方法,还提供了 服务请求
前提条件
- 要使用本地商品目录服务,您必须 创建商家资料, 将您的商家资料与 Merchant Center 账号相关联, 验证您的商家,并且 设置商家资料商店代码。
您的 Merchant Center 账号必须已加入本地计划: 本地 Google 平台呈现或本地产品目录广告。有关 如需了解如何通过 Content API 使用本地产品目录广告,请参阅 开始使用本地产品目录广告。
本地商品目录服务会为现有商品或服务 本地产品 您必须先创建本地产品,方法是使用内容 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
您可以针对单个产品
或为多个实体店创建本地商品目录实例
多款本地商品