Datafeedstatuses

For a list of methods for this resource, see the end of this page.

Resource representations

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

JSON

{
  "kind": "content#datafeedStatus",
  "datafeedId": unsigned long,
  "country": string,
  "language": string,
  "processingStatus": string,
  "errors": [
    {
      "code": string,
      "count": unsigned long,
      "message": string,
      "examples": [
        {
          "lineNumber": unsigned long,
          "itemId": string,
          "value": string
        }
      ]
    }
  ],
  "warnings": [
    {
      "code": string,
      "count": unsigned long,
      "message": string,
      "examples": [
        {
          "lineNumber": unsigned long,
          "itemId": string,
          "value": string
        }
      ]
    }
  ],
  "itemsTotal": unsigned long,
  "itemsValid": unsigned long,
  "lastUploadDate": string
}
Property name Value Description Notes
country string The country for which the status is reported, represented as a CLDR territory code.
datafeedId unsigned long The ID of the feed for which the status is reported.
errors[] list The list of errors occurring in the feed.
errors[].code string The code of the error, e.g., "validation/invalid_value".
errors[].count unsigned long The number of occurrences of the error in the feed.
errors[].examples[] list A list of example occurrences of the error, grouped by product.
errors[].examples[].itemId string The ID of the example item.
errors[].examples[].lineNumber unsigned long Line number in the data feed where the example is found.
errors[].examples[].value string The problematic value.
errors[].message string The error message, e.g., "Invalid price".
itemsTotal unsigned long The number of items in the feed that were processed.
itemsValid unsigned long The number of items in the feed that were valid.
kind string Identifies what kind of resource this is. Value: the fixed string "content#datafeedStatus".
language string The two-letter ISO 639-1 language for which the status is reported.
lastUploadDate string The last date at which the feed was uploaded.
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.
warnings[] list The list of errors occurring in the feed.
warnings[].code string The code of the error, e.g., "validation/invalid_value".
warnings[].count unsigned long The number of occurrences of the error in the feed.
warnings[].examples[] list A list of example occurrences of the error, grouped by product.
warnings[].examples[].itemId string The ID of the example item.
warnings[].examples[].lineNumber unsigned long Line number in the data feed where the example is found.
warnings[].examples[].value string The problematic value.
warnings[].message string The error message, e.g., "Invalid price".

XML

<datafeed_status>
  <datafeed_id>
    unsigned long
  </datafeed_id>
  <country>
    string
  </country>
  <language>
    string
  </language>
  <processing_status>
    string
  </processing_status>
  <last_upload_date>
    string
  </last_upload_date>
  <items_total>
    unsigned long
  </items_total>
  <items_valid>
    unsigned long
  </items_valid>
  <errors>
    (foreach)
      <error code="string" count="unsigned long" message="string">
        (foreach)
          <example>
            <line_number>
              unsigned long
            </line_number>
            <item_id>
              string
            </item_id>
            <value>
              string
            </value>
          </example>
        (/foreach)
      </error>
    (/foreach)
  </errors>
  <warnings>
    (foreach)
      <warning code="string" count="unsigned long" message="string">
        (foreach)
          <example>
            <line_number>
              unsigned long
            </line_number>
            <item_id>
              string
            </item_id>
            <value>
              string
            </value>
          </example>
        (/foreach)
      </warning>
    (/foreach)
  </warnings>
</datafeed_status>
Property name Value Description Notes
datafeed_status object The status of a datafeed, i.e., the result of the last retrieval of the datafeed computed asynchronously when the feed processing is finished.
datafeed_status/country string The country for which the status is reported, represented as a CLDR territory code.
datafeed_status/datafeed_id unsigned long The ID of the feed for which the status is reported.
datafeed_status/errors object
datafeed_status/errors/error object The list of errors occurring in the feed. An error occurring in the feed, like "invalid price".
datafeed_status/errors/error/code string The code of the error, e.g., "validation/invalid_value".
datafeed_status/errors/error/count unsigned long The number of occurrences of the error in the feed.
datafeed_status/errors/error/example object A list of example occurrences of the error, grouped by product. An example occurrence for a particular error.
datafeed_status/errors/error/example/item_id string The ID of the example item.
datafeed_status/errors/error/example/line_number unsigned long Line number in the data feed where the example is found.
datafeed_status/errors/error/example/value string The problematic value.
datafeed_status/errors/error/message string The error message, e.g., "Invalid price".
datafeed_status/items_total unsigned long The number of items in the feed that were processed.
datafeed_status/items_valid unsigned long The number of items in the feed that were valid.
datafeed_status/language string The two-letter ISO 639-1 language for which the status is reported.
datafeed_status/last_upload_date string The last date at which the feed was uploaded.
datafeed_status/processing_status string The processing status of the feed. Status of a data 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.
datafeed_status/warnings object
datafeed_status/warnings/warning object The list of errors occurring in the feed. An error occurring in the feed, like "invalid price".
datafeed_status/warnings/warning/code string The code of the error, e.g., "validation/invalid_value".
datafeed_status/warnings/warning/count unsigned long The number of occurrences of the error in the feed.
datafeed_status/warnings/warning/example object A list of example occurrences of the error, grouped by product. An example occurrence for a particular error.
datafeed_status/warnings/warning/example/item_id string The ID of the example item.
datafeed_status/warnings/warning/example/line_number unsigned long Line number in the data feed where the example is found.
datafeed_status/warnings/warning/example/value string The problematic value.
datafeed_status/warnings/warning/message string The error message, e.g., "Invalid price".

Methods

custombatch
get
Retrieves the status of a datafeed from your Merchant Center account.
list
Lists the statuses of the datafeeds in your Merchant Center account.

Send feedback about...

Content API for Shopping