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" |
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.
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)
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.