Package google.cloud.identitytoolkit.v1

索引

AccountManagementService

Identity Toolkit 的帳戶管理

BatchDeleteAccounts

rpc BatchDeleteAccounts(BatchDeleteAccountsRequest) returns (BatchDeleteAccountsResponse)

批次刪除多個帳戶。如果無法刪除帳戶,回應中就會包含錯誤資訊。這個方法會忽略不存在或在要求中重複的帳戶。

這個方法需要具備適當權限的 Google OAuth 2.0 憑證。

授權範圍

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

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

詳情請參閱 Authentication Overview

DeleteAccount

rpc DeleteAccount(DeleteAccountRequest) returns (DeleteAccountResponse)

刪除使用者帳戶。

授權範圍

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

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

詳情請參閱 Authentication Overview

DownloadAccount

rpc DownloadAccount(DownloadAccountRequest) returns (DownloadAccountResponse)

以分頁方式下載專案中所有帳戶的帳戶資訊。使用這個方法需要具備具備適當權限的 Google OAuth 2.0 憑證。此外,您還需要其他權限,才能從帳戶取得密碼雜湊、密碼鹽值和密碼版本;否則,這些欄位會遭到遮蓋。

授權範圍

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

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

詳情請參閱 Authentication Overview

GetAccountInfo

rpc GetAccountInfo(GetAccountInfoRequest) returns (GetAccountInfoResponse)

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

授權範圍

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

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

詳情請參閱 Authentication Overview

GetOobCode

rpc GetOobCode(GetOobCodeRequest) returns (GetOobCodeResponse)

傳送帳戶的額外確認碼。經過驗證的要求可以選擇傳回包含 OOB 代碼的連結,而非傳送該代碼。

授權範圍

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

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

詳情請參閱 Authentication Overview

QueryUserInfo

rpc QueryUserInfo(QueryUserInfoRequest) returns (QueryUserInfoResponse)

根據要求中的條件,查詢專案或租用戶中的使用者帳戶。

授權範圍

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

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

詳情請參閱 Authentication Overview

ResetPassword

rpc ResetPassword(ResetPasswordRequest) returns (ResetPasswordResponse)

使用 [sendOobCode][v1.accounts.sendOobCode] 產生的額外代碼,或指定要修改的帳戶電子郵件和密碼,重設帳戶密碼。也可以在不使用外部程式碼的情況下,查看其用途。

授權範圍

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

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

詳情請參閱 Authentication Overview

SetAccountInfo

rpc SetAccountInfo(SetAccountInfoRequest) returns (SetAccountInfoResponse)

透過設定特定欄位或套用動作代碼,更新指定使用者的帳戶相關資訊。我們支援管理員和使用者提出的要求。

授權範圍

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

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

詳情請參閱 Authentication Overview

UploadAccount

rpc UploadAccount(UploadAccountRequest) returns (UploadAccountResponse)

將多個帳戶上傳至 Google Cloud 專案。如果上傳一或多個帳戶時發生問題,系統會上傳其餘帳戶,並傳回錯誤清單。使用這個方法需要具備 Google OAuth 2.0 憑證,且具備適當的權限

授權範圍

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

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

詳情請參閱 Authentication Overview

AuthenticationService

Identity Toolkit 的驗證

CreateAuthUri

rpc CreateAuthUri(CreateAuthUriRequest) returns (CreateAuthUriResponse)

如果指定電子郵件 ID,系統會檢查並傳回是否有任何使用者帳戶已註冊該電子郵件地址。如果有已註冊的帳戶,就會擷取與帳戶電子郵件地址相關聯的所有供應商。

如果指定了 Identity Provider (IdP) 的供應器 ID,就會為 IdP 建立授權 URI。使用者可以前往這個 URI,透過 IdP 登入。

如要識別 Google Cloud 專案,請在要求中提供 API 金鑰

授權範圍

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

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

詳情請參閱 Authentication Overview

GetPublicKeys

rpc GetPublicKeys(Empty) returns (Struct)

擷取舊版 Identity Toolkit 權杖簽署者的公開金鑰,讓第三方驗證舊版 ID 權杖。目前僅支援 X509 PEM 憑證格式。

授權範圍

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

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

詳情請參閱 Authentication Overview

GetRecaptchaParam

rpc GetRecaptchaParam(Empty) returns (GetRecaptchaParamResponse)

取得產生 reCAPTCHA 驗證問題所需的參數。

授權範圍

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

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

詳情請參閱 Authentication Overview

IssueSamlResponse

rpc IssueSamlResponse(IssueSamlResponseRequest) returns (IssueSamlResponseResponse)

實驗功能

授權範圍

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

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

詳情請參閱 Authentication Overview

SendVerificationCode

rpc SendVerificationCode(SendVerificationCodeRequest) returns (SendVerificationCodeResponse)

傳送電話號碼驗證碼,以便使用者透過電話號碼登入。

如要將傳送給使用者的 SMS 本地化,請將 HTTP 標頭 X-Firebase-Locale 設為與使用者語言代碼相對應的語言代碼。

如要識別 Google Cloud 專案,請在要求中提供 API 金鑰

授權範圍

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

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

詳情請參閱 Authentication Overview

SignInWithCustomToken

rpc SignInWithCustomToken(SignInWithCustomTokenRequest) returns (SignInWithCustomTokenResponse)

透過交換自訂驗證權杖,讓使用者登入或註冊。使用者成功登入或註冊後,系統會為使用者發出新的 Identity Platform ID 權杖和重新整理權杖。

如要識別 Google Cloud 專案,請在要求中提供 API 金鑰

授權範圍

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

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

詳情請參閱 Authentication Overview

SignInWithGameCenter

rpc SignInWithGameCenter(SignInWithGameCenterRequest) returns (SignInWithGameCenterResponse)

使用 iOS Game Center 憑證登入或註冊使用者。如果登入成功,系統會為已驗證的使用者核發新的 Identity Platform ID 權杖和重新整理權杖。要求標頭中必須包含軟體包 ID,格式為 x-ios-bundle-identifier

如要識別 Google Cloud 專案,請在要求中提供 API 金鑰

Apple 已淘汰 playerID 欄位。Apple 平台 Firebase SDK 會從 10.5.0 以上版本開始使用 gamePlayerIDteamPlayerID。升級至 SDK 10.5.0 以上版本後,使用 playerID 的現有整合作業會改為使用 gamePlayerIDteamPlayerID。呼叫 signInWithGameCenter 時,您必須將 playerID 與新欄位 gamePlayerIDteamPlayerID 一併納入,才能順利識別所有現有使用者。

將現有的 Game Center 登入整合功能升級至 SDK 10.5.0 以上版本後,便無法再將其降級。

授權範圍

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

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

詳情請參閱 Authentication Overview

SignInWithIdp

rpc SignInWithIdp(SignInWithIdpRequest) returns (SignInWithIdpResponse)

使用身分識別提供者 (IdP) 的憑證,登入或註冊使用者。方法是手動提供 IdP 憑證,或是透過 CreateAuthUri 的授權要求取得授權回應。如果登入成功,系統會為已驗證的使用者核發新的 Identity Platform ID 權杖和重新整理權杖。

如果使用者先前未使用相同帳戶登入 IdP,系統就會建立新的 Identity Platform 使用者帳戶。此外,如果啟用「每個電子郵件地址只能建立一個帳戶」設定,則新使用者帳戶的電子郵件地址不得與現有的 Identity Platform 使用者帳戶相同。

如要識別 Google Cloud 專案,請在要求中提供 API 金鑰

授權範圍

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

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

詳情請參閱 Authentication Overview

SignInWithPassword

rpc SignInWithPassword(SignInWithPasswordRequest) returns (SignInWithPasswordResponse)

使用電子郵件地址和密碼登入使用者。如果登入成功,系統會為已驗證的使用者核發新的 Identity Platform ID 權杖和重新整理權杖。

如要識別 Google Cloud 專案,請在要求中提供 API 金鑰

授權範圍

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

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

詳情請參閱 Authentication Overview

SignInWithPhoneNumber

rpc SignInWithPhoneNumber(SignInWithPhoneNumberRequest) returns (SignInWithPhoneNumberResponse)

完成電話號碼驗證嘗試。如果使用者已使用指定的電話號碼,系統會為該使用者鑄造 ID 權杖。否則,系統會建立新使用者並與電話號碼建立關聯。您也可以使用這個方法,將電話號碼連結至現有使用者。

如要將傳送給使用者的 SMS 本地化,請將 HTTP 標頭 X-Firebase-Locale 設為與使用者語言代碼相對應的語言代碼。

如要識別 Google Cloud 專案,請在要求中提供 API 金鑰

授權範圍

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

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

詳情請參閱 Authentication Overview

SignUp

rpc SignUp(SignUpRequest) returns (SignUpResponse)

註冊新的電子郵件和密碼使用者或匿名使用者,或將匿名使用者升級為電子郵件和密碼使用者。如果管理員要求具備適當權限的 Google OAuth 2.0 憑證,系統會建立新的匿名使用者、電子郵件和密碼使用者,或電話號碼使用者。

如要識別 Google Cloud 專案,請在要求中提供 API 金鑰

授權範圍

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

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

詳情請參閱 Authentication Overview

VerifyIosClient

rpc VerifyIosClient(VerifyIosClientRequest) returns (VerifyIosClientResponse)

驗證 iOS 用戶端是否為實際的 iOS 裝置。如果要求有效,回應中就會傳送收據,並透過 Apple 推播通知服務傳送密鑰。用戶端應在後續呼叫 (例如 /accounts:sendVerificationCode) 中將這兩者傳回至特定 Identity Platform API,以便驗證用戶端。要求標頭中必須包含軟體包 ID,格式為 x-ios-bundle-identifier

如要識別 Google Cloud 專案,請在要求中提供 API 金鑰

授權範圍

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

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

詳情請參閱 Authentication Overview

ProjectConfigService

Identity Toolkit 的專案設定

GetProjectConfig

