الأسئلة الشائعة

هل يجب استخدام reCAPTCHA Enterprise؟

تقدّم خدمة reCAPTCHA Enterprise مليون تقييم شهريًا للميزات الإضافية والمجانية. توفّر الميزات الأخرى مثل التحليلات في الوقت الفعلي أفضل نقطة بداية لمعظم مطوّري البرامج. يمكنك البدء من هنا مجانًا.

هل يمكنني استخدام خدمة reCAPTCHA مع حلول الجهات الخارجية؟

نعم، يمكنك استخدام reCAPTCHA (إصدار غير Enterprise) و reCAPTCHA Enterprise. يطلب عادةً حل الجهة الخارجية مفتاحك العام والمفتاح السري أو مفتاح واجهة برمجة التطبيقات. يُرجى الحرص على تقديم المفتاح السري ومفتاح واجهة برمجة التطبيقات فقط لجهات خارجية موثوق بها.

كيف يمكن نقل البيانات إلى الإصدار 2 أو v3 من reCAPTCHA Enterprise؟

تستغرق عملية الترحيل من 5 إلى 10 دقائق للاستكمال ولا تتطلب إجراء أية تغييرات على الشفرة.

هل يجب استخدام reCAPTCHA v2 أو v3؟

الإصدار 3 من reCAPTCHA مخصص لمالكي المواقع الذين يريدون مزيدًا من البيانات عن زياراتهم. لمزيد من المعلومات، اطلع على دليل مطوري الإصدار 3 من reCAPTCHA.

ندعم الأمان وسهولة الاستخدام للإصدار 2.

لمزيد من المعلومات عن الاختلافات بين الإصدارين 2 و3 من reCAPTCHA، اطّلع على مقارنة الإصدارات.

هل يمكنني تشغيل الإصدارين 2 و3 من reCAPTCHA على نفس الصفحة؟

ولإجراء ذلك، حمِّل مفتاح الموقع الإلكتروني v3 على أنه موثَّق، ثم اعرض الإصدار 2 بشكل صريح باستخدام grecaptcha.render.

<html>
  <head>
    <title>reCAPTCHA demo: Running both v2 and v3</title>
    <script src="https://www.google.com/recaptcha/api.js?render=v3_site_key"></script>
    <script>
      grecaptcha.ready(() => {
        grecaptcha.render('html_element', {
           'sitekey' : 'v2_site_key'
        });
      });
    </script>
    <script>
      function onSubmit() {
        grecaptcha.ready(() => {
            grecaptcha.execute('v3_site_key', {action: 'homepage'}).then((token) => {
               ...
            });
        });
      }
    </script>
  </head>
</html>

هل يستخدم reCAPTCHA ملفات تعريف الارتباط؟

تُحدِّد خدمة reCAPTCHA ملف تعريف ارتباط ضروريًا (_GRECAPTCHA) عند تنفيذه بغرض تقديم تحليل للمخاطر. إذا كنت تفضل عدم استخدام نطاق www.google.com الذي قد يحتوي على ملفات تعريف ارتباط أخرى تم تعيينها، فيمكنك استخدام www.recaptcha.net بدلاً من ذلك.

هل هناك أي قيود على الاستخدام عبر QPS أو قيود يومية على استخدام reCAPTCHA؟

