通知

Duet AI 现已更名为 Google Workspace 专用 Gemini。了解详情

通过 CSV 文件添加或更新多个用户

对于贵单位订阅的 Google 服务(例如 Google Workspace 或 Cloud Identity),您的团队成员必须有用户帐号才能登录和使用它们。如果您有许多新用户,则可以通过 CSV 文件一次性添加对应的所有帐号。

您也可以通过电子表格或 CSV 文件更新多个现有帐号。

全部展开  |  全部收起

准备工作

确保此方式适合您
  • 如果您需要上传大量用户,可以使用 CSV 文件。如果您使用新许可[仅限上传]列分配或更新新许可,则用户数上限为 200 位,否则,用户上限为 15 万位。如要详细了解新许可[仅限上传]列,请参阅列参考文档
  • 但是,如果您使用 LDAP 服务器(例如 Microsoft Active Directory)或具备编程技能,建议您选用其他适合大型单位的方式。有关详情,请参阅添加用户的各种方式
了解帐号许可和结算
  • (包年套餐客户)确保您拥有足够的许可:在添加用户之前,您可能需要先向您的帐号添加新许可。了解如何获取更多许可
  • (弹性方案客户)您的订阅费用取决于您拥有多少用户:添加用户帐号后,您的每月付款额会增加。
  • (Google Workspace 商务版客户)您可以添加的用户上限为 300 位企业版方案的用户数量无限制。
  • 优先应用自动分配许可设置:如果您将用户添加到启用了自动分配许可功能的单位部门,则系统会优先应用自动分配许可设置,而不是您在 CSV 文件中为用户分配的许可。错误不会记录在日志文件中。
检查是否存在非受管帐号和访问者帐号
  • 非受管帐号 - 检查您计划添加的用户是否已拥有 Google 帐号,然后按照相关步骤操作,以避免与这些帐号冲突。请参阅查找并添加非受管用户
  • 访问者帐号 - 如果用户邀请组织外没有 Google 帐号的人员在云端硬盘上展开协作,则对方会收到访问者帐号,格式如下:<访问者的用户名>@<您的域名>.com。如果您添加了一位用户,且其用户名与访问者帐号的用户名相同,则该帐号将被转换为完整的 Google Workspace 帐号。该帐号将保留其现有的云端硬盘文件权限。建议详细了解如何与访问者共享文档
已知问题
使用 CSV 文件更新多个用户时,可能会发生已知的许可管理问题。有关详情,请参阅 Google Workspace 已知问题

通过 CSV 文件添加用户

如果您使用 CSV 文件创建新帐号,用户不会收到包含凭据的新用户欢迎电子邮件。您必须单独向新用户发送帐号凭据。

提示:如果您忘记了新用户的密码,请重置密码,然后将新密码通过电子邮件发送给用户。

第 1 步:下载模板文件
  1. 登录您的 Google 管理控制台

    请使用您的管理员帐号(不是以“@gmail.com”结尾的帐号)登录。

  2. 在管理控制台中,依次点击“菜单”图标 接着点击  目录 接着点击 用户
  3. 点击页面顶部的批量更新用户

    用户表格顶部的“批量更新用户”已选中。

  4. 点击下载空白 CSV 模板,以下载逗号分隔值 (CSV) 文件。
  5. 在电子表格应用(例如 Google 表格或 Microsoft Excel)中打开此 CSV 文件。

    此文件中的列对应于可能出现在各用户个人资料中的属性。个人资料会显示在管理控制台和用户的通讯录管理器中。

第 2 步:输入用户信息
  1. 针对您要添加的每位用户,请在 CSV 文件的相应列中输入以下必填信息
    • 名字
    • Last Name(姓氏)
    • Email Address(电子邮件地址):请使用“<用户名>@example.com”格式
    • Password(密码):必须至少包含 8 个字符。
    • Org Unit Path(组织部门路径)- 要将用户置于顶级组织部门,请输入 /(正斜线)。如果您尚未在管理控制台中设置单位层次结构,可以执行此操作。 您也可以输入特定组织部门的路径。

      如需详细了解列说明和格式,请参阅下文中的准则

      您的 CSV 文件应大致如下:

      用于批量上传用户的 CSV 示例文件,其中所有必填列都填有条目。

  2. (可选)如要要求用户在第一次登录帐号时重置密码,请在 Change Password at Next Sign-In(下次登录时更改密码)列中输入 TRUE。否则,请将这一列留空。
  3. (可选)要指定其他信息(例如辅助邮箱、家庭住址或许可),请在剩余列中输入相应信息。
第 3 步:保存文件

完成后,将其保存为 CSV 文件 (.csv)。

