Method: accounts.lookup

一致したすべてのアカウントのアカウント情報を取得します。エンドユーザーのリクエストの場合は、エンドユーザーのアカウントを取得します。Google OAuth 2.0 認証情報を含む管理者リクエストの場合、条件に一致する 1 つ以上のアカウントを取得します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現
{
  "idToken": string,
  "localId": [
    string
  ],
  "email": [
    string
  ],
  "delegatedProjectNumber": string,
  "phoneNumber": [
    string
  ],
  "federatedUserId": [
    {
      object (FederatedUserIdentifier)
    }
  ],
  "tenantId": string,
  "targetProjectId": string,
  "initialEmail": [
    string
  ]
}
フィールド
idToken

string

取得するアカウントの Identity Platform ID トークン。エンドユーザーからのリクエストで指定する必要があります。

localId[]

string

取得する 1 つ以上のアカウントの ID。適切な権限を持つ Google OAuth 2.0 認証情報を含む認証済みリクエストでのみ指定する必要があります。

email[]

string

取得する 1 つ以上のアカウントのメールアドレス。メールアドレスは 256 文字未満で、name@domain.tld の形式にする必要があります。また、メールは RFC 822 の addr-spec 本番環境と一致している必要があります。デベロッパーからの認証済みリクエストによってのみ指定する必要があります。

delegatedProjectNumber
(deprecated)

string (int64 format)

phoneNumber[]

string

取得する 1 つ以上のアカウントの電話番号。デベロッパーからの認証済みリクエストでのみ指定し、E.164 形式(+15555555555 など)で指定する必要があります。

federatedUserId[]

object (FederatedUserIdentifier)

tenantId

string

アカウントが属するテナントの ID。デベロッパーからの認証済みリクエストによってのみ指定する必要があります。

targetProjectId

string

tenantId で指定されたアカウントまたは Identity Platform テナントが属する Google Cloud プロジェクトの ID。適切な権限を持つ Google OAuth 2.0 認証情報を含む認証済みリクエストでのみ指定する必要があります。

認可には、指定されたリソース targetProjectId に対する次の IAM の権限が必要です。

  • firebaseauth.users.get
initialEmail[]

string

取得する 1 つ以上のアカウントの最初のメールアドレス。メールアドレスは 256 文字未満で、name@domain.tld の形式にする必要があります。また、メールは RFC 822 の addr-spec 本番環境と一致している必要があります。デベロッパーからの認証済みリクエストによってのみ指定する必要があります。

レスポンスの本文

成功した場合、レスポンスの本文には GetAccountInfoResponse のインスタンスが含まれます。

認可スコープ

以下のいずれかの OAuth スコープが必要です。

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

詳細については、Authentication Overview をご覧ください。