Questa pagina di riferimento descrive l'API JavaScript di supporto per iframe intermedi, utilizzata da One Tap per manipolare l'iframe intermedio nella UX 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 One Tap è stato saltato |
notifyParentDone |
notifica al frame principale che il flusso UX di One Tap è terminato |
notifyParentResize |
Invia una notifica al frame principale per 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 per iframe intermedi
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 l'esempio di codice del metodo che segue:
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. |
origins
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 singolo URI di 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 saltato. Vedi l'esempio di codice del metodo che segue:
google.accounts.id.intermediate.notifyParentClose()
Metodo: google.accounts.id.intermediate.notifyParentDone
Il metodo google.accounts.id.intermediate.notifyParentDone comunica 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 comunica 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 height è 0, l'iframe intermedio diventa invisibile. Un iframe nascosto non è chiuso. Può essere mostrato in un secondo momento tramite un'altra chiamata al metodo di ridimensionamento.
Metodo: google.accounts.id.intermediate.notifyParentTapOutsideMode
Il metodo google.accounts.id.intermediate.notifyParentTapOutsideMode indica al frame principale se annullare l'iframe intermedio quando l'utente fa clic al di fuori dell'iframe intermedio. Vedi l'esempio di codice del metodo che segue:
google.accounts.id.intermediate.notifyParentTapOutsideMode(cancel)
annulla
Questo valore booleano obbligatorio indica se annullare l'iframe intermedio quando l'utente fa clic al di fuori dell'iframe intermedio.