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

כניסה באמצעות Google HTML API

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

רכיב עם מזהה "g_id_onload"

ניתן למקם מאפייני נתונים של 'כניסה באמצעות חשבון Google' בכל אלמנט גלוי או בלתי נראה, כמו <div> ו-<span>. הדרישה היחידה היא שהמזהה של הרכיב יהיה g_id_onload. אין להציב את המזהה הזה על כמה רכיבים.

מאפייני נתונים

בטבלה הבאה מפורטים מאפייני הנתונים עם התיאורים שלהם:

מאפיין
data-client_id מספר הלקוח של האפליקציה שלך
data-auto_prompt הצגת הקשה של Google One.
data-auto_select מאפשרת בחירה אוטומטית ב-Google One Tap.
data-login_uri כתובת ה-URL של נקודת הקצה להתחברות
data-callback שם הפונקציה של אסימון האסימון של JavaScript
data-native_login_uri כתובת ה-URL של נקודת הקצה של פרטי הכניסה לסיסמה
data-native_callback שם הפונקציה של מטפל בפרטי כניסה ל-JavaScript
data-native_id_param שם הפרמטר עבור הערך credential.id
data-native_password_param שם הפרמטר עבור הערך credential.password
data-cancel_on_tap_outside המדיניות קובעת אם לבטל את הבקשה אם המשתמש לוחץ מחוץ לבקשה.
data-prompt_parent_id מזהה DOM של רכיב מאגר התגים של 'הקשה אחת'
data-skip_prompt_cookie יתבצע דילוג על הקשה אחת אם לקובץ ה-cookie שצוין יש ערך שאינו ריק.
data-nonce מחרוזת אקראית לאסימוני מזהה
data-context הכותרת והמילים בהקשה אחת
data-moment_callback שם הפונקציה של ההאזנה להודעה של סטטוס ממשק המשתמש
data-state_cookie_domain כדי להפעיל את התכונה 'הקשה אחת' בדומיין ההורה ובתת-דומיינים של הדומיין, צריך להעביר את הדומיין הראשי למאפיין הזה כדי להשתמש בקובץ cookie משותף אחד.
data-ux_mode תהליך חוויית המשתמש בלחצן 'כניסה באמצעות חשבון Google'
data-allowed_parent_origin המקורות שרשאים להטמיע את ה-iframe הביניים. הקשה אחת תפעל במצב iframe בינוני אם המאפיין הזה יוצג.
data-intermediate_iframe_close_callback המדיניות הזו עוקפת את התנהגות ברירת המחדל של iframe ביניים כשמשתמשים סוגרים ידנית.
data-itp_support הפעלת חוויית משתמש בהקשה אחת בדפדפני ITP.

סוגי מאפיינים

הקטעים הבאים מכילים פרטים לגבי הסוג של כל מאפיין ודוגמה.

data-client_id

מאפיין זה הוא מספר הלקוח של האפליקציה שלך, שנמצא ונוצר ב-Google Developers Console. מידע נוסף זמין בטבלה הבאה:

סוג נדרש דוגמה
string כן data-client_id="CLIENT_ID.apps.googleusercontent.com"

data-auto_prompt

המאפיין הזה קובע אם להציג בהקשה אחת או לא. ערך ברירת המחדל הוא true. הערך הזה לא יוצג ב-Google One כאשר הערך הוא false. אפשר לעיין בטבלה הבאה לקבלת מידע נוסף:

סוג נדרש דוגמה
boolean אופציונלי data-auto_prompt="true"

data-auto_select

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

סוג נדרש דוגמה
boolean אופציונלי data-auto_select="true"

data-login_uri

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

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

מידע נוסף זמין בטבלה הבאה:

סוג אופציונלי דוגמה
כתובת URL ברירת המחדל של ה-URI של הדף הנוכחי, או הערך שציינתם.
המערכת תתעלם מהמאפיינים כאשר data-ux_mode="popup" ו-data-callback מוגדרים.
data-login_uri="https://www.example.com/login"

נקודת הקצה להתחברות חייבת לטפל בבקשות POST שמכילות מפתח credential בגוף של אסימון מזהה.

לפניכם בקשה לדוגמה לנקודת הקצה שלכם להתחברות:

POST /login HTTP/1.1
Host: www.example.com
Content-Type: application/x-www-form-urlencoded

credential=ID_TOKEN

קריאה חוזרת לנתונים

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

סוג נדרש דוגמה
string חובה אם המאפיין data-login_uri לא מוגדר. data-callback="handleToken"

ניתן להשתמש באחד מהמאפיינים data-login_uri ו-data-callback. הדבר תלוי בהגדרות הבאות של הרכיב ומצב חוויית המשתמש:

  • יש להזין את המאפיין data-login_uri ללחצן 'כניסה באמצעות חשבון Google' מצב חוויית משתמש (redirect) שמתעלם ממאפיין data-callback.

  • צריך להגדיר אחד משני המאפיינים האלה ב-Google One Tap ובמצב Google לחצן הכניסה של popup. אם שניהם מוגדרים, למאפיין data-callback יש עדיפות גבוהה יותר.

פונקציות JavaScript במרחב שמות אינן נתמכות על ידי ה-HTML API. במקום זאת, יש להשתמש בפונקציית JavaScript גלובלית ללא מרחב שמות. לדוגמה, יש להשתמש ב-mylibCallback במקום ב-mylib.callback.

data-Native_login_uri

המאפיין הזה הוא כתובת ה-URL של נקודת הקצה של פרטי הכניסה לסיסמה. אם הגדרת את המאפיין data-native_login_uri או את המאפיין data-native_callback, ספריית ה-JavaScript תוחזר למנהל פרטי הכניסה המקורי כאשר אין סשן של Google. אין לך הרשאה להגדיר גם את המאפיין data-native_callback וגם את המאפיין data-native_login_uri. מידע נוסף זמין בטבלה הזו:

סוג נדרש דוגמה
string אופציונלי data-login_uri="https://www.example.com/password_login"

data-Native_callback

מאפיין זה הוא השם של פונקציית JavaScript המטפלת בפרטי הכניסה של הסיסמה שהוחזרו ממנהל פרטי הכניסה של הדפדפן. אם תגדירו את המאפיין data-native_login_uri או את המאפיין data-native_callback, ספריית ה-JavaScript תוחזר למנהל פרטי הכניסה המקורי כשאין סשן של Google. אין לך הרשאה להגדיר גם את data-native_callback וגם את data-native_login_uri. אפשר לעיין בטבלה למידע נוסף:

סוג נדרש דוגמה
string אופציונלי data-native_callback="handlePasswordCredential"

פונקציות JavaScript במרחב שמות אינן נתמכות על ידי ה-HTML API. במקום זאת, יש להשתמש בפונקציית JavaScript גלובלית ללא מרחב שמות. לדוגמה, יש להשתמש ב-mylibCallback במקום ב-mylib.callback.

data-id_id_param

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

סוג נדרש דוגמה
כתובת URL אופציונלי data-native_id_param="user_id"

data-Native_password_param – נתונים

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

סוג נדרש דוגמה
כתובת URL אופציונלי data-native_password_param="pwd"

data-cancel_on_tap_outside

המאפיין הזה קובע אם לבטל את הבקשה בהקשה אחת אם משתמש לוחץ מחוץ לבקשה. ערך ברירת המחדל הוא true. כדי להשבית אותה, צריך להגדיר את הערך כ-false. מידע נוסף זמין בטבלה הבאה:

סוג נדרש דוגמה
boolean אופציונלי data-cancel_on_tap_outside="false"

data-prompt_parent_id

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

סוג נדרש דוגמה
string אופציונלי data-prompt_parent_id="parent_id"

במאפיין הזה מדלגים על 'הקשה אחת' אם בקובץ ה-cookie שצוין יש ערך שאינו ריק. אפשר לעיין בטבלה הבאה לקבלת מידע נוסף:

סוג נדרש דוגמה
string אופציונלי data-skip_prompt_cookie="SID"

שום נתונים

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

סוג נדרש דוגמה
string אופציונלי data-nonce="biaqbm70g23"

אורך הנומה מוגבל לגודל ה-JWT המקסימלי שנתמך על ידי הסביבה שלך, ולמגבלות גודל HTTP של דפדפן ושרת נפרדים.

הקשר נתונים

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

סוג נדרש דוגמה
string אופציונלי data-context="use"

