Retrieve product status
Stay organized with collections Save and categorize content based on your preferences.

You can use the accounts.products resource to view the detailed status of your Shopping products.

If you are using the Content API for Shopping to add products, see the migration guide to understand how to get started with the Merchant Products API.

You are responsible for complying with the Shopping ads and free listings policies. Shopping ads reserves the right to enforce these policies and respond appropriately if we find content or behavior that violates these policies.

Requirements

To see product statuses, you must do the following:

Enroll your account in a program.
Provide a valid country code in one of the following (the product will target the union of the provided countries):
- In the shipping attribute of your product.
- In the countries field of your primary data source.

Get a product's status

Retrieve the accounts.products resource to view the status of a product.

Here's a sample GET request:

GET https://merchantapi.googleapis.com/products/v1beta/accounts/ACCOUNT_ID/products/PRODUCT_ID

All responses from products.get include the ProductStatus message with the following fields:

creationDate: The date that the product was created.
lastUpdateDate: The last time that the product was updated.
googleExpirationDate: The date when the product expires.
destinationStatuses: The intended destinations for the product and the statuses for each target country.
itemLevelIssues: A list of all issues associated with the product.

You only see the itemLevelIssues field in the response if the product has item-level issues at the time of your request.

Here's a sample JSON response:

{
"name": "accounts/123/products/online~en~US~1",
"channel": "ONLINE",
"offerId": "1",
"contentLanguage": "en",
"feedLabel": "US",
"dataSource": "accounts/123/dataSources/456",
"attributes": {
  "title": "Color Headphones",
  "description": "A light and elegant design and super sound quality make these over-ear headphones a constant companion. Foldable to save space, and printed with the white Google logo on one earpiece.",
  "imageLink": "http://tmp53317.purecake.com/images/headphones.jpg",
  "availability": "in stock",
  "brand": "Google",
  "condition": "new",
  "googleProductCategory": "Electronics \u003e Audio \u003e Audio Components \u003e Headphones",
  "gtin": "00050644632143",
  "mpn": "90000007101",
  "price": {
    "amountMicros": "288000",
    "currencyCode": "USD"
  }
},
"productStatus": {
  "destinationStatuses": [
    {
      "reportingContext": "FREE_LISTINGS",
      "disapprovedCountries": [
        "US"
      ]
    }
  ],
  "itemLevelIssues": [
    {
      "code": "pending_phone_verification",
      "severity": "NOT_IMPACTED",
      "resolution": "merchant_action",
      "reportingContext": "FREE_LISTINGS",
      "description": "Unverified phone number",
      "detail": "Go to the Business information page to verify your business phone number",
      "documentation": "https://support.google.com/merchants/answer/10139041",
      "applicableCountries": [
        "US"
      ]
    },
    {
      "code": "pending_initial_policy_review_free_listings",
      "severity": "DISAPPROVED",
      "resolution": "pending_processing",
      "reportingContext": "FREE_LISTINGS",
      "description": "Pending initial review",
      "detail": "Please wait up to 3 business days for the review to be completed",
      "documentation": "https://support.google.com/merchants/answer/2948694",
      "applicableCountries": [
        "US"
      ]
    },
    {
      "code": "url_does_not_match_homepage",
      "severity": "DISAPPROVED",
      "resolution": "merchant_action",
      "attribute": "link",
      "reportingContext": "FREE_LISTINGS",
      "description": "Mismatched domains [link]",
      "detail": "Use the same domain for product landing page URLs as in your Merchant Center website setting",
      "documentation": "https://support.google.com/merchants/answer/160050",
      "applicableCountries": [
        "US"
      ]
    }
  ],
  "creationDate": "2024-05-27T16:15:31.791730Z",
  "lastUpdateDate": "2024-05-27T16:15:31.791730Z",
  "googleExpirationDate": "2024-06-26T16:15:31.791730Z"
}

Retrieve all disapproved products

To retrieve all the products that are disapproved or not eligible, use the following accounts.reports.search request:

POST https://merchantapi.googleapis.com/reports/v1beta/accounts/{ACCOUNT_ID}/reports:search

{
  "query": "SELECT id,offer_id,feed_label,title FROM product_view WHERE aggregated_reporting_context_status = 'NOT_ELIGIBLE_OR_DISAPPROVED'"
}

For more information about filtering and retrieving products using the Merchant Reports API, see Evaluate your products.

Retrieve all products that are pending review

To retrieve all the products that are pending review, use the following request:

POST https://merchantapi.googleapis.com/reports/v1beta/accounts/{ACCOUNT_ID}/reports:search

{
  "query": "SELECT id,offer_id,feed_label,title FROM product_view WHERE aggregated_reporting_context_status = 'PENDING'"
}

List all product statuses

Use the products.list method to view all your products and their statuses.

You can use the following parameters to refine your query:

pageToken: Used to get subsequent pages of results. Every page has a nextPageToken you can use to get the next page in the sequence.
maxResults: The maximum number of results per page.

Here's a sample list request with optional query parameters:

GET https://merchantapi.googleapis.com/products/v1beta/{PARENT}/products?maxResults=1&pageToken=5108b52782905aa9

Here's a sample JSON response:

{
"nextPageToken": "632fd090c95712c6",
"products": [
 {
  "name": "accounts/123/products/online~en~US~1",
  "channel": "ONLINE",
  "offerId": "1",
  "contentLanguage": "en",
  "feedLabel": "US",
  "dataSource": "accounts/123/dataSources/10355371287",
  "attributes": {
    "title": "Color Headphones",
    "description": "A light and elegant design and super sound quality make these over-ear headphones a constant companion. Foldable to save space, and printed with the white Google logo on one earpiece.",
    "imageLink": "http://tmp53317.purecake.com/images/headphones.jpg",
    "availability": "in stock",
    "brand": "Google",
    "condition": "new",
    "googleProductCategory": "Electronics \u003e Audio \u003e Audio Components \u003e Headphones",
    "gtin": "00050644632143",
    "mpn": "90000007101",
    "price": {
      "amountMicros": "28800000",
      "currencyCode": "USD"
    }
  },
  "productStatus": {
    "destinationStatuses": [
      {
        "reportingContext": "FREE_LISTINGS",
        "disapprovedCountries": [
          "US"
        ]
      }
    ],
    "itemLevelIssues": [
      {
        "code": "pending_phone_verification",
        "severity": "NOT_IMPACTED",
        "resolution": "merchant_action",
        "reportingContext": "FREE_LISTINGS",
        "description": "Unverified phone number",
        "detail": "Go to the Business information page to verify your business phone number",
        "documentation": "https://support.google.com/merchants/answer/10139041",
        "applicableCountries": [
          "US"
        ]
      },
      {
        "code": "pending_initial_policy_review_free_listings",
        "severity": "DISAPPROVED",
        "resolution": "pending_processing",
        "reportingContext": "FREE_LISTINGS",
        "description": "Pending initial review",
        "detail": "Please wait up to 3 business days for the review to be completed",
        "documentation": "https://support.google.com/merchants/answer/2948694",
        "applicableCountries": [
          "US"
        ]
      },
      {
        "code": "url_does_not_match_homepage",
        "severity": "DISAPPROVED",
        "resolution": "merchant_action",
        "attribute": "link",
        "reportingContext": "FREE_LISTINGS",
        "description": "Mismatched domains [link]",
        "detail": "Use the same domain for product landing page URLs as in your Merchant Center website setting",
        "documentation": "https://support.google.com/merchants/answer/160050",
        "applicableCountries": [
          "US"
        ]
      }
    ],
    "creationDate": "2024-05-27T16:15:31.791730Z",
    "lastUpdateDate": "2024-05-27T16:15:31.791730Z",
    "googleExpirationDate": "2024-06-26T16:15:31.791730Z"
  }
]
}

The products.list call is safe to test in production because it doesn't make any changes to your data.

Item-level issues

Each item-level issue includes the following fields:

code: The error code of the issue.
severity: The severity of the issue.
resolution: Informs if the merchant can solve the issue.
attribute: The attribute name that is affected.
reportingContext: The reporting context the issue applies to.
description: The description of the issue.
detail: Gives more information about the problem.
documentation: The URL for the documentation about the problem.
applicableCountries: Indicates in which countries the issue affects the product.

Retrieve product status Stay organized with collections Save and categorize content based on your preferences.