注意:

  • CSV 文件的大小上限为 35 MB。
  • 每个文件的记录数上限为 15 万条。

    如果文件较大或包含的记录较多,请在电子表格程序中打开文件,将表格拆分为不同的文件,然后将每个文件另存为 CSV 文件。请确保所有 CSV 文件均包含列标题行。

  • 要上传双字节或非 ASCII 的用户名,请先以 UTF-8 编码(包括 BOM)保存 CSV 文件。
第 4 步:上传文件
  1. 点击用户页面顶部的批量更新用户
  2. 点击附加 CSV 文件
  3. 在计算机上浏览至相应位置,然后附加 CSV 文件。
  4. 点击上传。如果出现错误,请在您的 CSV 文件中输入缺少的信息,然后重新上传。有关详情,请参阅下文中的解决常见错误

    系统会自动打开“任务”列表并显示上传进度。处理完成后,您会通过电子邮件收到一份报告。

    如果处理时出错,请从“任务”列表中下载日志文件。有关详情,请参阅下文中的解决常见错误

新用户最多可能需要 24 小时才能访问 Google 服务,并显示在目录中。不妨详细了解目录

遵循 CSV 文件格式准则

一般准则
如果您需要… 请遵循以下原则…
在一列中输入多个值 要在一列中输入多个值,例如电话号码和电子邮件地址,请使用英文逗号进行分隔(不留空格)。示例:username1@domain.com,username2@domain.com
输入包含英文逗号、换行符或英文双引号的值

将值括在英文双引号中。示例:"123 Anystreet, Anytown"

上传双字节或非 ASCII 的用户名 务必使用 UTF-8 编码保存 CSV 文件,以便读取用户名。
添加更多列 您只能在所下载文件提供的列中输入信息,而不能新增列,例如不能为自定义属性添加列。
上传现有用户 如果您在 Email Address(电子邮件地址)列中输入现有用户的电子邮件地址或电子邮件别名,那么只要您在其他列中对该用户的信息进行任何更改,系统均会相应地更新其帐号信息。
列参考

必填列

说明/格式
First Name / Last Name(名字/姓氏) 名字和姓氏分别可包含最多 60 个字符。
Email Address(电子邮件地址) 用户的登录名。输入完整的电子邮件地址:<用户名>@example.com
Password(密码) 密码区分大小写。默认情况下,密码必须至少包含 8 个字符。您可以更改单位的密码要求

如果您要更新现有用户的信息,但不想更改其密码,请输入 ****(4 个星号)。

如果还指定了 Password Hash Function(密码哈希函数),则密码列必须包含经过哈希处理的密码。例如,如果您使用 SHA-1 且密码 abc 的哈希为 xyz,请在 Password(密码)列中输入 xyz

Org Unit Path(单位部门路径)

用于指定要将用户置于哪个单位部门

如果您尚未设置单位层次结构:请输入 /(正斜线),将所有用户置于顶级单位部门。您可以将用户移至您随后创建的其他单位部门。

如果您已经设置单位层次结构:请使用以下示例中的格式,将每位用户置于所需的单位部门,可以置于顶级单位部门,也可置于下级单位部门。

示例:

  • /(将用户置于顶级单位部门请勿输入您的域名)

  • /销售(将用户置于顶级单位部门下的下级单位部门)

  • /学生/一年级

选填列

格式
Password Hash Function(密码哈希函数)[仅限上传]

请指定以下任一受支持的哈希函数:MD5SHA-1crypt

Password(密码)列必须包含经过哈希处理的密码。例如,如果您使用 SHA-1 且密码 abc 的哈希为 xyz,请在 Password(密码)列中输入 xyz

提示:您可以在网络上查找实用程序,以使用受支持的哈希函数生成经过哈希处理的密码。

Recovery Email(辅助邮箱)和 Recovery Phone(辅助电话号码)

提供用于登录验证的辅助联系信息。

  • Recovery email(辅助邮箱):您网域外的电子邮件地址。
  • Recovery phone(辅助电话号码):必须采用 E.164 格式,即必须以加号 (+) 开头,后跟国家/地区代码、区域代码和电话号码。最多可输入 15 位的号码。示例:+16505551212

    注意:各用户的辅助电话号码不得重复。如果多位用户使用了同一辅助电话号码,则系统会出于安全考虑自动屏蔽该号码。

  • Employee ID(员工 ID):部分登录验证会要求用户输入员工 ID。此 ID 可包含数字、字母和符号。有关详情,请参阅将员工 ID 添加为登录验证方式
