Method: accounts.promotions.insert
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. 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)."]]
