Method: accounts.resetPassword

Redefinir a senha de uma conta usando um código externo gerado por sendOobCode ou especificando o e-mail e a senha da conta a ser modificada. Também é possível verificar a finalidade de um código fora da banda sem consumi-lo.

Solicitação HTTP

POST https://identitytoolkit.googleapis.com/v1/accounts:resetPassword

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "oobCode": string,
  "newPassword": string,
  "oldPassword": string,
  "email": string,
  "tenantId": string
}
Campos
oobCode

string

Um código fora de banda (OOB, na sigla em inglês) gerado pela solicitação accounts.sendOobCode. Especifique apenas esse parâmetro (ou apenas esse parâmetro e um ID de locatário) para receber o tipo de código fora da banda na resposta sem mudar o estado da conta. Somente um código PASSWORD_RESET fora da banda pode ser consumido por esse método.
newPassword

string

A nova senha que será definida para essa conta. A especificação desse campo resultará em uma mudança na conta e consumirá o código fora da banda, se um tiver sido especificado e for do tipo PASSWORD_RESET.
oldPassword

string

A senha atual da conta que será modificada. Especifique esse e-mail para mudar a senha de uma conta sem usar um código externo.
email

string

Opcional. O e-mail da conta que será modificado. Especifique esse código e a senha antiga para mudar a senha de uma conta sem usar um código externo.
tenantId

string

Opcional. O ID do locatário do Identity Platform ao qual a conta pertence.

Corpo da resposta

Mensagem de resposta para accounts.resetPassword.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "kind": string,
  "email": string,
  "newEmail": string,
  "requestType": enum (OobReqType),
  "mfaInfo": {
    object (MfaEnrollment)
  }
}
Campos
kind
(deprecated)

string
email

string

O e-mail associado ao código fora da banda que foi usado.
newEmail

string
requestType

enum (OobReqType)
mfaInfo

object (MfaEnrollment)

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/identitytoolkit
  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte Authentication Overview.