Method: projects.accounts.batchCreate

将多个账号上传到 Google Cloud 项目。如果在上传一个或多个账号时出现问题，系统会上传其余账号，并返回错误列表。如需使用此方法，您需要拥有具有适当权限的 Google OAuth 2.0 凭据。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
targetProjectId

string

账号所属 Identity Platform 项目的项目 ID。

必须对指定的资源 targetProjectId 具有以下 IAM 权限才能进行授权：

  • firebaseauth.users.create

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "hashAlgorithm": string,
  "signerKey": string,
  "saltSeparator": string,
  "rounds": integer,
  "memoryCost": integer,
  "users": [
    {
      object (UserInfo)
    }
  ],
  "delegatedProjectNumber": string,
  "sanityCheck": boolean,
  "allowOverwrite": boolean,
  "cpuMemCost": integer,
  "parallelization": integer,
  "blockSize": integer,
  "dkLen": integer,
  "passwordHashOrder": enum (PasswordHashOrder),
  "tenantId": string,
  "argon2Parameters": {
    object (Argon2Parameters)
  }
}
字段
hashAlgorithm

string

必需。用于对账号密码进行哈希处理的哈希函数。必须是以下各项之一：* HMAC_SHA256 * HMAC_SHA1 * HMAC_MD5 * SCRYPT * PBKDF_SHA1 * MD5 * HMAC_SHA512 * SHA1 * BCRYPT * PBKDF2_SHA256 * SHA256 * SHA512 * STANDARD_SCRYPT * ARGON2
signerKey

string (bytes format)

用于对密码进行哈希处理的 signer 密钥。以下哈希函数需要此参数：* SCRYPT、* HMAC_MD5、* HMAC_SHA1、* HMAC_SHA256、* HMAC_SHA512

使用 base64 编码的字符串。
saltSeparator

string (bytes format)

要插入在盐和纯文本密码之间的一个或多个字节。为了提高安全性，此字符应为单个不可打印字符。

使用 base64 编码的字符串。
rounds

integer

用于哈希计算的轮数。仅适用于以下哈希函数：* MD5 * SHA1 * SHA256 * SHA512 * PBKDF_SHA1 * PBKDF2_SHA256 * SCRYPT
memoryCost

integer

哈希计算的内存开销。仅当哈希函数为 SCRYPT 时才需要。
users[]

object (UserInfo)

要上传的账号列表。每个用户都必须提供 localId；所有其他信息都是可选的。
delegatedProjectNumber
(deprecated)

string (int64 format)
sanityCheck

boolean

如果为 true，则该服务会在上传账号之前执行以下检查：* 重复的电子邮件地址 * 重复的联合身份 * 联合身份提供程序验证。如果要上传的账号列表中存在重复项，则会导致无法上传整个列表。如果电子邮件地址或联合身份 ID 与项目/租户中已有的用户重复，系统将不会上传该账号，但其他账号不会受到影响。如果为 false，系统会跳过这些检查。
allowOverwrite

boolean

是否使用请求中的匹配 localId 覆盖 Identity Platform 中的现有账号。如果为 true，系统会覆盖现有账号。如果为 false，则会返回错误。
cpuMemCost

integer

STANDARD_SCRYPT 哈希函数要使用的 CPU 内存消耗参数。此参数以及 blockSize 和 cpuMemCost 有助于调整哈希密码所需的资源，并且应随着处理器速度和内存技术的进步而进行调整。
parallelization

integer

STANDARD_SCRYPT 哈希函数要使用的并行化开销参数。此参数以及 blockSize 和 cpuMemCost 有助于调整哈希密码所需的资源，并且应随着处理器速度和内存技术的进步而进行调整。
blockSize

integer

STANDARD_SCRYPT 哈希函数使用的块大小参数。此参数以及并行化和 cpuMemCost 有助于调整哈希密码所需的资源，并且应随着处理器速度和内存技术的进步而进行调整。
dkLen

integer

STANDARD_SCRYPT 哈希函数的所需密钥长度。不得低于 1。
passwordHashOrder

enum (PasswordHashOrder)
tenantId

string

账号所属的 Identity Platform 租户的 ID。
argon2Parameters

object (Argon2Parameters)

Argon2 哈希算法的参数。

响应正文

如果成功，则响应正文包含一个 UploadAccountResponse 实例。

授权范围

需要以下 OAuth 范围之一：

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

如需了解详情，请参阅 Authentication Overview。