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