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

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

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

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

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

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

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

هل يجب استخدام الإصدار الثاني أو الثالث من خدمة reCAPTCHA؟

الإصدار الثالث من خدمة reCAPTCHA مخصّص لمالكي المواقع الإلكترونية الذين يريدون الحصول على مزيد من البيانات حول عدد الزيارات. لمزيد من المعلومات، اطّلِع على دليل المطوِّرين الإصدار 3 من ReCAPTCHA.

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

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

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

لإجراء ذلك، يجب تحميل مفتاح الموقع الإلكتروني v3 على أنّه موثَّق، ثم عرض الإصدار الثاني بشكل صريح باستخدام 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؟

إذا أردت إجراء أكثر من 1,000 مكالمة في الثانية أو 1000,000 مكالمة في الشهر، عليك استخدام reCAPTCHA Enterprise أو ملء هذا النموذج وانتظار الموافقة على الاستثناء. إذا تجاوز مفتاح الموقع الإلكتروني 1000 طلب في الثانية، قد لا تتم معالجة بعض الطلبات. إذا تجاوز مفتاح الموقع الإلكتروني v3 الحصة الشهرية المحدّدة، قد يتعذّر فتح site_verify من خلال عرض نتيجة ثابتة 0.9 ورسالة الخطأ ""تم تجاوز الحصة المجانية" خلال الفترة المتبقية من الشهر. ما مِن مؤشرات مرئية للمستخدم عندما تتجاوز المواقع الإلكترونية ذات الإصدار 3 مساحة التخزين المتوفّرة. في حال تجاوز مفتاح الموقع الإلكتروني v2 حصته الشهرية، قد يتم عرض الرسالة التالية أو رسالة مشابهة للمستخدمين في أداة reCAPTCHA خلال الوقت المتبقي من الشهر: "يتجاوز هذا الموقع الإلكتروني حصة reCAPTCHA." قبل فرض الحصة، سيتم إشعار مالكي المواقع الإلكترونية عبر البريد الإلكتروني ثلاث مرات ومنحهم 90 يومًا على الأقل لنقل بياناتهم إلى reCAPTCHA Enterprise. تُعتبر مفاتيح الموقع الإلكتروني زائدة عن مساحة التخزين المتوفّرة في حال استخدام أكثر من 1000,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. ماذا يجب أن أفعل؟

بالنسبة إلى الإصدار الثالث من خدمة reCAPTCHA، يمكنك إنشاء مفتاح منفصل لبيئات الاختبار. قد لا تكون النتائج دقيقة لأنّ الإصدار الثالث من خدمة reCAPTCHA يعتمد على رؤية زيارات حقيقية.

في الإصدار الثاني من خدمة 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"></script> بـ <script src="https://www.recaptcha.net/recaptcha/api.js"></script>
  • بعد ذلك، طبِّق الأمر نفسه على جميع الأماكن الأخرى التي تستخدم "www.google.com/recaptcha/" على موقعك.

هل يمكنني تخصيص تطبيق reCAPTCHA المصغّر أو شارةه؟

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

المظهر الفاتح:

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

كيف يمكنني تخصيص الإصدار الثالث من خدمة reCAPTCHA؟

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

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

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

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

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

ويحدث ذلك عادةً إذا تمت إزالة عنصر HTML لأداة reCAPTCHA آليًا بعد أن ينقر المستخدم النهائي على مربّع الاختيار. ننصحك باستخدام دالة JavaScript 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 إلى أعلى الصفحة أو خفضها أو استخدام الإصدار 3 من reCAPTCHA.

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

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

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

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

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

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

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