Method: accounts.resetPassword

Reimposta la password di un account utilizzando un codice out-of-band generato da sendOobCode o specificando l'email e la password dell'account da modificare. Può anche controllare lo scopo di un codice out-of-band senza consumarlo.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "oobCode": string,
  "newPassword": string,
  "oldPassword": string,
  "email": string,
  "tenantId": string
}
Campi
oobCode

string

Un codice out-of-band (OOB) generato dalla richiesta accounts.sendOobCode. Specifica solo questo parametro (o solo questo parametro e un ID tenant) per ottenere il tipo di codice out-of-band nella risposta senza modificare lo stato dell'account. Tramite questo metodo è possibile utilizzare solo un codice PASSWORD_RESET out-of-band.

newPassword

string

La nuova password da impostare per questo account. La specifica di questo campo comporterà una modifica dell'account e utilizzerà il codice out-of-band, se specificato e di tipo PASSWORD_RESET.

oldPassword

string

La password attuale dell'account da modificare. Specifica questo indirizzo e l'indirizzo email per cambiare la password di un account senza utilizzare un codice esterno.

email

string

Facoltativo. L'indirizzo email dell'account da modificare. Specifica questo codice e la password precedente per cambiare la password di un account senza utilizzare un codice esterno.

tenantId

string

Facoltativo. L'ID del tenant di Identity Platform a cui appartiene l'account.

Corpo della risposta

Messaggio di risposta per accounts.resetPassword.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "kind": string,
  "email": string,
  "newEmail": string,
  "requestType": enum (OobReqType),
  "mfaInfo": {
    object (MfaEnrollment)
  }
}
Campi
kind
(deprecated)

string

email

string

L'email associata al codice out-of-band utilizzato.

newEmail

string

requestType

enum (OobReqType)

mfaInfo

object (MfaEnrollment)

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la sezione Authentication Overview.