您可以使用 MerchantPromotion API 在 Google 上创建和管理促销活动。借助 accounts.promotions 资源,您可以展示在 Google 上销售的商品的特别优惠。如需了解详情,请参阅 MerchantPromotion API 概览。
请求
如需发出请求,请使用以下网址。
POST https://merchantapi.googleapis.com/promotions/v1beta/{account_name}/promotions
从 Content API for Shopping 迁移
下文比较了用于购物的 Content API 与用于促销相关请求的 MerchantPromotion API。
网址
在 Content API for Shopping 中:
https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/promotions
转换为:
https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions
标识符
在 Content API for Shopping 中:
{merchantId}/promotions/{promotionId}
转换为:
{name}
方法
Merchant API 支持以下促销方法:
- 插入促销信息
- 获取促销优惠
- 列出促销信息
下面对比了 Content API for Shopping 和 Merchant API 中促销方式的可用性:
方法 | Content API for Shopping | 商家 API |
---|---|---|
插入 | 是 | 是 |
获取 | 是 | 是 |
列表 | 是 | 是 |
customBatch | 否 | 否 |
删除 | 否 | (待定) |
资源名称
下表显示了 MerchantPromotion API 中促销活动功能的变化。
如需查看参考示例,请参阅本地商品目录。
Content API for Shopping | 商家 API | 说明 |
---|---|---|
(不支持) | custom_attributes |
自定义(商家提供的)属性列表。 您也可以使用它以通用形式提交 Feed 规范的任何属性。 例如: { "name": "size type", "value": "regular" }这对于提交 API 未明确 提供的属性非常有用。 |
不支持 | data_source | 创建促销活动需要使用现有的数据源。 |
不支持 | 属性 |
促销专用属性(例如 long_tile、promotion_effective_timeperiod、 及其他)是属性消息的一部分。 |
item_id | item_id_inclusion |
对促销活动适用的商品 ID 列表 进行了重命名。 |
store_id | store_id_inclusion |
对促销活动适用的 的商店 ID 列表进行了重命名。 |
prduct_type | product_type_inclusion |
对促销活动适用的 商品类型列表进行了重命名。 |
item_group_id | item_group_id_inclusion |
对促销活动适用的 的商品组 ID 列表进行了重命名。 |
brand | brand_inclusion |
对促销活动适用的 品牌列表进行了重命名。 |
store_code | store_codes_inclusion |
对促销活动适用的 商店代码列表进行了重命名。 |
price: { object (Price) } |
price: { object (Price) } |
Price 的定义发生了变化。
在 Content API for Shopping 中,Price
Price 金额现在以微单位记录,
amount 字段名称已从值更改为
currency 字段名称已更改为 |
order_limit | (不支持) | 不支持 order_limit 属性。 |
shippingServiceNames[]] | (不支持) | shippingServiceNames[] 不受支持。 |
money_budget | (不支持) | money_budget。 |
promotion_destination_ids | promotion_destinations | promotionDestinationIds 已重命名。 |
促销活动状态
{ "destinationStatuses": [ { "destination": string, "status": enum (State) } ], "promotionIssue": [ { "code": string, "detail": string } ], "creationDate": string, "lastUpdateDate": string } |
促销状态已更改。
如需了解更精细的详细信息,请参阅这些问题。 promotionStatus = { destinationStatuses = [ { reportingContext = Enum status = Enum }, ], itemLevelIssues = [ { code = String severity = Enum resolution = String reportingContext = Enum description = String detail = String documentation = String applicableCountries = [ String, ] } ] } |