Advertencia: Estos datos se proporcionan bajo la Política de datos de usuario de Google . Por favor revise y cumpla con la política. De lo contrario, podría resultar en la suspensión del proyecto o de la cuenta.

API de JavaScript de soporte de iframe intermedio

Esta página de referencia describe la API de JavaScript de soporte de iframe intermedio, que le permite manipular el iframe intermedio en la UX posterior.

La siguiente tabla enumera todos los métodos disponibles y sus comportamientos.

Métodos
verifyParentOrigin realiza la verificación del origen principal
notifyParentClose notifica al marco principal que se omite el flujo de One Tap UX
notifyParentDone notifica al marco principal que el flujo de One Tap UX está terminado
notifyParentResize notifica al marco principal que cambie el tamaño del iframe intermedio
notifyParentTapOutsideMode notifica al marco principal si debe cancelar el iframe intermedio cuando el usuario hace clic fuera del iframe intermedio

Cargar la biblioteca JavaScript de compatibilidad con iframe intermedio

Coloque el siguiente fragmento de código en las páginas HTML donde desee cargar el iframe intermedio:

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

Método: google.accounts.id.intermediate.verifyParentOrigin

El método google.accounts.id.intermediate.verifyParentOrigin realiza la verificación del origen principal. Vea el siguiente ejemplo de código del método:

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

El siguiente ejemplo de código muestra cómo mostrar la IU solo después de verificar el origen principal:

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

La siguiente tabla enumera los parámetros:

Parámetro
origins Los orígenes que pueden incrustar el iframe intermedio.
verifiedCallback El método de devolución de llamada de JavaScript que se activará cuando el origen principal actual tenga permitido incrustar el iframe intermedio.
verificationFailedCallback El método de devolución de llamada de JavaScript que se activará cuando el origen principal actual no pueda incrustar el iframe intermedio.

orígenes

Los orígenes que pueden incrustar el iframe intermedio. Consulte la siguiente tabla para obtener más información:

Tipo Requerido Ejemplo
cadena, matriz de cadena o función Opcional allowed_parent_origin: "https://example.com"

La siguiente tabla enumera los tipos de valores admitidos y sus descripciones.

Tipos de valor
string Un URI de dominio único. "https://example.com"
string array Una matriz de URI de dominio. "https: //news.example.com,https: //local.example.com"

VerifiedCallback

Este campo es un método de devolución de llamada de JavaScript que se activará cuando el origen principal actual pueda incrustar el iframe intermedio.

verificaciónFailedCallback

Este campo es un método de devolución de llamada de JavaScript que se activará cuando el origen principal actual no pueda incrustar el iframe intermedio.

Método: google.accounts.id.intermediate.notifyParentClose

El método google.accounts.id.intermediate.notifyParentClose notifica al marco principal que cierre el iframe intermedio cuando se omite el flujo de One Tap UX. Vea el siguiente ejemplo de código del método:

google.accounts.id.intermediate.notifyParentClose()

Método: google.accounts.id.intermediate.notifyParentDone

El método google.accounts.id.intermediate.notifyParentClose notifica al marco principal que cierre el iframe intermedio y actualice el estado de inicio de sesión. Vea el siguiente ejemplo de código del método:

google.accounts.id.intermediate.notifyParentDone()

Método: google.accounts.id.intermediate.notifyParentResize

El método google.accounts.id.intermediate.notifyParentResize notifica al marco principal que google.accounts.id.intermediate.notifyParentResize el tamaño del iframe intermedio. Vea el siguiente ejemplo de código del método:

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

altura

La nueva altura en píxeles. Este es un campo obligatorio. El valor debe ser un número no negativo.

Si el parámetro de altura es mayor que 0, el iframe intermedio se establecerá en la nueva altura. Si el parámetro de altura es 0, el iframe intermedio se vuelve invisible. Un iframe oculto no está cerrado. Puede mostrarse más tarde mediante otra llamada al método de cambio de tamaño.

Método: google.accounts.id.intermediate.notifyParentTapOutsideMode

El método google.accounts.id.intermediate.notifyParentTapOutsideMode notifica al marco principal si debe cancelar el iframe intermedio cuando el usuario hace clic fuera del iframe intermedio. Vea el siguiente ejemplo de código del método:

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

cancelar

Este valor booleano obligatorio indica si se cancela el iframe intermedio cuando el usuario hace clic fuera del iframe intermedio.