קבלת התראות על הסטטוס של שורת הפקודה בממשק המשתמש

המטרה: אם תהליך הכניסה שמוגדר כברירת מחדל לא עומד בדרישות שלכם, תוכלו להתאים אותו אישית בכמה דרכים. בהמשך מפורט מידע על אפשרויות ההתאמה האישית הזמינות.

כדי להקל על המשתמשים להיכנס לחשבון או להירשם, אפשר לתקשר עם מספר ספקי זהויות כדי למצוא פרטי כניסה זמינים. כדאי לדעת מה המצב של ממשק המשתמש של ההנחיה כדי שתוכלו לקרוא לספק הזהויות הבא.

כדי לקבל התראות על סטטוס ממשק המשתמש של ההנחיה ברגעים שונים, מגדירים את שם פונקציית ה-callback למאפיין data-moment_callback, או את הפונקציה לשיטה prompt() אם משתמשים ב-JavaScript API.

ההתראות נשלחות על הרגעים הבאים:

• רגע הצגה: זה קורה אחרי שמפעילים את השיטה prompt(). ההתראה מכילה ערך בוליאני שמציין אם ממשק המשתמש מוצג או לא.

• רגע שעבר ללא שימוש: המצב הזה מתרחש כשההודעה של One Tap נסגרת כתוצאה מביטול אוטומטי, ביטול ידני או כאשר Google לא מצליחה להנפיק פרטי כניסה, למשל כשהסשן שנבחר נסגר ב-Google.

  במקרה הזה, מומלץ להמשיך לספקי הזהויות הבאים, אם יש כאלה.

• רגע נסגר: המצב הזה מתרחש כש-Google מאחזרת בהצלחה פרטי כניסה, או כשמשתמש רוצה להפסיק את תהליך אחזור פרטי הכניסה. לדוגמה, כשהמשתמש מתחיל להזין את שם המשתמש והסיסמה שלו בתיבת הדו-שיח של ההתחברות, אפשר להפעיל את השיטה google.accounts.id.cancel() כדי לסגור את ההנחיה של One Tap ולהפעיל רגעים שנסגרו.

  אזהרה: כשמתרחש רגע סגירה, אסור לנסות את ספקי הזהויות הבאים.

בדוגמת הקוד הבאה מוטמע רגע שעבר על פניו:

<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>