Inicie sesión con la referencia de la API de JavaScript de Google

Esta página de referencia describe la API JavaScript de inicio de sesión. Puede usar esta API para mostrar el indicador One Tap o el botón Iniciar sesión con Google en sus páginas web.

Método: google.accounts.id.initialize

El método google.accounts.id.initialize inicializa el cliente Iniciar sesión con Google según el objeto de configuración. Consulte el siguiente ejemplo de código del método:

google.accounts.id.initialize(IdConfiguration)

El siguiente ejemplo de código implementa el método google.accounts.id.initialize con una función de onload :

<script>
  window.onload = function () {
    google.accounts.id.initialize({
      client_id: 'YOUR_GOOGLE_CLIENT_ID',
      callback: handleCredentialResponse
    });
    google.accounts.id.prompt();
  };
</script>

Tipo de dato: IdConfiguration

La siguiente tabla enumera los campos y las descripciones del tipo de datos IdConfiguration :

Campo
client_id	ID de cliente de su aplicación
auto_select	Habilita la selección automática.
callback	La función de JavaScript que maneja tokens de ID. Google One Tap y el modo UX popup del botón Iniciar sesión con Google usan este atributo.
login_uri	La URL de su punto final de inicio de sesión. El modo UX de redirect del botón Iniciar sesión con Google utiliza este atributo.
native_callback	La función de JavaScript que maneja las credenciales de contraseña.
cancel_on_tap_outside	Cancela la solicitud si el usuario hace clic fuera de la solicitud.
prompt_parent_id	El ID de DOM del elemento contenedor de solicitud de One Tap
nonce	Una cadena aleatoria para tokens de ID
context	El título y las palabras en el aviso de One Tap
state_cookie_domain	Si necesita llamar a One Tap en el dominio principal y sus subdominios, pase el dominio principal a este campo para que se use una sola cookie compartida.
ux_mode	Flujo de experiencia de usuario del botón Iniciar sesión con Google
allowed_parent_origin	Los orígenes que pueden insertar el iframe intermedio. One Tap se ejecutará en el modo iframe intermedio si se presenta este campo.
intermediate_iframe_close_callback	Anula el comportamiento de iframe intermedio predeterminado cuando los usuarios cierran manualmente One Tap.
itp_support	Habilita One Tap UX actualizado en navegadores ITP.

Identificación del cliente

Este campo es el ID de cliente de su aplicación, que se encuentra y crea en Google Developers Console. Consulte la siguiente tabla para obtener más información:

Tipo	Requerido	Ejemplo
cuerda	Sí	client_id: "CLIENT_ID.apps.googleusercontent.com"

Selección automática

Este campo determina si un token de ID se devuelve automáticamente sin ninguna interacción del usuario cuando solo hay una sesión de Google que haya aprobado su aplicación anteriormente. El valor predeterminado es false . Consulte la siguiente tabla para obtener más información:

Tipo	Requerido	Ejemplo
booleano	Opcional	auto_select: true

llamar de vuelta

Este campo es la función de JavaScript que maneja el token de ID devuelto desde el aviso de One Tap o la ventana emergente. Este atributo es obligatorio si se utiliza Google One Tap o el modo UX popup del botón Iniciar sesión con Google. Consulte la siguiente tabla para obtener más información:

Tipo	Requerido	Ejemplo
función	Requerido para One Tap y el modo UX popup	callback: handleResponse

login_uri

Este atributo es el URI de su punto final de inicio de sesión. Puede omitirse si la página actual es su página de inicio de sesión, en cuyo caso la credencial se publica en esta página de forma predeterminada.

La respuesta de la credencial del token de ID se publica en su punto final de inicio de sesión cuando un usuario hace clic en el botón Iniciar sesión con Google y se utiliza el modo UX de redirección.

Consulte la siguiente tabla para obtener más información:

Tipo	Opcional	Ejemplo
URL	El valor predeterminado es el URI de la página actual o el valor que especifique. Solo se usa cuando se ux_mode: "redirect" .	login_uri="https://www.example.com/login"

Su punto final de inicio de sesión debe gestionar las solicitudes POST que contengan una clave de credential con un valor de token de ID en el cuerpo.

El siguiente es un ejemplo de solicitud a su punto final de inicio de sesión:

POST /login HTTP/1.1
Host: www.example.com
Content-Type: application/x-www-form-urlencoded

credential=ID_TOKEN

Nota: Con la API de JavaScript, la respuesta de Google One Tap y el modo UX popup del botón Iniciar sesión con Google solo se pueden devolver a la función JavaScript de callback de llamada. Pruebe la API de HTML si la respuesta debe enviarse automáticamente a login_uri .

devolución_de_llamada_nativa

Este campo es el nombre de la función de JavaScript que maneja la credencial de contraseña devuelta por el administrador de credenciales nativo del navegador. Consulte la siguiente tabla para obtener más información:

Tipo	Requerido	Ejemplo
función	Opcional	native_callback: handleResponse

cancel_on_tap_fuera

Este campo establece si cancelar o no la solicitud de un toque si un usuario hace clic fuera del indicador. El valor predeterminado es true . Puede deshabilitarlo si establece el valor en false . Consulte la siguiente tabla para obtener más información:

Tipo	Requerido	Ejemplo
booleano	Opcional	cancel_on_tap_outside: false

prompt_parent_id

Este atributo establece el ID de DOM del elemento contenedor. Si no está configurado, el indicador One Tap se muestra en la esquina superior derecha de la ventana. Consulte la siguiente tabla para obtener más información:

Tipo	Requerido	Ejemplo
cuerda	Opcional	prompt_parent_id: 'parent_id'

mientras tanto

Este campo es una cadena aleatoria utilizada por el token de ID para evitar ataques de repetición. Consulte la siguiente tabla para obtener más información:

Tipo	Requerido	Ejemplo
cuerda	Opcional	nonce: "biaqbm70g23"

La longitud de Nonce está limitada al tamaño máximo de JWT admitido por su entorno y las restricciones de tamaño HTTP del servidor y del navegador individuales.

contexto

Este campo cambia el texto del título y los mensajes en el aviso de One Tap. Consulte la siguiente tabla para obtener más información:

Tipo	Requerido	Ejemplo
cuerda	Opcional	context: "use"

La siguiente tabla enumera los contextos disponibles y sus descripciones:

Contexto
signin	"Inicia sesión con Google"
signup	"Registrarse con Google"
use	"Usar con Google"

estado_cookie_dominio

Si necesita mostrar One Tap en el dominio principal y sus subdominios, pase el dominio principal a este campo para que se use una sola cookie de estado compartido. Consulte la siguiente tabla para obtener más información:

Tipo	Requerido	Ejemplo
cuerda	Opcional	state_cookie_domain: "example.com"

modo_ux

Utilice este campo para configurar el flujo de UX utilizado por el botón Iniciar sesión con Google. El valor predeterminado es popup . Este atributo no tiene impacto en OneTap UX. Consulte la siguiente tabla para obtener más información:

Tipo	Requerido	Ejemplo
cuerda	Opcional	ux_mode: "redirect"

La siguiente tabla enumera los modos UX disponibles y sus descripciones.

Modo UX
popup	Realiza el flujo de UX de inicio de sesión en una ventana emergente.
redirect	Realiza el flujo de UX de inicio de sesión mediante una redirección de página completa.

origen_principal_permitido

Los orígenes que pueden insertar el iframe intermedio. One Tap se ejecutará en el modo iframe intermedio si se presenta este campo. Consulte la siguiente tabla para obtener más información:

Tipo	Requerido	Ejemplo
cadena o matriz de cadenas	Opcional	allowed_parent_origin: "https://example.com"

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

