Method: projects.tenants.accounts.lookup

Recupera le informazioni dell'account per tutti gli account corrispondenti. Per una richiesta di un utente finale, recupera l'account dell'utente finale. Per una richiesta di amministratore con credenziale OAuth 2.0 di Google, recupera uno o più account con criteri di corrispondenza.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
targetProjectId

string

L'ID del progetto Google Cloud a cui appartiene l'account o il tenant Identity Platform specificato da tenantId. Deve essere specificato solo dalle richieste autenticate che contengono una credenziale OAuth 2.0 di Google con le autorizzazioni appropriate.

L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata targetProjectId:

  • firebaseauth.users.get
tenantId

string

L'ID del tenant a cui appartiene l'account. Deve essere specificato solo dalle richieste autenticate di uno sviluppatore.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "idToken": string,
  "localId": [
    string
  ],
  "email": [
    string
  ],
  "delegatedProjectNumber": string,
  "phoneNumber": [
    string
  ],
  "federatedUserId": [
    {
      object (FederatedUserIdentifier)
    }
  ],
  "initialEmail": [
    string
  ]
}
Campi
idToken

string

Il token ID di Identity Platform dell'account da recuperare. Deve essere specificato per le richieste degli utenti finali.
localId[]

string

L'ID di uno o più account da recuperare. Deve essere specificato solo dalle richieste autenticate che contengono una credenziale OAuth 2.0 di Google con le autorizzazioni appropriate.
email[]

string

L'indirizzo email di uno o più account da recuperare. La lunghezza dell'email deve essere inferiore a 256 caratteri e nel formato name@domain.tld. L'email deve inoltre corrispondere alla produzione di addr-spec RFC 822. Deve essere specificato solo dalle richieste autenticate di uno sviluppatore.
delegatedProjectNumber
(deprecated)

string (int64 format)
phoneNumber[]

string

Il numero di telefono di uno o più account da recuperare. Deve essere specificato solo da richieste autenticate di uno sviluppatore e deve essere nel formato E.164, ad esempio +15555555555.
federatedUserId[]

object (FederatedUserIdentifier)
initialEmail[]

string

L'email iniziale di uno o più account da recuperare. La lunghezza dell'email deve essere inferiore a 256 caratteri e nel formato name@domain.tld. L'email deve inoltre corrispondere alla produzione di addr-spec RFC 822. Deve essere specificato solo dalle richieste autenticate di uno sviluppatore.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di GetAccountInfoResponse.

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.