[null,null,["Last updated 2025-02-25 UTC."],[[["\u003cp\u003eThis operation retrieves and updates the shipping settings of multiple accounts through a single HTTP POST request.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain a \u003ccode\u003eShippingsettingsCustomBatchRequest\u003c/code\u003e object, specifying the desired actions for each account.\u003c/p\u003e\n"],["\u003cp\u003eIf successful, the response provides a \u003ccode\u003eShippingsettingsCustomBatchResponse\u003c/code\u003e containing the results for each individual account request, including updated shipping settings or errors.\u003c/p\u003e\n"],["\u003cp\u003eThe process utilizes the \u003ccode\u003ehttps://www.googleapis.com/auth/content\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can find details about request and response structures, including JSON representations, for each component involved in the batch operation.\u003c/p\u003e\n"]]],["This document details the process for batch retrieving and updating shipping settings for multiple accounts. It uses an HTTP POST request to `shippingsettings/batch`. The request body is a `ShippingsettingsCustomBatchRequest` containing `entries` of individual requests. Each entry specifies a `method` (`get` or `update`), `merchantId`, and `accountId`. The response, `ShippingsettingsCustomBatchResponse`, contains `entries` with results for each request, including the `batchId`, `shippingSettings`, and potential `errors`. Authorization requires the `content` OAuth scope.\n"],null,["# Method: shippingsettings.custombatch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ShippingsettingsCustomBatchResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [ShippingsettingsCustomBatchRequest](#ShippingsettingsCustomBatchRequest)\n - [JSON representation](#ShippingsettingsCustomBatchRequest.SCHEMA_REPRESENTATION)\n- [ShippingsettingsCustomBatchRequestEntry](#ShippingsettingsCustomBatchRequestEntry)\n - [JSON representation](#ShippingsettingsCustomBatchRequestEntry.SCHEMA_REPRESENTATION)\n- [ShippingsettingsCustomBatchResponseEntry](#ShippingsettingsCustomBatchResponseEntry)\n - [JSON representation](#ShippingsettingsCustomBatchResponseEntry.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nRetrieves and updates the shipping settings of multiple accounts in a single request.\n\n### HTTP request\n\n`POST https://shoppingcontent.googleapis.com/content/v2.1/shippingsettings/batch`\n\n### Request body\n\nThe request body contains an instance of [ShippingsettingsCustomBatchRequest](/shopping-content/reference/rest/v2.1/shippingsettings/custombatch#ShippingsettingsCustomBatchRequest).\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"entries\": [ { object (/shopping-content/reference/rest/v2.1/shippingsettings/custombatch#ShippingsettingsCustomBatchResponseEntry) } ], \"kind\": string } ``` |\n\n| Fields ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `entries[]` | `object (`[ShippingsettingsCustomBatchResponseEntry](/shopping-content/reference/rest/v2.1/shippingsettings/custombatch#ShippingsettingsCustomBatchResponseEntry)`)` The result of the execution of the batch requests. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string \"`content#shippingsettingsCustomBatchResponse`\". |\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).\n\nShippingsettingsCustomBatchRequest\n----------------------------------\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"entries\": [ { object (/shopping-content/reference/rest/v2.1/shippingsettings/custombatch#ShippingsettingsCustomBatchRequestEntry) } ] } ``` |\n\n| Fields ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `entries[]` | `object (`[ShippingsettingsCustomBatchRequestEntry](/shopping-content/reference/rest/v2.1/shippingsettings/custombatch#ShippingsettingsCustomBatchRequestEntry)`)` The request entries to be processed in the batch. |\n\nShippingsettingsCustomBatchRequestEntry\n---------------------------------------\n\nA batch entry encoding a single non-batch shippingsettings request.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"batchId\": integer, \"merchantId\": string, \"method\": string, \"accountId\": string, \"shippingSettings\": { object (/shopping-content/reference/rest/v2.1/shippingsettings#ShippingSettings) } } ``` |\n\n| Fields ||\n|--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `batchId` | `integer (`[uint32](https://developers.google.com/discovery/v1/type-format)` format)` An entry ID, unique within the batch request. |\n| `merchantId` | `string` The ID of the managing account. |\n| `method` | `string` The method of the batch entry. Acceptable values are: - \"`get`\" - \"`update`\" \u003cbr /\u003e |\n| `accountId` | `string` The ID of the account for which to get/update account shipping settings. |\n| `shippingSettings` | `object (`[ShippingSettings](/shopping-content/reference/rest/v2.1/shippingsettings#ShippingSettings)`)` The account shipping settings to update. Only defined if the method is `update`. |\n\nShippingsettingsCustomBatchResponseEntry\n----------------------------------------\n\nA batch entry encoding a single non-batch shipping settings response.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"batchId\": integer, \"shippingSettings\": { object (/shopping-content/reference/rest/v2.1/shippingsettings#ShippingSettings) }, \"kind\": string, \"errors\": { object (/shopping-content/reference/rest/v2.1/Errors) } } ``` |\n\n| Fields ||\n|--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `batchId` | `integer (`[uint32](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the request entry to which this entry responds. |\n| `shippingSettings` | `object (`[ShippingSettings](/shopping-content/reference/rest/v2.1/shippingsettings#ShippingSettings)`)` The retrieved or updated account shipping settings. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string \"`content#shippingsettingsCustomBatchResponseEntry`\" |\n| `errors` | `object (`[Errors](/shopping-content/reference/rest/v2.1/Errors)`)` A list of errors for failed custombatch entries. | **Note:** Schema errors fail the whole request. \u003cbr /\u003e |"]]