בטבלה הבאה מפורטים ההקשרים הזמינים והתיאורים שלהם:

הקשר
signin "כניסה באמצעות Google"
signup "הרשמה באמצעות Google"
use "Use with Google"

data-moment_callback

המאפיין הזה הוא שם הפונקציה של חיישן ההתראות על סטטוס ממשק המשתמש של בקשה. מידע נוסף זמין בסוג הנתונים PromptMomentNotification. מידע נוסף זמין בטבלה הבאה:

סוג נדרש דוגמה
string אופציונלי data-moment_callback="logMomentNotification"

פונקציות JavaScript במרחב שמות אינן נתמכות על ידי ה-HTML API. במקום זאת, יש להשתמש בפונקציית JavaScript גלובלית ללא מרחב שמות. לדוגמה, יש להשתמש ב-mylibCallback במקום ב-mylib.callback.

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

סוג נדרש דוגמה
string אופציונלי data-state_cookie_domain="example.com"

data-ux_mode

המאפיין הזה מגדיר את תהליך חוויית המשתמש (UX) שנעשה בו שימוש בלחצן 'כניסה באמצעות חשבון Google'. ערך ברירת המחדל הוא popup. למאפיין הזה אין השפעה על חוויית המשתמש ב-One Tap. מידע נוסף זמין בטבלה הבאה:

סוג נדרש דוגמה
string אופציונלי data-ux_mode="redirect"

בטבלה הבאה מפורטים המצבים הזמינים של חוויית המשתמש והתיאורים שלהם.

מצב חוויית משתמש
popup ביצוע תהליך חוויית משתמש בכניסה בחלון קופץ.
redirect מבצע זרימת חוויית משתמש בכניסה באמצעות הפניה אוטומטית של דף מלא.

data-allowed_parent_origin

המקורות שרשאים להטמיע את ה-iframe הביניים. הקשה אחת תוצג במצב iframe בינוני אם המאפיין הזה מוצג. מידע נוסף זמין בטבלה הזו:

סוג נדרש דוגמה
מחרוזת או מערך מחרוזת אופציונלי data-allowed_parent_origin="https://example.com"

בטבלה הבאה מפורטים סוגי הערכים הנתמכים והתיאורים שלהם.

סוגי ערכים
string URI של דומיין יחיד. "https://example.com"
string array רשימה של URIs של דומיינים המופרדים בפסיקים. "https://news.example.com,https://local.example.com"

אם הערך של המאפיין data-allowed_parent_origin אינו חוקי, ההפעלה של הקשה אחת של מצב הביניים של iframe תיכשל ותפסיק.

יש תמיכה גם בקידומות לחיפוש כללי. לדוגמה, "https://*.example.com" יתאים לexample.com ותת-הדומיינים שלו בכל הרמות (למשל, news.example.com , login.news.example.com). דברים שחשוב לזכור כשמשתמשים בתווים כלליים לחיפוש:

  • מחרוזות דפוס לא יכולות להכיל רק תו כללי לחיפוש ודומיין ברמה עליונה. לדוגמה https://*.com ו-https://*.co.uk אינם חוקיים; כפי שצוין למעלה, "https://*.example.com" יתאים ל-example.com ולתתי-הדומיינים שלו. אפשר גם להשתמש ברשימה המופרדת בפסיקים כדי לייצג 2 דומיינים שונים. לדוגמה, "https://example1.com,https://*.example2.com" יתאים לדומיינים example1.com, example2.com ותת-דומיינים של example2.com
  • דומיינים עם תו כללי לחיפוש חייבים להתחיל בסכימת https:// מאובטחת. "*.example.com" ייחשב כלא חוקי.

data-intermediate_iframe_closure_callback

מדיניות זו מבטלת את התנהגות ברירת המחדל של iframe הביניים כשמשתמשים סוגרים ידנית בהקשה אחת, על ידי לחיצה על הלחצן 'X' בממשק המשתמש. התנהגות ברירת המחדל היא הסרה מיידית של ה-iframe הביניים מ-DOM.

השדה data-intermediate_iframe_close_callback נכנס לתוקף רק במצב iframe בינוני. כמו כן, היא משפיעה רק על ה-iframe הביניים, במקום על ה-iframe של 'הקשה אחת'. ממשק המשתמש בהקשה אחת יוסר לפני הפעלת הקריאה החוזרת.

