迁移促销活动管理

您可以使用 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
其中 100 万微单位相当于您所用货币的
标准广告单元

amount 字段名称已从值更改为
amountMicros：

currency 字段名称已更改为
currencyCode。格式仍为
ISO 4217。（维基百科）

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,
    ]
    }
  ]
}