הפניה ל-API של Iframe ביניים

בדף העזרה הזה נסביר איך לטעון iframe ביניים לדפי HTML.

טעינת ספריית JavaScript של Iframe ביניים

מוסיפים את קטע הקוד הבא לכל דפי ה-HTML שבהם רוצים להציג את Google One בנגיעה:

<script src="https://accounts.google.com/gsi/intermediate"></script>

API ל-HTML

כדי לטעון את ה-iframe הביניים, צריך לכלול אלמנט HTML עם המאפיין ID שמוגדר לערך g_id_intermediate_iframe. קטע הקוד לדוגמה הבא:

<script src="https://accounts.google.com/gsi/intermediate"></script>
<div id="g_id_intermediate_iframe"
     data-src="https://example.com/onetap_iframe.html">
</div>

רכיב עם המזהה 'g_id_intermediate_iframe'

אפשר להוסיף את מאפייני הנתונים של iframe הביניים לכל רכיב גלוי או מוסתר, כמו <div> ו-<span>. הדרישה היחידה היא שמזהה הרכיב מוגדר ל-g_id_intermediate_iframe. אל תכללו את המזהה הזה בכמה רכיבים.

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

מאפיין
data-src ה-URI של מסגרת ה-iframe המקשרת של One Tap
data-done שיטת קריאה חוזרת (callback) של JavaScript שתופעל בסיום חוויית המשתמש של One Tap.

data-src

המאפיין הזה הוא ה-URI של ה-iframe הביניים של One Tap. מידע נוסף זמין בטבלה הבאה:

סוג חובה דוגמה
מחרוזת כן data-src="https://example.com/onetap_iframe.html"

data-done

המאפיין הזה הוא שיטת קריאה חוזרת (callback) של JavaScript שמופעל בסיום חוויית המשתמש של הקשה אחת.

כברירת מחדל, דף התוכן נטען מחדש כשה-One Tap UX. אפשר לבטל את התנהגות ברירת המחדל על ידי מתן קריאה חוזרת (callback) משלכם לסיום. מידע נוסף זמין בטבלה הבאה:

סוג חובה דוגמה
פעולה אופציונלי data-done="onOneTapSuccess"

JavaScript API

ניתן לטעון את iframe הביניים על ידי קריאה ל-method של JavaScript.

שיטה: google.accounts.id.initializeIntermediate

השיטה google.accounts.id.initializeIntermediate טוענת את ה-iframe הביניים על סמך אובייקט התצורה. דוגמה לקוד של השיטה:

google.accounts.id.initializeIntermediate(IntermediateConfig)

בדוגמת הקוד הבאה מוטמעת השיטה google.accounts.id.initializeIntermediate באמצעות פונקציית onload:

<script>
  window.onload = function () {
    google.accounts.id.initializeIntermediate({
      src: 'https://example.com/intermediate'
    });
  };
</script>

סוג הנתונים: IntermediateConfig

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

שדה
src ה-URI של מסגרת ה-iframe המקשרת של One Tap
done שיטת קריאה חוזרת (callback) של JavaScript שתופעל כשממשק המשתמש של הקשה אחת הוא אחד.

src

השדה הזה הוא ה-URI של ה-iframe הביניים של One Tap. מידע נוסף זמין בטבלה הבאה:

סוג חובה דוגמה
מחרוזת כן src: "https://example.com/onetap_iframe.html"

סיום

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

כברירת מחדל, דף התוכן נטען מחדש כשה-One Tap UX. אפשר לבטל את התנהגות ברירת המחדל על ידי מתן קריאה חוזרת (callback) משלכם לסיום. מידע נוסף זמין בטבלה הבאה:

סוג חובה דוגמה
פעולה אופציונלי done: onOneTapSuccess