דף עזרה זה מתאר את ממשק ה-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" |
data-skip_prompt_cookie
במאפיין הזה מדלגים על 'הקשה אחת' אם בקובץ ה-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.
data-state_cookie_domain
אם ברצונך להציג 'הקשה אחת' בדומיין הורה ובתת-דומיינים של הדומיין שלך, יש להעביר את הדומיין של ההורה למאפיין זה כדי להשתמש בקובץ 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":
|
signup_with |
הטקסט של הלחצן הוא "הרשמה ל-Google":
|
continue_with |
הטקסט של הלחצן הוא "המשך עם Google":
|
signin |
הטקסט בלחצן הוא "כניסה":
|
עיצוב נתונים
צורת הלחצן. ערך ברירת המחדל הוא 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:
|
center |
יישור למרכז של הלוגו של Google:
|
רוחב נתונים
רוחב הלחצן המינימלי, בפיקסלים. הרוחב המרבי הזמין הוא 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; כ-' כדי לבחור חשבון ולאחר מכן לחץ על הלחצן 'אישור' בחלון קופץ כדי להעניק הסכמה ולשתף את פרטי הכניסה. חלה על דפדפנים שאינם 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 |
איך בוחרים את פרטי הכניסה. |