Method: accounts.resetPassword

Das Passwort eines Kontos wird entweder mit einem Out-of-Band-Code zurückgesetzt, der mit sendOobCode generiert wurde, oder durch Angabe der E-Mail-Adresse und des Passworts des zu ändernden Kontos. Sie können auch den Zweck eines Out-of-Band-Codes prüfen, ohne ihn zu verwenden.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "oobCode": string,
  "newPassword": string,
  "oldPassword": string,
  "email": string,
  "tenantId": string
}
Felder
oobCode

string

Ein Out-of-Band-Code (OOB-Code), der durch die Anfrage „accounts.sendOobCode“ generiert wurde. Geben Sie nur diesen Parameter (oder nur diesen Parameter und eine Tenant-ID) an, um den Typ des Out-of-Band-Codes in der Antwort abzurufen, ohne den Status des Kontos zu ändern. Über diese Methode kann nur ein Out-of-Band-Code vom Typ PASSWORD_RESET verwendet werden.
newPassword

string

Das neue Passwort, das für dieses Konto festgelegt werden soll. Wenn Sie dieses Feld angeben, wird das Konto geändert und der Out-of-Band-Code wird verwendet, falls einer vom Typ PASSWORD_RESET angegeben wurde.
oldPassword

string

Das aktuelle Passwort des zu ändernden Kontos. Geben Sie diese und die E-Mail-Adresse an, um das Passwort eines Kontos ohne Out-of-Band-Code zu ändern.
email

string

Optional. Die E-Mail-Adresse des Kontos, das geändert werden soll. Geben Sie diese und das alte Passwort an, um das Passwort eines Kontos ohne Out-of-Band-Code zu ändern.
tenantId

string

Optional. Die Mandanten-ID des Identity Platform-Mandaten, zu dem das Konto gehört.

Antworttext

Antwortnachricht für accounts.resetPassword.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "kind": string,
  "email": string,
  "newEmail": string,
  "requestType": enum (OobReqType),
  "mfaInfo": {
    object (MfaEnrollment)
  }
}
Felder
kind
(deprecated)

string
email

string

Die E-Mail-Adresse, die mit dem verwendeten externen Code verknüpft ist.
newEmail

string
requestType

enum (OobReqType)
mfaInfo

object (MfaEnrollment)

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentication Overview.