Method: accounts.promotions.insert
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-01-23 (UTC).
[null,null,["Zuletzt aktualisiert: 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)."]]
