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
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
yhttps://*.co.uk
no son válidos; Como se indicó anteriormente,"https://*.example.com"
coincidirá conexample.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 dominiosexample1.com
,example2.com
y subdominios deexample2.com
- Los dominios comodín deben comenzar con un esquema https:// seguro.
"*.example.com"
se considerará no válido.
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.
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>
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:
|
isSkippedMoment() | ¿Es esta notificación para un momento omitido? |
getSkippedReason() | El motivo detallado del momento omitido. Los siguientes son valores posibles:
|
isDismissedMoment() | ¿Esta notificación es para un momento descartado? |
getDismissedReason() | El motivo detallado del despido. Los siguientes son valores posibles:
|
getMomentType() | Devuelve una cadena para el tipo de momento. Los siguientes son valores posibles:
|
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": "elisa.g.beckett@gmail.com", // 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 yhd
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); });
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.