Method: accounts.promotions.insert
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-01-23 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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)."]]