rpc GetProjectConfig(GetProjectConfigRequest) returns (GetProjectConfigResponse)

取得專案的公開 Identity Toolkit 設定。(已淘汰) 這個方法也支援開發人員透過驗證的呼叫,擷取非公開設定。

授權範圍

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

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

詳情請參閱 Authentication Overview

SessionManagementService

Identity Platform 的工作階段管理。

CreateSessionCookie

rpc CreateSessionCookie(CreateSessionCookieRequest) returns (CreateSessionCookieResponse)

為指定的 Identity Platform ID 權杖建立工作階段 Cookie。用戶端會使用工作階段 Cookie 來保留使用者的登入狀態。

授權範圍

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

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

詳情請參閱 Authentication Overview

GetSessionCookiePublicKeys

rpc GetSessionCookiePublicKeys(Empty) returns (GetSessionCookiePublicKeysResponse)

擷取工作階段 Cookie JSON Web Token (JWT) 簽署者的公開金鑰組合,可用於驗證透過 [createSessionCookie][v1.projects.createSessionCookie] 建立的工作階段 Cookie。

Argon2Parameters

Argon2 雜湊演算法的參數。

欄位
hash_length_bytes

int32

這是必要旗標,所需雜湊長度 (以位元組為單位)。最小值為 4,最大值為 1024。

hash_type

HashType

這是必要旗標,不得為 HASH_TYPE_UNSPECIFIED。

parallelism

int32

這是必要旗標,平行處理作業程度,也稱為執行緒或車道。最少 1 個,最多 16 個。

iterations

int32

這是必要旗標,要執行的疊代次數。最少 1 個,最多 16 個。

memory_cost_kib

int32

這是必要旗標,以千字節為單位的記憶體成本。上限為 32768。

version

Version

Argon2 演算法的版本。如未指定,預設值為 VERSION_13。

associated_data

bytes

如果提供額外的相關資料,系統會附加至雜湊值,提供額外的安全防護。如果是透過 JSON 指定的值,則為 Base64 編碼的字串。

HashType

演算法的類型。

列舉
HASH_TYPE_UNSPECIFIED 未指定雜湊類型。
ARGON2_D Argon2 變化版本 Argon2d。
ARGON2_ID Argon2 變化版本 Argonid。(建議)。
ARGON2_I Argon2 變體版本 Argon2i。

版本

演算法的版本。

列舉
VERSION_UNSPECIFIED 未指定版本。
VERSION_10 舊版本 0x10。
VERSION_13 目前的版本為 0x13。版本的預設值。

BatchDeleteAccountsRequest

BatchDeleteAccounts 要求訊息。

欄位
target_project_id

string

如果指定 tenant_id,則為 Identity Platform 租用戶所屬 Google Cloud 專案的 ID。否則,則為帳戶所屬 Google Cloud 專案的 ID。

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

  • firebaseauth.users.delete
local_ids[]

string

這是必要旗標,要刪除的使用者 ID 清單。

force

bool

是否強制刪除未停用的帳戶。如果為 false,系統只會刪除已停用的帳戶,並將未停用的帳戶新增至 errors

tenant_id

string

如果帳戶屬於 Identity Platform 租戶,則為租戶的 ID。如果帳戶屬於預設 Identity Platform 專案,則不需要這個欄位。

BatchDeleteAccountsResponse

回覆訊息,用於 BatchDeleteAccounts。

欄位
errors[]

BatchDeleteErrorInfo

無法刪除的帳戶詳細錯誤資訊。

BatchDeleteErrorInfo

無法刪除帳戶的錯誤資訊。

欄位
index

int32

原始 local_ids 欄位中錯誤項目的索引。

local_id

string

對應的使用者 ID。

error_message

string

詳細的錯誤訊息。

ClientType

用戶端的平台類型:網頁、Android 或 iOS。

列舉
CLIENT_TYPE_UNSPECIFIED 未指定用戶端類型。
CLIENT_TYPE_WEB 用戶端類型為網頁。
CLIENT_TYPE_ANDROID 用戶端類型為 Android。
CLIENT_TYPE_IOS 用戶端類型為 ios。

CreateAuthUriRequest

CreateAuthUri 的要求訊息。

欄位
identifier

string

要擷取相關供應商的使用者帳戶電子郵件 ID。必須設定至少一個 identifierprovider_id 欄位。

電子郵件地址的長度不得超過 256 個半形字元,格式為 [email protected]。電子郵件地址也應符合 RFC 822 addr-spec 產生內容。

continue_uri

string

IdP 將使用者重新導向的有效網址。網址不得含有片段或保留的 state 查詢參數。

openid_realm
(deprecated)

string

provider_id

string

使用者用於登入的 IdP 供應器 ID。這應該是已啟用登入功能的供應商 ID,可從預設支援的 IdP清單中找到,或採用 oidc.*saml.* 格式。例如 google.comfacebook.comoidc.testappsaml.testapp。必須設定至少一個 identifierprovider_id 欄位。

oauth_consumer_key
(deprecated)

string

oauth_scope

string

其他以空格分隔的 OAuth 2.0 範圍,用於指定與 IdP 的驗證要求範圍。用於 OAuth 2.0 IdP。

如果是 Google 供應器,則會在設定這個欄位時使用授權碼流程。

context

string

不透明字串,用於在驗證要求和 IdP 的回呼之間維持背景資訊。

ota_app
(deprecated)

string

app_id
(deprecated)

string

hosted_domain

string

用於 Google 供應器。使用者的 G Suite 代管網域,用於限制登入該網域的使用者。

session_id

string

可在 SignInWithIdp 中驗證的工作階段 ID,以防範工作階段固定攻擊。如果未提供,系統會產生隨機字串,並以工作階段 ID 的形式傳回。

auth_flow_type

string

用於 Google 供應器。要使用的驗證流程類型。如果存在,則應為 CODE_FLOW,以便指定授權碼流程。否則會使用預設的 ID 權杖流程。

custom_parameter

map<string, string>

要新增至授權 URI 的其他自訂查詢參數。下列參數為保留參數,無法新增:client_idresponse_typescoperedirect_uristate

針對 Microsoft 提供者,您可以在 tenant 自訂參數中指定要登入的 Azure AD 租用戶。

tenant_id

string

要建立授權 URI 或查詢電子郵件 ID 的 Identity Platform 租戶 ID。如果未設定,系統會在專案中的預設 Identity Platform 例項中執行這項作業。

CreateAuthUriResponse

CreateAuthUri 的回應訊息。

欄位
kind
(deprecated)

string

auth_uri

string

要求的供應商授權 URI。只有在要求中設定了供應商 ID 時才會顯示。

all_providers[]
(deprecated)

string

registered

bool

電子郵件 ID 是否代表現有帳戶。只有在要求中設定電子郵件 ID 時才會出現。

provider_id

string

來自要求的提供者 ID (如有提供)。

for_existing_provider

bool

指出使用者是否曾以要求中的提供者 ID 登入。只有在要求中設定已註冊的電子郵件 ID 時才會出現。

captcha_required

bool

使用者嘗試登入失敗次數過多,是否需要輸入人機驗證。只有在要求中設定已註冊的電子郵件 ID 時才會出現。

session_id

string

要求中的會話 ID,如果沒有,則為 CreateAuthUri 產生的隨機字串。可用來防範工作階段固定攻擊。

signin_methods[]

string

使用者先前使用的登入方式清單。每個元素都是 passwordemailLink 或 IdP 的供應商 ID 之一。只有在要求中設定已註冊的電子郵件 ID 時才會出現。如果啟用電子郵件列舉防護,這個方法會傳回空白清單。

CreateSessionCookieRequest

CreateSessionCookie 的要求訊息。

欄位
id_token

string

這是必要旗標,有效的 Identity Platform ID 權杖。

valid_duration

int64

工作階段 Cookie 到期前的秒數。以秒為單位指定時間長度,範圍為 5 分鐘至 14 天 (含兩者)。

target_project_id

string

帳戶所屬專案的 ID。

tenant_id

string

帳戶所屬 Identity Platform 租戶的租戶 ID。

CreateSessionCookieResponse

CreateSessionCookie 的回應訊息。

欄位

DeleteAccountRequest

DeleteAccount 要求訊息。

欄位
local_id

string

要刪除的使用者帳戶 ID。如要指定這個欄位,您必須具備具備適當權限的 Google OAuth 2.0 憑證。缺少憑證的使用者應改為傳送 ID 權杖。

delegated_project_number
(deprecated)

int64

id_token

string

要刪除的帳戶的 Identity Platform ID 權杖。對於缺少 Google OAuth 2.0 憑證的使用者所提出的要求,必須指定此屬性。驗證要求中如果包含具備適當權限的 Google OAuth2 憑證,則可以傳遞 local_id,以便指定要刪除的帳戶。

tenant_id

string

帳戶所屬租用戶的 ID (如適用)。只有在經過驗證的請求中,如果有 Google OAuth 2.0 憑證,並指定屬於 Identity Platform 租用戶的帳戶 local_id,才需要指定此值。

target_project_id

string

帳戶所屬專案的 ID。僅應在指定帳戶 local_id 的驗證要求中指定。

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

  • firebaseauth.users.delete

DeleteAccountResponse

DeleteAccount 的回應訊息。

欄位
kind
(deprecated)

string

DownloadAccountRequest

DownloadAccount 的請求訊息

欄位
delegated_project_number
(deprecated)

int64

next_page_token

string

先前要求回應中的分頁符記。

max_results

int32

要傳回的結果數上限。下限值為 1,上限值為 1000。預設值為 20。

target_project_id

string

如果指定 tenant_id,則為 Identity Platform 租用戶所屬 Google Cloud 專案的 ID。否則,則為帳戶所屬 Google Cloud 專案的 ID。

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

  • firebaseauth.users.get
tenant_id

string

帳戶所屬的 Identity Platform 租用戶 ID。如未指定,系統會傳回 Identity Platform 專案中的帳戶。

