You can use
freelistingprogram.get
to get the
current status of free
listings for a specific
region.
Selected merchants can use
freelistingprogram.requestreview
to request a review of their free listings after making changes. Submit this
form
to request early access to freelistingprogram.requestreview
.
See the Shopping ads guide for problems with your Shopping ads, and the Account Statuses guide for account information and issues.
Merchants are responsible for complying with the free listings 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
freelistingprogram.get
method to get the current status of your free listings. This method requires
your merchantID
and returns an instance of
freelistingprogramstatus
with the current approval status and review eligibility. If your free listings
are enrolled in multiple regions, get
returns a freelistingprogramstatus
resource for each region.
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/freelistingprogram
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"
}
}
]
}
requestreview
This method is only available to selected merchants. Submit this
form
to request early access to freelistingprogram.requestreview
.
Some issues require a review of your free listings. You can use the
freelistingprogram.requestreview
method to request a review after making changes. This method requires your
merchantId
and regionCode
,
and returns an empty response body if completed successfully.
You need to do the following before you can request a review:
- Have an address.
- Verify a phone number.
- Claim a website.
- Upload products.
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/freelistingsprogram/requestreview
After a successful request, the eligibilityStatus
of your account changes to
PENDING_REVIEW
.