GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/freelistingprogram
以下是示例响应:
{"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"}}]}
[null,null,["最后更新时间 (UTC):2025-08-13。"],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and represents the future of the platform.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the \u003ccode\u003efreelistingprogram.get\u003c/code\u003e method to check the status of your free listings, including approval status and review eligibility.\u003c/p\u003e\n"],["\u003cp\u003eSome issues with free listings may require a review, which can be requested using the \u003ccode\u003efreelistingprogram.requestreview\u003c/code\u003e method after addressing any identified problems.\u003c/p\u003e\n"],["\u003cp\u003eMerchants are responsible for adhering to free listing policies, and Google Shopping reserves the right to enforce these policies.\u003c/p\u003e\n"],["\u003cp\u003eTo view comprehensive account information and issues, including those beyond free listings, refer to the Account Statuses guide.\u003c/p\u003e\n"]]],["The Merchant API's beta version is introduced as the future of the Content API for Shopping. Merchants can check the status of free listings per region using `freelistingprogram.get`, which returns approval status and eligibility. The `freelistingprogram.requestreview` method allows merchants to request a review of their free listings program for a specific region after resolving issues and meeting specific requirements like providing address, phone, website and uploading products. Warnings of various severity may impact product impressions. A general review of account statuses is available.\n"],null,["# Free listings\n\nYou can use [`freelistingprogram.get`](/shopping-content/reference/rest/v2.1/freelistingsprogram/get) to\nget the current status of [free\nlistings](//support.google.com/merchants/answer/9199328) for a specific region.\n\nSee the [Shopping ads guide](/shopping-content/guides/review-shopping-ads) for\nproblems with your [Shopping ads](/google-ads/api/docs/shopping-ads/overview),\nand the [Account Statuses guide](/shopping-content/guides/accountstatuses) for\naccount information and issues.\n\nMerchants are responsible for complying with the [free\nlistings](//support.google.com/merchants/answer/9261529) policies. Google\nShopping reserves the right to enforce these policies and respond appropriately\nif we find content or behavior that violates these policies.\n\nget\n---\n\nYou can use the\n[`freelistingprogram.get`](/shopping-content/reference/rest/v2.1/freelistingsprogram/get) method to get\nthe current status of your free listings. This method requires your `merchantID`\nand returns an instance of\n[`freelistingprogramstatus`](/shopping-content/reference/rest/v2.1/freelistingsprogram) with the current\napproval status and review eligibility. If your free listings are enrolled in\nmultiple regions, `get` returns a `freelistingprogramstatus` resource for each\nregion. \n\n GET https://shoppingcontent.googleapis.com/content/v2.1/\u003cvar translate=\"no\"\u003emerchantId\u003c/var\u003e/freelistingprogram\n\nHere's a sample response: \n\n {\n \"globalState\": \"NOT_ENABLED\",\n \"regionStatuses\": [\n {\n \"regionCodes\": [\n \"US\"\n ],\n \"eligibilityStatus\": \"DISAPPROVED\",\n \"reviewIssues\": [\n \"editorial_and_professional_standards_destination_url_down_policy\"\n ],\n \"onboardingIssues\": [\n \"home_page_issue\"\n ],\n \"disapprovalDate\": \"2013-02-25\",\n \"reviewEligibilityStatus\": \"INELIGIBLE\",\n \"reviewIneligibilityReason\": \"IN_COOLDOWN_PERIOD\",\n \"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\",\n \"reviewIneligibilityReasonDetails\": {\n \"cooldownTime\": \"2013-02-30\"\n }\n }\n ]\n }\n\nThere are three cases where an issue has the severity `WARNING`:\n\n- Warnings that turn into disapprovals if you don't resolve them by the deadline.\n- Warnings that don't have a deadline or turn into disapprovals, but limit the impressions for your products.\n- Warnings that don't have a deadline and don't impact the impressions for your products.\n\nThis method returns errors and warnings if they require action to resolve, will\nbecome disapprovals, or impact impressions. Use [account\nstatuses](/shopping-content/guides/accountstatuses) to view all issues impacting\nan account, regardless of severity.\n\nrequestreview\n-------------\n\n| **Deprecated:** We recommend using the [Merchant Support\n| service](/shopping-content/guides/merchant-support) to view the status and request reviews of your products and account.\n\nSome issues require a review of your free listings. You can use the\n[`freelistingprogram.requestreview`](/shopping-content/reference/rest/v2.1/freelistingsprogram/requestreview)\nmethod to request a review after making changes. This method requires your\n`merchantId` and\n[`regionCode`](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), and returns an\nempty response body if completed successfully.\n\nYou need to do the following before you can request a review:\n\n- Have an [address](/shopping-content/reference/rest/v2.1/accounts#AccountAddress).\n- [Verify a phone number](/shopping-content/guides/phoneverification).\n- [Claim a website](//support.google.com/merchants/answer/176793).\n- [Upload products](/shopping-content/guides/products/overview).\n\n**Note:** The review is of your entire free listings program for a specific region. Fix all issues for that region then raise a single review request. \n\n POST https://shoppingcontent.googleapis.com/content/v2.1/\u003cvar translate=\"no\"\u003emerchantId\u003c/var\u003e/freelistingsprogram/requestreview\n\nAfter a successful request, the `eligibilityStatus`of your account changes to\n`PENDING_REVIEW`."]]