الأسئلة الشائعة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
-
هل يجب استخدام reCAPTCHA Enterprise؟
-
توفّر خدمة reCAPTCHA Enterprise ما يصل إلى 10,000 تقييم في الشهر بدون أي تكلفة.
وتوفّر أيضًا ميزات إضافية
ميزات أخرى
مثل التحليلات في الوقت الفعلي، وهي أفضل مكان للبدء بالنسبة لمعظم المطورين.
يمكنك البدء من هنا.
-
هل يمكنني استخدام reCAPTCHA مع حلول تابعة لجهات خارجية؟
-
نعم، يمكنك استخدام reCAPTCHA (إصدار غير مخصص للمؤسسات) و reCAPTCHA
Enterprise: عادةً ما يطلب الحل التابع للجهة الخارجية مفتاحك العام.
وإما المفتاح السري أو مفتاح واجهة برمجة التطبيقات. تأكد من تقديم
والمفتاح السري ومفتاح واجهة برمجة التطبيقات إلى جهات خارجية موثوق بها.
-
كيف يمكن نقل البيانات من الإصدار 2 أو 3 إلى reCAPTCHA Enterprise؟
-
صفحة
عملية نقل البيانات
يستغرق إكماله من 5 إلى 10 دقائق ولا يتطلّب أي تغيير على الرمز.
-
هل يجب أن أستخدم الإصدار 2 أو 3 من reCAPTCHA؟
-
الإصدار 3 من reCAPTCHA مخصص لمالكي المواقع الإلكترونية الذين يريدون الحصول على مزيد من البيانات حول عدد الزيارات.
لمزيد من المعلومات، يمكنك الاطّلاع على دليل المطوِّر للإصدار 3 من reCAPTCHA.
نوفِّر الأمان وسهولة الاستخدام للإصدار 2.
لمزيد من المعلومات حول الاختلافات في الإصدارَين 2 و3، يمكنك الاطّلاع على مقارنة الإصدارات.
-
هل يستخدم reCAPTCHA ملفات تعريف الارتباط؟
-
تحدّد reCAPTCHA ملف تعريف ارتباط (_GRECAPTCHA) ضروري عند تنفيذه بغرض تقديم تحليل المخاطر.
إذا كنت تفضّل عدم استخدام النطاق www.google.com الذي قد يحتوي على ملفات تعريف ارتباط أخرى تم ضبطها، يمكنك استخدام www.recaptcha.net بدلاً من ذلك.
-
هل هناك أي طلبات في الثانية أو حدود يومية على استخدامي لخدمة reCAPTCHA؟
-
إذا كنت ترغب في إجراء أكثر من 1,000 مكالمة في الثانية أو 100,000 اتصال في الشهر، عليك استخدام
reCAPTCHA Enterprise أو ملء
هذا النموذج وانتظار الموافقة على الاستثناء.
إذا تجاوز مفتاح الموقع الإلكتروني 1, 000 طلب في الثانية، قد لا تتم معالجة بعض الطلبات.
في حال تجاوز مفتاح الموقع الإلكتروني الإصدار 3 من حصته الشهرية، قد يتعذّر فتح site_verify.
عن طريق عرض نتيجة ثابتة 0.9 ورسالة الخطأ "تجاوز الحصة المجانية".
لبقية الشهر. ليست هناك مؤشرات مرئية للمستخدم عند
تجاوزت المواقع الإلكترونية في الإصدار 3 من المساحة المحدّدة.
في حال تجاوز مفتاح الموقع الإلكتروني الإصدار 2 حصته الشهرية، فيما يلي أو مفتاح
للمستخدمين في تطبيق reCAPTCHA المصغّر للباقي
من الشهر: "يتجاوز هذا الموقع الإلكتروني حصة reCAPTCHA."
قبل فرض الحصة، سيتم إشعار مالكي المواقع الإلكترونية عبر البريد الإلكتروني ثلاث مرات
وأن يكون قد تم منحه 90 يومًا على الأقل لنقله إلى reCAPTCHA Enterprise.
يتم اعتبار مفاتيح الموقع الإلكتروني زائدة عن الحدّ الأقصى للحصة المخصّصة لك إذا كان هناك أكثر من 100,000 اتصال في الشهر.
استخدامه لأي نطاق. ويشمل ذلك ما إذا كان هذا المجلد موزَّعًا على منصات متعددة.
على نفس النطاق.
-
أريد إخفاء شارة reCAPTCHA. ما المسموح به؟
-
ويُسمح لك بإخفاء الشارة شرط تضمين علامة reCAPTCHA التجارية بوضوح في مسار المستخدم. يُرجى تضمين النص التالي:
This site is protected by reCAPTCHA and the Google
<a href="https://policies.google.com/privacy">Privacy Policy</a> and
<a href="https://policies.google.com/terms">Terms of Service</a> apply.
على سبيل المثال:
ملاحظة: إذا اخترت إخفاء الشارة، يُرجى استخدام
.grecaptcha-badge { visibility: hidden; }
-
أريد إجراء اختبارات آلية باستخدام reCAPTCHA. ماذا يجب أن أفعل؟
-
بالنسبة إلى الإصدار 3 من reCAPTCHA، يمكنك إنشاء مفتاح منفصل لبيئات الاختبار. قد لا تكون النتائج دقيقة لأنّ الإصدار الثالث من خدمة reCAPTCHA يعتمد على تسجيل زيارات حقيقية.
بالنسبة إلى الإصدار 2 من reCAPTCHA، استخدِم مفاتيح الاختبار التالية. ستحصل دائمًا على اختبار No CAPTCHA، وسيتم اجتياز جميع طلبات إثبات الملكية.
- مفتاح الموقع: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
- المفتاح السري: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe
سيعرض التطبيق المصغّر reCAPTCHA رسالة تحذير لضمان عدم استخدامه كزيارات خاصة بمرحلة الإنتاج.
-
كيف يمكنني تجنُّب استخدام رمز reCAPTCHA عند تصحيح أخطاء موقعي الإلكتروني؟
-
لتجنُّب الدخول إلى رمز reCAPTCHA أثناء تصحيح أخطاء JavaScript أخرى على موقعك الإلكتروني، أضِف نص reCAPTCHA /recaptcha__.+\.js$ البرمجي إلى قائمة التجاهل في المتصفّح. للحصول على تعليمات حول Chrome، راجِع مقالة تجاهل قائمة مخصَّصة من النصوص البرمجية. تتوفّر ميزات مشابهة في المتصفّحات الأخرى.
-
كيف يمكنني معرفة المزيد عن عدد زيارات موقعي الإلكتروني؟
-
يعرض reCAPTCHA الإحصاءات اليومية في وحدة تحكّم المشرف.
-
هل يمكنني استخدام reCAPTCHA على مستوى العالم؟
-
نعم، يُرجى استخدام "www.recaptcha.net" في التعليمات البرمجية في الحالات التي يتم فيها "www.google.com" لا يمكن الوصول إليه.
- أولاً، استبدِل <script src="https://www.google.com/recaptcha/api.js"></script>. باستخدام <script src="https://www.recaptcha.net/recaptcha/api.js"></script>
- بعد ذلك، طبِّق الإجراء نفسه على أي منتج آخر يستخدم "www.google.com/recaptcha/". على موقعك الإلكتروني
-
-
نعم. تقدّم reCAPTCHA موضوعَين، فاتح وداكن، كما هو موضّح أدناه. لاختيار مظهر، ما عليك سوى
ضبط سمة مظهر البيانات في grecaptcha.render
.
المظهر الفاتح:
المظهر الداكن:
-
كيف يمكنني تخصيص الإصدار 3 من reCAPTCHA؟
-
إنّ واجهة برمجة تطبيقات JavaScript المتاحة لاختبار reCAPTCHA غير المرئي تعمل أيضًا مع الإصدار الثالث. ما عليك سوى استخدام JavaScript API لعرض reCAPTCHA بشكل صريح باستخدام مفتاح الإصدار 3 من الموقع الإلكتروني للوصول إلى خيارات مثل تغيير موضع الشارة أو تغيير مظهرها.
عند عرض الإصدار 3 من reCAPTCHA باستخدام هذه الطريقة، لا تنسَ ضبط المَعلمة size على 'invisible' واستخدام معرّف العميل الذي يعرضه grecaptcha.render عند طلب grecaptcha.execute بدلاً من مفتاح الموقع الإلكتروني.
-
-
إذا ظهر لك هذا الخطأ، يعني هذا أنّ مفتاح موقع reCAPTCHA لم يعُد صالحًا. للتفعيل، يُرجى
سجِّل مفتاحًا جديدًا واتّبِع التعليمات الواردة في تلك الصفحة.
-
تظهر لي رسالة SecurityError غير مرتبطة: تم حظر إطار من المصدر "https://www.google.com". من الوصول إلى إطار يتضمن المصدر "<your domain>". ماذا يجب أن أفعل؟
-
ويحدث ذلك عادةً إذا تمت إزالة عنصر HTML المصغّر لأداة reCAPTCHA بشكل آلي بعد أن ينقر المستخدم على مربّع الاختيار. ننصحك باستخدام دالة JavaScript grecaptcha.reset() لإعادة ضبط تطبيق reCAPTCHA المصغّر.
-
أستخدم سياسة أمان المحتوى (CSP) على موقعي الإلكتروني. كيف يمكنني ضبطه بحيث يعمل مع reCAPTCHA؟
-
ننصح باستخدام النهج غير المستند إلى النهج والموثَّق في CSP3.
احرص على تضمين nonce في علامة النص البرمجي api.js الخاصة بخدمة reCAPTCHA، وسنتولى باقي الأمر.
ملاحظة: تعمل خدمة reCAPTCHA أيضًا مع دالة 'strict-dynamic' في المتصفّحات المتوافقة.
وكإجراء بديل، يُرجى إضافة القيم التالية إلى الأوامر:
- script-src https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/
- frame-src https://www.google.com/recaptcha/ وhttps://recaptcha.google.com/recaptcha/
-
تظهر لي رسالة الخطأ "المضيف المحلي غير مُدرَج في قائمة النطاقات المتوافقة". ماذا يجب أن أفعل؟
-
لا تكون نطاقات المضيف المحلي متوافقة بشكلٍ تلقائي. إذا أردت مواصلة دعمه
التطوير، يمكنك إضافتها إلى قائمة النطاقات المدعومة لمفتاح موقعك. الانتقال إلى قسم
وحدة تحكُّم ReCAPTCHA Enterprise
أو إلى وحدة تحكم reCAPTCHA، حسب الحاجة،
لتعديل قائمة النطاقات المتوافقة. ننصحك باستخدام مفاتيح منفصلة للتطوير
والسماح بالمضيف المحلي فقط على مفتاح موقع التطوير.
-
في نظام التشغيل iOS 10 فقط، يتم تمرير الصفحة إلى الأسفل عندما يكمل المستخدم التحدي؟
-
هذا خطأ يركّز على جانب شركة Apple وقد أبلغناهم به. ويؤثر في المستخدمين على نظام التشغيل iOS 10 وعلى بعض المواقع فقط. وفي حال تأثّرت بالمشكلة، يمكنك نقل أداة reCAPTCHA إلى أعلى أو أسفل في الصفحة أو استخدام الإصدار 3 من reCAPTCHA.
-
هل من الممكن أن يكون جهاز الكمبيوتر أو الشبكة التي أستخدمها ترسل طلبات بحث مبرمَجة؟
-
إذا تم توجيهك إلى هذه الصفحة من تطبيق reCAPTCHA المصغّر، ستظهر لك الرسالة "عذرًا، ولكن يُحتمَل أنّ الكمبيوتر أو الشبكة التي تستخدمها ترسل طلبات بحث مبرمَجة. ولحماية المستخدمين، لا يمكننا معالجة طلبك الآن.
يمكن أن يحدث هذا للأسف للمستخدمين الجيدين لعدة أسباب:
- قد تكون متصلاً بشبكة مشتركة يتم استخدامها بشكل مسيء.
- من المحتمل أنّ مزوّد خدمة الإنترنت قد حدّد لك مؤخرًا عنوان IP مريبًا.
- قد يتعرّض الموقع الإلكتروني الذي تحاول الوصول إليه حاليًا لهجوم شديدة.
لتحديد هذه المشاكل وحلّها، يُرجى الاطّلاع على صفحة المساعدة بشأن الزيارات غير المعتادة أو إعادة المحاولة لاحقًا.
-
ما أسماء الإجراءات الصالحة؟
-
يمكن أن تحتوي الإجراءات فقط على أحرف أبجدية رقمية وشرطات مائلة وشرطات سفلية.
يجب ألا تكون الإجراءات خاصة بالمستخدم.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003ereCAPTCHA Enterprise offers a free tier with 10,000 assessments per month and advanced features like real-time analytics.\u003c/p\u003e\n"],["\u003cp\u003eYou can migrate to reCAPTCHA Enterprise from v2 or v3 in 5-10 minutes without code changes.\u003c/p\u003e\n"],["\u003cp\u003ereCAPTCHA v3 provides website traffic insights while v2 focuses on security and usability.\u003c/p\u003e\n"],["\u003cp\u003ereCAPTCHA sets a necessary cookie but you can use www.recaptcha.net instead of www.google.com to avoid other potential Google cookies.\u003c/p\u003e\n"],["\u003cp\u003eTo hide the reCAPTCHA badge, ensure the reCAPTCHA branding is visible in the user flow with the provided text snippet.\u003c/p\u003e\n"]]],["reCAPTCHA offers Enterprise and non-Enterprise versions, with the former providing 10,000 free assessments monthly and features like real-time analytics. Migration to Enterprise is quick and doesn't require code changes. reCAPTCHA v3 provides more traffic data than v2. Both versions are compatible with third-party solutions, using public and secret/API keys. reCAPTCHA sets a necessary cookie, but an alternative domain is available. There are rate and volume limits; exceeding them may cause errors. You can hide the badge with specific text included, set testing keys, and use multiple ways to customize its behaviour.\n"],null,["# Frequently Asked Questions\n\n### Should I use reCAPTCHA Enterprise?\n\n\n:\n reCAPTCHA Enterprise offers up to 10,000 assessments per month at no cost\n and also provides additional features.\n [Other features](https://cloud.google.com/recaptcha-enterprise/docs/compare-versions)\n such as real time analytics provide the best place to start for most developers.\n [Get started here.](https://www.google.com/recaptcha/admin/enterprise)\n\n\n### Can I use reCAPTCHA with third party solutions?\n\n\n:\n Yes, you can use both reCAPTCHA (non-Enterprise version) and reCAPTCHA\n Enterprise. Typically the third party solution asks for your public key\n and either your secret key or your API key. Make sure to only provide your\n secret key and API key to trusted third parties.\n\n\n### How to migrate to reCAPTCHA Enterprise from v2 or v3?\n\n\n:\n The [migration process](http://cloud.google.com/recaptcha-enterprise/docs/migrate-recaptcha)\n takes 5-10 minutes to complete and requires no code changes.\n\n\n### Should I use reCAPTCHA v2 or v3?\n\n\n:\n reCAPTCHA v3 is for site owners who want more data about their traffic.\n For more information, see the [reCAPTCHA v3 developer guide](/recaptcha/docs/v3).\n\n We support security and usability for v2.\n\n\n For more information about reCAPTCHA v2 and v3 differences, see [versions comparison](/recaptcha/docs/versions).\n\n\n### Does reCAPTCHA use cookies?\n\n\n:\n reCAPTCHA sets a necessary cookie (_GRECAPTCHA) when executed for the purpose of providing its risk analysis.\n If you prefer to not use the www.google.com domain which may have other cookies set, you can use www.recaptcha.net instead.\n\n\n### Are there any QPS or daily limits on my use of reCAPTCHA?\n\n\n:\n If you wish to make more than 1000 calls per second or 1000000 calls per month, you must use\n [reCAPTCHA Enterprise](https://cloud.google.com/recaptcha-enterprise) or fill out\n [this form](https://forms.gle/caCX5Sgkz2N1maGa9) and wait for an exception approval.\n If a site key exceeds 1000 QPS, then some requests may not be processed.\n If a v3 site key exceeds its monthly quota, then site_verify may fail open\n by returning a static score 0.9 and an error message \\`\"Over free quota.\"\\`\n for the remainder of the month. There are no user-visible indications when\n v3 sites are over quota.\n If a v2 site key exceeds its monthly quota, then the following or a similar\n message may be displayed to users in the reCAPTCHA widget for the remainder\n of the month: \\`This site is exceeding reCAPTCHA quota.\\`\n Before quota is enforced, site owners will be notified by email three times\n and given at least 90 days to migrate to reCAPTCHA Enterprise.\n Site keys are considered over quota if more than 1000000 calls per month are\n used for any domain. This includes if this volume is spread across multiple\n keys on the same domain.\n\n\n### I'd like to hide the reCAPTCHA badge. What is allowed?\n\n\n: You are allowed to hide the badge as long as you include the reCAPTCHA branding visibly in the user flow. Please include the following text:\n\n ```html\n This site is protected by reCAPTCHA and the Google\n \u003ca href=\"https://policies.google.com/privacy\"\u003ePrivacy Policy\u003c/a\u003e and\n \u003ca href=\"https://policies.google.com/terms\"\u003eTerms of Service\u003c/a\u003e apply.\n ```\n\n For example:\n\n **Note:** if you choose to hide the badge, please use \n\n ```css\n .grecaptcha-badge { visibility: hidden; }\n ```\n\n \u003cbr /\u003e\n\n\n### I'd like to run automated tests with reCAPTCHA. What should I do?\n\n\n: For reCAPTCHA v3, create a separate key for testing environments. Scores may not be accurate as reCAPTCHA v3 relies on seeing real traffic.\n\n For reCAPTCHA v2, use the following test keys. You will always get No CAPTCHA and all verification requests will pass.\n\n - Site key: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI\n - Secret key: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe\n\n The reCAPTCHA widget will show a warning message to ensure it's not used for production traffic.\n\n\n### How can I avoid stepping into reCAPTCHA code when debugging my site?\n\n\n: To avoid stepping into the reCAPTCHA code while debugging other JavaScript on your site, add the reCAPTCHA script `/recaptcha__.+\\.js$` to your browser's ignore list. For instructions for Chrome, refer to [Ignore a custom list of scripts](https://developer.chrome.com/docs/devtools/settings/ignore-list). Similar features are available in other browsers.\n\n\n### How can I see more about my website's traffic?\n\n\n: reCAPTCHA reports daily stats in the [admin console](https://www.google.com/recaptcha/admin).\n\n\n### Can I use reCAPTCHA globally?\n\n\n: Yes, please use \"www.recaptcha.net\" in your code in circumstances when \"www.google.com\" is not accessible.\n\n - First, replace \\\u003cscript src=\"https://**www.google.com** /recaptcha/api.js\"\\\u003e\\\u003c/script\\\u003e with \\\u003cscript src=\"https://**www.recaptcha.net**/recaptcha/api.js\"\\\u003e\\\u003c/script\\\u003e\n - After that, apply the same to everywhere else that uses \"www.google.com/recaptcha/\" on your site.\n\n\n### Can I customize the reCAPTCHA widget or badge?\n\n\n: Yes. reCAPTCHA offers two themes, light and dark, as shown below. To choose a theme, simply\n set the data-theme attribute in the [grecaptcha.render\n parameter](/recaptcha/docs/display#render_param).\n\n Light theme:\n\n Dark theme:\n\n\n### How can I customize reCAPTCHA v3?\n\n\n: The [JavaScript API](/recaptcha/docs/invisible#js_api) available for Invisible reCAPTCHA also works for v3. Simply use the JavaScript API to explicitly render reCAPTCHA with a v3 site key to access options such as repositioning the badge or changing the theme.\n\n When rendering reCAPTCHA v3 with this method, remember to set the `size` parameter to `'invisible'` and use the client ID returned by `grecaptcha.render` when calling `grecaptcha.execute` instead of the site key.\n\n\n### Recently my reCAPTCHA widget started displaying \"Invalid site key\". What's happening?\n\n\n:\n\n If you are seeing this error, your reCAPTCHA site key is no longer valid. To activate, please\n [register a new key](https://www.google.com/recaptcha/admin) and follow the [instructions](/recaptcha/intro) on that page.\n\n\n### I'm getting an uncaught SecurityError: blocked a frame with origin \"https://www.google.com\" from accessing a frame with origin \"\\<your domain\\>\". What should I do?\n\n\n: This typically occurs if the reCAPTCHA widget HTML element is programmatically removed sometime after the end user clicks on the checkbox. We recommend using the [grecaptcha.reset()](/recaptcha/docs/display#js_api) javascript function to reset the reCAPTCHA widget.\n\n\n### I'm using Content-Security-Policy (CSP) on my website. How can I configure it to work with reCAPTCHA?\n\n\n: We recommend using the nonce-based approach documented with [CSP3](https://w3c.github.io/webappsec-csp/#framework-directive-source-list).\n Make sure to include your nonce in the reCAPTCHA [api.js](/recaptcha/docs/display#auto_render) script tag, and we'll handle the rest.\n\n Note: reCAPTCHA also works with ['strict-dynamic'](https://w3c.github.io/webappsec-csp/#strict-dynamic-usage) on browsers that support it.\n\n Alternatively, please add the following values to the directives:\n\n - **script-src** https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/\n - **frame-src** https://www.google.com/recaptcha/, https://recaptcha.google.com/recaptcha/\n\n\n### I'm getting an error \"Localhost is not in the list of supported domains\". What should I do?\n\n\n: localhost domains are not supported by default. If you wish to continue supporting them for\n development you can add them to the list of supported domains for your site key. Go to the\n [reCAPTCHA Enterprise console](https://console.cloud.google.com/security/recaptcha)\n or to the [reCAPTCHA console](https://www.google.com/recaptcha/admin), as appropriate,\n to update your list of supported domains. We advise to use separate keys for development and\n production, and to only allow localhost on your development site key.\n\n\n### Only on iOS 10, the page scrolls to the bottom when the user completes the challenge?\n\n\n: This is a focusing bug on Apple's side that we've reported to them. It affects users only on iOS 10 and only on some sites. If you are affected, a workaround is to move the reCAPTCHA widget higher or lower on the page, or use [reCAPTCHA v3](/recaptcha/docs/v3).\n\n\n### My computer or network may be sending automated queries?\n\n\n: If you were directed to this page from the reCAPTCHA widget, you would have seen a message that said \"We're sorry, but your computer or network may be sending automated queries. To protect our users, we can't process your request right now.\"\n\n This can unfortunately happen to good users for a few reasons:\n\n - You may be on a shared network that is being used abusively\n - Your internet service provider may have recently assigned you a suspicious IP address\n - The site you are trying to access may be currently under heavy attack\n\n To troubleshoot these issues, please look at the [unusual traffic help page](https://support.google.com/websearch/answer/86640), or try again later.\n\n\n### What action names are valid?\n\n\n: Actions might contain only alphanumeric characters, slashes, and underscores.\n Actions must not be user-specific."]]
