Stay organized with collectionsSave and categorize content based on your preferences.
You can usepromotionsto
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 example15% offorFree 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 therequest
form. The promotions
team will let you know when you’re ready to start implementation.
You can usepromotions.createto create or update a promotion.promotions.createtakes apromotionsresource and returns the new or updated promotion if successful. The entirepromotionsresource is overwritten by this request, so you need to include the
fullpromotionsdetails to avoid losing information.
Google reviews and approves your promotions before distributing them. SeePromotion approval processfor
more information.
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/promotions
View promotions
You can usepromotions.getto view
an existing promotion.getis read-only, and requires yourmerchantIdand
the ID of the promotion. Thegetmethod returns the correspondingpromotionsresource.
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/promotions/{id}
End a promotion
You can end a promotion by usingpromotions.createto update the promotion'stimePeriodto
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."]]
