您可以使用 MerchantPromotion API 在以下位置创建和管理促销活动:
Google。通过
accounts.promotions
资源,您可以展示您在 Google 上销售的商品的特别优惠。
如需了解详情,请参阅商家促销信息概览
API。
请求
如需发出请求,请使用以下网址。
POST https://merchantapi.googleapis.com/promotions/v1beta/{account_name}/promotions
从 Content API for Shopping 迁移
以下内容比较了 Content API for Shopping 与商家促销信息 用于促销相关请求的 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 支持以下促销方法:
- 插入促销信息
- 获取促销优惠
- 列出促销信息
下面对比了适用于 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 } |
<ph type="x-smartling-placeholder"></ph>
促销状态已更改。
您可在相应问题中找到更精细的详细信息。 promotionStatus = { destinationStatuses = [ { reportingContext = Enum status = Enum }, ], itemLevelIssues = [ { code = String severity = Enum resolution = String reportingContext = Enum description = String detail = String documentation = String applicableCountries = [ String, ] } ] } |