Riferimento API iframe intermedio

Questa pagina di riferimento descrive l'API iframe intermedio, utilizzata per incorporare il prompt One Tap nelle pagine web utilizzando un iframe.

Per ulteriori informazioni su come lavorare con gli iframe intermedi, consulta la sezione Integrare One Tap utilizzando un iframe.

Carica la libreria JavaScript Iframe intermedio

Inserisci il seguente snippet di codice in tutte le pagine HTML che vuoi visualizzare con Google One Tap:

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

API HTML

Puoi caricare l'iframe intermedio includendo un elemento HTML con l'attributo ID impostato su g_id_intermediate_iframe. Vedi il seguente snippet di codice di esempio:

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

Elemento con ID "g_id_intermediate_iframe"

Puoi inserire gli attributi di dati iframe intermedi in qualsiasi elemento visibile o invisibile, come <div> e <span>. L'unico requisito è che l'ID elemento sia impostato su g_id_intermediate_iframe. Non inserire questo ID in più elementi.

La tabella seguente elenca gli attributi dei dati con le relative descrizioni:

Attributo
data-src L'URI dell'iframe intermedio di One Tap
data-done Un metodo di callback JavaScript da attivare al termine dell'esperienza utente One Tap.

data-src

Questo attributo è l'URI dell'iframe intermedio di One Tap. Per ulteriori informazioni, consulta la tabella seguente:

Tipo Obbligatorio Esempio
stringa Sì data-src="https://example.com/onetap_iframe.html"

data-done

Questo attributo è un metodo di callback JavaScript attivato al termine dell'esperienza utente One Tap.

Per impostazione predefinita, la pagina dei contenuti viene ricaricata al termine dell'esperienza utente One Tap. Puoi ignorare il comportamento predefinito fornendo il tuo callback di completamento. Per ulteriori informazioni, consulta la tabella seguente:

Tipo Obbligatorio Esempio
Funzione Facoltativo data-done="onOneTapSuccess"

API JavaScript

Puoi caricare l'iframe intermedio chiamando un metodo JavaScript.

Metodo: google.accounts.id.initializeIntermediate

Il metodo google.accounts.id.initializeIntermediate carica l'iframe intermedio in base all'oggetto di configurazione. Vedi il seguente esempio di codice del metodo:

google.accounts.id.initializeIntermediate(IntermediateConfig)

Il seguente esempio di codice implementa il metodo google.accounts.id.initializeIntermediate con una funzione onload:

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

Tipo di dati: IntermediateConfig

La tabella seguente elenca i campi con le relative descrizioni:

Campo
src L'URI dell'iframe intermedio di One Tap
done Un metodo di callback JavaScript da attivare quando l'esperienza utente One Tap è una.

src

Questo campo è l'URI dell'iframe intermedio di One Tap. Per ulteriori informazioni, consulta la tabella seguente:

Tipo Obbligatorio Esempio
stringa Sì src: "https://example.com/onetap_iframe.html"

fine

Questo campo è il metodo di callback JavaScript da attivare al termine dell'esperienza utente One Tap.

Per impostazione predefinita, la pagina dei contenuti viene ricaricata al termine dell'esperienza utente One Tap. Puoi ignorare il comportamento predefinito fornendo il tuo callback di completamento. Per ulteriori informazioni, consulta la tabella seguente:

Tipo Obbligatorio Esempio
Funzione Facoltativo done: onOneTapSuccess