rocket
Meet
Merchant API
- the official successor to Content API for Shopping.
update
Get the latest
on new Merchant API features, bug fixes, and updates.
add_alert
Note: Content API for Shopping will be sunset on August 18, 2026.
Method: shippingsettings.update
Stay organized with collections
Save and categorize content based on your preferences.
Updates the shipping settings of the account. Any fields that are not provided are deleted from the resource.
HTTP request
PUT https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/shippingsettings/{accountId}
Path parameters
Parameters |
merchantId |
string
The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account.
|
accountId |
string
The ID of the account for which to get/update shipping settings.
|
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 one of the following OAuth scopes:
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-02-25 UTC.
[null,null,["Last updated 2025-02-25 UTC."],[[["\u003cp\u003eUpdates the shipping settings for a given account, deleting any unspecified fields.\u003c/p\u003e\n"],["\u003cp\u003eUses an HTTP PUT request to \u003ccode\u003ehttps://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/shippingsettings/{accountId}\u003c/code\u003e with \u003ccode\u003emerchantId\u003c/code\u003e and \u003ccode\u003eaccountId\u003c/code\u003e path parameters.\u003c/p\u003e\n"],["\u003cp\u003eRequires a request body containing a \u003ccode\u003eShippingSettings\u003c/code\u003e object and returns the updated \u003ccode\u003eShippingSettings\u003c/code\u003e object upon success.\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 outlines how to update shipping settings for a specific account. A `PUT` request is sent to the provided URL, including the `merchantId` and `accountId` as path parameters. The request body contains the new `ShippingSettings` data, with unspecified fields being deleted. A successful response will return the updated `ShippingSettings`. Authorization requires the `https://www.googleapis.com/auth/content` OAuth scope. The `merchantId` must be a multi-client account, if it's different from `accountId`.\n"],null,["# Method: shippingsettings.update\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\nUpdates the shipping settings of the account. Any fields that are not provided are deleted from the resource.\n\n### HTTP request\n\n`PUT https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/shippingsettings/{accountId}`\n\n### Path parameters\n\n| Parameters ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `merchantId` | `string` The ID of the managing account. If this parameter is not the same as [accountId](#accountId), then this account must be a multi-client account and `accountId` must be the ID of a sub-account of this account. |\n| `accountId` | `string` The ID of the account for which to get/update shipping settings. |\n\n### Request body\n\nThe request body contains an instance of [ShippingSettings](/shopping-content/reference/rest/v2.1/shippingsettings#ShippingSettings).\n\n### Response body\n\nIf successful, the response body contains an instance of [ShippingSettings](/shopping-content/reference/rest/v2.1/shippingsettings#ShippingSettings).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/content`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]