DownloadAccountResponse

DownloadAccount 的回應訊息。

欄位
kind
(deprecated)

string

users[]

UserInfo

屬於專案/租用戶的所有帳戶,受限於要求中的 max_results。

next_page_token

string

如果還有其他帳戶需要下載,則可傳回至 DownloadAccount 的符記,以便取得更多帳戶。否則,此欄為空白。

EmailInfo

電子郵件 MFA 相關資訊。

欄位
email_address

string

應傳送多重認證驗證碼的電子郵件地址。

EmailTemplate

電子郵件範本

欄位
disabled

bool

是否停用範本。如果為 true,系統會使用預設範本。

from

string

電子郵件寄件地址

body

string

電子郵件內文

subject

string

電子郵件主旨

from_display_name

string

起點顯示名稱

format

EmailBodyFormat

電子郵件內文格式

reply_to

string

回覆地址

from_local_part

string

寄件者地址的本機部分

locale

string

值採用 III 語言代碼格式 (例如「zh-CN」、「es」)。系統接受「-」和「_」分隔符。

customized

bool

電子郵件內文或主旨是否為自訂內容。

EmailBodyFormat

電子郵件內文格式

列舉
EMAIL_BODY_FORMAT_UNSPECIFIED 預設值。請勿使用。
PLAINTEXT 電子郵件內文採用純文字格式。
HTML 電子郵件內文採用 HTML 格式。

ErrorInfo

錯誤資訊,說明帳戶無法上傳的原因。批次上傳。

欄位
index

int32

項目的索引,範圍為 [0, request.size - 1]

error_message

string

詳細的錯誤訊息

GetAccountInfoRequest

GetAccountInfo 的要求訊息。

欄位
id_token

string

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

local_id[]

string

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

email[]

string

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

delegated_project_number
(deprecated)

int64

phone_number[]

string

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

federated_user_id[]

FederatedUserIdentifier

tenant_id

string

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

target_project_id

string

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

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

  • firebaseauth.users.get
initial_email[]

string

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

FederatedUserIdentifier

在 Identity Provider 中的聯合使用者 ID。

欄位
provider_id

string

支援的識別資訊提供者的 ID。這應該是已啟用登入功能的供應商 ID,可從預設支援的 IdP清單中找到,或採用 oidc.*saml.* 格式。例如 google.comfacebook.comoidc.testappsaml.testapp

raw_id

string

provider_id 指定的第三方識別資訊提供者帳戶使用者 ID。

GetAccountInfoResponse

GetAccountInfo 的回應訊息。

欄位
kind
(deprecated)

string

users[]

UserInfo

與要求中參數相符的特定使用者帳戶資訊。

GetOobCodeRequest

GetOobCode 的要求訊息。

欄位
req_type

OobReqType

這是必要旗標,要傳送的非頻道 (OOB) 碼類型。視這個值而定,這項要求中的其他欄位將為必填欄位,且/或具有不同的含義。系統可傳送 4 種不同的 OOB 驗證碼:* PASSWORD_RESET * EMAIL_SIGNIN * VERIFY_EMAIL * VERIFY_AND_CHANGE_EMAIL

email

string

要傳送 OOB 代碼的帳戶電子郵件地址,通常是需要更新的帳戶電子郵件地址。此參數適用於 PASSWORD_RESET、EMAIL_SIGNIN 和 VERIFY_EMAIL。只有在 return_oob_link 設為 true 時,才需要提供 VERIFY_AND_CHANGE_EMAIL 要求。在本例中,這會是使用者的原始電子郵件地址。

challenge
(deprecated)

string

captcha_resp

string

對於 PASSWORD_RESET 要求,如果系統偵測到可能的濫用活動,就必須提供 reCaptcha 回應。在這種情況下,這是 reCAPTCHA 驗證問題的回應,用於驗證呼叫端。

user_ip

string

呼叫端的 IP 位址。只有 PASSWORD_RESET 要求需要提供。

new_email

string

帳戶更新後的電子郵件地址。僅適用於 VERIFY_AND_CHANGE_EMAIL 要求。

id_token

string

帳戶的 ID 權杖。除非 return_oob_link 設為 true,否則必須為 VERIFY_AND_CHANGE_EMAIL 和 VERIFY_EMAIL 要求提供。

continue_url

string

使用者點選電子郵件中傳送的連結後,要繼續執行的網址。這個網址可讓網頁小工具處理 OOB 代碼。

ios_bundle_id

string

如果相關聯的 iOS 應用程式可以處理 OOB 代碼,則為該應用程式的 iOS 軟體包 ID。這樣一來,如果已安裝正確的應用程式,系統就會開啟該應用程式。

ios_app_store_id

string

如果相關聯的 iOS 應用程式可以處理 OOB 代碼,則為該應用程式的 App Store ID。這樣一來,如果應用程式尚未安裝,App Store 就會開啟正確的應用程式。

android_package_name

string

如果相關聯的 Android 應用程式可以處理 OOB 代碼,則在使用此 OOB 代碼時,會處理回呼的 Android 應用程式 Android 套件名稱。這樣一來,系統就能開啟正確的應用程式 (如果已安裝),或開啟 Google Play 商店,讓使用者安裝正確的應用程式。

android_install_app

bool

如果相關聯的 Android 應用程式可以處理 OOB 程式碼,則在開啟連結的裝置上安裝 Android 應用程式 (如果尚未安裝)。

android_minimum_version_code

string

如果相關聯的 Android 應用程式可處理 OOB 代碼,則為應用程式的最低版本。如果裝置上的版本低於此版本,使用者就會前往 Google Play 商店升級應用程式。

can_handle_code_in_app

bool

如果設為 true,系統會以通用連結或 Android 應用程式連結傳送 OOB 程式碼連結,並由已安裝的對應應用程式開啟。如果未設定或設為 false,系統會先將 OOB 代碼傳送至網頁小工具,然後在繼續時將重新導向至已安裝的應用程式。

tenant_id

string

帳戶所屬 Identity Platform 租戶的租戶 ID。

target_project_id

string

帳戶所屬 Identity Platform 專案的專案 ID。如要指定這個欄位,您必須具備具備適當權限的 Google OAuth 2.0 憑證。

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

  • firebaseauth.users.sendEmail
client_type

ClientType

用戶端類型:網頁、Android 或 iOS。啟用 reCAPTCHA Enterprise 防護功能時必須提供。

recaptcha_version

RecaptchaVersion

captcha_response 中 reCAPTCHA 權杖的 reCAPTCHA 版本。

GetOobCodeResponse

GetOobCode 的回應訊息。

欄位
kind
(deprecated)

string

oob_code

string

如果要求中的 return_oob_link 為 true,則傳送的 OOB 代碼。

email

string

如果要求中的 return_oob_link 為 false,則為驗證連結傳送至的電子郵件地址。

GetProjectConfigRequest

GetProjectconfig 的要求訊息。

欄位
delegated_project_number

int64

委派專案要求的專案編號。這個欄位僅應用於 Firebase 1.0 遷移作業。

project_number

int64

要擷取的設定專案編號。這個欄位已淘汰,新整合項目不應使用。

android_package_name

string

要與實際 Android 套件名稱進行比對的 Android 套件名稱。如果您提供這個欄位,但未提供 sha1_cert_hash,且這個欄位不符合實際的 Android 套件名稱,則動作會擲回錯誤。

ios_bundle_id

string

iOS 軟體包 ID,用於比對實際的 iOS 軟體包 ID。如果提供這個欄位,如果這個欄位不符合實際的 iOS 套件 ID,這個動作就會擲回錯誤。

client_id

string

RP OAuth 用戶端 ID。如果已設定,系統會執行檢查,確保 OAuth 用戶端適用於擷取的專案,如果不符合要求,則會拒絕要求並顯示用戶端錯誤。

sha1_cert

string

SHA-1 Android 應用程式憑證雜湊。如果已設定,系統會執行檢查,確保憑證雜湊值對於擷取的專案和 android_package_name 有效。

firebase_app_id

string

Firebase 應用程式 ID (適用於使用 Firebase 的應用程式)。您可以在專案的 Firebase 控制台中找到這項資訊。如果已設定,系統會執行檢查,確保應用程式 ID 適用於擷取的專案。如果無效,系統會拒絕要求,並傳回用戶端錯誤。

GetProjectConfigResponse

GetProjectConfig 的回應訊息。

欄位
project_id

string

擷取的設定專案 ID。

api_key

string

Google Cloud API 金鑰這個欄位只會傳回開發人員的已驗證呼叫。

allow_password_user

bool

是否允許使用密碼帳戶註冊。這個欄位只會傳回開發人員的已驗證呼叫。

idp_config[]

IdpConfig

OAuth2 提供者設定。這個欄位只會傳回開發人員的已驗證呼叫。

authorized_domains[]

string

小工具重新導向的授權網域。

enable_anonymous_user

bool

是否啟用匿名使用者。這個欄位只會傳回開發人員的已驗證呼叫。

use_email_sending

bool

是否使用電子郵件傳送。這個欄位只會傳回開發人員的已驗證呼叫。

reset_password_template

EmailTemplate

密碼重設電子郵件範本。這個欄位只會傳回開發人員的已驗證呼叫。

verify_email_template

EmailTemplate

驗證電子郵件的電子郵件範本。這個欄位只會傳回開發人員的已驗證呼叫。

change_email_template

EmailTemplate

變更電子郵件的電子郵件範本。這個欄位只會傳回開發人員的已驗證呼叫。

legacy_reset_password_template

EmailTemplate

舊版 Firebase V1 應用程式的密碼重設電子郵件範本。這個欄位只會針對開發人員的已驗證呼叫傳回。

revert_second_factor_addition_template

EmailTemplate

用於撤銷新增第二個驗證方法的電子郵件範本。這個欄位只會傳回開發人員的已驗證呼叫。

GetRecaptchaParamResponse

GetRecaptchaParam 的回應訊息。

欄位
kind
(deprecated)

string

