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"

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.

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)

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.