Inserts a promotion for your Merchant Center account. If the promotion already exists, then it updates the promotion instead. To end or delete a promotion update the time period of the promotion to a time that has already passed.
HTTP request
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/promotions
[[["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-02-25 UTC."],[[["\u003cp\u003eThis operation inserts or updates a promotion for a Merchant Center account using the \u003ccode\u003ePOST\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eYou need to provide the \u003ccode\u003emerchantId\u003c/code\u003e as a path parameter and a \u003ccode\u003ePromotion\u003c/code\u003e object in the request body.\u003c/p\u003e\n"],["\u003cp\u003eA successful request will return the created or updated \u003ccode\u003ePromotion\u003c/code\u003e object in the response body.\u003c/p\u003e\n"],["\u003cp\u003eTo end a promotion, update its time period to a past date.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/content\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This content outlines the process for managing promotions within a Merchant Center account. It uses a POST HTTP request to `https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/promotions`, with the `merchantId` as a required path parameter. The request body requires a `Promotion` instance, and successful responses also return a `Promotion` instance. To delete a promotion update its time period to a past time. The action requires authorization with the `https://www.googleapis.com/auth/content` OAuth scope.\n"],null,["# Method: promotions.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nInserts a promotion for your Merchant Center account. If the promotion already exists, then it updates the promotion instead. To [end or delete](https://developers.google.com/shopping-content/guides/promotions#end_a_promotion) a promotion update the time period of the promotion to a time that has already passed.\n\n### HTTP request\n\n`POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/promotions`\n\n### Path parameters\n\n| Parameters ||\n|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------|\n| `merchantId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the account that contains the collection. |\n\n### Request body\n\nThe request body contains an instance of [Promotion](/shopping-content/reference/rest/v2.1/promotions#Promotion).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Promotion](/shopping-content/reference/rest/v2.1/promotions#Promotion).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/content`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]