recaptcha_stoken
(deprecated)

string

recaptcha_site_key

string

用於叫用 reCAPTCHA 服務的 reCAPTCHA v2 網站金鑰。一律會出現。

producer_project_number

string

用來產生 PIA 權杖的生產者專案編號

GetSessionCookiePublicKeysResponse

GetSessionCookiePublicKeys 的回應訊息。

欄位
keys[]

OpenIdConnectKey

工作階段 Cookie 簽署者的公開金鑰,格式為 JSON Web Keys (JWK)

IdpConfig

識別資訊提供者的設定。

欄位
provider

Provider

enabled

bool

如果允許使用者透過提供者登入,則值為「是」。

experiment_percent

int32

系統會提示/重新導向使用者聯合登入此 IdP 的百分比

key

string

OAuth2 用戶端 ID。

secret

string

OAuth2 用戶端密鑰。

whitelisted_audiences[]

string

用戶端 ID 已加入許可清單,可進行目標對象檢查。

供應商

識別資訊提供者的名稱。

列舉
PROVIDER_UNSPECIFIED
MSLIVE Microsoft Live 做為識別資訊提供者。
GOOGLE Google 做為識別資訊提供者。
FACEBOOK Facebook 做為識別資訊提供者。
PAYPAL PayPal 做為識別資訊提供者。
TWITTER Twitter 做為識別資訊提供者。
YAHOO Yahoo 做為識別資訊提供者。
AOL AOL 做為識別資訊提供者。
GITHUB GitHub 做為識別資訊提供者。
GOOGLE_PLAY_GAMES Google Play 遊戲做為識別資訊提供者。
LINKEDIN LinkedIn 做為識別資訊提供者。
IOS_GAME_CENTER iOS Game Center 做為識別資訊提供者。

IssueSamlResponseRequest

IssueSamlResponse 的要求訊息。

欄位
rp_id

string

信賴憑證者 ID,也就是已發出 SAMLResponse 的目標對象。

id_token

string

Identity Platform ID 權杖。系統會驗證這項資訊,然後轉換為新的 SAMLResponse。

saml_app_entity_id

string

為每個應用程式在 Google 管理控制台中指定的 SAML 應用程式實體 ID。如果開發人員想要重新導向至第三方應用程式,而非 G Suite 應用程式,就可能需要這個值。使用時,我們會傳回 RelayState。這包括 SAMLRequest,可用於觸發由服務提供者啟動的 SAML 流程,將使用者重新導向至實際應用程式。

IssueSamlResponseResponse

IssueSamlResponse 要求的回應。

欄位
saml_response

string

為信賴方建立的已簽署 SAMLResponse。

acs_endpoint

string

使用傳回 SAMLResponse 的 ACS 端點。

relay_state

string

產生的 RelayState。

email

string

使用者的電子郵件地址。

first_name

string

使用者的名字。

last_name

string

使用者的姓氏。

is_new_user

bool

這項要求是否建立登入使用者。

MfaEnrollment

帳戶啟用的多重驗證 (MFA) 供應商資訊。

欄位
mfa_enrollment_id

string

這項 MFA 選項的 ID。

display_name

string

這個 MFA 選項的顯示名稱,例如「公司手機」。

enrolled_at

Timestamp

帳戶註冊這項第二重驗證條件的時間戳記。

聯集欄位 mfa_value。MFA 選項的定義值。mfa_value 只能是下列其中一項:
phone_info

string

通常會顯示與這項註冊相關聯的電話號碼。在某些情況下 (例如在第一個因素登入後),系統只會顯示相關聯的電話號碼的模糊處理版本。

totp_info

TotpInfo

包含 TOTP MFA 專屬資訊。

email_info

EmailInfo

包含電子郵件多重認證機制相關資訊。

聯集欄位 unobfuscated_mfa_value

unobfuscated_mfa_value 只能是下列其中一項:

unobfuscated_phone_info

string

僅供輸出。未經模糊處理的 phone_info。

OobReqType

OOB 代碼要求的動作類型。

列舉
OOB_REQ_TYPE_UNSPECIFIED 未指定 OOB 代碼類型。
PASSWORD_RESET 重設密碼
OLD_EMAIL_AGREE
NEW_EMAIL_ACCEPT
VERIFY_EMAIL 透過電子郵件驗證帳戶的電子郵件地址
RECOVER_EMAIL
EMAIL_SIGNIN 僅使用電子郵件地址登入
VERIFY_AND_CHANGE_EMAIL 這個流程會將電子郵件傳送至指定的新電子郵件地址,並在使用者點選電子郵件中的連結後,將帳戶的電子郵件地址變更為新電子郵件地址。適用於帳戶必須隨時擁有已驗證的電子郵件地址的情況,例如多重驗證帳戶。
REVERT_SECOND_FACTOR_ADDITION

OpenIdConnectKey

代表工作階段 Cookie 簽署者的公開金鑰,格式為 JSON Web Key (JWK)

欄位
type

string

鍵類型。

algorithm

string

簽名演算法。

use

string

使用金鑰。

id

string

用於識別此鍵的專屬字串。

modulus

string

RSA 公開金鑰的模數,以 Base64url 編碼表示值的大端序表示法。

exponent

string

RSA 公開金鑰的指數,以 Base64url 編碼表示值的大端序表示法。

ProviderUserInfo

各種身分識別提供者提供的使用者資訊。

欄位
provider_id

string

識別資訊提供者的 ID。

display_name

string

使用者在 Identity Provider 中的顯示名稱。

photo_url

string

使用者在識別資訊提供者中的個人資料相片網址。

federated_id

string

使用者在 Identity Provider 中的 ID。

email

string

使用者在身分識別提供者中的電子郵件地址。

raw_id

string

直接由 Identity Provider 傳回的使用者原始 ID。

screen_name

string

使用者在 Twitter 上的 screen_name,或在 GitHub 上的登入名稱。

phone_number

string

使用者在身分識別提供者中的電話號碼。

QueryUserInfoRequest

QueryUserInfo 的要求訊息。

欄位
return_user_info

bool

如果為 true,這項要求會傳回符合查詢的帳戶。如果 false,系統只會傳回符合查詢的帳戶數量。預設值為 true

limit

int64

傳回的帳戶數量上限為 500。預設值為 500。只有在 return_user_info 設為 true 時才有效。

offset

int64

從相符記錄的開頭略過的帳戶數量。只有在 return_user_info 設為 true 時才有效。

sort_by

SortByField

order

Order

target_project_id

string

結果的專案範圍 ID。

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

  • firebaseauth.users.get
tenant_id

string

結果的範圍所屬租用戶 ID。

expression[]

SqlExpression

訂單

排序查詢結果的順序。

列舉
ORDER_UNSPECIFIED 未指定順序。
ASC 依遞增順序排序。
DESC 依遞減順序排序。

SortByField

用於排序使用者帳戶的欄位。

列舉
SORT_BY_FIELD_UNSPECIFIED 未指定排序欄位。
USER_ID 依 userId 排序結果。
NAME 依名稱排序結果。
CREATED_AT 依 createdAt 排序結果。
LAST_LOGIN_AT 依 lastLoginAt 排序結果。
USER_EMAIL 依 userEmail 排序結果。

SqlExpression

用於篩選結果的查詢條件。

欄位
email

string

不區分大小寫的字串,帳戶的電子郵件必須與此相符。SqlExpression 中只能指定 emailphone_numberuser_id 其中一個。如果指定多個,系統只會套用第一個 (依順序)。

user_id

string

帳戶的本機 ID 應相符的字串。SqlExpression 中應只指定 emailphone_numberuser_id 其中一個,如果指定多個,系統只會套用第一個 (依序)。

phone_number

string

帳戶的電話號碼應與此字串相符。SqlExpression 中只能指定 emailphone_numberuser_id 其中一個。如果指定多個,系統只會套用第一個 (依順序)。

QueryUserInfoResponse

QueryUserInfo 的回應訊息。

欄位
records_count

int64

如果要求中的 return_user_info 為 true,則這是此訊息中傳回的帳戶數量。否則,這會是符合查詢的帳戶總數。

user_info[]

UserInfo

如果要求中的 return_user_info 為 true,表示這是符合查詢的帳戶。

RecaptchaVersion

reCAPTCHA 版本。

列舉
RECAPTCHA_VERSION_UNSPECIFIED 未指定 reCAPTCHA 版本。
RECAPTCHA_ENTERPRISE reCAPTCHA Enterprise。

ResetPasswordRequest

ResetPassword 的要求訊息。

欄位
oob_code

string

由 GetOobCode 要求產生的頻外 (OOB) 程式碼。只要指定這個參數 (或只指定這個參數和租用戶 ID),即可在回應中取得非頻道外程式碼的類型,而不會變更帳戶狀態。這個方法只能用來使用 PASSWORD_RESET 外部代碼。

new_password

string

要為這個帳戶設定的新密碼。指定這個欄位會導致帳戶變更,並使用非頻道代碼 (如果指定了 PASSWORD_RESET 類型的代碼)。

old_password

string

要修改的帳戶目前密碼。指定這個值和電子郵件地址,即可變更帳戶密碼,而不需要使用額外的驗證碼。

email

string

(非必要) 要修改的帳戶電子郵件地址。請指定這項資訊和舊密碼,即可變更帳戶密碼,而無須使用額外驗證碼。

tenant_id

string

(非必要) 帳戶所屬 Identity Platform 租戶的租戶 ID。

ResetPasswordResponse

ResetPassword 的回應訊息。

欄位
kind
(deprecated)

string

email

string

與所用外部驗證碼相關聯的電子郵件地址。

new_email

string

req_type

OobReqType

mfa_info

MfaEnrollment

SendVerificationCodeRequest

SendVerificationCode 的請求訊息。啟用 reCAPTCHA Enterprise 時,必須提供「captcha_response」;否則,您必須指定至少一個 (ios_receiptios_secret)、recaptcha_tokensafety_net_token,以驗證驗證碼是代表實際應用程式而非模擬器傳送。

