Method: projects.accounts.lookup

Ruft Kontoinformationen für alle übereinstimmenden Konten ab. Ruft für eine Endnutzeranfrage das Konto des Endnutzers ab. Ruft bei einer Administratoranfrage mit Google OAuth 2.0-Anmeldedaten ein oder mehrere Konten mit übereinstimmenden Kriterien ab.

HTTP-Anfrage

POST https://identitytoolkit.googleapis.com/v1/projects/{targetProjectId}/accounts:lookup

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
targetProjectId

string

Die ID des Google Cloud-Projekts, zu dem das Konto oder der mit tenantId angegebene Identity Platform-Mandant gehört. Sollte nur von authentifizierten Anfragen mit Google OAuth 2.0-Anmeldedaten mit den richtigen Berechtigungen angegeben werden.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource targetProjectId erforderlich:

  • firebaseauth.users.get

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "idToken": string,
  "localId": [
    string
  ],
  "email": [
    string
  ],
  "delegatedProjectNumber": string,
  "phoneNumber": [
    string
  ],
  "federatedUserId": [
    {
      object (FederatedUserIdentifier)
    }
  ],
  "tenantId": string,
  "initialEmail": [
    string
  ]
}
Felder
idToken

string

Das Identity Platform-ID-Token des abzurufenden Kontos. Muss für Anfragen von Endnutzern angegeben werden.
localId[]

string

Die ID eines oder mehrerer Konten, die abgerufen werden sollen. Sollte nur von authentifizierten Anfragen mit Google OAuth 2.0-Anmeldedaten mit den richtigen Berechtigungen angegeben werden.
email[]

string

Die E-Mail-Adresse eines oder mehrerer Konten, die abgerufen werden sollen. Die E-Mail-Adresse darf maximal 256 Zeichen lang sein und muss im Format name@domain.tld sein. Die E-Mail-Adresse muss außerdem der RFC 822-Adressenspezifikation entsprechen. Sollte nur in authentifizierten Anfragen von einem Entwickler angegeben werden.
delegatedProjectNumber
(deprecated)

string (int64 format)
phoneNumber[]

string

Die Telefonnummer eines oder mehrerer Konten, die abgerufen werden sollen. Sollte nur in authentifizierten Anfragen von einem Entwickler angegeben werden und muss im E.164-Format sein, z. B. +15555555555.
federatedUserId[]

object (FederatedUserIdentifier)
tenantId

string

Die ID des Mandanten, zu dem das Konto gehört. Sollte nur in authentifizierten Anfragen von einem Entwickler angegeben werden.
initialEmail[]

string

Die erste E-Mail-Adresse eines oder mehrerer abzurufender Konten. Die E-Mail-Adresse darf maximal 256 Zeichen lang sein und muss im Format name@domain.tld sein. Die E-Mail-Adresse muss außerdem der RFC 822-Adressenspezifikation entsprechen. Sollte nur in authentifizierten Anfragen von einem Entwickler angegeben werden.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von GetAccountInfoResponse.

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.