API Intermediate Iframe Support JavaScript

In questa pagina di riferimento viene descritta l'API Intermediate iframe Support JavaScript, che consente di modificare l'iframe intermedio nell'esperienza utente successiva.

Per informazioni su come utilizzare iframe intermedi, consulta la guida Integrare un tocco con un iframe.

Nella tabella seguente sono elencati tutti i metodi disponibili e i relativi comportamenti.

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

Carica la libreria JavaScript di supporto per iframe intermedio

Inserisci il seguente snippet di codice in qualsiasi pagina 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 riportato di seguito:

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

L'esempio di codice seguente mostra come mostrare la UI solo dopo la verifica dell'origine padre:

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

Nella tabella seguente sono elencati i parametri:

Parametro
origins	Le origini autorizzate a incorporare l'iframe intermedio.
verifiedCallback	Il metodo di callback JavaScript attivato quando l'origine principale corrente può 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 seguente tabella:

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

Nella tabella seguente sono elencati i tipi di valori supportati e le relative descrizioni.

Tipi di valore
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"

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

callback verificato

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

verificaNon riuscitoRichiama

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 all'infinito. In questo caso, non è stato richiamato né verifiedCallback né verificationFailedCallback.

Metodo: google.accounts.id.intermediate.notifyParentClose

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

google.accounts.id.intermediate.notifyParentClose()

Metodo: google.accounts.id.intermediate.notifyParentFatto

Il metodo google.accounts.id.intermediate.notifyParentClose 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)

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 di altezza è maggiore di 0, l'iframe intermedio viene impostato sulla nuova altezza. Se il parametro di 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 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 riportato di seguito:

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.