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

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

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

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

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

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

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

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

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

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

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

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

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

هل هناك أي حدود قصوى لعدد الطلبات في الثانية أو حدود يومية لاستخدامي reCAPTCHA؟

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

أريد إخفاء شارة reCAPTCHA. ما هو المحتوى المسموح به؟

يُسمح لك بإخفاء الشارة طالما أنّك تُضمِّن العلامة التجارية لخدمة reCAPTCHA بشكل مرئي في مسار المستخدم. يُرجى تضمين النص التالي:

This site is protected by reCAPTCHA.

على سبيل المثال:

ملاحظة: إذا اخترت إخفاء الشارة، يُرجى استخدام

.grecaptcha-badge { visibility: hidden; }

أريد إجراء اختبارات مبرمَجة باستخدام reCAPTCHA. ماذا يجب أن أفعل؟

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

بالنسبة إلى الإصدار الثاني من خدمة 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 المصغّر أو شارته؟

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

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

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

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

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

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

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

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

تظهر لي رسالة الخطأ SecurityError: blocked a frame with origin "https://www.google.com" from accessing a frame with origin "<your domain>". ماذا أفعل؟

يحدث هذا عادةً إذا تمت إزالة عنصر 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/
• connect-src https://www.google.com/recaptcha/

تظهر لي رسالة الخطأ "Localhost is not in the list of supported domains" (لا يتوفّر Localhost في قائمة النطاقات المتوافقة). ماذا يجب أن أفعل؟

لا تتوافق نطاقات localhost تلقائيًا. إذا أردت مواصلة استخدامها لأغراض التطوير، يمكنك إضافتها إلى قائمة النطاقات المسموح بها لمفتاح الموقع الإلكتروني. انتقِل إلى وحدة تحكّم reCAPTCHA Enterprise أو إلى وحدة تحكّم reCAPTCHA، حسب الاقتضاء، لتعديل قائمة النطاقات المتوافقة. ننصحك باستخدام مفاتيح منفصلة للتطوير والإنتاج، والسماح فقط بالمضيف المحلي على مفتاح موقع التطوير.

هل يتم الانتقال إلى أسفل الصفحة فقط على نظام التشغيل iOS 10 عندما يكمل المستخدم التحدي؟

هذا خطأ في التركيز من جانب Apple وقد أبلغناهم به. ويؤثر ذلك في المستخدمين على نظام التشغيل iOS 10 فقط وعلى بعض المواقع الإلكترونية فقط. إذا تأثرت بهذه المشكلة، يمكنك حلّها من خلال نقل تطبيق reCAPTCHA المصغّر إلى أعلى الصفحة أو أسفلها، أو استخدام الإصدار الثالث من خدمة reCAPTCHA.

هل من المحتمل أن يكون جهاز الكمبيوتر أو الشبكة لديّ يرسلان طلبات بحث مبرمَجة؟

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

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

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

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

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

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