Tipos de valor
string	URI de un único dominio.	"https://ejemplo.com"
string array	Una matriz de URI de dominio.	["https://noticias.ejemplo.com", "https://local.ejemplo.com"]

También se admiten los prefijos comodín. Por ejemplo, "https://*.example.com" coincidirá con example.com y sus subdominios en todos los niveles (p. ej., news.example.com , login.news.example.com ). Cosas a tener en cuenta al usar comodines:

• Las cadenas de patrones no pueden estar compuestas solo por un comodín y un dominio de nivel superior. Por ejemplo https://*.com y https://*.co.uk no son válidos; Como se indicó anteriormente, "https://*.example.com" coincidirá con example.com y sus subdominios. También puede usar una matriz para representar 2 dominios diferentes. Por ejemplo, ["https://example1.com", "https://*.example2.com"] coincidirá con los dominios example1.com , example2.com y subdominios de example2.com
• Los dominios comodín deben comenzar con un esquema https:// seguro. "*.example.com" se considerará no válido.

Nota: a diferencia de la API de HTML, una cadena con URI separados por comas no es válida para el campo allowed_parent_origin . Utilice un objeto de matriz de JavaScript en su lugar.

Si el valor del campo allowed_parent_origin no es válido, la inicialización One Tap del modo iframe intermedio fallaría y se detendría.

intermedio_iframe_cerrar_devolución de llamada

Anula el comportamiento de iframe intermedio predeterminado cuando los usuarios cierran manualmente One Tap tocando el botón 'X' en la interfaz de usuario de One Tap. El comportamiento predeterminado es eliminar el iframe intermedio del DOM inmediatamente.

El campo intermediate_iframe_close_callback surte efecto solo en el modo de iframe intermedio. Y tiene impacto solo en el iframe intermedio, en lugar del iframe One Tap. La interfaz de usuario de One Tap se elimina antes de que se invoque la devolución de llamada.

Tipo	Requerido	Ejemplo
función	Opcional	intermediate_iframe_close_callback: logBeforeClose

soporte_itp

Este campo determina si One Tap UX actualizado debe habilitarse en los navegadores que admiten la prevención de seguimiento inteligente (ITP). El valor predeterminado es false . Consulte la siguiente tabla para obtener más información:

Tipo	Requerido	Ejemplo
booleano	Opcional	itp_support: true

Método: google.accounts.id.prompt

El método google.accounts.id.prompt muestra el indicador One Tap o el administrador de credenciales nativo del navegador después de invocar el método initialize() . Consulte el siguiente ejemplo de código del método:

 google.accounts.id.prompt(/**
 @type{(function(!PromptMomentNotification):void)=} */ momentListener)

Normalmente, el método prompt() se llama al cargar la página. Debido al estado de la sesión y la configuración del usuario en el lado de Google, es posible que no se muestre la interfaz de usuario de One Tap. Para recibir notificaciones sobre el estado de la interfaz de usuario en diferentes momentos, pase una función para recibir notificaciones de estado de la interfaz de usuario.

Las notificaciones se disparan en los siguientes momentos:

• Momento de visualización: Esto ocurre después de llamar al método prompt() . La notificación contiene un valor booleano para indicar si la interfaz de usuario se muestra o no.

• Momento omitido: esto ocurre cuando el aviso de One Tap se cierra mediante una cancelación automática, una cancelación manual o cuando Google no puede emitir una credencial, como cuando la sesión seleccionada se ha desconectado de Google.

  En estos casos, le recomendamos que continúe con los siguientes proveedores de identidad, si los hay.

• Momento descartado: Esto ocurre cuando Google recupera con éxito una credencial o un usuario desea detener el flujo de recuperación de la credencial. Por ejemplo, cuando el usuario comienza a ingresar su nombre de usuario y contraseña en su cuadro de diálogo de inicio de sesión, puede llamar al método google.accounts.id.cancel() para cerrar el indicador One Tap y activar un momento descartado.

  Advertencia: cuando se encuentre en un momento descartado, no intente con ninguno de los siguientes proveedores de identidad.

