Method: projects.accounts.lookup

取得所有比對成功的帳戶資訊。針對使用者要求，擷取使用者的帳戶。如果是使用 Google OAuth 2.0 憑證的管理員要求，則會根據符合條件的一或多個帳戶進行擷取。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
targetProjectId

string

由 tenantId 指定的帳戶或 Identity Platform 租用戶所屬的 Google Cloud 專案 ID。只有具備 Google OAuth 2.0 憑證且具有適當權限的已驗證要求，才能指定此屬性。

授權需要指定資源 targetProjectId 的下列 IAM 權限：

  • firebaseauth.users.get

要求主體

要求主體包含下列結構的資料：

JSON 表示法 
{
  "idToken": string,
  "localId": [
    string
  ],
  "email": [
    string
  ],
  "delegatedProjectNumber": string,
  "phoneNumber": [
    string
  ],
  "federatedUserId": [
    {
      object (FederatedUserIdentifier)
    }
  ],
  "tenantId": string,
  "initialEmail": [
    string
  ]
}
欄位
idToken

string

要擷取的帳戶 Identity Platform ID 權杖。必須為使用者提出的要求指定此值。
localId[]

string

要擷取的一或多個帳戶 ID。只有具備 Google OAuth 2.0 憑證且具有適當權限的已驗證要求，才能指定此屬性。
email[]

string

要擷取的一或多個帳戶的電子郵件地址。電子郵件長度不得超過 256 個半形字元，格式為 [email protected]。電子郵件也應符合 RFC 822 的 addr-spec 產生方式。應僅由開發人員透過經過驗證的要求指定。
delegatedProjectNumber
(deprecated)

string (int64 format)
phoneNumber[]

string

要擷取的一或多個帳戶的電話號碼。應僅由開發人員透過經過驗證的要求指定，且應採用 E.164 格式，例如 +15555555555。
federatedUserId[]

object (FederatedUserIdentifier)
tenantId

string

帳戶所屬租用戶的 ID。應僅由開發人員透過經過驗證的要求指定。
initialEmail[]

string

要擷取的一或多個帳戶的初始電子郵件。電子郵件長度不得超過 256 個半形字元，格式為 [email protected]。電子郵件也應符合 RFC 822 的 addr-spec 產生方式。應僅由開發人員透過經過驗證的要求指定。

回應主體

如果成功，回應主體會包含 GetAccountInfoResponse 的執行個體。

授權範圍

需要下列其中一種 OAuth 範圍：

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

詳情請參閱 Authentication Overview。