[null,null,["Last updated 2025-02-25 UTC."],[[["\u003cp\u003eEnables updating regional inventory for multiple products or regions within a single request.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes a batch system where individual entries specify product IDs, methods (like "insert"), and regional inventory data.\u003c/p\u003e\n"],["\u003cp\u003eResponses include details about each entry's success or failure, along with any associated errors.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/content\u003c/code\u003e scope for access.\u003c/p\u003e\n"]]],["This document outlines the process for updating regional inventory for multiple products or regions via a batch request. A `POST` HTTP request is sent to `https://shoppingcontent.googleapis.com/content/v2.1/regionalinventory/batch`. The request body, `RegionalinventoryCustomBatchRequest`, contains entries with `batchId`, `merchantId`, `method` (`insert`), `productId`, and `regionalInventory` details. The response, `RegionalinventoryCustomBatchResponse`, provides an array of entries, each containing `batchId`, potential errors, and the updated `regionalInventory`. The process requires the `https://www.googleapis.com/auth/content` authorization scope.\n"],null,["# Method: regionalinventory.custombatch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.RegionalinventoryCustomBatchResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [RegionalinventoryCustomBatchRequest](#RegionalinventoryCustomBatchRequest)\n - [JSON representation](#RegionalinventoryCustomBatchRequest.SCHEMA_REPRESENTATION)\n- [RegionalinventoryCustomBatchRequestEntry](#RegionalinventoryCustomBatchRequestEntry)\n - [JSON representation](#RegionalinventoryCustomBatchRequestEntry.SCHEMA_REPRESENTATION)\n- [RegionalinventoryCustomBatchResponseEntry](#RegionalinventoryCustomBatchResponseEntry)\n - [JSON representation](#RegionalinventoryCustomBatchResponseEntry.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nUpdates regional inventory for multiple products or regions in a single request.\n\n### HTTP request\n\n`POST https://shoppingcontent.googleapis.com/content/v2.1/regionalinventory/batch`\n\n### Request body\n\nThe request body contains an instance of [RegionalinventoryCustomBatchRequest](/shopping-content/reference/rest/v2.1/regionalinventory/custombatch#RegionalinventoryCustomBatchRequest).\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/regionalinventory/custombatch#RegionalinventoryCustomBatchResponseEntry) } ], \"kind\": string } ``` |\n\n| Fields ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `entries[]` | `object (`[RegionalinventoryCustomBatchResponseEntry](/shopping-content/reference/rest/v2.1/regionalinventory/custombatch#RegionalinventoryCustomBatchResponseEntry)`)` The result of the execution of the batch requests. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string \"`content#regionalinventoryCustomBatchResponse`\". |\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\nRegionalinventoryCustomBatchRequest\n-----------------------------------\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"entries\": [ { object (/shopping-content/reference/rest/v2.1/regionalinventory/custombatch#RegionalinventoryCustomBatchRequestEntry) } ] } ``` |\n\n| Fields ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `entries[]` | `object (`[RegionalinventoryCustomBatchRequestEntry](/shopping-content/reference/rest/v2.1/regionalinventory/custombatch#RegionalinventoryCustomBatchRequestEntry)`)` The request entries to be processed in the batch. |\n\nRegionalinventoryCustomBatchRequestEntry\n----------------------------------------\n\nA batch entry encoding a single non-batch regional inventory request.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"batchId\": integer, \"merchantId\": string, \"method\": string, \"productId\": string, \"regionalInventory\": { object (/shopping-content/reference/rest/v2.1/regionalinventory#RegionalInventory) } } ``` |\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` Method of the batch request entry. Acceptable values are: - \"`insert`\" \u003cbr /\u003e |\n| `productId` | `string` The ID of the product for which to update price and availability. |\n| `regionalInventory` | `object (`[RegionalInventory](/shopping-content/reference/rest/v2.1/regionalinventory#RegionalInventory)`)` Price and availability of the product. |\n\nRegionalinventoryCustomBatchResponseEntry\n-----------------------------------------\n\nA batch entry encoding a single non-batch regional inventory response.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"batchId\": integer, \"errors\": { object (/shopping-content/reference/rest/v2.1/Errors) }, \"regionalInventory\": { object (/shopping-content/reference/rest/v2.1/regionalinventory#RegionalInventory) }, \"kind\": string } ``` |\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| `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 |\n| `regionalInventory` | `object (`[RegionalInventory](/shopping-content/reference/rest/v2.1/regionalinventory#RegionalInventory)`)` Price and availability of the product. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string \"`content#regionalinventoryCustomBatchResponseEntry`\". |"]]