Method: accounts.lookup

Obtiene información de la cuenta para todas las cuentas coincidentes. Para una solicitud de usuario final, recupera la cuenta del usuario final. Para una solicitud de administrador con credencial de OAuth 2.0 de Google, recupera una o varias cuentas con criterios coincidentes.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "idToken": string,
  "localId": [
    string
  ],
  "email": [
    string
  ],
  "delegatedProjectNumber": string,
  "phoneNumber": [
    string
  ],
  "federatedUserId": [
    {
      object (FederatedUserIdentifier)
    }
  ],
  "tenantId": string,
  "targetProjectId": string,
  "initialEmail": [
    string
  ]
}
Campos
idToken

string

El token de ID de Identity Platform de la cuenta que se recuperará. Se debe especificar para las solicitudes de los usuarios finales.
localId[]

string

El ID de una o más cuentas que se recuperarán. Solo deben especificarse las solicitudes autenticadas que tengan una credencial de OAuth 2.0 de Google con los permisos adecuados.
email[]

string

Es la dirección de correo electrónico de una o más cuentas que se recuperarán. La longitud del correo electrónico debe ser inferior a 256 caracteres y debe tener el formato name@domain.tld. El correo electrónico también debe coincidir con la producción de addr-spec de la RFC 822. Solo debe especificarse mediante solicitudes autenticadas de un desarrollador.
delegatedProjectNumber
(deprecated)

string (int64 format)
phoneNumber[]

string

Es el número de teléfono de una o más cuentas que se recuperarán. Solo debe especificarse mediante solicitudes autenticadas de un desarrollador y debe estar en formato E.164, por ejemplo, +15555555555.
federatedUserId[]

object (FederatedUserIdentifier)
tenantId

string

Es el ID del grupo de usuarios al que pertenece la cuenta. Solo debe especificarse mediante solicitudes autenticadas de un desarrollador.
targetProjectId

string

Es el ID del proyecto de Google Cloud al que pertenece la cuenta o el usuario de Identity Platform que especifica tenantId. Solo deben especificarse las solicitudes autenticadas que tengan una credencial de OAuth 2.0 de Google con los permisos adecuados.

La autorización requiere el siguiente permiso IAM en el recurso especificado targetProjectId:

  • firebaseauth.users.get
initialEmail[]

string

Es el correo electrónico inicial de una o más cuentas que se recuperarán. La longitud del correo electrónico debe ser inferior a 256 caracteres y debe tener el formato name@domain.tld. El correo electrónico también debe coincidir con la producción de addr-spec de la RFC 822. Solo debe especificarse mediante solicitudes autenticadas de un desarrollador.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de GetAccountInfoResponse.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta Authentication Overview.