El siguiente ejemplo de código implementa el momento omitido:

<script>
  window.onload = function () {
    google.accounts.id.initialize(...);
    google.accounts.id.prompt((notification) => {
      if (notification.isNotDisplayed() || notification.isSkippedMoment()) {
        // continue with another identity provider.
      }
    });
  };
</script>

Nota: No le notificaremos los momentos de visualización, omisión o desestimación de la interfaz de usuario del administrador de credenciales nativo. No tenemos control sobre eso.

Tipo de dato: PromptMomentNotification

La siguiente tabla enumera métodos y descripciones del tipo de datos PromptMomentNotification :

Método
isDisplayMoment()	¿Esta notificación es para un momento de visualización?
isDisplayed()	¿Esta notificación es para un momento de visualización y se muestra la interfaz de usuario?
isNotDisplayed()	¿Esta notificación es para un momento de visualización y no se muestra la interfaz de usuario?
getNotDisplayedReason()	El motivo detallado por el que no se muestra la interfaz de usuario. Los siguientes son valores posibles: browser_not_supported invalid_client missing_client_id opt_out_or_no_session secure_http_required suppressed_by_user unregistered_origin unknown_reason
isSkippedMoment()	¿Es esta notificación para un momento omitido?
getSkippedReason()	El motivo detallado del momento omitido. Los siguientes son valores posibles: auto_cancel user_cancel tap_outside issuing_failed
isDismissedMoment()	¿Esta notificación es para un momento descartado?
getDismissedReason()	El motivo detallado del despido. Los siguientes son valores posibles: credential_returned cancel_called flow_restarted
getMomentType()	Devuelve una cadena para el tipo de momento. Los siguientes son valores posibles: display skipped dismissed

Tipo de dato: CredentialResponse

Cuando se invoca la función de callback de llamada, se pasa un objeto CredentialResponse como parámetro. La siguiente tabla enumera los campos que están contenidos en el objeto de respuesta de credencial:

Campo
credential	Este campo es el token de ID devuelto.
select_by	Este campo establece cómo se selecciona la credencial.

credencial

Este campo es el token de ID como una cadena JSON Web Token (JWT) codificada en base64.

Cuando se decodifica , el JWT se parece al siguiente ejemplo:

header
{
  "alg": "RS256",
  "kid": "f05415b13acb9590f70df862765c655f5a7a019e", // JWT signature
  "typ": "JWT"
}
payload
{
  "iss": "https://accounts.google.com", // The JWT's issuer
  "nbf":  161803398874,
  "aud": "314159265-pi.apps.googleusercontent.com", // Your server's client ID
  "sub": "3141592653589793238", // The unique ID of the user's Google Account
  "hd": "gmail.com", // If present, the host domain of the user's GSuite email address
  "email": "[e-mail]", // The user's email address
  "email_verified": true, // true, if Google has verified the email address
  "azp": "314159265-pi.apps.googleusercontent.com",
  "name": "Elisa Beckett",
                            // If present, a URL to user's profile picture
  "picture": "https://lh3.googleusercontent.com/a-/e2718281828459045235360uler",
  "given_name": "Elisa",
  "family_name": "Beckett",
  "iat": 1596474000, // Unix timestamp of the assertion's creation time
  "exp": 1596477600, // Unix timestamp of the assertion's expiration time
  "jti": "abc161803398874def"
}

El sub contiene un identificador global único para la cuenta de Google.

Con los campos email , email_verified y hd puede determinar si Google aloja y tiene autoridad para una dirección de correo electrónico. En los casos en que Google tiene autoridad, se sabe que el usuario es el propietario legítimo de la cuenta.

Casos en los que Google tiene autoridad:

• el email tiene un sufijo @gmail.com , esta es una cuenta de Gmail.
• email_verified es verdadero y hd está configurado, esta es una cuenta de G Suite.

