تلقّي إشعارات بشأن حالة الطلب الخاص بواجهة المستخدم

الهدف: إذا كان مسار تسجيل الدخول التلقائي لا يلبي متطلباتك، يمكنك تخصيصه بعدة طرق. اقرأ المعلومات التالية لمعرفة خيارات التخصيص المتاحة.

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

لتلقّي إشعارات بشأن حالة واجهة المستخدم في الطلب في أوقات مختلفة، عليك ضبط اسم دالة معاودة الاتصال على السمة data-moment_callback أو دالة على طريقة prompt() إذا كنت تستخدم JavaScript API.

يتم إرسال الإشعارات للحظات التالية:

• لحظة العرض: تحدث هذه اللحظة بعد استدعاء طريقة prompt(). ويحتوي الإشعار على قيمة منطقية للإشارة إلى ما إذا كان سيتم عرض واجهة المستخدم أم لا.

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

  في هذه الحالة، ننصحك بالمتابعة إلى موفِّري الهوية التاليين، إن وجدوا.

• لحظة الرفض: يحدث ذلك عندما يسترد محرّك بحث Google بيانات اعتماد بنجاح أو عندما يريد المستخدم إيقاف عملية استرداد بيانات الاعتماد. على سبيل المثال، عندما يبدأ المستخدم في إدخال اسم المستخدم وكلمة المرور في مربّع حوار تسجيل الدخول، يمكنك استدعاء الطريقة google.accounts.id.cancel() لإغلاق إشعار "نقرة واحدة" وتشغيل لحظة تجاهل.

  تحذير: عند حدوث لحظة تجاهل، لا تحاول أيًا من موفِّري الهوية التاليين.

يوضّح مثال الرمز التالي لقطة تم تخطيها:

<script>
  function continueWithNextIdp(notification) {
      if (notification.isNotDisplayed() || notification.isSkippedMoment()) {
          // try Next provider if One Tap is not displayed or skipped
      }
  }
</script>
...
<div id="g_id_onload"
     data-client_id="YOUR_GOOGLE_CLIENT_ID"
     data-login_uri="https://your.domain/your_login_endpoint"
     data-moment_callback="continueWithNextIdp"
</div>