Work/Home Address(单位/家庭地址) 如果地址中包含逗号或换行符,请将地址括在英文双引号中。示例:“123 Anystreet, Anytown”
New Primary Email(新的主电子邮件)[仅限上传] 仅用于修改现有用户帐号。指定新的主电子邮件地址(用户名)。
Building ID(建筑物 ID)、Floor Name(楼层名称)和 Floor Section(楼层分区) 要输入此类信息,请遵循这些准则操作。
Change Password at Next Sign-In(下次登录时更改密码) 如要要求用户在下次登录帐号时更改密码,请输入 TRUE;否则,请将这一列留空或输入 FALSE
New Status(新状态)[仅限上传] 仅用于修改现有用户帐号。如要封存或暂停用户,请分别输入 Archived(已封存)或 Suspended(已暂停)。如要取消封存用户或恢复已暂停的用户,请输入 Active
New Licenses(新许可)[仅限上传]

仅用于修改现有用户帐号。要为用户分配其他许可,请输入相应许可的 SKU ID。如果有多个许可 ID,请用英文逗号分隔。例如:1010020020,1010330002

一份 CSV 文件最多可包含 200 位要分配新许可的用户。

解决常见错误

上传 CSV 文件时出现的错误
错误 原因/解决方案
文件中没有内容 您的文件不包含任何信息。
文件格式有误或者列名称未知 文件中的列标题应为 First Name [Required](名字 [必填])、Last Name [Required](姓氏 [必填])、Email Address [Required](电子邮件地址 [必填])、Password [Required](密码 [必填])和 Org Unit Path [Required](单位部门路径 [必填])。
文件必须包含“<列名称>”列 缺少必填列。
nn 行中的“<列名称>”没有内容 特定行中的必填列没有内容。

例如,如果您没有输入要将用户帐号置于哪个单位部门,就会看到第 2 行中的“Org Unit Path”列 [必填] 没有内容的错误消息。请参阅上文中的 Org Unit Path(单位部门路径)部分。

文件太大,无法上传 CSV 文件大小超过 35 MB,或者文件中的记录超过 15 万条。打开文件并将表格拆分为多个文件。以 CSV 格式保存每个文件。请确保所有 CSV 文件均包含列标题行。
nn 行中的列数不正确 特定行中缺少一列。
nn 行的“Email Address [Required]”(电子邮件地址 [必填])列包含预留的用户名 某些帐号已预留,因此不能创建为用户名,例如“abuse”和“postmaster”
Action_Failed: User_LIMIT_EXCEEDED 您向 Google Workspace 版本添加的许可数量已达上限,因此您的 CSV 文件中的部分用户没有获得许可。

注意:系统将从 CSV 文件的第一行开始添加 Google 帐号,直到没有可用的许可为止。
日志文件中的错误
错误 原因/解决方案
ACTION FAILED: Validation 有条目包含不受支持的字符。如需帮助,请参阅用户和群组的命名准则
ACTION FAILED: UNKNOWN ERROR 最有可能发生了临时错误。请尝试再次上传 CSV 文件,或分批上传相关内容。如果您在 Email Address(电子邮件地址)列中输入的用户电子邮件地址的域名(@ 符号后面的部分)不正确,也会出现此错误。
ACTION FAILED: INSUFFICIENT LICENSES 您单位的 Google 帐号没有足够的许可供 CSV 文件中的所有新用户使用。系统会从第一行开始添加帐号,直到将所有可用的许可用完为止。您可以购买更多许可,然后上传 CSV 文件中剩余的用户。
ACTION FAILED: OU INVALID

此错误通常由以下格式错误造成:

  • Org Unit Path(单位部门路径)列的格式不正确。
  • 您输入的一个或多个单位部门在管理控制台中不存在。请确保您所输入的单位部门名称与管理控制台内单位层次结构中的名称一致。
ACTION FAILED: USER NAME INVALID Email Address(电子邮件地址)列中的电子邮件地址(用户名)格式不正确。请务必输入用户的完整电子邮件地址。此外,还要检查电子邮件地址中是否有空格。  
ACTION FAILED: PERMISSION DENIED Email Address(电子邮件地址)列中的用户电子邮件地址包含与贵单位 Google 帐号不相关的域名(“@”符号之后的内容)。请确保您输入的电子邮件地址包含正确的域名。
ACTION FAILED: PASSWORD INVALID 用户密码不正确。如果您尝试更新的帐号已被删除,则可能会发生这种情况。确认所使用的每位用户的密码是正确的。
ACTION FAILED: PASSWORD HASH FUNCTION INVALID Password Hash Function(密码哈希函数)列所包含的哈希函数名称不正确。
ACTION FAILED: UPDATE USER LICENSES FAILED 无法为用户更新 New License(新许可)列中的一个或多个 SKU ID。请确保 SKU ID 正确无误,而且此列的格式无误,可以添加多个 SKU ID。
ACTION FAILED: ONLY VFE ALLOWED 用户当前拥有离职员工专用保险柜 (VFE) 许可,但 New License(新许可)列中包含非 VFE 许可的 SKU ID。您无法为拥有 VFE 许可的用户添加其他类型的许可。
ACTION FAILED: UNASSIGNABLE LICENSE New License(新许可)列中包含您未订阅的产品的 SKU ID。
ACTION FAILED: MULTIPLE LICENSES IN SAME PRODUCT