Los usuarios pueden registrarse para cuentas de Google sin usar Gmail o G Suite. Cuando el email no contiene un sufijo @gmail.com y hd está ausente, Google no tiene autoridad y se recomiendan contraseñas u otros métodos de desafío para verificar al usuario. email_verfied también puede ser cierto, ya que Google verificó inicialmente al usuario cuando se creó la cuenta de Google; sin embargo, la propiedad de la cuenta de correo electrónico de terceros puede haber cambiado desde entonces.

seleccionar_por

La siguiente tabla enumera los valores posibles para el campo select_by . El tipo de botón utilizado junto con la sesión y el estado de consentimiento se utilizan para establecer el valor,

• El usuario presionó el botón One Tap o Iniciar sesión con Google o utilizó el proceso de inicio de sesión automático sin contacto.

• Se encontró una sesión existente o el usuario seleccionó e inició sesión en una cuenta de Google para establecer una nueva sesión.

• Antes de compartir las credenciales del token de identificación con su aplicación, el usuario

  • presionó el botón Confirmar para otorgar su consentimiento para compartir credenciales, o
  • había otorgado previamente su consentimiento y utilizó Seleccionar una cuenta para elegir una cuenta de Google.

El valor de este campo se establece en uno de estos tipos,

Valor	Descripción
auto	Inicio de sesión automático de un usuario con una sesión existente que previamente había otorgado su consentimiento para compartir credenciales.
user	Un usuario con una sesión existente que había otorgado previamente su consentimiento presionó el botón "Continuar como" de One Tap para compartir las credenciales.
user_1tap	Un usuario con una sesión existente presionó el botón 'Continuar como' de One Tap para otorgar el consentimiento y compartir las credenciales. Se aplica solo a Chrome v75 y superior.
user_2tap	Un usuario sin una sesión existente presionó el botón 'Continuar como' de One Tap para seleccionar una cuenta y luego presionó el botón Confirmar en una ventana emergente para otorgar el consentimiento y compartir las credenciales. Se aplica a navegadores no basados ​​en Chromium.
btn	Un usuario con una sesión existente que previamente otorgó su consentimiento presionó el botón Iniciar sesión con Google y seleccionó una cuenta de Google en 'Elegir una cuenta' para compartir credenciales.
btn_confirm	Un usuario con una sesión existente presionó el botón Iniciar sesión con Google y presionó el botón Confirmar para otorgar el consentimiento y compartir las credenciales.
btn_add_session	Un usuario sin una sesión existente que previamente otorgó su consentimiento presionó el botón Iniciar sesión con Google para seleccionar una cuenta de Google y compartir credenciales.
btn_confirm_add_session	Un usuario sin una sesión existente primero presionó el botón Iniciar sesión con Google para seleccionar una cuenta de Google y luego presionó el botón Confirmar para dar su consentimiento y compartir las credenciales.

Método: google.accounts.id.renderButton

El método google.accounts.id.renderButton muestra un botón Iniciar sesión con Google en sus páginas web.

Consulte el siguiente ejemplo de código del método:

google.accounts.id.renderButton(
      /** @type{!HTMLElement} */ parent,
      /** @type{!GsiButtonConfiguration} */ options
    )

Tipo de dato: GsiButtonConfiguration

La siguiente tabla enumera los campos y las descripciones del tipo de datos GsiButtonConfiguration :

Atributo
type	El tipo de botón: icono o botón estándar.
theme	El tema del botón. Por ejemplo, relleno_azul o relleno_negro.
size	El tamaño del botón. Por ejemplo, pequeño o grande.
text	El texto del botón. Por ejemplo, "Iniciar sesión con Google" o "Registrarse con Google".
shape	La forma del botón. Por ejemplo, rectangular o circular.
logo_alignment	La alineación del logotipo de Google: izquierda o centro.
width	El ancho del botón, en píxeles.
locale	Si se establece, se representa el idioma del botón.

Tipos de atributos

