[null,null,["Last updated 2025-02-25 UTC."],[[["\u003cp\u003eRetrieves and updates tax settings for multiple accounts through a single HTTP POST request.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain an \u003ccode\u003eAccounttaxCustomBatchRequest\u003c/code\u003e object with entries for each account.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an \u003ccode\u003eAccounttaxCustomBatchResponse\u003c/code\u003e with the results for each entry, including any errors.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/content\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document details how to use a batch request to manage tax settings for multiple accounts. It involves sending a `POST` HTTP request to a specific endpoint with an `AccounttaxCustomBatchRequest` in the body. This request includes an array of `AccounttaxCustomBatchRequestEntry`, each specifying an action (`get` or `update`) and target `accountId`. The response, `AccounttaxCustomBatchResponse`, contains an array of `AccounttaxCustomBatchResponseEntry`, detailing the results for each request, including any errors. Authentication requires the `https://www.googleapis.com/auth/content` scope.\n"],null,["# Method: accounttax.custombatch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.AccounttaxCustomBatchResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [AccounttaxCustomBatchRequest](#AccounttaxCustomBatchRequest)\n - [JSON representation](#AccounttaxCustomBatchRequest.SCHEMA_REPRESENTATION)\n- [AccounttaxCustomBatchRequestEntry](#AccounttaxCustomBatchRequestEntry)\n - [JSON representation](#AccounttaxCustomBatchRequestEntry.SCHEMA_REPRESENTATION)\n- [AccounttaxCustomBatchResponseEntry](#AccounttaxCustomBatchResponseEntry)\n - [JSON representation](#AccounttaxCustomBatchResponseEntry.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nRetrieves and updates tax settings of multiple accounts in a single request.\n\n### HTTP request\n\n`POST https://shoppingcontent.googleapis.com/content/v2.1/accounttax/batch`\n\n### Request body\n\nThe request body contains an instance of [AccounttaxCustomBatchRequest](/shopping-content/reference/rest/v2.1/accounttax/custombatch#AccounttaxCustomBatchRequest).\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/accounttax/custombatch#AccounttaxCustomBatchResponseEntry) } ], \"kind\": string } ``` |\n\n| Fields ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `entries[]` | `object (`[AccounttaxCustomBatchResponseEntry](/shopping-content/reference/rest/v2.1/accounttax/custombatch#AccounttaxCustomBatchResponseEntry)`)` The result of the execution of the batch requests. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string \"`content#accounttaxCustomBatchResponse`\". |\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\nAccounttaxCustomBatchRequest\n----------------------------\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"entries\": [ { object (/shopping-content/reference/rest/v2.1/accounttax/custombatch#AccounttaxCustomBatchRequestEntry) } ] } ``` |\n\n| Fields ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `entries[]` | `object (`[AccounttaxCustomBatchRequestEntry](/shopping-content/reference/rest/v2.1/accounttax/custombatch#AccounttaxCustomBatchRequestEntry)`)` The request entries to be processed in the batch. |\n\nAccounttaxCustomBatchRequestEntry\n---------------------------------\n\nA batch entry encoding a single non-batch accounttax request.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"batchId\": integer, \"merchantId\": string, \"method\": string, \"accountId\": string, \"accountTax\": { object (/shopping-content/reference/rest/v2.1/accounttax#AccountTax) } } ``` |\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 tax settings. |\n| `accountTax` | `object (`[AccountTax](/shopping-content/reference/rest/v2.1/accounttax#AccountTax)`)` The account tax settings to update. Only defined if the method is `update`. |\n\nAccounttaxCustomBatchResponseEntry\n----------------------------------\n\nA batch entry encoding a single non-batch accounttax response.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"batchId\": integer, \"kind\": string, \"accountTax\": { object (/shopping-content/reference/rest/v2.1/accounttax#AccountTax) }, \"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 this entry responds to. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string \"`content#accounttaxCustomBatchResponseEntry`\" |\n| `accountTax` | `object (`[AccountTax](/shopping-content/reference/rest/v2.1/accounttax#AccountTax)`)` The retrieved or updated account tax settings. |\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 |"]]