Method: accounts.promotions.insert
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-01-23 UTC.
[null,null,["Последнее обновление: 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)."]]