סוג נדרש דוגמה
פונקציה אופציונלי data-intermediate_iframe_close_callback="logBeforeClose"

פונקציות JavaScript במרחב שמות אינן נתמכות על ידי ה-HTML API. במקום זאת, יש להשתמש בפונקציית JavaScript גלובלית ללא מרחב שמות. לדוגמה, יש להשתמש ב-mylibCallback במקום ב-mylib.callback.

data-itp_support

השדה הזה קובע אם יש להפעיל את חוויית המשתמש בהקשה אחת בדפדפנים שתומכים במניעה של מעקב חכם (ITP). ערך ברירת המחדל הוא false. מידע נוסף זמין בטבלה הבאה:

סוג נדרש דוגמה
boolean אופציונלי data-itp_support="true"

רכיב עם class "g_id_signin"

אם מוסיפים את g_id_signin למאפיין class של הרכיב, הרכיב מוצג כלחצן כניסה באמצעות Google.

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

מאפיינים של נתונים חזותיים

בטבלה הבאה מפורטים מאפייני הנתונים החזותיים והתיאורים שלהם:

מאפיין
data-type סוג הלחצן: סמל או לחצן רגיל.
data-theme העיצוב של הלחצן. לדוגמה: filled_blue או filled_black.
data-size גודל הלחצן. לדוגמה, Small או Large.
data-text הטקסט של הלחצן. לדוגמה, & "היכנסו באמצעות Google " או "הירשמו באמצעות Google ".
data-shape צורת הלחצן. לדוגמה, מלבני או עגול.
data-logo_alignment יישור הלוגו של Google: משמאל או במרכז.
data-width רוחב הלחצן, בפיקסלים.
data-locale הטקסט של הלחצן מעובד בשפה שמוגדרת במאפיין הזה.

סוגי מאפיינים

הקטעים הבאים מכילים פרטים לגבי הסוג של כל מאפיין ודוגמה.

סוג נתונים

סוג הלחצן. ערך ברירת המחדל הוא standard. אפשר לעיין בטבלה למידע נוסף:

סוג נדרש דוגמה
string כן data-type="icon"

בטבלה הבאה מפורטים סוגי הלחצנים הזמינים והתיאורים שלהם:

סוג
standard לחצן עם טקסט או פרטים בהתאמה אישית:
icon לחצן סמל ללא טקסט:

עיצוב נתונים

העיצוב של הלחצן. ערך ברירת המחדל הוא outline. אפשר לעיין בטבלה למידע נוסף:

סוג נדרש דוגמה
string אופציונלי data-theme="filled_blue"

בטבלה הבאה מפורטים הנושאים הזמינים והתיאורים שלהם:

עיצוב
outline העיצוב הרגיל של הלחצן:
לחצן סטנדרטי עם רקע לבן לחצן סמל עם רקע לבן לחצן מותאם אישית עם רקע לבן
filled_blue עיצוב הלחצן הכחול:
לחצן רגיל עם רקע כחול לחצן סמל עם רקע כחול לחצן מותאם אישית עם רקע כחול
filled_black עיצוב הלחצן השחור:
לחצן סטנדרטי עם רקע שחור לחצן סמל עם רקע שחור לחצן מותאם אישית עם רקע שחור

גודל נתונים

גודל הלחצן. ערך ברירת המחדל הוא large. אפשר לעיין בטבלה למידע נוסף:

סוג נדרש דוגמה
string אופציונלי data-size="small"

בטבלה הבאה מפורטים הגדלים הזמינים של הלחצנים והתיאורים שלהם.

גודל
large לחצן גדול:
לחצן רגיל גדול לחצן סמל גדול לחצן גדול ומותאם אישית
medium לחצן בגודל בינוני:
לחצן סטנדרטי בינוני לחצן סמל בינוני
small לחצן קטן:
לחצן קטן לחצן סמל קטן

טקסט-נתונים

הטקסט של הלחצן. ערך ברירת המחדל הוא signin_with. אין הבדלים חזותיים בטקסט של לחצני הסמלים שיש להם מאפייני data-text שונים. החריג היחיד הוא כאשר הטקסט קריא עבור נגישות במסך.

