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

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

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

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

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

ממשק API של HTML

כדי לטעון את iframe הביניים, אפשר לכלול רכיב HTML עם מאפיין המזהה שמוגדר כ-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 הביניים בהקשה אחת
data-done שיטת JavaScript של קריאה חוזרת (callback) שתופעל בסיום חוויית המשתמש בהקשה אחת.

data-src

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

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

סיום טיפול בנתונים

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

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

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

ממשק API של JavaScript

ניתן לטעון את iframe הביניים על ידי קריאה לשיטת 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 הביניים בהקשה אחת
done שיטת JavaScript של קריאה חוזרת (callback) תופעל כאשר חוויית המשתמש בהקשה אחת היא אחת.

src

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

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

done

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

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

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