API-Referenz für das Zwischen-Iframe

Auf dieser Referenzseite wird die Intermediate Iframe API beschrieben, mit der die One Tap-Aufforderung mithilfe eines iFrames in Webseiten eingebettet wird.

Weitere Informationen zum Arbeiten mit Zwischen-iFrames finden Sie unter One Tap mit einem iFrame einbinden.

Intermediate Iframe JavaScript Library laden

Fügen Sie das folgende Code-Snippet in alle HTML-Seiten ein, die in Google One Tap angezeigt werden sollen:

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

HTML API

Sie können das Zwischen-iFrame laden, indem Sie ein HTML-Element mit dem ID-Attribut g_id_intermediate_iframe einfügen. Hier ein Beispiel-Code-Snippet:

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

Element mit der ID „g_id_intermediate_iframe“

Sie können die Datenattribute des Zwischen-iFrames in beliebige sichtbare oder unsichtbare Elemente einfügen, z. B. <div> und <span>. Die einzige Voraussetzung ist, dass die Element-ID auf g_id_intermediate_iframe festgelegt ist. Verwenden Sie diese ID nicht für mehrere Elemente.

In der folgenden Tabelle sind die Datenattribute mit ihren Beschreibungen aufgeführt:

Attribut
data-src Der URI Ihres Zwischen-iFrames für die Einmalanmeldung
data-done Eine JavaScript-Callback-Methode, die ausgelöst wird, wenn die One Tap-Benutzeroberfläche abgeschlossen ist.

data-src

Dieses Attribut ist der URI Ihres One Tap-Zwischen-iFrames. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
String Ja data-src="https://example.com/onetap_iframe.html"

data-done

Dieses Attribut ist eine JavaScript-Callback-Methode, die ausgelöst wird, wenn die One Tap-Benutzeroberfläche abgeschlossen ist.

Standardmäßig wird die Inhaltsseite neu geladen, wenn die One Tap-Benutzeroberfläche abgeschlossen ist. Sie können das Standardverhalten überschreiben, indem Sie einen eigenen „done“-Callback angeben. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
Funktion Optional data-done="onOneTapSuccess"

JavaScript API

Sie können das Zwischen-Iframe laden, indem Sie eine JavaScript-Methode aufrufen.

Methode: google.accounts.id.initializeIntermediate

Mit der Methode google.accounts.id.initializeIntermediate wird das Zwischen-Iframe basierend auf dem Konfigurationsobjekt geladen. Hier ein Codebeispiel für die Methode:

google.accounts.id.initializeIntermediate(IntermediateConfig)

Im folgenden Codebeispiel wird die Methode google.accounts.id.initializeIntermediate mit einer onload-Funktion implementiert:

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

Datentyp: IntermediateConfig

In der folgenden Tabelle sind die Felder mit ihren Beschreibungen aufgeführt:

Feld
src Der URI Ihres Zwischen-iFrames für die Einmalanmeldung
done Eine JavaScript-Callback-Methode, die ausgelöst wird, wenn die One Tap-Benutzeroberfläche angezeigt wird.

src

Dieses Feld enthält den URI Ihres One Tap-Zwischen-iFrames. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
String Ja src: "https://example.com/onetap_iframe.html"

Fertig

Dieses Feld ist die JavaScript-Callback-Methode, die ausgelöst werden soll, wenn die One Tap-Benutzeroberfläche abgeschlossen ist.

Standardmäßig wird die Inhaltsseite neu geladen, wenn die One Tap-Benutzeroberfläche abgeschlossen ist. Sie können das Standardverhalten überschreiben, indem Sie einen eigenen „done“-Callback angeben. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
Funktion Optional done: onOneTapSuccess