מידע נוסף זמין בטבלה הבאה:

סוג Required דוגמה
string אופציונלי data-text="signup_with"

בטבלה הבאה מפורטים הטקסטים הזמינים בלחצנים והתיאורים שלהם:

טקסט
signin_with הטקסט בלחצן הוא "כניסה באמצעות חשבון Google":
לחצן רגיל עם התווית &#39;כניסה באמצעות Google&#39; לחצן סמל ללא טקסט גלוי
signup_with הטקסט של הלחצן הוא "הרשמה ל-Google":
לחצן רגיל עם &&39;הרשמה באמצעות Google&#39; לחצן סמל ללא טקסט גלוי
continue_with הטקסט של הלחצן הוא "המשך עם Google":
לחצן רגיל עם התווית &#39;המשך עם Google&#39; לחצן סמל ללא טקסט גלוי
signin הטקסט בלחצן הוא "כניסה":
לחצן רגיל עם &&39;כניסה&#39; לחצן סמל ללא טקסט גלוי

עיצוב נתונים

צורת הלחצן. ערך ברירת המחדל הוא rectangular. אפשר להיעזר בטבלה הבאה כדי לקבל מידע נוסף:

סוג נדרש דוגמה
string אופציונלי data-shape="rectangular"

בטבלה הבאה מפורטים הצורות הזמינות של הלחצנים והתיאורים שלהן:

צורה
rectangular הלחצן בצורת מלבני. אם נעשה בהם שימוש בסוג הלחצן icon, היא זהה ל-square.
לחצן סטנדרטי מלבני לחצן סמל מלבני לחצן מותאם אישית מלבני
pill הלחצן בצורת גלולה. אם נעשה שימוש בסוג הלחצן icon, היא זהה ל-circle.
לחצן רגיל בצורת גלולה לחצן סמל בצורת גלולה לחצן מותאם אישית בצורת גלולה
circle הלחצן בצורת עיגול. אם נעשה שימוש בסוג הלחצן standard, הוא זהה ל-pill.
לחצן רגיל עגול לחצן סמל עגול לחצן מותאם אישית עגול
square הלחצן בצורת ריבוע. אם נעשה שימוש בסוג הלחצן standard, הוא זהה ל-rectangular.
לחצן רגיל מרובע לחצן סמל מרובע לחצן מותאם אישית וריבוע

data-logo_alignment

היישור של הלוגו של Google. ערך ברירת המחדל הוא left. המאפיין הזה חל רק על סוג הלחצן standard. מידע נוסף זמין בטבלה הבאה:

סוג נדרש דוגמה
string אופציונלי data-logo_alignment="center"

בטבלה הבאה מפורטים היישור הזמין והתיאורים שלו:

הלוגו_יישור
left יישור לשמאל של הלוגו של Google:
לחצן רגיל עם הלוגו G
center יישור למרכז של הלוגו של Google:
לחצן רגיל עם הלוגו G במרכז

רוחב נתונים

רוחב הלחצן המינימלי, בפיקסלים. הרוחב המרבי הזמין הוא 400 פיקסלים.

מידע נוסף זמין בטבלה הבאה:

סוג נדרש דוגמה
string אופציונלי data-width=400

לוקאל נתונים

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

מידע נוסף זמין בטבלה הבאה:

סוג נדרש דוגמה
string אופציונלי data-locale="zh_CN"

שילוב בצד השרת

נקודות הקצה בצד השרת חייבות לטפל בבקשות POST הבאות ב-HTTP.

נקודת הקצה של הגורם המטפל באסימון המזהה

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

בקשת ה-HTTP POST כוללת את המידע הבא:

פורמט שם תיאור
קובץ Cookie g_csrf_token מחרוזת אקראית שמשתנה עם כל בקשה לנקודת הקצה של ה-handler.
פרמטר בקשה g_csrf_token מחרוזת זהה לערך הקודם של קובץ ה-cookie, g_csrf_token.
פרמטר בקשה credential אסימון המזהה ש-Google מנפיקה.
פרמטר בקשה select_by איך בוחרים את פרטי הכניסה.

כשמקודדים, אסימון המזהה נראה כמו בדוגמה הבאה:

