[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-02-25 UTC."],[[["\u003cp\u003eThis operation batches multiple return address related calls, such as get, insert, and delete, in a single request to the Shopping Content API.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain a \u003ccode\u003eReturnaddressCustomBatchRequest\u003c/code\u003e object specifying the individual operations to perform.\u003c/p\u003e\n"],["\u003cp\u003eEach individual operation within the batch is defined by a \u003ccode\u003eReturnaddressCustomBatchRequestEntry\u003c/code\u003e object, containing details like the method and the return address data.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides a \u003ccode\u003eReturnaddressCustomBatchResponse\u003c/code\u003e object containing a list of \u003ccode\u003eReturnaddressCustomBatchResponseEntry\u003c/code\u003e objects, each corresponding to an individual operation result.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required using OAuth 2.0 with the \u003ccode\u003ehttps://www.googleapis.com/auth/content\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This content outlines how to batch multiple return address operations via a single HTTP POST request to `https://shoppingcontent.googleapis.com/content/v2.1/returnaddress/batch`. The request body, `ReturnaddressCustomBatchRequest`, contains an array of `ReturnaddressCustomBatchRequestEntry` objects, each defining a single action (`delete`, `get`, or `insert`). The response body, `ReturnaddressCustomBatchResponse`, contains an array of `ReturnaddressCustomBatchResponseEntry` objects, reflecting the outcome of each request entry. Authorization requires the `https://www.googleapis.com/auth/content` scope.\n"],null,["- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ReturnaddressCustomBatchResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [ReturnaddressCustomBatchRequest](#ReturnaddressCustomBatchRequest)\n - [JSON representation](#ReturnaddressCustomBatchRequest.SCHEMA_REPRESENTATION)\n- [ReturnaddressCustomBatchRequestEntry](#ReturnaddressCustomBatchRequestEntry)\n - [JSON representation](#ReturnaddressCustomBatchRequestEntry.SCHEMA_REPRESENTATION)\n- [ReturnaddressCustomBatchResponseEntry](#ReturnaddressCustomBatchResponseEntry)\n - [JSON representation](#ReturnaddressCustomBatchResponseEntry.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nBatches multiple return address related calls in a single request.\n\nHTTP request\n\n`POST https://shoppingcontent.googleapis.com/content/v2.1/returnaddress/batch`\n\nRequest body\n\nThe request body contains an instance of [ReturnaddressCustomBatchRequest](/shopping-content/reference/rest/v2.1/returnaddress/custombatch#ReturnaddressCustomBatchRequest).\n\nResponse body If successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"entries\": [ { object (/shopping-content/reference/rest/v2.1/returnaddress/custombatch#ReturnaddressCustomBatchResponseEntry) } ], \"kind\": string } ``` |\n\n| Fields ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `entries[]` | `object (`[ReturnaddressCustomBatchResponseEntry](/shopping-content/reference/rest/v2.1/returnaddress/custombatch#ReturnaddressCustomBatchResponseEntry)`)` The result of the execution of the batch requests. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string \"`content#returnaddressCustomBatchResponse`\". |\n\nAuthorization 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\nReturnaddressCustomBatchRequest\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"entries\": [ { object (/shopping-content/reference/rest/v2.1/returnaddress/custombatch#ReturnaddressCustomBatchRequestEntry) } ] } ``` |\n\n| Fields ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `entries[]` | `object (`[ReturnaddressCustomBatchRequestEntry](/shopping-content/reference/rest/v2.1/returnaddress/custombatch#ReturnaddressCustomBatchRequestEntry)`)` The request entries to be processed in the batch. |\n\nReturnaddressCustomBatchRequestEntry\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"batchId\": integer, \"merchantId\": string, \"method\": string, \"returnAddressId\": string, \"returnAddress\": { object (/shopping-content/reference/rest/v2.1/returnaddress#ReturnAddress) } } ``` |\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 Merchant Center account ID. |\n| `method` | `string` Method of the batch request entry. Acceptable values are: - \"`delete`\" - \"`get`\" - \"`insert`\" \u003cbr /\u003e |\n| `returnAddressId` | `string` The return address ID. This should be set only if the method is `delete` or `get`. |\n| `returnAddress` | `object (`[ReturnAddress](/shopping-content/reference/rest/v2.1/returnaddress#ReturnAddress)`)` The return address to submit. This should be set only if the method is `insert`. |\n\nReturnaddressCustomBatchResponseEntry\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"batchId\": integer, \"returnAddress\": { object (/shopping-content/reference/rest/v2.1/returnaddress#ReturnAddress) }, \"errors\": { object (/shopping-content/reference/rest/v2.1/Errors) }, \"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 to which this entry responds. |\n| `returnAddress` | `object (`[ReturnAddress](/shopping-content/reference/rest/v2.1/returnaddress#ReturnAddress)`)` The retrieved return address. |\n| `errors` | `object (`[Errors](/shopping-content/reference/rest/v2.1/Errors)`)` A list of errors defined if, and only if, the request failed. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string \"`content#returnaddressCustomBatchResponseEntry`\" |"]]