欄位
phone_number

string

傳送驗證碼的電話號碼,格式為 E.164。

ios_receipt

string

收到 iOS 應用程式權杖驗證成功的通知。如果您未使用「captcha_response」(未啟用 reCAPTCHA Enterprise),就必須指定至少一個 (ios_receiptios_secret)、recaptcha_tokensafety_net_token,以便驗證驗證碼是代表實際應用程式而非模擬器傳送。這項資訊應來自 [verifyIosClient][v1.accounts.verifyIosClient] 的回應。如果有,呼叫端也應在 x-ios-bundle-identifier 標頭中提供 ios_secret 和軟體包 ID,且該 ID 必須與 [verifyIosClient][v1.accounts.verifyIosClient] 要求中的軟體包 ID 相符。

ios_secret

string

密鑰以推播通知的形式傳送至 iOS 應用程式。應搭配 ios_receiptx-ios-bundle-identifier 標頭傳遞。

recaptcha_token

string

應用程式驗證的 reCAPTCHA 權杖。如果您未使用「captcha_response」(未啟用 reCAPTCHA Enterprise),就必須指定至少一個 (ios_receiptios_secret)、recaptcha_tokensafety_net_token,以便驗證驗證碼是代表實際應用程式而非模擬器傳送。您應呼叫 [getRecaptchaParams][v1.getRecaptchaParams] 產生 recaptcha,並在使用者完成 recaptcha 驗證後產生 recaptcha 權杖。

tenant_id

string

使用者要登入的 Identity Platform 租用戶 ID。

auto_retrieval_info

AutoRetrievalInfo

僅限 Android 裝置。Google Play 服務會使用這項參數,識別要自動擷取的應用程式。

safety_net_token

string

僅限 Android 裝置。用於代替 recaptcha 權杖,宣告應用程式身分。如果您未使用「captcha_response」(未啟用 reCAPTCHA Enterprise),就必須指定至少一個 (ios_receiptios_secret)、recaptcha_tokensafety_net_token,以便驗證驗證碼是代表實際應用程式而非模擬器傳送。您可以透過 SafetyNet Android Attestation API 產生 SafetyNet 權杖,並將 phone_number 欄位的 Base64 編碼做為 Nonce。

play_integrity_token

string

僅限 Android 裝置。用於代替 recaptcha 權杖 (和 safety_net_token),宣告應用程式身分。如果您未使用「captcha_response」(未啟用 reCAPTCHA Enterprise),就必須指定至少一種 (ios_receiptios_secret)、recaptcha_tokenplay_integrity_token,以便驗證驗證碼是代表實際應用程式而非模擬器傳送。您可以透過 PlayIntegrity API 產生 Play Integrity 權杖,方法是將 SHA256 套用至 phone_number 欄位做為 Nonce。

captcha_response

string

(非必要) reCAPTCHA 用戶端整合功能提供的 reCAPTCHA Enterprise 權杖。啟用 reCAPTCHA Enterprise 時必須提供。

client_type

ClientType

(非必要) 用戶端類型 (網頁、Android 或 iOS)。啟用 reCAPTCHA Enterprise 時必須提供。

recaptcha_version

RecaptchaVersion

(非必要) captcha_response 中 reCAPTCHA 權杖的 reCAPTCHA 版本。啟用 reCAPTCHA Enterprise 時必須提供。

AutoRetrievalInfo

自動擷取簡訊所需的資訊。

欄位
app_signature_hash

string

Android 應用程式針對 Google Play 服務的 SMS Retriever API 所用的簽署雜湊。

SendVerificationCodeResponse

SendVerificationCode 的回應訊息。

欄位
session_info

string

已加密的工作階段資訊。這項資訊可用於 [signInWithPhoneNumber][v1.accounts.signInWithPhoneNumber] 驗證電話號碼。

SetAccountInfoRequest

SetAccountInfo 的要求訊息。

欄位
id_token

string

有效的 Identity Platform ID 權杖。嘗試變更使用者相關資訊時,必須提供此權限。

local_id

string

使用者的 ID。如要指定這個欄位,您必須具備具備適當權限的 Google OAuth 2.0 憑證。如果是來自使用者的請求,則應改為傳遞 ID 權杖。

display_name

string

使用者的新顯示名稱,會在帳戶屬性中更新。顯示名稱的長度不得超過 256 個半形字元。

email

string

使用者的新電子郵件地址,將更新至帳戶的屬性。電子郵件長度不得超過 256 個半形字元,格式為 [email protected]。電子郵件也必須符合 RFC 822 的 addr-spec 產生方式。如果啟用電子郵件列舉保護,使用者必須先驗證電子郵件,才能變更電子郵件,但管理員可以變更電子郵件。

password

string

使用者的新密碼,會在帳戶屬性中更新。密碼長度至少須為 6 個字元。

provider[]

string

帳戶應連結的身分驗證方。

oob_code

string

要套用至使用者帳戶的額外代碼。支援下列非正式驗證碼類型:* VERIFY_EMAIL * RECOVER_EMAIL * REVERT_SECOND_FACTOR_ADDITION * VERIFY_AND_CHANGE_EMAIL

email_verified

bool

使用者的電子郵件是否已經驗證。如要指定這個欄位,您必須具備具備適當權限的 Google OAuth 2.0 憑證。

upgrade_to_federated_login

bool

帳戶是否應僅限使用聯合登入。

captcha_challenge
(deprecated)

string

captcha_response

string

reCAPTCHA 驗證問題的回應。系統偵測到可能的濫用活動時,必須提供這項資訊。

valid_since

int64

指定 Identity Platform ID 權杖最短的有效時間戳記 (以秒為單位)。

disable_user

bool

如果為 true,表示帳戶已停用,使用者將無法再登入。

instance_id
(deprecated)

string

delegated_project_number
(deprecated)

int64

photo_url

string

使用者新的相片網址,用於更新帳戶的個人資料相片。網址長度不得超過 2048 個半形字元。

delete_attribute[]

UserAttributeName

return_secure_token

bool

是否傳回 ID 和重新整理權杖。應一律為 true。

delete_provider[]

string

取消連結使用者帳戶的 ID 提供者。

last_login_at

int64

帳戶上次登入的時間戳記,以毫秒為單位。

created_at

int64

帳戶建立時間的時間戳記 (以毫秒為單位)。

phone_number

string

要在帳戶屬性中更新的電話號碼。

custom_attributes

string

以 JSON 格式儲存的 Identity Platform ID 權杖中自訂屬性。如要指定這個欄位,您必須具備具備適當權限的 Google OAuth 2.0 憑證。

tenant_id

string

帳戶所屬 Identity Platform 租戶的租戶 ID。使用者端的要求應傳遞 Identity Platform ID 權杖,而非設定此欄位。

target_project_id

string

帳戶所屬專案的專案 ID。如要指定這個欄位,您必須具備 Google OAuth 2.0 憑證,並擁有適當的權限。來自使用者的請求應改為傳遞 Identity Platform ID 權杖。

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

  • firebaseauth.users.update
mfa

MfaInfo

在使用者帳戶中設定的多重驗證相關資訊。這項操作會覆寫帳戶中先前任何與多重驗證相關的資訊。如要指定這個欄位,您必須具備具備適當權限的 Google OAuth 2.0 憑證。

MfaInfo

多重驗證相關資訊。

欄位
enrollments[]

MfaEnrollment

使用者註冊的第二重驗證。

UserAttributeName

可刪除的帳戶屬性。

列舉
USER_ATTRIBUTE_NAME_UNSPECIFIED 未指定使用者屬性名稱。
EMAIL 使用者屬性鍵名為 email。
DISPLAY_NAME 使用者屬性鍵名為 displayName。
PROVIDER 使用者屬性鍵名稱為 provider。
PHOTO_URL 使用者屬性鍵名稱為 photoURL。
PASSWORD 使用者屬性鍵名稱為 password。
RAW_USER_INFO 使用者屬性鍵名為 rawUserInfo。

SetAccountInfoResponse

SetAccountInfo 的回應訊息

欄位
kind
(deprecated)

string

local_id

string

已驗證使用者的 ID。

email
(deprecated)

string

帳戶的電子郵件地址。

display_name
(deprecated)

string

帳戶的顯示名稱。

id_token

string

帳戶的 Identity Platform ID 權杖。這項屬性用於舊版使用者註冊。

provider_user_info[]

ProviderUserInfo

帳戶中已連結的識別資訊提供者。

new_email

string

使用者帳戶屬性中已設定的新電子郵件地址。

photo_url
(deprecated)

string

使用者個人資料相片的網址。

refresh_token

string

帳戶的更新權杖。這項屬性用於舊版使用者註冊。

expires_in

int64

Identity Platform ID 權杖到期前的秒數。

password_hash
(deprecated)

string

已淘汰,目前不會傳回實際的密碼雜湊。

email_verified

bool

帳戶的電子郵件是否已通過驗證。

SignInWithCustomTokenRequest

SignInWithCustomToken 的要求訊息。

欄位
token

string

這是必要旗標,開發人員斷言的自訂驗證權杖。憑證應為 JSON Web Token (JWT),其中包含「自訂憑證宣告」部分中 API 參考資料所列的聲明。

instance_id
(deprecated)

string

return_secure_token

bool

應一律為 true。

delegated_project_number
(deprecated)

int64

tenant_id

string

使用者要登入的 Identity Platform 租用戶 ID。如果存在,這個 ID 應與符記中的 tenant_id 相符。

SignInWithCustomTokenResponse

SignInWithCustomToken 的回應訊息。

欄位
kind
(deprecated)

string

id_token

string

經過驗證的使用者所需的 Identity Platform ID 權杖。

refresh_token

string

已驗證使用者的 Identity Platform 重新整理權杖。

expires_in

int64

ID 權杖到期前的秒數。

is_new_user

bool

系統是否已透過這項要求建立已驗證的使用者。

SignInWithEmailLinkRequest

