Method: accounts.lookup

Recebe informações de todas as contas correspondentes. Para uma solicitação de usuário final, recupera a conta do usuário final. Para uma solicitação de administrador com a credencial do Google OAuth 2.0, recupera uma ou várias contas com critérios correspondentes.

Solicitação HTTP

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

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
{
  "idToken": string,
  "localId": [
    string
  ],
  "email": [
    string
  ],
  "delegatedProjectNumber": string,
  "phoneNumber": [
    string
  ],
  "federatedUserId": [
    {
      object (FederatedUserIdentifier)
    }
  ],
  "tenantId": string,
  "targetProjectId": string,
  "initialEmail": [
    string
  ]
}
Campos
idToken

string

O token de ID do Identity Platform da conta a ser buscado. Exija que seja especificado para solicitações de usuários finais.

localId[]

string

O ID de uma ou mais contas a serem buscadas. Só pode ser especificado por solicitações autenticadas com uma credencial do Google OAuth 2.0 com permissões adequadas.

email[]

string

O endereço de e-mail de uma ou mais contas a serem buscadas. O e-mail precisa ter menos de 256 caracteres e estar no formato name@domain.tld. O e-mail também precisa corresponder à produção de addr-spec do RFC 822. Só pode ser especificado por solicitações autenticadas de um desenvolvedor.

delegatedProjectNumber
(deprecated)

string (int64 format)

phoneNumber[]

string

O número de telefone de uma ou mais contas a serem buscadas. Só pode ser especificado por solicitações autenticadas de um desenvolvedor e precisa estar no formato E.164, por exemplo, +15555555555.

federatedUserId[]

object (FederatedUserIdentifier)

tenantId

string

O ID do locatário ao qual a conta pertence. Só pode ser especificado por solicitações autenticadas de um desenvolvedor.

targetProjectId

string

O ID do projeto do Google Cloud ao qual a conta ou o locatário do Identity Platform especificado por tenantId pertence. Só pode ser especificado por solicitações autenticadas com uma credencial do Google OAuth 2.0 com permissões adequadas.

A autorização requer a seguinte permissão do IAM no recurso especificado targetProjectId:

  • firebaseauth.users.get
initialEmail[]

string

O e-mail inicial de uma ou mais contas a serem extraídas. O e-mail precisa ter menos de 256 caracteres e estar no formato name@domain.tld. O e-mail também precisa corresponder à produção de addr-spec do RFC 822. Só pode ser especificado por solicitações autenticadas de um desenvolvedor.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de GetAccountInfoResponse.

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.