header
{
  "alg": "RS256",
  "kid": "f05415b13acb9590f70df862765c655f5a7a019e", // JWT signature
  "typ": "JWT"
}
payload
{
  "iss": "https://accounts.google.com", // The JWT's issuer
  "nbf":  161803398874,
  "aud": "314159265-pi.apps.googleusercontent.com", // Your server's client ID
  "sub": "3141592653589793238", // The unique ID of the user's Google Account
  "hd": "gmail.com", // If present, the host domain of the user's GSuite email address
  "email": "elisa.g.beckett@gmail.com", // The user's email address
  "email_verified": true, // true, if Google has verified the email address
  "azp": "314159265-pi.apps.googleusercontent.com",
  "name": "Elisa Beckett",
                            // If present, a URL to user's profile picture
  "picture": "https://lh3.googleusercontent.com/a-/e2718281828459045235360uler",
  "given_name": "Eliza",
  "family_name": "Beckett",
  "iat": 1596474000, // Unix timestamp of the assertion's creation time
  "exp": 1596477600, // Unix timestamp of the assertion's expiration time
  "jti": "abc161803398874def"
}

הטבלה הבאה מפרטת את הערכים האפשריים לשדה select_by. סוג הלחצן שמשמש יחד עם הסשן ומצב ההסכמה משמש להגדרת הערך

  • המשתמש לחץ על הלחצן בהקשה אחת או על כניסה באמצעות חשבון Google, או השתמש בתהליך הכניסה האוטומטית ללא מגע.

  • נמצא ביקור קיים או שהמשתמש בחר חשבון Google ונכנס אליו כדי ליצור ביקור חדש.

  • לפני שיתוף פרטי הכניסה של אסימון הזיהוי עם האפליקציה שלך, המשתמש יכול

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

הערך של השדה הזה מוגדר לאחד מהסוגים האלה,

ערך תיאור
auto כניסה אוטומטית של משתמש עם סשן קיים שהעניק בעבר הסכמה לשיתוף פרטי כניסה.
user משתמש עם סשן קיים שנתן בעבר הסכמה לחץ על הלחצן 'הקשה אחת' 'המשך כ&&39; כדי לשתף פרטי כניסה.
user_1tap משתמש עם סשן קיים לחץ על הלחצן '&הקשה אחת'; המשך בתור' כדי להעניק הסכמה ולשתף פרטי כניסה. ההגדרות חלות רק על Chrome מגרסה 75 ואילך.
user_2tap משתמש שאין לו סשן קיים לחץ על הלחצן One&&39; כ-&#39 כדי לבחור חשבון ולאחר מכן לחץ על הלחצן 'אישור' בחלון קופץ כדי להעניק הסכמה ולשתף את פרטי הכניסה. חלה על דפדפנים שאינם Chromium.
btn משתמש עם סשן קיים שהסכים בעבר לחץ על הלחצן 'כניסה באמצעות חשבון Google' ובחר חשבון Google מ-'יש לבחור חשבון' כדי לשתף פרטי כניסה.
btn_confirm משתמש עם סשן קיים לחץ על הלחצן 'כניסה באמצעות חשבון Google' ולחץ על הלחצן 'אישור' כדי להעניק הסכמה ולשתף את פרטי הכניסה.
btn_add_session משתמש ללא סשן קיים שהעניק בעבר הסכמה, לחץ על לחצן הכניסה באמצעות חשבון Google כדי לבחור חשבון Google ולשתף פרטי כניסה.
btn_confirm_add_session משתמש שאין לו סשן קיים לחץ קודם על הלחצן 'כניסה באמצעות חשבון Google' כדי לבחור חשבון Google, ולאחר מכן לחץ על הלחצן 'אישור' כדי להסכים ולשתף את פרטי הכניסה.

נקודת קצה של פרטי כניסה לסיסמה

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

בקשת ה-HTTP POST כוללת את המידע הבא:

פורמט שם תיאור
קובץ Cookie g_csrf_token מחרוזת אקראית שמשתנה עם כל בקשה לנקודת הקצה של ה-handler.
פרמטר בקשה g_csrf_token מחרוזת זהה לערך הקודם של קובץ ה-cookie, g_csrf_token.
פרמטר בקשה email אסימון המזהה הזה ש-Google מנפיקה.
פרמטר בקשה password איך בוחרים את פרטי הכניסה.