SignInWithEmailLink 的請求訊息

欄位
oob_code

string

這是必要旗標,電子郵件連結中的額外程式碼。

email

string

這是必要旗標,系統傳送登入連結的電子郵件地址。電子郵件長度不得超過 256 個半形字元,格式為 [email protected]。電子郵件也應符合 RFC 822 的 addr-spec 產生方式。

id_token

string

Identity Platform 帳戶的有效 ID 權杖。如果通過,這項要求會將電子郵件地址連結至由此 ID 權杖代表的使用者,並在日後啟用帳戶的電子郵件連結登入功能。

tenant_id

string

使用者要登入的 Identity Platform 租用戶 ID。如果未設定,使用者會登入預設的 Identity Platform 專案。

SignInWithEmailLinkResponse

SignInWithEmailLink 的回應訊息。

欄位
kind
(deprecated)

string

id_token

string

經過驗證的使用者所需的 Identity Platform ID 權杖。

email

string

使用者用來登入的電子郵件地址。回應中一律會出現。

refresh_token

string

已驗證使用者的權杖重新整理。

expires_in

int64

ID 權杖到期前的秒數。

local_id

string

已驗證使用者的 ID。回應中一律會出現。

is_new_user

bool

系統是否已透過此要求建立已驗證的使用者。

mfa_pending_credential

string

不透明字串,可做為使用者已成功通過第一個因素檢查的證明。

mfa_info[]

MfaEnrollment

已啟用的多重驗證服務供應商資訊。如果使用者需要使用多重驗證功能完成登入程序,就會顯示這項屬性。

SignInWithGameCenterRequest

SignInWithGameCenter 的請求訊息

欄位
player_id

string

這是必要旗標,使用者的 Game Center 玩家 ID。已由 Apple 淘汰。

playerIDgamePlayerIDteamPlayerID 一併傳遞,即可開始將使用者的 Game Center 玩家 ID 遷移至 gamePlayerID

public_key_url

string

這是必要旗標,用來擷取 Apple 公開金鑰的網址,以便驗證由 Apple 簽署的簽名。

signature

string

這是必要旗標,Apple 產生的驗證簽名資料。

salt

string

這是必要旗標,用於產生指定簽章的隨機字串。

timestamp

int64

這是必要旗標,Apple 建立簽章的時間,以 Epoch 紀元時間起算的毫秒數為單位。

id_token

string

Identity Platform 帳戶的有效 ID 權杖。如果有此 ID 符記,這項要求會將 Game Center 玩家 ID 連結至由此 ID 符記代表的帳戶。

display_name

string

使用者的 Game Center 顯示名稱。

tenant_id

string

使用者要登入的 Identity Platform 租用戶 ID。

team_player_id

string

使用者的 Game Center 團隊玩家 ID。您使用開發人員帳戶發行的所有遊戲玩家專屬 ID。https://developer.apple.com/documentation/gamekit/gkplayer/3174857-teamplayerid

game_player_id

string

使用者的 Game Center 遊戲玩家 ID。遊戲玩家的專屬 ID。https://developer.apple.com/documentation/gamekit/gkplayer/3113960-gameplayerid

SignInWithGameCenterResponse

SignInWithGameCenter 的回應訊息

欄位
local_id

string

已驗證使用者的 ID。回應中一律會出現。

player_id

string

使用者的 Game Center 玩家 ID。

playerIDgamePlayerIDteamPlayerID 一併傳遞,即可開始將使用者的 Game Center 玩家 ID 遷移至 gamePlayerID

id_token

string

經過驗證的使用者所需的 Identity Platform ID 權杖。

refresh_token

string

已驗證使用者的 Identity Platform 重新整理權杖。

expires_in

int64

ID 權杖到期前的秒數。

is_new_user

bool

這項要求是否建立登入使用者。

display_name

string

已驗證使用者的顯示名稱。

team_player_id

string

使用者的 Game Center 團隊玩家 ID。您使用開發人員帳戶發行的所有遊戲玩家專屬 ID。https://developer.apple.com/documentation/gamekit/gkplayer/3174857-teamplayerid

game_player_id

string

使用者的 Game Center 遊戲玩家 ID。遊戲玩家的專屬 ID。https://developer.apple.com/documentation/gamekit/gkplayer/3113960-gameplayerid

SignInWithIdpRequest

SignInWithIdp 的要求訊息。

欄位
request_uri

string

這是必要旗標,IdP 將使用者重新導向的網址。如果使用者是使用手動提供的 IdP 憑證登入,則可將這項屬性設為 http://localhost

post_body

string

如果使用者是透過先前的 CreateAuthUri 授權要求取得授權回應,則這是 IdP 的 HTTP POST 回呼內容 (如有)。

否則,如果使用者是使用手動提供的 IdP 憑證登入,則這應為 URL 編碼表單,其中包含憑證 (例如 ID 權杖或 OAuth 2.0 IdP 的存取權杖),以及核發憑證的 IdP 提供者 ID。

舉例來說,如果使用者使用 Google ID 權杖登入 Google 供應器,則應將此權杖設為 id_token=[GOOGLE_ID_TOKEN]&providerId=google.com,其中 [GOOGLE_ID_TOKEN] 應替換為 Google ID 權杖。

如果使用者是使用 Facebook 驗證權杖登入 Facebook 供應器,則應將此值設為 id_token=[FACEBOOK_AUTHENTICATION_TOKEN]&providerId=facebook. com&nonce= [NONCE],其中 [FACEBOOK_AUTHENTICATION_TOKEN] 應替換為 Facebook 驗證權杖。驗證權杖時必須使用 Nonce。如果未提供 Nonce,要求就會失敗。

如果使用者使用 Facebook 存取權杖登入 Facebook 供應器,則應將此值設為 access_token=[FACEBOOK_ACCESS_TOKEN]&providerId=facebook. com,其中 [FACEBOOK_ACCESS_TOKEN] 應替換為 Facebook 存取權杖。

如果使用者使用 Twitter OAuth 1.0 憑證登入 Twitter 供應商,則應將此值設為 access_token=[TWITTER_ACCESS_TOKEN]&oauth_token_secret= [TWITTER_TOKEN_SECRET]&providerId=twitter.com,其中 [TWITTER_ACCESS_TOKEN][TWITTER_TOKEN_SECRET] 分別應替換為 Twitter OAuth 存取權杖和 Twitter OAuth 權杖密碼。

pending_id_token
(deprecated)

string

return_refresh_token

bool

是否要從 IdP 傳回 OAuth 更新權杖 (如有)。

session_id

string

先前 CreateAuthUri 呼叫傳回的工作階段 ID。系統會根據該工作階段 ID 驗證這個欄位,以防範工作階段固定攻擊。如果使用者是使用先前 CreateAuthUri 授權要求的授權回應登入,則必須提供此參數。

delegated_project_number
(deprecated)

int64

id_token

string

有效的 Identity Platform ID 權杖。如果通過,IdP 中的使用者帳戶就會連結至此 ID 權杖所代表的帳戶。

return_secure_token

bool

應一律為 true。

return_idp_credential

bool

是否要針對以下錯誤 FEDERATED_USER_ID_ALREADY_LINKEDEMAIL_EXISTS 從 IdP 傳回 OAuth 憑證。

auto_create
(deprecated)

bool

tenant_id

string

使用者要登入的 Identity Platform 租用戶 ID。如果未設定,使用者會登入預設的 Identity Platform 專案。

pending_token

string

來自先前 SignInWithIdp 回應的不透明字串。如果已設定,則可用於重複執行先前 SignInWithIdp 作業的登入作業。如果使用者需要在先前的聯合登入嘗試中確認帳戶資訊,或執行帳戶連結作業,就可能會出現這個錯誤。

SignInWithIdpResponse

SignInWithIdp 的回應訊息。

欄位
federated_id

string

使用者在 IdP 中的帳戶 ID。回應中一律會出現。

provider_id

string

使用者登入的 IdP 提供者 ID。回應中一律會出現。

email

string

使用者在 IdP 帳戶中的電子郵件地址。

email_verified

bool

使用者帳戶的電子郵件地址是否已完成驗證。

first_name

string

使用者在 IdP 帳戶中的名字。

full_name

string

使用者在 IdP 帳戶中的全名。

last_name

string

使用者在 IdP 帳戶中的姓氏。

nick_name

string

使用者在 ID 提供者帳戶中的暱稱。

language

string

使用者在 IdP 帳戶的語言偏好設定。

time_zone

string

IdP 中使用者帳戶的時區。

photo_url

string

IdP 中使用者個人資料相片的網址。

date_of_birth

string

使用者在 ID 提供者帳戶中的出生日期。

input_email
(deprecated)

string

original_email

string

使用者 Identity Platform 帳戶的主要 (頂層) 電子郵件地址,如果與 IdP 中的電子郵件地址不同。只有在啟用「每個電子郵件地址一個帳戶」設定時才會顯示。

local_id

string

已驗證的 Identity Platform 使用者 ID。回應中一律會出現。

email_recycled

bool

是否有現有的 Identity Platform 使用者帳戶,使用相同的電子郵件地址,但連結至同一 IdP 的其他帳戶。只有在啟用「每個電子郵件地址只能建立一個帳戶」設定,且 ID 提供者中的電子郵件地址已驗證過時,這個選項才會顯示。

display_name

string

IdP 中使用者帳戶的顯示名稱。

id_token

string

經過驗證的使用者所需的 Identity Platform ID 權杖。

context

string

CreateAuthUri 中設定的不透明字串,用於在驗證要求和 IdP 回呼之間維持情境資訊。

verified_provider[]

string

使用者可登入的提供者 ID 清單,以便解決 need_confirmation 錯誤。只有在 need_confirmation 設為 true 時才會出現。

need_confirmation

bool

是否有現有的 Identity Platform 使用者帳戶,其電子郵件地址與目前在 IdP 登入的帳戶相同,且該帳戶的電子郵件地址未在 IdP 驗證。使用者必須登入現有的 Identity Platform 帳戶,然後將 IdP 目前的憑證連結至該帳戶。只有在啟用「每個電子郵件地址一個帳戶」設定時才會顯示。