由于以下原因之一,上传失败:

  • 新许可列中的 SKU ID 与当前已分配的许可具有相同的产品 ID。

    例如,如果您将许可从商务新手版更改为企业 Plus 版,那么 CSV 文件上传将失败,因为这两个版本名称的产品 ID 相同,都是 Google-Apps。有关详情,请参阅 Google 产品 ID 和 SKU ID

  • 新许可列包含的多个 SKU ID 具有分配给同一用户的相同产品 ID。
ACTION FAILED: REPEATED SKU ASSIGNMENTS FOR USER New License(新许可)列中同一个 SKU ID 出现两次或多次。
ACTION FAILED: SKU SWITCH RESTRICTED New License(新许可)列中包含某个产品的 SKU ID,但您当前的订阅不允许您升级或降级至该产品。
ACTION FAILED: UPDATING DELETED USER New License(新许可)列中包含用户帐号已被删除的 SKU ID。

如果您将用户添加到启用了自动分配许可功能的单位部门,则系统会优先应用自动分配许可设置,而不是您在 CSV 文件中为用户分配的许可。错误不会记录在日志文件中。

更新现有用户帐号

使用 CSV 文件修改帐号

当需要修改多个帐号时,从管理控制台下载帐号列表可以节省时间。

准备工作

  • 当您上传文件时,可修改的列中的任意信息将替换管理控制台中现有的信息。
  • 对于您不想更改的列,您可以将其删除(如果相应列不是必需的),也可以将其中的信息保留在文件中或删除。
  • 如果您删除某个非必要列中的所有信息,但在 CSV 文件中保留该列,那么当您上传文件时,系统不会从用户帐号中移除现有信息。
  • 如果您不想更改用户密码,请确保 Password(密码)列包含符号 ****(4 个星号)。
  • 如果您不想修改特定用户的信息,可以在 CSV 文件中保留与其对应的行或移除该行。如果您从文件中移除某位用户的所有信息,其帐号不会遭到删除。
  • 如要更改用户的用户名,请在 New Primary Email(新的主电子邮件地址)列中输入新的电子邮件地址。
  • 如果您已经为 Google Workspace 帐号更改主域名,请参阅更改主域名后批量重命名用户地址了解具体操作说明。

如何修改多个用户帐号

  1. 登录您的 Google 管理控制台

    请使用您的管理员帐号(不是以“@gmail.com”结尾的帐号)登录。

  2. 在管理控制台中,依次点击“菜单”图标 接着点击  目录 接着点击 用户
  3. 点击页面顶部的批量更新用户

    用户表格顶部的“批量更新用户”已选中。

  4. 点击以 CSV 文件格式下载用户信息,以下载包含所有用户帐号的逗号分隔值 (.csv) 文件。

    系统会自动打开“任务”列表并显示下载进度。

  5. 您的任务下,点击下载 CSV 文件
  6. 在电子表格应用(例如 Google 表格或 Microsoft Excel)中打开此 CSV 文件。

    此文件中的列与各个用户个人资料中的属性对应。

  7. 修改文件中的信息。
  8. 填完电子表格后,将其保存为 CSV 文件。
  9. 点击用户页面顶部的批量更新用户
  10. 点击附加 CSV 文件
  11. 在计算机上浏览至相应位置,然后附加 CSV 文件。
  12. 点击上传
  13. 如果出现错误,请在您的 CSV 文件中输入缺少的信息,然后重新上传。有关详情,请参阅解决常见错误

    系统会自动打开“任务”列表并显示上传进度。处理完成后,您会通过电子邮件收到一份报告。

  14. 如果处理时出错,请从“任务”列表中下载日志文件。有关详情,请参阅解决常见错误

将用户数据与 LDAP 服务器同步

如果您有 LDAP 服务器(例如 Microsoft Active Directory),则可以使用 Google Cloud Directory Sync 同步您的 Google 用户、群组和共享的联系人,使其与 LDAP 服务器中的信息保持一致。

需要他人为您代劳吗获取专业的设置帮助

相关文章

 


“Google”、Google Workspace 以及相关标志和徽标是 Google LLC 的商标。其他所有公司名和产品名是其各自相关公司的商标。

 

该内容对您有帮助吗?

您有什么改进建议?
搜索
清除搜索内容
关闭搜索框
Google 应用
主菜单
3989344197194726754
true
搜索支持中心
true
true
true
true
true
73010
false
false