دليل مطوّري البرامج
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تقدم Google reCAPTCHA (الإصداران 3 و2) و reCAPTCHA Enterprise لمساعدتك في حمايتك.
مواقعك الإلكترونية من الأنشطة الاحتيالية والرسائل غير المرغوب فيها وإساءة الاستخدام. لمعرفة المزيد عن
في إصدارَي reCAPTCHA Enterprise وreCAPTCHA، يُرجى الاطّلاع على مقارنة الميزات بين إصدارات reCAPTCHA.
يقدم هذا المستند نظرة عامة على الإصدارين 3 و2 من خدمة reCAPTCHA من Google. بالنسبة
حول reCAPTCHA Enterprise، راجِع
مستندات reCAPTCHA Enterprise
لبدء استخدام reCAPTCHA Enterprise، يمكنك استخدام
أداة تسجيل الموقع الإلكتروني. هذا النمط
في إنشاء مفتاح موقع جديد على reCAPTCHA، وإذا لزم الأمر، يمكنك أيضًا إنشاء
حساب جديد على Google Cloud.
البدء
الجمهور
تم تصميم هذا الوثائق للأشخاص الذين لديهم دراية بنماذج HTML أو المعالجة من جهة الخادم أو الجوّال
وتطوير التطبيقات. لتثبيت reCAPTCHA، قد تحتاج إلى تعديل بعض الرموز البرمجية.
نأمل أن يكون من السهل تتبُّع هذه المستندات. يمكنك طرح سؤال حول reCAPTCHA على
Stack Overflow، باستخدام العلامة recaptcha
.
نظرة عامة
لبدء استخدام reCAPTCHA، يجب الاشتراك للحصول على مفتاح واجهة برمجة التطبيقات.
إقران بموقعك الإلكتروني. يتكون زوج المفتاح من مفتاح موقع
المفتاح السري. يُستخدَم مفتاح الموقع الإلكتروني لاستدعاء خدمة reCAPTCHA على موقعك الإلكتروني أو تطبيقك للأجهزة الجوّالة. يمنح
المفتاح السري الإذن بالتواصل بين الخلفية في تطبيقك وخادم reCAPTCHA من أجل
التحقّق من استجابة المستخدم. يجب الحفاظ على أمان المفتاح السري لأغراض تتعلّق
بالأمان.
أولاً، اختَر نوع reCAPTCHA، ثم املأ النطاقات المسموح بها.
أو حزمة
الأسماء. بعد
الموافقة على بنود الخدمة، انقر على تسجيل للحصول على مفتاحَي واجهة برمجة التطبيقات الجديدَين.
يمكنك الآن اتّباع الخطوات التالية لإضافة reCAPTCHA إلى موقعك الإلكتروني أو تطبيقك للأجهزة الجوّالة:
- اختَر الدمج من جهة العميل:
- تحقّق من رد المستخدم.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-09-18 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-09-18 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGoogle reCAPTCHA helps protect your website from spam, abuse, and fraudulent activities with v3, v2, and Enterprise options.\u003c/p\u003e\n"],["\u003cp\u003eTo use reCAPTCHA, you'll need to sign up for an API key pair (site key and secret key) and integrate it into your website or mobile application.\u003c/p\u003e\n"],["\u003cp\u003ereCAPTCHA offers different integration options including v3, v2 (checkbox, invisible), and Android, allowing you to choose the best fit for your needs.\u003c/p\u003e\n"],["\u003cp\u003eThis documentation is intended for developers familiar with HTML, server-side processing, or mobile application development and requires code edits for installation.\u003c/p\u003e\n"]]],["Google offers reCAPTCHA v3, v2, and reCAPTCHA Enterprise to protect against fraud and spam. To begin, register for an API key pair (site and secret keys) using the Site Registration Tool. Choose a reCAPTCHA type and provide authorized domains or package names. Integrate reCAPTCHA on the client-side, selecting from v3, v2 checkbox, invisible, or Android options. Finally, verify the user's response by authorizing communication with the reCAPTCHA server using the secret key.\n"],null,["# Developer's Guide\n\nGoogle offers reCAPTCHA (v3 and v2) and reCAPTCHA Enterprise to help you protect\nyour sites from fraudulent activities, spam, and abuse. To know more about the\nfeatures of reCAPTCHA and reCAPTCHA Enterprise, see [Comparison of features between reCAPTCHA versions](https://cloud.google.com/recaptcha/docs/compare-tiers).\n\nThis document provides an overview of Google reCAPTCHA v3 and v2. For\ninformation about reCAPTCHA Enterprise, see the\n[reCAPTCHA Enterprise documentation](https://cloud.google.com/recaptcha/docs/overview).\n\nTo get started with reCAPTCHA Enterprise, you can use our\n[Site Registration Tool](https://www.google.com/recaptcha/admin/create). This\ntool will help you create a new reCAPTCHA Site Key, and if needed also create a\nnew Google Cloud account.\n\n[Get Started](https://www.google.com/recaptcha/admin/create)\n\nAudience\n--------\n\nThis documentation is designed for people familiar with HTML forms, server-side processing or mobile\napplication development. To install reCAPTCHA, you might need to edit some code.\n\nWe hope you find this documentation easy to follow. You can ask a question about reCAPTCHA on\n[Stack Overflow](https://stackoverflow.com/questions/tagged/recaptcha), using the tag `recaptcha`.\n\nOverview\n--------\n\nTo start using reCAPTCHA, you need to [sign up for an API key\npair](http://www.google.com/recaptcha/admin) for your site. The key pair consists of a site key and\nsecret key. The site key is used to invoke reCAPTCHA service on your site or mobile application. The\nsecret key authorizes communication between your application backend and the reCAPTCHA server to\n[verify the user's response](/recaptcha/docs/verify). The secret key needs to be kept safe for\nsecurity purposes.\n\nFirst, choose the [type of reCAPTCHA](/recaptcha/docs/versions) and then fill in authorized domains\nor [package\nnames.](https://developer.android.com/guide/topics/manifest/manifest-element.html#package) After you\nhave accepted the terms of service, click **Register** to get new API key pair.\n\nNow, perform the following steps to add reCAPTCHA to your site or mobile application:\n\n1. Choose the client-side integration:\n - [reCAPTCHA v3](/recaptcha/docs/v3)\n - reCAPTCHA v2\n - [Checkbox](/recaptcha/docs/display)\n - [Invisible](/recaptcha/docs/invisible)\n - [Android](https://developer.android.com/training/safetynet/recaptcha.html)\n2. [Verify the user's response](/recaptcha/docs/verify)."]]