oauth_access_token

string

來自 IdP 的 OAuth 存取權杖 (如有)。

oauth_refresh_token

string

來自 IdP 的 OAuth 2.0 更新權杖 (如果可用且 return_refresh_token 已設為 true)。

oauth_expire_in

int32

IdP 的 OAuth 存取權杖到期前剩餘的秒數。

oauth_authorization_code

string

OAuth 2.0 授權碼 (如有)。僅適用於 Google 供應器。

need_email
(deprecated)

bool

oauth_token_secret

string

IdP 提供的 OAuth 1.0 憑證密鑰 (如有)。僅適用於 Twitter 供應器。

refresh_token

string

已驗證使用者的 Identity Platform 重新整理權杖。

expires_in

int64

Identity Platform ID 權杖到期前的秒數。

oauth_id_token

string

來自 IdP 的 OpenID Connect ID 權杖 (如有)。

screen_name

string

使用者在 Twitter IdP 帳戶的螢幕名稱,或使用者在 GitHub IdP 帳戶的登入名稱。

raw_user_info

string

字串化 JSON 回應,其中包含與 IdP 使用者帳戶相對應的所有資料。

error_message

string

如果將 return_idp_credential 設為 true,且發生 FEDERATED_USER_ID_ALREADY_LINKEDEMAIL_EXISTS 錯誤,系統會傳回錯誤訊息。這個欄位的值為 FEDERATED_USER_ID_ALREADY_LINKEDEMAIL_EXISTS

is_new_user

bool

是否為已驗證的使用者建立新的 Identity Platform 帳戶。

kind
(deprecated)

string

pending_token

string

這個不透明字串可用於使用者登入的 IdP 憑證。您可以在這裡取得待處理的權杖,並在日後的 SignInWithIdp 要求中設定,以便再次透過 IdP 登入相同使用者。

tenant_id

string

要求中 tenant_id 欄位的值。

mfa_pending_credential

string

這項隱含的字串可做為證明使用者已成功通過第一層驗證的證明。

mfa_info[]

MfaEnrollment

帳戶啟用的多重驗證供應商資訊。如果使用者需要使用多重驗證功能完成登入程序,就會顯示這項屬性。

SignInWithPasswordRequest

SignInWithPassword 的要求訊息。

欄位
email

string

這是必要旗標,使用者用來登入的電子郵件地址。電子郵件長度不得超過 256 個半形字元,且格式為 [email protected]。電子郵件也應符合 RFC 822 的 addr-spec 產生方式。

password

string

這是必要旗標,使用者提供的密碼,用於登入帳戶。

pending_id_token
(deprecated)

string

captcha_challenge
(deprecated)

string

captcha_response

string

reCAPTCHA 用戶端整合功能提供的 reCAPTCHA 權杖。reCAPTCHA Enterprise 會使用這項權杖進行風險評估。啟用 reCAPTCHA Enterprise 時必須提供。

instance_id
(deprecated)

string

delegated_project_number
(deprecated)

int64

id_token
(deprecated)

string

return_secure_token

bool

應一律為 true。

tenant_id

string

使用者要登入的 Identity Platform 租用戶 ID。如果未設定,使用者會登入專案中的預設 Identity Platform 例項。

client_type

ClientType

用戶端類型 (網頁、Android 或 iOS)。啟用 reCAPTCHA Enterprise 時必須提供。

recaptcha_version

RecaptchaVersion

captcha_response 中 reCAPTCHA 權杖的 reCAPTCHA 版本。

SignInWithPasswordResponse

SignInWithPassword 的回應訊息。

欄位
kind
(deprecated)

string

local_id

string

已驗證使用者的 ID。回應中一律會出現。

email

string

已驗證使用者的電子郵件地址。回應中一律會出現。

display_name

string

儲存在帳戶屬性中的使用者顯示名稱。

id_token

string

經過驗證的使用者所需的 Identity Platform ID 權杖。

registered
(deprecated)

bool

電子郵件地址是否屬於現有帳戶。一律為 true。

profile_picture

string

儲存在帳戶屬性中的使用者個人資料相片。

oauth_access_token
(deprecated)

string

OAuth2 存取權杖。

oauth_expire_in
(deprecated)

int32

存取權杖的過期時間 (以秒為單位)。

oauth_authorization_code
(deprecated)

string

refresh_token

string

已驗證使用者的 Identity Platform 重新整理權杖。

expires_in

int64

Identity Platform ID 權杖到期前的秒數。

mfa_pending_credential

string

這項隱含的字串可做為證明使用者已成功通過第一層驗證的證明。

mfa_info[]

MfaEnrollment

帳戶啟用的多重驗證供應商資訊。如果使用者需要使用多重驗證功能完成登入程序,就會顯示這項屬性。

user_notifications[]

UserNotification

使用者警告通知。

SignInWithPhoneNumberRequest

SignInWithPhoneNumber 的要求訊息。

欄位
session_info

string

來自 [sendVerificationCode][v1.accounts.sendVerificationCode] 回應的加密工作階段資訊。如果是使用簡訊驗證碼,則必須指定此值,但如果是使用臨時證明,則可以不指定。

phone_number

string

使用者用於登入的電話號碼。使用臨時證件的情況下,這項資訊是必要的,且必須與產生臨時證件的請求中驗證的電話號碼相符。如果傳遞工作階段資訊,系統會略過這個欄位。

code

string

使用者輸入的驗證碼,來自傳送至使用者手機的簡訊。

temporary_proof

string

電話號碼驗證的證明,由先前的 [signInWithPhoneNumber][v1.accounts.signInWithPhoneNumber] 要求提供。如果傳遞此值,呼叫端也必須在 phone_number 欄位中傳遞先前要求中驗證過的電話號碼。

verification_proof

string

請勿使用。

id_token

string

Identity Platform 帳戶的有效 ID 權杖。如果通過,且電話號碼未使用,這項要求會將電話號碼連結至由此 ID 權杖代表的使用者;如果電話號碼已連結至使用者,則會重新驗證使用者。

operation
(deprecated)

VerifyOp

tenant_id

string

使用者要登入的 Identity Platform 租用戶 ID。如果未設定,使用者會登入預設的 Identity Platform 專案。

VerifyOp

預期的作業。

列舉
VERIFY_OP_UNSPECIFIED 未指定作業。
SIGN_UP_OR_IN 驗證作業是註冊/登入。
REAUTH 驗證作業是否為重新授權。
UPDATE 驗證作業是否為更新。

SignInWithPhoneNumberResponse

SignInWithPhoneNumber 的回應訊息。

欄位
id_token

string

已驗證使用者的 Identity Platform ID 權杖。

refresh_token

string

已驗證使用者的權杖重新整理。

expires_in

int64

ID 權杖到期前的秒數。

local_id

string

已驗證使用者的 ID。在驗證成功的情況下顯示。如果電話號碼可以驗證,但無法執行帳戶操作,系統會改為傳回臨時證明。

is_new_user

bool

系統是否已透過這項要求建立已驗證的使用者。

temporary_proof

string

電話號碼驗證證明,如果電話驗證成功,但使用者操作失敗,則會提供這項證明。當要求嘗試使用 ID 權杖將電話號碼連結至使用者,或使用 ID 權杖重新驗證,但電話號碼已連結至其他使用者時,就會發生這種情況。

verification_proof

string

請勿使用。

verification_proof_expires_in

int64

請勿使用。

phone_number

string

已驗證使用者的電話號碼。回應中一律會出現。

temporary_proof_expires_in

int64

臨時證件到期前的秒數。

SignUpRequest

註冊要求訊息。

欄位
email

string

要指派給新建立使用者的電子郵件地址。電子郵件長度不得超過 256 個半形字元,且格式為 [email protected]。電子郵件也必須符合 RFC 822 的 addr-spec 產生方式。如未提供,系統會建立匿名使用者。

password

string

要指派給建立的使用者所使用的密碼。密碼長度至少須為 6 個半形字元。如果已設定,則必須一併設定 email 欄位。

display_name

string

要建立的使用者顯示名稱。

captcha_challenge
(deprecated)

string

captcha_response

string

reCAPTCHA 用戶端整合功能提供的 reCAPTCHA 權杖。reCAPTCHA Enterprise 會使用這項權杖進行評估。啟用 reCAPTCHA Enterprise 時必須提供。

instance_id
(deprecated)

string

id_token

string

Identity Platform 使用者的有效 ID 權杖。如果設定了這個值,這項要求就會將驗證憑證連結至由此 ID 權杖代表的使用者。對於非管理員要求,必須同時設定 emailpassword 欄位。對於管理員要求,local_id 不得設定。

email_verified

bool

使用者是否已驗證電子郵件地址。如要指定這個欄位,您必須具備具備適當權限的 Google OAuth 2.0 憑證。

photo_url

string

要建立的使用者個人資料相片網址。

disabled

bool

系統是否會在建立使用者時將其停用。除了具備適當權限的 Google OAuth2 憑證要求外,您無法存取已停用的帳戶。

local_id

string

要建立的使用者 ID。這個 ID 在使用者所屬專案中不得重複。如要指定這個欄位,您必須具備具備適當權限的 Google OAuth 2.0 憑證。

phone_number

string

要建立的使用者電話號碼。如要指定這個欄位,您必須具備具備適當權限的 Google OAuth 2.0 憑證。

tenant_id

string

要建立使用者的 Identity Platform 租戶 ID。如未設定,系統會在預設的 Identity Platform 專案下建立使用者。

target_project_id

string

使用者應屬於的專案 ID。如要指定這個欄位,您必須具備具備適當權限的 Google OAuth 2.0 憑證。如果未設定此屬性,系統會根據與 Bearer 存取權杖相關聯的範圍推斷目標專案。

mfa_info[]

MfaFactor

