Method: accounts.resetPassword

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

string

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

string

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

string

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

string

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

string

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 (OobReqType),
  "mfaInfo": {
    object (MfaEnrollment)
  }
}
Campos
kind
(deprecated)

string

email

string

El correo electrónico asociado con el código fuera de banda que se usó

newEmail

string

requestType

enum (OobReqType)

mfaInfo

object (MfaEnrollment)

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.