rocket
隆重推出
Merchant API - Content API for Shopping 的正式替代方案。
update
获取最新资讯，了解 Merchant API 的新功能、问题修复和更新。
add_alert
注意：Content API for Shopping 将于 2026 年 8 月 18 日停用。
推广
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
您可以使用 promotions 来展示您在 Google 上销售的商品的特惠。促销活动会展示在各种 Google 产品和服务中，包括 Google 搜索、Google 购物和 Chrome。如果您为商品添加了促销信息，买家就会看到一个“特别优惠”链接，例如八五折或免运费。商品链接可提高商品的吸引力，并鼓励买家购买。
如需了解详情，请参阅推广活动基础知识。
开始使用
Google 需要您提供有关您的商家和商品的具体信息，然后才会显示您的促销活动。您必须满足以下条件才能使用促销活动：
检查 Google Merchant Center 界面，看看您是否已加入促销计划。如果您尚未注册，请填写申请表单。当您可以开始实施时，促销信息团队会通知您。
如需了解详情，请参阅参与条件和政策。
您可以使用 promotions.create 创建或更新促销活动。promotions.create 接受 promotions 资源，并在成功时返回新的或更新后的宣传广告。此请求会覆盖整个 promotions 资源，因此您需要包含完整的 promotions 详细信息，以免丢失信息。
Google 会先审核和批准您的促销活动，然后再发布这些促销活动。如需了解详情，请参阅促销活动审批流程。
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/promotions
您可以使用 promotions.get 查看现有宣传广告。get 是只读字段，需要提供 merchantId 和宣传广告的 ID。get 方法会返回相应的 promotions 资源。
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/promotions/{id}
您可以使用 promotions.create 更新促销活动的 timePeriod，将其设为已过的时间，从而结束促销活动。
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-08-13。
[null,null,["最后更新时间 (UTC)：2025-08-13。"],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and provides enhanced integration capabilities.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the \u003ccode\u003epromotions\u003c/code\u003e resource to showcase special offers for your products on various Google platforms.\u003c/p\u003e\n"],["\u003cp\u003eTo use promotions, you need an active product feed, a Google Ads account for Shopping campaigns, and enrollment in the Promotions program.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003epromotions.create\u003c/code\u003e allows you to create, update, or end promotions, while \u003ccode\u003epromotions.get\u003c/code\u003e enables viewing existing ones.\u003c/p\u003e\n"],["\u003cp\u003eGoogle reviews and approves all promotions before they are displayed.\u003c/p\u003e\n"]]],["The new Merchant API, the next version of the Content API for Shopping, is in beta. To use promotions and showcase special offers on Google, you need an active product feed in Google Merchant Center, a Google Ads account for Shopping campaigns, and enrollment in the Promotions program. You can create or update promotions via `promotions.create`, which requires complete promotion details. View existing promotions using `promotions.get`. End a promotion by updating its `timePeriod` to a past time using `promotions.create`.\n"],null,["# Promotions\n\nYou can use [`promotions`](/shopping-content/reference/rest/v2.1/promotions) to\nshowcase special offers for products you sell on Google. Promotions display\nacross different Google properties, including Google Search, Shopping, and\nChrome. When you add promotions to your products, shoppers see a special offer\nlink, for example **15% off** or **Free shipping**. Offer links can increase\nthe appeal of your products, and encourage shoppers to make a purchase.\n\nFor more information, see [Promotion\nbasics](//support.google.com/merchants/answer/7322422).\n\nGet started\n-----------\n\nGoogle needs you to provide specific information about your business and\nproducts before your promotions display. You must meet the following criteria to\nuse promotions:\n\n- Have an active [product feed](//support.google.com/merchants/answer/7439882?) in the [Google Merchant Center](//merchants.google.com/).\n- Have a [Google Ads](//support.google.com/google-ads/topic/3119073) account for [Shopping campaigns](//support.google.com/google-ads/answer/2454022?).\n- Your merchant account must be enrolled in the Promotions program.\n\nCheck the Google Merchant Center UI to see if you're already enrolled in the\nPromotions program. If you're not enrolled, complete the [request\nform](//support.google.com/merchants/contact/promos_contact). The promotions\nteam will let you know when you're ready to start implementation.\n\nFor more information, see [Participation criteria and\npolicies](//support.google.com/merchants/answer/4588460).\n\nModify promotions\n-----------------\n\nYou can use\n[`promotions.create`](/shopping-content/reference/rest/v2.1/promotions/create)\nto create or update a promotion. `promotions.create` takes a `promotions`\nresource and returns the new or updated promotion if successful. The entire\n`promotions` resource is overwritten by this request, so you need to include the\nfull `promotions` details to avoid losing information.\n\nGoogle reviews and approves your promotions before distributing them. See\n[Promotion approval process](//support.google.com/merchants/answer/4588464) for\nmore information. \n\n POST https://shoppingcontent.googleapis.com/content/v2.1/\u003cvar translate=\"no\"\u003e{merchantId}\u003c/var\u003e/promotions\n\nView promotions\n---------------\n\nYou can use\n[`promotions.get`](/shopping-content/reference/rest/v2.1/promotions/get) to view\nan existing promotion. `get` is read-only, and requires your `merchantId` and\nthe ID of the promotion. The `get` method returns the corresponding\n`promotions` resource. \n\n GET https://shoppingcontent.googleapis.com/content/v2.1/\u003cvar translate=\"no\"\u003e{merchantId}\u003c/var\u003e/promotions/{id}\n\nEnd a promotion\n---------------\n\nYou can end a promotion by using\n[`promotions.create`](/shopping-content/reference/rest/v2.1/promotions/create)\nto update the promotion's\n[`timePeriod`](/shopping-content/reference/rest/v2.1/promotions#timeperiod) to\na time that has already passed."]]