使用者要建立的多重驗證供應商。

client_type

ClientType

用戶端類型:網頁、Android 或 iOS。啟用 reCAPTCHA Enterprise 防護功能時必填。

recaptcha_version

RecaptchaVersion

captcha_response 中 reCAPTCHA 權杖的 reCAPTCHA 版本。

MfaFactor

欄位
display_name

string

這個 MFA 選項的顯示名稱,例如「公司手機」。

聯集欄位 mfa_value

mfa_value 只能是下列其中一項:

phone_info

string

用於接收 MFA 動態密碼的電話號碼。

SignUpResponse

SignUp 的回應訊息。

欄位
kind

string

id_token

string

已建立使用者的 Identity Platform ID 權杖。這個欄位只會針對非管理員要求設定。

display_name

string

建立的使用者顯示名稱。

email

string

已建立使用者的電子郵件地址。

refresh_token

string

已建立使用者的 Identity Platform 重新整理權杖。這個欄位只會針對非管理員要求設定。

expires_in

int64

ID 權杖到期前的秒數。

local_id

string

已建立使用者的 ID。回應中一律會出現。

TotpInfo

這個類型沒有任何欄位。

TOTP MFA 相關資訊。

UploadAccountRequest

UploadAccount 的要求訊息。

欄位
hash_algorithm

string

這是必要旗標,用於雜湊帳戶密碼的雜湊函式。必須是下列其中一個:* HMAC_SHA256 * HMAC_SHA1 * HMAC_MD5 * SCRYPT * PBKDF_SHA1 * MD5 * HMAC_SHA512 * SHA1 * BCRYPT * PBKDF2_SHA256 * SHA256 * SHA512 * STANDARD_SCRYPT * ARGON2

signer_key

bytes

用於雜湊密碼的簽署者金鑰。下列雜湊函式需要此選項:* SCRYPT、* HMAC_MD5、* HMAC_SHA1、* HMAC_SHA256、* HMAC_SHA512

salt_separator

bytes

在鹽值和純文字密碼之間插入一或多個位元組。為提升安全性,此字元應為單一不可列印字元。

rounds

int32

用於雜湊運算的輪數。僅適用於下列雜湊函式:* MD5 * SHA1 * SHA256 * SHA512 * PBKDF_SHA1 * PBKDF2_SHA256 * SCRYPT

memory_cost

int32

雜湊運算的記憶體成本。只有在雜湊函式為 SCRYPT 時才需要。

users[]

UserInfo

要上傳的帳戶清單。local_id 是每位使用者必填的欄位,其他欄位則為選填。

delegated_project_number
(deprecated)

int64

sanity_check

bool

如果為 True,服務會在上傳帳戶前執行以下檢查清單:* 重複的電子郵件 * 重複的聯合 ID * 聯合 ID 供應器驗證 如果上傳的帳戶清單中存在重複項目,系統就不會上傳整個清單。如果電子郵件或聯合 ID 與專案/租用戶中已有的使用者重複,系統就不會上傳該帳戶,但其他帳戶不會受到影響。如果為 false,系統會略過這些檢查。

target_project_id

string

帳戶所屬 Identity Platform 專案的專案 ID。

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

  • firebaseauth.users.create
allow_overwrite

bool

是否要使用要求中的相符 local_id 覆寫身分識別平台中的現有帳戶。如果為 true,現有帳戶會遭到覆寫。如果為 false,系統會傳回錯誤。

cpu_mem_cost

int32

STANDARD_SCRYPT 雜湊函式要使用的 CPU 記憶體成本參數。這個參數與 block_size 和 cpu_mem_cost 一同協助調整產生密碼雜湊值所需的資源,並應隨著處理器速度和記憶體技術的進步而調整。

parallelization

int32

STANDARD_SCRYPT 雜湊函式要使用的並行處理成本參數。這個參數與 block_size 和 cpu_mem_cost 一同協助調整產生密碼雜湊值所需的資源,並應隨著處理器速度和記憶體技術的進步而調整。

block_size

int32

STANDARD_SCRYPT 雜湊函式使用的區塊大小參數。這個參數與並行處理和 cpu_mem_cost 一同協助調整產生密碼雜湊值所需的資源,並應隨著處理器速度和記憶體技術的進步而調整。

dk_len

int32

STANDARD_SCRYPT 雜湊函式所需的鍵長度。不得小於 1。

password_hash_order

PasswordHashOrder

tenant_id

string

帳戶所屬的 Identity Platform 用戶群 ID。

argon2_parameters

Argon2Parameters

Argon2 雜湊演算法的參數。

PasswordHashOrder

在對密碼進行雜湊運算時,密碼應放在鹽值之前還是之後。

列舉
UNSPECIFIED_ORDER 未指定順序。
SALT_AND_PASSWORD 順序為先輸入鹽值,再輸入密碼。
PASSWORD_AND_SALT 順序為先輸入密碼,再輸入鹽值。

UploadAccountResponse

UploadAccount 的回應訊息。

欄位
kind
(deprecated)

string

error[]

ErrorInfo

無法上傳的帳戶詳細錯誤資訊。

UserInfo

Identity Platform 帳戶的資訊。

欄位
local_id

string

不可變動。帳戶的專屬 ID。

email

string

帳戶的電子郵件地址。電子郵件長度不得超過 256 個半形字元,且格式為 [email protected]。電子郵件地址也應符合 RFC 822 的 addr-spec。

display_name

string

帳戶的顯示名稱。Identity Platform 不會使用這項帳戶屬性。這項資訊僅供參考。

language

string

僅供輸出。帳戶的語言偏好設定。Identity Platform 不會使用這項帳戶屬性。這項資訊僅供參考。

photo_url

string

帳戶個人資料相片的網址。Identity Platform 不會使用這項帳戶屬性。這項資訊僅供參考。

time_zone

string

僅供輸出。帳戶的時區偏好設定。Identity Platform 不會使用這項帳戶屬性。這項資訊僅供參考。

date_of_birth

string

僅供輸出。帳戶設定的出生日期。Identity Platform 不會使用這項帳戶屬性。這項資訊僅供參考。

password

bytes

帳戶的雜湊密碼。只有具備 Google OAuth2 憑證且具有適當權限的要求才能存取。

salt

bytes

帳戶的密碼加鹽值。只有具有適當權限的 Google OAuth2 憑證要求才能存取。

version

int32

帳戶密碼的版本。只有具有適當權限的 Google OAuth2 憑證要求才能存取。

email_verified

bool

帳戶的電子郵件地址是否已通過驗證。

password_updated_at

double

帳戶上次更新密碼的時間戳記,以 1970-01-01T00:00:00Z 為起點,以毫秒為單位。

provider_user_info[]

ProviderUserInfo

各種身分識別提供者提供的使用者資訊。

valid_since

int64

系統應將 ID 權杖視為有效的時間戳記最久的時間 (以 Epoch 紀元後的秒數為單位)。在此時間之前發出的所有 ID 權杖都會視為無效。

disabled

bool

帳戶是否已停用。除了具備適當權限的 Google OAuth2 憑證要求外,無法存取已停用的帳戶。

last_login_at

int64

上次登入這個帳戶的時間,以紀元起算的毫秒數。

created_at

int64

帳戶建立時間,以 Epoch 紀元時間為始 (單位為毫秒)。

screen_name

string

僅供輸出。這個帳戶的 Twitter 螢幕名稱或 GitHub 登入名稱。

custom_auth

bool

僅供輸出。這個帳戶是否已使用 SignInWithCustomToken 驗證。

raw_password

string

僅限輸入。用於更新帳戶密碼的純文字密碼。這個欄位只會用於做為要求中的輸入內容。Identity Platform 在管理密碼時會使用加密安全的雜湊演算法,絕不會以純文字儲存或傳輸使用者的密碼。

phone_number

string

帳戶的電話號碼。

custom_attributes

string

新增至帳戶所產生的任何 ID 權杖的自訂權杖。長度不得超過 1,000 個字元,且必須採用有效的 JSON 格式。

tenant_id

string

這個帳戶所屬租用戶的 ID。只有在這個帳戶屬於租用戶時才會設定。

mfa_info[]

MfaEnrollment

這個帳戶啟用的多重驗證供應商資訊。

initial_email

string

與這個帳戶相關聯的第一個電子郵件地址。帳戶的初始電子郵件地址一旦設定就無法變更,且可用於透過 GetOobCode 中的 RECOVER_EMAIL 流程,在您遺失帳戶存取權時進行復原。應符合 RFC 822 的 addr-spec。

last_refresh_at

Timestamp

上次為這個帳戶鑄造 ID 權杖的時間戳記。

UserNotification

使用者警告通知。

欄位
notification_code

NotificationCode

警告通知列舉。可用於本地化。

notification_message

string

警告通知字串。可用做備用值。

NotificationCode

警告通知列舉。可用於本地化。

列舉
NOTIFICATION_CODE_UNSPECIFIED 未指定通知。
MISSING_LOWERCASE_CHARACTER 密碼缺少小寫字元。
MISSING_UPPERCASE_CHARACTER 密碼缺少大寫字元。
MISSING_NUMERIC_CHARACTER 密碼缺少數字。
MISSING_NON_ALPHANUMERIC_CHARACTER 密碼缺少非英數字元。
MINIMUM_PASSWORD_LENGTH 密碼長度未達規定長度下限。
MAXIMUM_PASSWORD_LENGTH 密碼長度超過規定上限。

VerifyIosClientRequest

VerifyIosClient 的請求訊息

欄位
app_token

string

iOS 用戶端註冊 APNs (Apple 推播通知服務) 後取得的裝置權杖。

is_sandbox

bool

應用程式權杖是否位於 iOS 沙箱中。如果為 false,表示應用程式權杖位於正式環境。

VerifyIosClientResponse

VerifyIosClient 的回應訊息。

欄位
receipt

string

收到應用程式權杖驗證成功的通知。

suggested_timeout

int64

建議的秒數,用於客戶等待推播通知的時間。