Productstatuses

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

Resource representations

The status of a product, i.e., information about a product computed asynchronously.

JSON

{
  "kind": "content#productStatus",
  "productId": string,
  "title": string,
  "link": string,
  "destinationStatuses": [
    {
      "destination": string,
      "intention": string,
      "approvalStatus": string,
      "approvalPending": boolean
    }
  ],
  "dataQualityIssues": [
    {
      "id": string,
      "severity": string,
      "timestamp": string,
      "location": string,
      "detail": string,
      "valueProvided": string,
      "valueOnLandingPage": string,
      "fetchStatus": string,
      "destination": string
    }
  ],
  "itemLevelIssues": [
    {
      "code": string,
      "servability": string,
      "resolution": string,
      "attributeName": string,
      "destination": string,
      "description": string,
      "detail": string,
      "documentation": string
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string,
  "product": products Resource
}
Property name Value Description Notes
creationDate string Date on which the item has been created, in ISO 8601 format.
dataQualityIssues[] list DEPRECATED - never populated
dataQualityIssues[].destination string
dataQualityIssues[].detail string
dataQualityIssues[].fetchStatus string
dataQualityIssues[].id string
dataQualityIssues[].location string
dataQualityIssues[].severity string

Acceptable values are:
  • "critical"
  • "error"
  • "suggestion"
dataQualityIssues[].timestamp string
dataQualityIssues[].valueOnLandingPage string
dataQualityIssues[].valueProvided string
destinationStatuses[] list The intended destinations for the product.
destinationStatuses[].approvalPending boolean Whether the approval status might change due to further processing.
destinationStatuses[].approvalStatus string The destination's approval status.

Acceptable values are:
  • "approved"
  • "disapproved"
destinationStatuses[].destination string The name of the destination
destinationStatuses[].intention string Provided for backward compatibility only. Always set to "required".

Acceptable values are:
  • "default"
  • "excluded"
  • "optional"
  • "required"
googleExpirationDate string Date on which the item expires in Google Shopping, in ISO 8601 format.
itemLevelIssues[] list A list of all issues associated with the product.
itemLevelIssues[].attributeName string The attribute's name, if the issue is caused by a single attribute.
itemLevelIssues[].code string The error code of the issue.
itemLevelIssues[].description string A short issue description in English.
itemLevelIssues[].destination string The destination the issue applies to.
itemLevelIssues[].detail string A detailed issue description in English.
itemLevelIssues[].documentation string The URL of a web page to help with resolving this issue.
itemLevelIssues[].resolution string Whether the issue can be resolved by the merchant.
itemLevelIssues[].servability string How this issue affects serving of the offer.
kind string Identifies what kind of resource this is. Value: the fixed string "content#productStatus".
lastUpdateDate string Date on which the item has been last updated, in ISO 8601 format.
product nested object Product data after applying all the join inputs.
productId string The ID of the product for which status is reported.
title string The title of the product.

XML

<product_status>
  <product_id>
    string
  </product_id>
  <title>
    string
  </title>
  <link>
    string
  </link>
  <creation_date>
    string
  </creation_date>
  <last_update_date>
    string
  </last_update_date>
  <google_expiration_date>
    string
  </google_expiration_date>
  <destination_status>
    (foreach)
      <destination name="string" intention="string" status="string"/>
    (/foreach)
  </destination_status>
  <data_quality_issues>
    (foreach)
      <data_quality_issue id="string" severity="string" timestamp="string" location="string" detail="string" value_provided="string" value_on_landing_page="string" fetch_status="string"/>
    (/foreach)
  </data_quality_issues>
  <item_level_issues>
    (foreach)
      <item_level_issue code="string" servability="string" resolution="string" attribute_name="string" destination="string" description="string" detail="string" documentation="string"/>
    (/foreach)
  </item_level_issues>
  products Resource
</product_status>
Property name Value Description Notes
product_status object The status of a product, i.e., information about a product computed asynchronously.
product_status/creation_date string Date on which the item has been created, in ISO 8601 format.
product_status/data_quality_issues object DEPRECATED - never populated
product_status/data_quality_issues/data_quality_issue object A list of data quality issues associated with the product.
product_status/data_quality_issues/data_quality_issue/detail string
product_status/data_quality_issues/data_quality_issue/fetch_status string
product_status/data_quality_issues/data_quality_issue/id string
product_status/data_quality_issues/data_quality_issue/location string
product_status/data_quality_issues/data_quality_issue/severity string

Acceptable values are:
  • "critical"
  • "error"
  • "suggestion"
product_status/data_quality_issues/data_quality_issue/timestamp string
product_status/data_quality_issues/data_quality_issue/value_on_landing_page string
product_status/data_quality_issues/data_quality_issue/value_provided string
product_status/destination_status object The intended destinations for the product.
product_status/destination_status/destination object The intended destinations for the product.
product_status/destination_status/destination/intention string Provided for backward compatibility only. Always set to "required".

Acceptable values are:
  • "default"
  • "excluded"
  • "optional"
  • "required"
product_status/destination_status/destination/name string The name of the destination
product_status/destination_status/destination/status string The destination's approval status.

Acceptable values are:
  • "approved"
  • "disapproved"
product_status/google_expiration_date string Date on which the item expires in Google Shopping, in ISO 8601 format.
product_status/item_level_issues object
product_status/item_level_issues/item_level_issue object A list of all issues associated with the product.
product_status/item_level_issues/item_level_issue/attribute_name string The attribute's name, if the issue is caused by a single attribute.
product_status/item_level_issues/item_level_issue/code string The error code of the issue.
product_status/item_level_issues/item_level_issue/description string A short issue description in English.
product_status/item_level_issues/item_level_issue/destination string The destination the issue applies to.
product_status/item_level_issues/item_level_issue/detail string A detailed issue description in English.
product_status/item_level_issues/item_level_issue/documentation string The URL of a web page to help with resolving this issue.
product_status/item_level_issues/item_level_issue/resolution string Whether the issue can be resolved by the merchant.
product_status/item_level_issues/item_level_issue/servability string How this issue affects serving of the offer.
product_status/last_update_date string Date on which the item has been last updated, in ISO 8601 format.
product_status/product nested object Product data after applying all the join inputs. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect.
product_status/product_id string The ID of the product for which status is reported.
product_status/title string The title of the product.

Methods

custombatch
Gets the statuses of multiple products in a single request.
get
Gets the status of a product from your Merchant Center account.
list
Lists the statuses of the products in your Merchant Center account.