Las siguientes secciones contienen detalles sobre el tipo de cada atributo y un ejemplo.

tipo

El tipo de botón. El valor predeterminado es standard .

Consulte la siguiente tabla para obtener más información:

Tipo	Requerido	Ejemplo
cuerda	Sí	type: "icon"

La siguiente tabla enumera los tipos de botones disponibles y sus descripciones:

Tipo
standard	Un botón con texto o información personalizada:
icon	Un botón de icono sin texto:

temática

El tema del botón. El valor predeterminado es outline . Consulte la siguiente tabla para obtener más información:

Tipo	Requerido	Ejemplo
cuerda	Opcional	theme: "filled_blue"

La siguiente tabla enumera los temas disponibles y sus descripciones:

Temática
outline	Un tema de botón estándar:
filled_blue	Un tema de botón lleno de azul:
filled_black	Un tema de botón relleno de negro:

Talla

El tamaño del botón. El valor predeterminado es large . Consulte la siguiente tabla para obtener más información:

Tipo	Requerido	Ejemplo
cuerda	Opcional	size: "small"

La siguiente tabla enumera los tamaños de botón disponibles y sus descripciones:

Tamaño
large	Un botón grande:
medium	Un botón de tamaño mediano:
small	Un pequeño botón:

texto

El texto del botón. El valor predeterminado es signin_with . No hay diferencias visuales para el texto de los botones de iconos que tienen diferentes atributos de text . La única excepción es cuando se lee el texto para acceder a la pantalla.

Consulte la siguiente tabla para obtener más información:

Tipo	Requerido	Ejemplo
cuerda	Opcional	text: "signup_with"

La siguiente tabla enumera los textos de los botones disponibles y sus descripciones:

Texto
signin_with	El texto del botón es "Iniciar sesión con Google":
signup_with	El texto del botón es "Registrarse con Google":
continue_with	El texto del botón es "Continuar con Google":
signin	El texto del botón es "Iniciar sesión":

forma

La forma del botón. El valor predeterminado es rectangular . Consulte la siguiente tabla para obtener más información:

Tipo	Requerido	Ejemplo
cuerda	Opcional	shape: "rectangular"

La siguiente tabla enumera las formas de botón disponibles y sus descripciones:

Forma
rectangular	El botón de forma rectangular. Si se usa para el tipo de botón de icon , entonces es lo mismo que square .
pill	El botón en forma de pastilla. Si se usa para el tipo de botón de icon , entonces es lo mismo que circle .
circle	El botón en forma de círculo. Si se usa para el tipo de botón standard , entonces es lo mismo que la pill .
square	El botón de forma cuadrada. Si se usa para el tipo de botón standard , entonces es lo mismo que rectangular .

logo_alineación

La alineación del logotipo de Google. Se left el valor por defecto. Este atributo solo se aplica al tipo de botón standard . Consulte la siguiente tabla para obtener más información:

Tipo	Requerido	Ejemplo
cuerda	Opcional	logo_alignment: "center"

La siguiente tabla enumera las alineaciones disponibles y sus descripciones:

logo_alineación
left	Alinea a la izquierda el logotipo de Google.
center	Alinea al centro el logotipo de Google.

ancho

El ancho mínimo del botón, en píxeles. El ancho máximo es de 400 píxeles.

Consulte la siguiente tabla para obtener más información:

Tipo	Requerido	Ejemplo
cuerda	Opcional	width: 400

lugar

La configuración regional preestablecida del texto del botón. Si no está configurado, se usa la configuración regional predeterminada del navegador o la preferencia del usuario de la sesión de Google. Por lo tanto, diferentes usuarios pueden ver diferentes versiones de botones localizados y posiblemente con diferentes tamaños.

Consulte la siguiente tabla para obtener más información:

Tipo	Requerido	Ejemplo
cuerda	Opcional	locale: "zh_CN"

Tipo de dato: Credencial

