Riferimento API JavaScript per iframe intermedi

Questa pagina di riferimento descrive l'API JavaScript di supporto iframe intermedio, utilizzata da One Tap per manipolare l'iframe intermedio nell'esperienza utente successiva.

Consulta la guida Integrare One Tap utilizzando un iframe per scoprire come utilizzare gli iframe intermedi.

La tabella seguente elenca tutti i metodi disponibili e i relativi comportamenti.

Metodi
verifyParentOrigin	esegue la verifica dell'origine principale
notifyParentClose	notifica al frame principale che il flusso UX di One Tap è stato ignorato
notifyParentDone	notifica al frame principale che il flusso UX di One Tap è terminato
notifyParentResize	notifica al frame principale di ridimensionare l'iframe intermedio
notifyParentTapOutsideMode	notifica al frame principale se annullare l'iframe intermedio quando l'utente fa clic all'esterno dell'iframe intermedio

Carica la libreria JavaScript di supporto iframe intermedio

Inserisci il seguente snippet di codice in tutte le pagine HTML in cui vuoi caricare l'iframe intermedio:

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

Metodo: google.accounts.id.intermediate.verifyParentOrigin

Il metodo google.accounts.id.intermediate.verifyParentOrigin esegue la verifica dell'origine principale. Vedi il seguente esempio di codice del metodo:

google.accounts.id.intermediate.verifyParentOrigin(
    origins, verifiedCallback, verificationFailedCallback)

Il seguente esempio di codice mostra come visualizzare la UI solo dopo la verifica dell'origine principale:

<script>
  window.onload = () => {
    google.accounts.id.intermediate.verifyParentOrigin(
        "https://example.com", showUI, showError);
  };
</script>

La tabella seguente elenca i parametri:

Parametro
origins	Le origini autorizzate a incorporare l'iframe intermedio.
verifiedCallback	Il metodo di callback JavaScript attivato quando l'origine principale corrente è autorizzata a incorporare l'iframe intermedio.
verificationFailedCallback	Il metodo di callback JavaScript attivato quando l'origine principale corrente non è autorizzata a incorporare l'iframe intermedio.

origini

Le origini autorizzate a incorporare l'iframe intermedio. Per ulteriori informazioni, consulta la tabella seguente:

Tipo	Obbligatorio	Esempio
stringa, array di stringhe o funzione	Facoltativo	allowed_parent_origin: "https://example.com"

La tabella seguente elenca i tipi di valori supportati e le relative descrizioni.

Tipi di valori
string	Un URI di un singolo dominio.	"https://example.com"
string array	Un array di URI di dominio.	"https://news.example.com,https://local.example.com"

Nota: una stringa con URI separati da virgole non è valida. Utilizza invece un oggetto JavaScript Array.

verifiedCallback

Questo campo è un metodo di callback JavaScript attivato quando l'origine principale corrente è autorizzata a incorporare l'iframe intermedio.

verificationFailedCallback

Questo campo è un metodo di callback JavaScript attivato quando l'origine principale corrente non è autorizzata a incorporare l'iframe intermedio.

Avviso: se la pagina dei contenuti non risponde alla richiesta di verifica del dominio, il processo di verifica attende per sempre. In questo caso, non viene richiamato né verifiedCallback né verificationFailedCallback.

Metodo: google.accounts.id.intermediate.notifyParentClose

Il metodo google.accounts.id.intermediate.notifyParentClose notifica al frame principale di chiudere l'iframe intermedio quando il flusso UX di One Tap viene ignorato. Vedi il seguente esempio di codice del metodo:

google.accounts.id.intermediate.notifyParentClose()

Metodo: google.accounts.id.intermediate.notifyParentDone

Il metodo google.accounts.id.intermediate.notifyParentClose notifica al frame principale di chiudere l'iframe intermedio e aggiornare lo stato di accesso. Vedi il seguente esempio di codice del metodo:

google.accounts.id.intermediate.notifyParentDone()

Metodo: google.accounts.id.intermediate.notifyParentResize

Il metodo google.accounts.id.intermediate.notifyParentResize notifica al frame principale di ridimensionare l'iframe intermedio. Vedi il seguente esempio di codice del metodo:

google.accounts.id.intermediate.notifyParentResize(height)

Nota: non puoi modificare la larghezza dell'iframe intermedio.

altezza

La nuova altezza in pixel. Questo campo è obbligatorio. Il valore deve essere un numero non negativo.

Se il parametro height è maggiore di 0, l'iframe intermedio viene impostato sulla nuova altezza. Se il parametro altezza è 0, l'iframe intermedio diventa invisibile. Un iframe nascosto non è chiuso. Può essere mostrato in un secondo momento da un'altra chiamata al metodo di ridimensionamento.

Metodo: google.accounts.id.intermediate.notifyParentTapOutsideMode

Il metodo google.accounts.id.intermediate.notifyParentTapOutsideMode comunica al frame principale se annullare l'iframe intermedio quando l'utente fa clic all'esterno dell'iframe intermedio. Vedi il seguente esempio di codice del metodo:

google.accounts.id.intermediate.notifyParentTapOutsideMode(cancel)

annulla

Questo valore booleano obbligatorio indica se annullare l'iframe intermedio quando l'utente fa clic all'esterno dell'iframe intermedio.