Stay organized with collections
Save and categorize content based on your preferences.
You can use promotions to
showcase special offers for products you sell on Google. Promotions display
across different Google properties, including Google Search, Shopping, and
Chrome. When you add promotions to your products, shoppers see a special offer
link, for example 15% off or Free shipping. Offer links can increase
the appeal of your products, and encourage shoppers to make a purchase.
Google needs you to provide specific information about your business and
products before your promotions display. You must meet the following criteria to
use promotions:
Your merchant account must be enrolled in the Promotions program.
Check the Google Merchant Center UI to see if you’re already enrolled in the
Promotions program. If you’re not enrolled, complete the request
form. The promotions
team will let you know when you’re ready to start implementation.
You can use
promotions.create
to create or update a promotion. promotions.create takes a promotions
resource and returns the new or updated promotion if successful. The entire
promotions resource is overwritten by this request, so you need to include the
full promotions details to avoid losing information.
Google reviews and approves your promotions before distributing them. See
Promotion approval process for
more information.
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/promotions
View promotions
You can use
promotions.get to view
an existing promotion. get is read-only, and requires your merchantId and
the ID of the promotion. The get method returns the corresponding
promotions resource.
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/promotions/{id}
End a promotion
You can end a promotion by using
promotions.create
to update the promotion's
timePeriod to
a time that has already passed.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-13 UTC."],[[["\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."]]