يتحمّل التجّار مسؤولية الالتزام بسياسات البيانات المجانية. يحتفظ محرّك بحث Google Shopping بالحق في فرض هذه السياسات واتّخاذ الإجراءات اللازمة إذا عثرنا على محتوى أو سلوك يخالف هذه السياسات.
الحصول على
يمكنك استخدام طريقة
freelistingprogram.get للحصول على
الحالة الحالية لبياناتك المجانية. تتطلّب هذه الطريقة توفير merchantID وتعرض مثيلاً من freelistingprogramstatus يتضمّن حالة الموافقة الحالية والأهلية للمراجعة. إذا كانت بياناتك المجانية مسجّلة في مناطق متعدّدة، تعرض طريقة get المورد freelistingprogramstatus لكل منطقة.
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"}}]}
هناك ثلاث حالات تكون فيها خطورة المشكلة WARNING:
التحذيرات التي تتحوّل إلى حالات رفض إذا لم تتم معالجتها قبل الموعد النهائي
تحذيرات ليس لها موعد نهائي أو لا تتحوّل إلى حالات رفض، ولكنّها تحدّ من عدد مرّات الظهور لمنتجاتك.
التحذيرات التي ليس لها موعد نهائي ولا تؤثر في مرّات ظهور منتجاتك
تعرض هذه الطريقة الأخطاء والتحذيرات إذا كانت تتطلّب اتّخاذ إجراء لحلّها، أو إذا كانت ستؤدي إلى عدم الموافقة على الإعلانات، أو إذا كانت ستؤثّر في مرّات الظهور. استخدِم حالات الحساب للاطّلاع على جميع المشاكل التي تؤثّر في حساب معيّن، بغض النظر عن درجة خطورتها.
requestreview
تتطلّب بعض المشاكل مراجعة بياناتك المجانية. يمكنك استخدام طريقة
freelistingprogram.requestreview
لطلب إجراء مراجعة بعد إجراء التغييرات. تتطلّب هذه الطريقة توفير
merchantId و
regionCode، وتعرض نص استجابة فارغًا في حال إكمالها بنجاح.
يجب اتّخاذ الإجراءات التالية قبل طلب إجراء مراجعة:
تاريخ التعديل الأخير: 2025-08-13 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 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`."]]
