Shopping ads

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

You can use shoppingadsprogram.get to get the current status of your Shopping ads for a specific region, then use shoppingadsprogram.requestreview to request a review after making changes.

The shoppingadsprogram methods apply to your Shopping ads, not account level issues.

See the free listings guide for problems with free listings, and the Account Statuses guide for account information and issues.

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

get

You can use the shoppingadsprogram.get method to get the current status of your Shopping ads.

This method requires your merchantId and returns an instance of shoppingadsprogramstatus with the current status and review eligibility for that Shopping ads program.

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/shoppingadsprogram

Here’s a sample response:

{
  "globalState": "NOT_ENABLED",
  "regionStatuses": [
    {
      "regionCodes": [
        "US"
      ],
      "eligibilityStatus": "DISAPPROVED",
      "reviewIssues": [
        "editorial_and_professional_standards_destination_url_down_policy"
      ],
      "onboardingIssues": [
        "home_page_issue"
      ],
      "disapprovalDate": "2013-02-25",
      "reviewEligibilityStatus": "INELIGIBLE",
      "reviewIneligibilityReason": "IN_COOLDOWN_PERIOD",
      "reviewIneligibilityReasonDescription": "Cool down applies: Wait for one-week cool-down period to end before you can request a review from Google. End of cool down is 2013-02-30",
      "reviewIneligibilityReasonDetails": {
        "cooldownTime": "2013-02-30"
      }
    }
  ]
}

There are three cases where an issue has the severity WARNING:

  • Warnings that turn into disapprovals if you don't resolve them by the deadline.
  • Warnings that don't have a deadline or turn into disapprovals, but limit the impressions for your products.
  • Warnings that don't have a deadline and don't impact the impressions for your products.

This method returns errors and warnings if they require action to resolve, will become disapprovals, or impact impressions. Use account statuses to view all issues impacting an account, regardless of severity.

requestreview

Most issues require you to request a review after you fix them. You can use the shoppingadsprogram.requestreview method to request a review after you've fixed the issues.

You need to do the following before you can request a review:

This method requires your merchantID and regionCode, and doesn’t return a response if completed successfully.

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/shoppingadsprogram/requestreview

After a successful request, the eligibilityStatusof your account changes to PENDING_REVIEW.