从 Content API for Shopping 迁移产品目录管理系统

您可以使用 Merchant API 管理本地(实体店内)和地区性商品目录。

请求

对广告资源使用以下请求网址格式 子 API

POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories

在 Merchant API 中,Inventories 子 API 和相关端点都称为 表示为“inventory”

以下是 Content API for Shopping 与 Merchant Center 账号的对比情况 用于本地商品目录请求的 Inventories API:

Content API 商家 API
网址 https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}/localinventory https://merchantapi.googleapis.com/inventories/v1beta/{parent}/localInventories
标识符 {merchantId}/products/{productId} {name}

方法

Merchant API 引入了两种新的产品目录管理方法:

  • 列出商品的本地和地区商品目录
  • 请从商品中移除本地商品目录和地区商品目录

下面对比了 Content API for Shopping 中的商品目录方法 Merchant Inventories API:

方法 Content API for Shopping 商家 API
customBatch
insert
list
delete

本地商品目录

以下是 Merchant Inventories API 中本地商品目录的变化:

Content API for Shopping 商家 API 说明
不支持 name:string 添加了新字段,用于区分 product 中的 LocalInventory 资源。Content API for Shopping 根据 storeCodeproductId 识别本地商品目录。
不支持 account:string 添加了新字段,用于标识 productLocalInventory 所属的商家账号。
price: {

object (Price)

}

price: {

object (Price)

}

Price的定义已更改。
salePrice: {

object (Price)

}

salePrice: {

object (Price)

}

Price的定义已更改。
salePriceEffectiveDate: string salePriceEffectiveDate: {

object (TimePeriod)

},

salePriceEffectiveDate 会使用 Merchant Inventories API 中新的 TimePeriod 类型。
quantity:string, quantity:integer 在 Merchant Inventories API 中,quantity 接受整数而不是字符串。
kind:string 不支持 Merchant Inventories API 不支持 kind
不支持 localShippingLabel:string 在 Merchant Inventories API 中添加了用于标记本地配送服务的新字段。

地区商品目录

以下是 Merchant Inventories API 中地区商品目录的变化:

Content API for Shopping 商家 API 说明
不支持 name:string 添加了新字段,用于区分 product 中的 regionalInventory 资源。Content API for Shopping 用于根据 regionIdproductId 识别地区性商品目录。
不支持 account:string 添加了新字段,用于标识 productregionalInventory 所属的商家账号。
"regionId": string "region": string regionID 在 Merchant Inventories API 中称为 region
price: {

object (Price)

}

price: {

object (Price)

}

Price的定义已更改。
salePrice: {

object (Price)

}

salePrice: {

object (Price)

}

Price的定义已更改。
salePriceEffectiveDate: string salePriceEffectiveDate: {

object (TimePeriod)

},

salePriceEffectiveDate 会使用 Merchant Inventories API 中新的 TimePeriod 类型。
kind:string 不支持 Merchant Inventories API 不支持 kind