Method: accounts.shippingSettings.insert
Stay organized with collections
Save and categorize content based on your preferences.
Replace the shipping setting of a business with the request shipping setting. Executing this method requires admin access.
HTTP request
POST https://merchantapi.googleapis.com/accounts/v1beta/{parent=accounts/*}/shippingSettings:insert
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
parent |
string
Required. The account for which this shipping setting will be inserted. If you are using an advanced account, you must specify the unique identifier of the sub-account for which you want to insert the shipping setting. Format: accounts/{ACCOUNT_ID}
|
Request body
The request body contains an instance of ShippingSettings.
Response body
If successful, the response body contains an instance of ShippingSettings.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/content
For more information, see the OAuth 2.0 Overview.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-06-06 UTC.
[null,null,["Last updated 2025-06-06 UTC."],[[["\u003cp\u003eReplaces a merchant's shipping settings with new ones provided in the request.\u003c/p\u003e\n"],["\u003cp\u003eRequires admin access and utilizes an HTTP POST request to a specific endpoint.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain the new \u003ccode\u003eShippingSettings\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eA successful response will return the updated \u003ccode\u003eShippingSettings\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/content\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document details the process for replacing a merchant's shipping settings. The core action is a `POST` request to `https://merchantapi.googleapis.com/accounts/v1beta/{parent=accounts/*}/shippingSettings:insert`, requiring admin access. The `parent` path parameter, a string specifying the account, is mandatory. The request body and successful response body will include an instance of `ShippingSettings`. This process requires the `https://www.googleapis.com/auth/content` OAuth scope for authorization.\n"],null,["# Method: accounts.shippingSettings.insert\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReplace the shipping setting of a business with the request shipping setting. Executing this method requires admin access.\n\n### HTTP request\n\n`POST https://merchantapi.googleapis.com/accounts/v1beta/{parent=accounts/*}/shippingSettings: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 for which this shipping setting will be inserted. If you are using an advanced account, you must specify the unique identifier of the sub-account for which you want to insert the shipping setting. Format: `accounts/{ACCOUNT_ID}` |\n\n### Request body\n\nThe request body contains an instance of [ShippingSettings](/merchant/api/reference/rest/accounts_v1beta/accounts.shippingSettings#ShippingSettings).\n\n### Response body\n\nIf successful, the response body contains an instance of [ShippingSettings](/merchant/api/reference/rest/accounts_v1beta/accounts.shippingSettings#ShippingSettings).\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)."]]
