Method: accounts.promotions.insert
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/01/23 (UTC).
[null,null,["Dernière mise à jour le 2025/01/23 (UTC)."],[[["\u003cp\u003eInserts a new promotion or updates an existing one for your Merchant Center account.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes an HTTP POST request to \u003ccode\u003ehttps://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions:insert\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying the parent account and providing promotion details in the request body.\u003c/p\u003e\n"],["\u003cp\u003eReturns the \u003ccode\u003ePromotion\u003c/code\u003e object in the response body if the operation is successful.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/content\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This documentation details the process for inserting or updating a promotion in a Merchant Center account via an API. The `POST` request is sent to `https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions:insert`, with `parent` being the required account identifier. The request body requires `promotion` and `dataSource` fields. The API utilizes OAuth scope `https://www.googleapis.com/auth/content` for authorization, and a successful operation returns a `Promotion` object.\n"],null,["# Method: accounts.promotions.insert\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\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.\n\n### HTTP request\n\n`POST https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions:insert`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The account where the promotion will be inserted. Format: accounts/{account} |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"promotion\": { object (/merchant/api/reference/rest/promotions_v1beta/accounts.promotions#Promotion) }, \"dataSource\": string } ``` |\n\n| Fields ||\n|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `promotion` | `object (`[Promotion](/merchant/api/reference/rest/promotions_v1beta/accounts.promotions#Promotion)`)` Required. The promotion to insert. |\n| `dataSource` | `string` Required. The data source of the [promotion](https://support.google.com/merchants/answer/6396268?sjid=5155774230887277618-NC) Format: `accounts/{account}/dataSources/{datasource}`. |\n\n### Response body\n\nIf successful, the response body contains an instance of [Promotion](/merchant/api/reference/rest/promotions_v1beta/accounts.promotions#Promotion).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/content`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
