智能助手
帮助中心智能助手上线
我能为你解答 Lark 使用的问题,快来问问我吧!
00:00
点击按住可拖动视频
我知道了
去试试
管理员同步 Google Workspace 组织架构数据到 Lark

管理员同步 Google Workspace 组织架构数据到 Lark

本文阅读时长:6 分钟
一、功能简介
🔖
内测信息:功能内测中
谁能操作:超级管理员或拥有组织架构数据同步权限的管理员
管理员可以通过组织架构数据同步功能,将 Google Workspace 中的用户数据同步到 Lark 对应的企业组织架构中。
二、操作流程
获取 Client ID 和 Client Secret
在 Lark 中创建 Google Workspace 同步任务前,需在 Google Cloud Console 中获取客户端 ID 和客户端密钥,具体信息请参考在 Google Cloud 中获取授权凭证
创建 Google Workspace 同步任务
🔖
说明:建议管理员在正式开启同步前,清理 Lark 中的存量组织架构数据,避免同步后产生数据不一致的情况。
  1. 进入 Lark 管理后台,点击 企业设置 > 组织架构数据同步 > 创建同步数据源
  • 250px|700px|reset
  1. 在选择数据源页面点击 Google Workspace
  1. Client ID Client Secret 中填写在 Google 中获取的客户端 ID 和客户端密钥, 点击 立即授权,选择配置 Google Workspace 时的账号,根据提示完成授权。
  • 250px|700px|reset
  1. 完成授权后,勾选 我已阅读并同意《数据迁移同步服务声明》,点击 下一步
  1. 在同步规则页面选择同步方式。
  • 手动同步:后续每次组织架构数据同步都需要管理员手动操作。首次配置建议选择手动同步。
  • 定时同步:可选择定时周期(每星期、每天或每小时)。设置后,Lark 会定期自动执行同步任务。管理员需及时关注同步状态,如遇同步出错可及时进行纠正。
  • 250px|700px|reset
  1. 启用字段映射关系。映射关系包括:预置映射关系、推荐映射关系、自定义映射关系。
  • 预置映射关系:默认为启用状态,不支持关闭、修改和删除。
  • 推荐映射关系:支持停用,不支持修改和删除。
  • 自定义映射关系:点击页面底部的 + 新增一条字段映射,可添加自定义映射关系。自定义映射关系支持修改和删除。
  1. 点击 保存并立即同步 保存配置,在弹窗中二次确认后,点击 确定
  • 保存并立即同步Lark 将立即执行一次同步任务,请谨慎选择。
  • 保存配置:如果使用手动同步方式,Lark 不会开始执行同步任务,需要管理员后续手动开始任务;如果使用定时同步方式,Lark 后续将按管理员设置的定时周期执行同步任务。
验证同步结果
完成上述步骤后,Google Workspace 用户会自动同步到 Lark 组织架构中。管理员可以通过卡片中的状态标签及连线的颜色查看同步情况。
  • 正在同步:表示数据正在同步。执行同步任务的过程中,管理员无法编辑本次任务,也无法执行下一次同步任务。
  • 等待同步:表示当前没有数据同步,待执行下一次同步,且上一次任务执行成功。如果使用定时同步,管理员可以在卡片中看到预期的下次同步时间。
  • 同步出错:表示此次同步任务完全失败,没有任何数据同步到 Lark。同步出错一般是由于授权出错导致的,需检查 Google 配置与授权账号是否正确。
  • 部分失败:表示此次任务中有一部分成员或部门同步失败。管理员可以查看同步日志来了解错误原因并进行人工纠正。
250px|700px|reset
管理同步任务
点击 Google Workspace 应用卡片,可以在同步配置详情页修改任务配置、中止同步、删除任务等操作。
  • 立即执行同步:点击 立即执行同步,手动开始一次同步任务。
  • 中止/重新启用同步:点击 中止,如果使用手动同步方式,Lark 将暂停同步任务;如果使用定时同步方式,下一个同步周期开始将不再自动进行同步。 点击 重新启用,可恢复任务。
  • 编辑任务:点击 编辑任务 可修改设置。修改后的设置将在下次同步时生效。
  • 删除任务:如果你不再需要该应用,你可以点击 图标 > 删除任务,删除应用。
:应用删除后无法恢复,所有的配置都会丢失。已经完成同步的用户不受影响。
250px|700px|reset
查看同步日志
点击 Google Workspace 应用卡片上的 同步日志,在日志列表中点击右侧 查看详情,可查看同步的成员和部门信息。
250px|700px|reset
三、常见问题
问:如果开启 Google Workspace 组织架构数据步前,Lark 已有的存量数据,系统将如何进行匹配?
答:
  • 成员匹配规则:系统将按照工作邮箱字段匹配存量成员。如果 Lark 中的工作邮箱信息和 Google Workspace 中的一致,则判定为同一成员。如果 Lark 中的成员未匹配到 Google Workspace 中的对应用户,这些成员将会在 Lark 中继续保留。
  • 部门匹配规则:系统将按照部门默认名称及部门路径匹配存量部门。如果 Lark 中的部门默认名称、上级部门和 Google Workspace 中的一致,则判定为同一部门。如果 Lark 中的成员未匹配到 Google Workspace 中的对应部门,这些部门将会在 Lark 中继续保留。
基于以上系统匹配规则,建议管理员在正式开启同步前,清理 Lark 中的存量组织架构数据,避免同步后产生数据不一致的情况。
问:如果同步任务“部分失败”,如何进行人工纠正?
答:管理员可以在同步日志详情中查看错误原因,并根据具体原因,到 Google 管理后台更正信息,重新执行同步任务。
例如,日志详情中显示一名户成员同步失败,原因是用户信息中包含敏感词。管理员可以到 Google 管理后台修改该成员的姓名后再次执行同步任务。
问:在 Lark 中编辑来自 Google Workspace 的组织架构数据,会更新到 Google Workspace 吗?
答:不会,Google Workspace & Lark 组织架构数据同步是单向的,只会从 Google Workspace 同步到 Lark。
不建议在 Lark 编辑来自 Google Workspace 的组织架构数据(例如成员姓名、部门名称等),因为可能会导致 Lark 和 Google Workspace 中的数据不一致;且如果 Google Workspace 中的数据变更后再次同步到 Lark,之前在 Lark 中编辑过的信息会被重新覆盖并丢失。
作者Lark 帮助中心
最后更新于2025-02-26
评价此内容
提交成功,感谢你的反馈!
未能解决你的问题?请联系在线客服
0
rangeDom
rangeDom
rangeDom
rangeDom