The country to get the datafeed status for. If this parameter is provided, then language must also be provided. Note that for multi-target datafeeds this parameter is required.
feedLabel
string
The feed label to get the datafeed status for. If this parameter is provided, then language must also be provided. Note that for multi-target datafeeds this parameter is required.
language
string
The language to get the datafeed status for. If this parameter is provided then country must also be provided. Note that for multi-target datafeeds this parameter is required.
DatafeedstatusesCustomBatchResponseEntry
A batch entry encoding a single non-batch datafeedstatuses response.
[[["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 page details how to use the Datafeedstatuses Custom Batch API to get the status of multiple Merchant Center datafeeds in a single request.\u003c/p\u003e\n"],["\u003cp\u003eThe API uses a POST request to \u003ccode\u003ehttps://shoppingcontent.googleapis.com/content/v2.1/datafeedstatuses/batch\u003c/code\u003e and requires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/content\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eYou need to provide a request body containing a \u003ccode\u003eDatafeedstatusesCustomBatchRequest\u003c/code\u003e object, which includes an array of \u003ccode\u003eDatafeedstatusesCustomBatchRequestEntry\u003c/code\u003e objects specifying the datafeeds to retrieve statuses for.\u003c/p\u003e\n"],["\u003cp\u003eThe response will contain a \u003ccode\u003eDatafeedstatusesCustomBatchResponse\u003c/code\u003e object with an array of \u003ccode\u003eDatafeedstatusesCustomBatchResponseEntry\u003c/code\u003e objects, each containing the status of a requested datafeed or any errors encountered.\u003c/p\u003e\n"]]],["This content outlines the process of retrieving multiple Merchant Center datafeed statuses via a single batch request using the `POST` method. The request body, structured as `DatafeedstatusesCustomBatchRequest`, includes an array of `DatafeedstatusesCustomBatchRequestEntry` objects, each specifying a unique `batchId`, `merchantId`, and `datafeedId`, along with optional `country`, `feedLabel`, and `language`. The response, `DatafeedstatusesCustomBatchResponse`, returns `DatafeedstatusesCustomBatchResponseEntry` objects containing the requested data feed status or errors for each entry. Authorization requires the `https://www.googleapis.com/auth/content` scope.\n"],null,["# Method: datafeedstatuses.custombatch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.DatafeedstatusesCustomBatchResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [DatafeedstatusesCustomBatchRequest](#DatafeedstatusesCustomBatchRequest)\n - [JSON representation](#DatafeedstatusesCustomBatchRequest.SCHEMA_REPRESENTATION)\n- [DatafeedstatusesCustomBatchRequestEntry](#DatafeedstatusesCustomBatchRequestEntry)\n - [JSON representation](#DatafeedstatusesCustomBatchRequestEntry.SCHEMA_REPRESENTATION)\n- [DatafeedstatusesCustomBatchResponseEntry](#DatafeedstatusesCustomBatchResponseEntry)\n - [JSON representation](#DatafeedstatusesCustomBatchResponseEntry.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nGets multiple Merchant Center datafeed statuses in a single request.\n\n### HTTP request\n\n`POST https://shoppingcontent.googleapis.com/content/v2.1/datafeedstatuses/batch`\n\n### Request body\n\nThe request body contains an instance of [DatafeedstatusesCustomBatchRequest](/shopping-content/reference/rest/v2.1/datafeedstatuses/custombatch#DatafeedstatusesCustomBatchRequest).\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/datafeedstatuses/custombatch#DatafeedstatusesCustomBatchResponseEntry) } ], \"kind\": string } ``` |\n\n| Fields ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `entries[]` | `object (`[DatafeedstatusesCustomBatchResponseEntry](/shopping-content/reference/rest/v2.1/datafeedstatuses/custombatch#DatafeedstatusesCustomBatchResponseEntry)`)` The result of the execution of the batch requests. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string \"`content#datafeedstatusesCustomBatchResponse`\". |\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\nDatafeedstatusesCustomBatchRequest\n----------------------------------\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"entries\": [ { object (/shopping-content/reference/rest/v2.1/datafeedstatuses/custombatch#DatafeedstatusesCustomBatchRequestEntry) } ] } ``` |\n\n| Fields ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `entries[]` | `object (`[DatafeedstatusesCustomBatchRequestEntry](/shopping-content/reference/rest/v2.1/datafeedstatuses/custombatch#DatafeedstatusesCustomBatchRequestEntry)`)` The request entries to be processed in the batch. |\n\nDatafeedstatusesCustomBatchRequestEntry\n---------------------------------------\n\nA batch entry encoding a single non-batch datafeedstatuses request.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"batchId\": integer, \"merchantId\": string, \"method\": string, \"datafeedId\": string, \"country\": string, \"feedLabel\": string, \"language\": string } ``` |\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`\" \u003cbr /\u003e |\n| `datafeedId` | `string` The ID of the data feed to get. |\n| `country` | `string` Deprecated. Use `feedLabel` instead. The country to get the datafeed status for. If this parameter is provided, then `language` must also be provided. Note that for multi-target datafeeds this parameter is required. |\n| `feedLabel` | `string` The feed label to get the datafeed status for. If this parameter is provided, then `language` must also be provided. Note that for multi-target datafeeds this parameter is required. |\n| `language` | `string` The language to get the datafeed status for. If this parameter is provided then `country` must also be provided. Note that for multi-target datafeeds this parameter is required. |\n\nDatafeedstatusesCustomBatchResponseEntry\n----------------------------------------\n\nA batch entry encoding a single non-batch datafeedstatuses response.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"batchId\": integer, \"datafeedStatus\": { object (/shopping-content/reference/rest/v2.1/datafeedstatuses#DatafeedStatus) }, \"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| `datafeedStatus` | `object (`[DatafeedStatus](/shopping-content/reference/rest/v2.1/datafeedstatuses#DatafeedStatus)`)` The requested data feed status. Defined if and only if the request was successful. |\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 |"]]