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

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

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

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

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

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

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

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

• רגע שנסגר:מצב זה קורה כש-Google מאחזרת פרטי כניסה או אם משתמש רוצה להפסיק את תהליך האחזור. לדוגמה, כשהמשתמש מתחיל להזין את שם המשתמש והסיסמה בתיבת הדו-שיח להתחברות, אפשר לבצע קריאה ל-method 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>