REST Resource: datafeedstatuses

  • DatafeedStatus provides information on the processing status of a datafeed, including errors and warnings encountered.

  • DatafeedStatusError details specific errors found within the feed, such as invalid values, with occurrence counts and examples.

  • DatafeedStatusExample illustrates a specific instance of an error within the feed, pinpointing the location and problematic value.

  • You can retrieve and manage datafeed statuses through methods like custombatch, get, and list.

Resource: DatafeedStatus

The status of a datafeed, that is, the result of the last retrieval of the datafeed computed asynchronously when the feed processing is finished.

JSON representation 
{
  "datafeedId": string,
  "processingStatus": string,
  "errors": [
    {
      object (DatafeedStatusError)
    }
  ],
  "warnings": [
    {
      object (DatafeedStatusError)
    }
  ],
  "itemsTotal": string,
  "itemsValid": string,
  "lastUploadDate": string,
  "country": string,
  "feedLabel": string,
  "language": string,
  "kind": string
}
Fields
datafeedId

string

The ID of the feed for which the status is reported.
processingStatus

string

The processing status of the feed.

Acceptable values are:

  • ""failure": The feed could not be processed or all items had errors."
  • "in progress": The feed is being processed.
  • "none": The feed has not yet been processed. For example, a feed that has never been uploaded will have this processing status.
  • "success": The feed was processed successfully, though some items might have had errors.
errors[]

object (DatafeedStatusError)

The list of errors occurring in the feed.
warnings[]

object (DatafeedStatusError)

The list of errors occurring in the feed.
itemsTotal

string

The number of items in the feed that were processed.
itemsValid

string

The number of items in the feed that were valid.
lastUploadDate

string

The last date at which the feed was uploaded.
country

string

The country for which the status is reported, represented as a CLDR territory code.
feedLabel

string

The feed label status is reported for.
language

string

The two-letter ISO 639-1 language for which the status is reported.
kind

string

Identifies what kind of resource this is. Value: the fixed string "content#datafeedStatus"

DatafeedStatusError

An error occurring in the feed, like "invalid price".

JSON representation 
{
  "code": string,
  "count": string,
  "message": string,
  "examples": [
    {
      object (DatafeedStatusExample)
    }
  ]
}
Fields
code

string

The code of the error, for example, "validation/invalid_value".
count

string

The number of occurrences of the error in the feed.
message

string

The error message, for example, "Invalid price".
examples[]

object (DatafeedStatusExample)

A list of example occurrences of the error, grouped by product.

DatafeedStatusExample

An example occurrence for a particular error.

JSON representation 
{
  "lineNumber": string,
  "itemId": string,
  "value": string
}
Fields
lineNumber

string

Line number in the data feed where the example is found.
itemId

string

The ID of the example item.
value

string

The problematic value.

Methods

custombatch

 Gets multiple Merchant Center datafeed statuses in a single request.

get

 Retrieves the status of a datafeed from your Merchant Center account.

list

 Lists the statuses of the datafeeds in your Merchant Center account.