Restablece la contraseña de una cuenta con un código fuera de banda que genera sendOobCode o especificando el correo electrónico y la contraseña de la cuenta que se modificará. También puede verificar el propósito de un código fuera de banda sin consumirlo.
Solicitud HTTP
POST https://identitytoolkit.googleapis.com/v1/accounts:resetPassword
La URL usa la sintaxis de la transcodificación gRPC.
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "oobCode": string, "newPassword": string, "oldPassword": string, "email": string, "tenantId": string } |
Campos | |
---|---|
oobCode |
Un código fuera de banda (OOB) que genera la solicitud accounts.sendOobCode. Especifica solo este parámetro (o solo este parámetro y un ID de inquilino) para obtener el tipo de código fuera de banda en la respuesta sin mutar el estado de la cuenta. Solo se puede consumir un código fuera de banda PASSWORD_RESET a través de este método. |
newPassword |
La contraseña nueva que se establecerá para esta cuenta. Si especificas este campo, se realizará un cambio en la cuenta y se consumirá el código fuera de banda si se especificó uno y es del tipo PASSWORD_RESET. |
oldPassword |
La contraseña actual de la cuenta que se modificará. Especifica esta información y el correo electrónico para cambiar la contraseña de una cuenta sin usar un código fuera de banda. |
email |
Opcional. El correo electrónico de la cuenta que se modificará. Especifica este valor y la contraseña anterior para cambiar la contraseña de una cuenta sin usar un código fuera de banda. |
tenantId |
Opcional. El ID del usuario de Identity Platform al que pertenece la cuenta. |
Cuerpo de la respuesta
Mensaje de respuesta para accounts.resetPassword.
Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "kind": string, "email": string, "newEmail": string, "requestType": enum ( |
Campos | |
---|---|
kind |
|
email |
El correo electrónico asociado con el código fuera de banda que se usó |
newEmail |
|
requestType |
|
mfaInfo |
|
Permisos de autorización
Se necesita uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/identitytoolkit
https://www.googleapis.com/auth/cloud-platform
Para obtener más información, consulta Authentication Overview.