إذا كنت ترغب في إجراء أكثر من 1000 مكالمة في الثانية أو 1000000 مكالمة في الشهر، عليك استخدام reCAPTCHA Enterprise أو ملء هذا النموذج والانتظار حتى توافق على الاستثناء. وإذا تجاوز مفتاح الموقع 1000 QPS، فقد لا تتم معالجة بعض الطلبات. إذا تجاوز مفتاح الموقع الإلكتروني الإصدار v3 الحصة الشهرية، قد يتعذّر على site_verify فتح الموقع الإلكتروني عن طريق عرض نتيجة ثابتة 0.9 ورسالة خطأ `"تجاوز الحصة المجانية."` لبقية الشهر. لا تظهر مؤشرات مرئية للمستخدم عندما تتجاوز المواقع الإلكترونية الإصدار 3 الحصة. إذا تجاوز مفتاح الموقع الإلكتروني الإصدار 2 الحصة الشهرية، قد يتم عرض الرسالة التالية أو رسالة مشابهة للمستخدمين في أداة reCAPTCHA لبقية الشهر: "يتجاوز هذا الموقع الإلكتروني حصة reCAPTCHA".` وقبل فرض الحصة، سيتم إشعار مالكي الموقع الإلكتروني بالبريد الإلكتروني ثلاث مرات وسيتم منحه 90 يومًا على الأقل لنقل البيانات إلى reCAPTCHA Enterprise. يتم أخذ مفاتيح الموقع الإلكتروني في الاعتبار عند تجاوز أكثر من 1000000 مكالمة في الشهر لأي نطاق. ويشمل ذلك ما إذا كان هذا الحجم موزعًا على عدة مفاتيح في النطاق نفسه.

أريد إخفاء شارة 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 على مستوى العالم؟

نعم، الرجاء استخدام "www.recaptcha.net" في الشفرة في الحالات التي يتعذر فيها الوصول إلى "www.google.com".

  • أولاً، استبدل <script src="https://www.google.com/recaptcha/api.js" async defer></script> بـ <script src="https://www.recaptcha.net/recaptcha/api.js" غير مؤجل ></script>
  • وبعد ذلك، طبّق نفس الشيء على كل مكان آخر يستخدم فيه "www.google.com/recaptcha/" على موقعك.

هل يمكنني تخصيص أداة أو شارة reCAPTCHA؟

نعم. تقدم reCAPTCHA مظهرين، فاتحين وغامق، كما هو موضح أدناه. لاختيار تصميم، ما عليك سوى تعيين سمة data-theme في المعلمة grecaptcha.render.

مظهر فاتح:

المظهر الداكن:

كيف يمكنني تخصيص reCAPTCHA v3؟

تعمل واجهة برمجة تطبيقات جافا سكريبت المتاحة لـ reCAPTCHA غير المرئي أيضًا مع الإصدار 3. ما عليك سوى استخدام واجهة برمجة تطبيقات JavaScript لعرض reCAPTCHA بشكل واضح باستخدام مفتاح الموقع الإلكتروني الإصدار 3، وذلك للوصول إلى خيارات مثل تغيير موضع الشارة أو تغيير التصميم.

عند عرض الإصدار 3 من reCAPTCHA باستخدام هذه الطريقة، تذكّر ضبط المَعلمة size على 'invisible' واستخدام معرِّف العميل الذي يعرضه grecaptcha.render عند طلب grecaptcha.execute بدلاً من مفتاح الموقع الإلكتروني.

بدأت مؤخرًا أداة reCAPTCHA في عرض "مفتاح موقع غير صالح". ماذا يحدث؟

إذا كنت ترى هذا الخطأ، فإن مفتاح موقع reCAPTCHA لم يعد صالحًا. للتفعيل، يُرجى تسجيل مفتاح جديد واتّباع التعليمات في تلك الصفحة.

تظهر رسالة خطأ خطأ غير معروفة: تم حظر إطار له الأصل "https://www.google.com" من الوصول إلى إطار له الأصل "&ltyour&gt". ماذا يجب أن أفعل؟

ويحدث هذا عادةً إذا تمت إزالة عنصر HTML لأداة اختبار reCAPTCHA آليًا في وقت ما بعد نقر المستخدم على مربّع الاختيار. نوصي باستخدام وظيفة جافا سكريبت grecaptcha.reset() لإعادة تعيين أداة reCAPTCHA.

أستخدم سياسة أمان المحتوى (CSP) على موقعي الإلكتروني. كيف يمكنني تهيئته للعمل مع reCAPTCHA؟

نقترح عليك استخدام المنهج غير المستند إلى بيانات غير موثقة باستخدام CSP3. تأكد من تضمين الملف الشخصي في علامة النص البرمجي 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 إلى أعلى أو أقل على الصفحة، أو استخدام reCAPTCHA v3.

ربما يرسل جهاز الكمبيوتر أو الشبكة طلبات بحث تلقائية؟

إذا تم توجيهك إلى هذه الصفحة من أداة reCAPTCHA، فمن المفترض أن تظهر لك رسالة مفادها "عذرًا، ولكن جهاز الكمبيوتر أو الشبكة ربما يرسلان طلبات بحث تلقائية. ولحماية مستخدمينا، لا يمكننا معالجة طلبك الآن."

يمكن أن يحدث هذا - للأسف - للمستخدمين الجيدين لعدة أسباب:

  • قد تكون متصلاً بشبكة مشتركة يتم استخدامها بشكل مسيء.
  • ربما يكون مزوّد خدمة الإنترنت قد عيّن لك مؤخرًا عنوان IP مريبًا.
  • الموقع الذي تحاول الوصول إليه ربما يكون مهددًا حاليًا

لتحري هذه المشكلات وإصلاحها، يُرجى الاطلاع على صفحة المساعدة بشأن عدد الزيارات غير المعتاد أو إعادة المحاولة لاحقًا.

ما هي أسماء الإجراءات الصالحة؟

يمكن أن تحتوي الإجراءات على أحرف أبجدية رقمية وشرطات وشرطات سفلية فقط. يجب ألا تكون الإجراءات خاصة بالمستخدم.