إعداد ملف تعريف موقع reCAPTCHA

1. 1.

   تحقّق من مساحة العمل

   أعدّ ملف التعريف في مساحة العمل التي ستستخدم مفتاح API الخاص بها لإنشاء المهام. لا يكفي وجود ملف تعريف في مساحة عمل أخرى. إذا عرضت لوحة التحكّم «أضف رصيدًا للمتابعة»، فاستخدم هذا الخيار قبل متابعة الإعداد.

2. 2.

   افتح «إضافة موقع»

   في «ملفات تعريف المواقع»، اختر «إضافة موقع». أدخل صفحة HTTPS المستهدفة في «عنوان URL للصفحة». ضمن «نوع reCAPTCHA»، اختر Enterprise v3 أو Regular v3 بما يطابق الصفحة.

3. 3.

   اضبط مدخلات الالتقاط

   حقل «إجراء الالتقاط» مطلوب. استخدم الإجراء الذي تنوي الحل له؛ وإذا لم تكن متأكدًا، فاعثر على إجراء reCAPTCHA أولًا. يتضمن النموذج أيضًا حقولًا اختيارية هي «عنوان URL للتنقّل» و«مفتاح الموقع» و«قيمة Referer». يمكن اكتشاف مفتاح الموقع تلقائيًا.

4. 4.

   أرسل النموذج

   اختر «إضافة موقع». يمكن لملفات تعريف النظام التي خضعت للمراجعة تعبئة مواصفات الصفحة المعروفة وإجراء الالتقاط دون جلب مباشر؛ ويوضّح النموذج الإجراء المختار. قد تدخل الطلبات الأخرى حالات الانتظار أو الالتقاط أو التحقّق أو المراجعة.

تحقّق من حالة ملف التعريف الناتج. تُعرض ACTIVE بالشكل active، وهي الحالة المطلوبة للحل. إذا فشل الالتقاط، تعرض لوحة التحكّم السبب وتتيح لك إعادة المحاولة.

يستخدم جسم هذه المهمة اسم المضيف والإجراء من ملف التعريف:

{
  "site": "accounts.example.com",
  "action": "login",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "example_login_001"
}

• site هو اسم المضيف من «عنوان URL للصفحة»، دون البروتوكول أو المسار.
• action هو الإجراء الخاص بالطلب المحمي. طابقه مع ملف التعريف الذي تنوي استخدامه.
• القيمة الافتراضية لـ recaptchaType هي enterprise-v3. لملف تعريف Regular v3، اضبطه صراحةً على v3.
• استبدل العنصر النائب للوكيل بوكيل HTTP(S) الذي ستستخدمه أيضًا للطلب المستهدف.

يوضّح دليل البدء السريع لـ Python ودليل البدء السريع لـ Node.js كيفية إرسال الطلب واستخدام النتيجة.

لا يوجد ملف تعريف متاح للمهمة.

قارن مساحة العمل المرتبطة بمفتاح API الخاص بك واسم مضيف المهمة بملف التعريف الذي أعددته.

جرّب هذا: أضف ملف تعريف الموقع المقصود في مساحة العمل التي ستنشئ المهمة. تكرار إنشاء المهمة لن ينشئ ملف التعريف المفقود.

ملف التعريف في قائمة الانتظار، أو قيد الالتقاط، أو قيد التحقّق، أو قيد المراجعة.

اطّلع على حالته الحالية في «ملفات تعريف المواقع».

جرّب هذا: انتظر حتى يصبح ملف التعريف نشطًا قبل طلب الحل. هذه الحالات ليست بديلًا عن ملف تعريف نشط.

فشل الالتقاط.

اقرأ سبب الفشل المعروض في لوحة التحكّم.

جرّب هذا: عالج المشكلة التي يحدّدها ذلك السبب، ثم أعد محاولة الالتقاط.

يوجد ملف تعريف نشط، لكن لا يزال يتعذّر العثور على ملف تعريف مناسب للإجراء المقصود.

قارن اسم المضيف وإجراء الالتقاط ونوع reCAPTCHA. إذا اختلف إجراء التنفيذ، فتحقّق من وجود هدف التقاط واحد لا لبس فيه.

جرّب هذا: أعدّ ملف تعريف يطابق اسم المضيف والإجراء والنوع المقصودين بدلًا من تغيير المهمة إلى إجراء غير ذي صلة لمجرد اختيار ملف تعريف موجود.