Cuando se invoca la función native_callback , se pasa un objeto Credential como parámetro. La siguiente tabla enumera los campos contenidos en el objeto:

Campo
id	Identifica al usuario.
password	La contraseña

Método: google.accounts.id.disableAutoSelect

Cuando el usuario cierra sesión en su sitio web, debe llamar al método google.accounts.id.disableAutoSelect para registrar el estado en las cookies. Esto evita un bucle muerto de UX. Consulte el siguiente fragmento de código del método:

google.accounts.id.disableAutoSelect()

El siguiente ejemplo de código implementa el método google.accounts.id.disableAutoSelect con una función onSignout() :

<script>
  function onSignout() {
    google.accounts.id.disableAutoSelect();
  }
</script>

Método: google.accounts.id.storeCredential

Este método es un contenedor simple para el método store() de la API del administrador de credenciales nativo del navegador. Por lo tanto, solo se puede usar para almacenar una credencial de contraseña. Consulte el siguiente ejemplo de código del método:

google.accounts.id.storeCredential(Credential, callback)

El siguiente ejemplo de código implementa el método google.accounts.id.storeCredential con una función onSignIn() :

<script>
  function onSignIn() {
    let cred = {id: '...', password: '...'};
    google.accounts.id.storeCredential(cred);
  }
</script>

Método: google.accounts.id.cancel

Puede cancelar el flujo de One Tap si elimina el aviso del DOM de la parte de confianza. La operación de cancelación se ignora si ya se seleccionó una credencial. Consulte el siguiente ejemplo de código del método:

google.accounts.id.cancel()

El siguiente ejemplo de código implementa el método google.accounts.id.cancel() con una función onNextButtonClicked() :

<script>
  function onNextButtonClicked() {
    google.accounts.id.cancel();
    showPasswordPage();
  }
</script>

Devolución de llamada de carga de biblioteca: onGoogleLibraryLoad

Puede registrar una devolución de llamada onGoogleLibraryLoad . Se notifica después de que se carga la biblioteca Iniciar sesión con Google JavaScript:

window.onGoogleLibraryLoad = () => {
    ...
};

Esta devolución de llamada es solo un atajo para la devolución de llamada window.onload . No hay diferencias en el comportamiento.

El siguiente ejemplo de código implementa una devolución de llamada onGoogleLibraryLoad :

<script>
  window.onGoogleLibraryLoad = () => {
   google.accounts.id.initialize({
     ...
   });
   google.accounts.id.prompt();
  };
</script>

Método: google.accounts.id.revoke

El método google.accounts.id.revoke revoca la concesión de OAuth utilizada para compartir el token de ID para el usuario especificado. Consulte el siguiente fragmento de código del método: google.accounts.id.revoke(hint, callback)

Parámetro	Tipo	Descripción
hint	cuerda	La dirección de correo electrónico o ID único de la cuenta de Google del usuario. El ID es la sub de la carga útil de la credencial .
callback	función	Controlador de respuesta de revocación opcional.

El siguiente ejemplo de código muestra cómo usar el método de revoke con un Id.

  google.accounts.id.revoke('1618033988749895', done => {
    console.log(done.error);
  });

Punto clave: Al llamar a este método, se revocan todos los alcances de OAuth2 otorgados previamente por la biblioteca del cliente Iniciar sesión con Google.

Tipo de dato: RevocaciónRespuesta

Cuando se invoca su función de callback de llamada, se pasa un objeto RevocationResponse como parámetro. La siguiente tabla enumera los campos que están contenidos en el objeto de respuesta de revocación:

Campo
successful	Este campo es el valor de retorno de la llamada al método.
error	Este campo contiene opcionalmente un mensaje de respuesta de error detallado.

exitoso

Este campo es un valor booleano establecido en verdadero si la llamada al método de revocación tuvo éxito o falso en caso de falla.

error

Este campo es un valor de cadena y contiene un mensaje de error detallado si falla la llamada al método de revocación, no está definido en caso de éxito.