The country to get the datafeed status for. If this parameter is provided, thenlanguagemust 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, thenlanguagemust 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 thencountrymust 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 |"]]
