组织 Google 应用
组织 Google 应用是什么,它能让成员的 Gmail、Google 日历和 Google 云端硬盘连接做些什么,以及成员所在的组织有这样的应用时,成员会看到什么。
什么是组织 Google 应用
有人连接 Gmail、Google 日历或 Google 云端硬盘时,Haruno 会通过一个 Google 应用向 Google 请求授权:要么是 Haruno 内置的应用,要么是贵组织自己的应用。如果贵组织有这样的应用,成员新的登录都会经由它,Google 的授权页面上也会显示该应用的名称。它改变的是 Haruno 在聊天和定时任务中能做的事;月末结账从不读取这些服务。
- 它是贵组织所控制的某个 Google Cloud 项目中的一个桌面应用类型的客户端。每个组织只有一个;Mac 版和 Windows 版应用中都没有相应的设置项。
- Haruno 以加密方式保存客户端密钥,只提供给已登录成员的 Haruno 应用。Haruno 的任何界面都不会显示它。
- 它不会让您访问任何人的邮箱、日历或云端硬盘:每位成员登录的是自己的 Google 账号,登录信息只保存在成员本人的电脑上。
- 现有连接只有在成员重新登录该连接器后才会改用它。在 Windows 上,只有当成员选择“My Drive”(我的云端硬盘)时,Google 云端硬盘才会使用它。
财务团队为何要使用组织应用
如果您希望 Haruno 找到某家公司发来的邮件并保存其中作为附件的导出文件,或者处理您自己的 Google 云端硬盘中已有的文件夹,就需要一个组织应用。读取邮件和访问整个云端硬盘都属于 Google 限制的权限,Haruno 内置的应用不会请求这些权限;贵组织自己拥有的应用则可以请求。
| Haruno 能做什么 | 内置应用 | 贵组织的应用 |
|---|---|---|
| 发送带附件的邮件;创建和重命名 Gmail 标签 | 可以 | 可以 |
| 搜索和阅读邮件、保存附件、在邮件会话中回复、将邮件移到回收站 | 不可以 | 可以 |
| 访问 Google 云端硬盘 | 仅限 Haruno 创建的文件夹 | 成员自己“我的云端硬盘”中的文件夹,前提是成员保留完整的云端硬盘访问权限 |
使用贵组织的应用后,成员可以在聊天中请 Haruno 找到某家公司的邮件,并保存其中作为附件的导出文件:
找到 Acme Corp 本周发来的、附有 QuickBooks 导出文件的邮件,保存这些附件,并告诉我保存在哪里。除非您指定其他文件夹,Haruno 会把附件保存在当前聊天所用文件夹内的一个隐藏文件夹中(即 Workspace 文件夹,除非您打开了别的文件夹),所以请向 Haruno 询问保存路径。两种 Google 应用都不会把任何内容放进公司的账簿,文件需要您自己添加:科目映射建立之前,使用 Add data(添加数据);科目映射建立之后,使用 Books ▸ Import Exports…(账簿 ▸ 导入导出文件…)。要找到已保存的附件,请在“Upload company files”(上传公司文件)窗口中按 ⇧⌘G,然后粘贴路径。两种应用都能发送邮件,因此通过邮件向公司索取导出文件并不需要组织应用。
您需要准备什么
作为成员,您只需要一个属于该组织的 Haruno 账户:用它登录 Haruno,然后照常连接 Google 服务(成员如何连接)。一个人只能属于一个组织(组织)。
选择 Internal 还是 External
如果每位成员连接的都是贵机构自己的 Google Workspace 中的账号,请选择“Internal”(内部);如果要连接其他任何 Google 账号,请选择“External”(外部)。
| 目标对象 | 谁可以连接 | 成员会遇到什么 |
|---|---|---|
| Internal(内部) | 仅限贵机构 Google Workspace 中的账号 | 无需每周重新登录,也不会出现未经验证的应用警告。 |
| External(外部),处于测试状态 | 仅限您添加的测试用户 | Google 可能会警告该应用尚未经过其验证。每次登录的有效期约为七天。测试用户列表和 Data Access(数据访问)中的权限由您维护。 |
| External(外部),已结束测试 | 测试用户以外的账号 | 无需每周重新登录,但在 Google 验证该应用之前,成员可能会看到未经验证的应用警告。Google 可能要求对敏感或受限范围进行验证;读取邮件和完整的云端硬盘访问权限都属于受限范围。 |
在 Mac 上,每周的登录失效之前,Haruno 不会发出任何提醒。下次使用该连接器时,其所在行会显示 Credential rejected — sign in again to reconnect.(凭据被拒绝——请重新登录以重新连接。),聊天中也会出现类似这样的提示:“Gmail rejected its saved sign-in. Reconnect it in Connectors — its tools are off until you do.”(Gmail 拒绝了已保存的登录信息。请在“Connectors”(连接器)中重新连接——在此之前,它的工具处于关闭状态。)在最长一天的时间内,或在成员重新登录之前,新对话都不会包含该连接器。Google 的警告内容为“Google hasn't verified this app”(Google 尚未验证此应用):请把贵组织应用的名称告诉成员,让他们只在看到这个名称时才继续。
设置组织应用
目前,账户控制台不提供登记、替换或移除组织 Google 应用的功能。如需设置或更改,请联系我们,或发送邮件至 info@inferara.com。贵组织此前保存的应用仍然有效。
成员如何连接
成员无需做任何设置:照常连接即可,Google 的授权页面上会显示该组织应用的名称。
在 Mac 上
- 用组织中的账户登录 Haruno。
查看侧边栏底部的账户行,必要时先登录。未登录 Haruno 时,Google 登录会经由 Haruno 内置的应用进行,而内置应用无法读取邮件。
- 点击账户行,选择“Connectors…”(连接器…)。
如果应用发生变化时该窗口已经打开,请关闭后重新打开。
- 点击 Gmail 或 Google 日历所在行的“Sign in”(登录),在 Google 页面上保持所有权限处于勾选状态,然后允许访问。
该行随后会显示 Connected through your organization's Google app(已通过您组织的 Google 应用连接);其下方的确认开关默认处于开启状态(参见“连接器确认开关”)。关于 Google 云端硬盘,参见“连接 Google 云端硬盘”。
成员在组织应用设置之前已经连接时
该连接会继续有效;其所在行会显示类似这样的内容:Gmail is still connected through Haruno's built-in Google app. Sign in again to switch to your organization's Google app.(Gmail 仍通过 Haruno 内置的 Google 应用连接。请重新登录,以切换到您组织的 Google 应用。)请在该行的 ⋯ 菜单中选择 Sign in again(重新登录);如果是 Google 云端硬盘,则依次点击 Edit…(编辑…)、Continue to Google Drive(继续前往 Google 云端硬盘)和 Save(保存)。改为完整的云端硬盘访问权限后,云端硬盘中已选的文件夹会被清除:请用 Choose folders…(选择文件夹…)重新选择。
在 Windows 上
在 Windows 上,Google 连接器——位于 Settings ▸ Connectors(设置 ▸ 连接器)的 Integrations(集成)卡片中——使用的是同一个应用:只要成员已登录 Haruno,Gmail 和 Google 日历的每个新连接都会使用它。Google 云端硬盘则会先询问:选择“Haruno connection folder”(Haruno 连接文件夹)时使用内置应用,只能访问 Haruno 在该文件夹中创建的文件;选择“My Drive”(我的云端硬盘)时使用贵组织的应用,拥有完整的云端硬盘访问权限,前提是已保存组织应用且成员已登录 Haruno。
| 成员在 Windows 上看到的消息 | 处理方法 |
|---|---|
| Sign in to Haruno before connecting My Drive.(连接“我的云端硬盘”之前,请先登录 Haruno。) | 登录 Haruno,然后再连接。 |
| My Drive requires a Google app configured by your organization. …(“我的云端硬盘”需要由您组织配置的 Google 应用。…) | 联系我们了解组织应用(参见“设置组织应用”),或改选“Haruno connection folder”。 |
| Your organization's Google app could not be checked, so this sign-in was stopped. …(无法检查您组织的 Google 应用,因此已停止本次登录。…) | Haruno 未能获取贵组织的应用。请重试。 |
| Update this integration before connecting it with your organization's Google app.(请先更新此集成,再通过您组织的 Google 应用连接它。) | 更新该连接器,然后再连接。 |
| These Gmail permissions require an organization Google app. …(这些 Gmail 权限需要组织 Google 应用。…) | 本次连接没有使用组织应用。请联系我们了解组织应用,然后重新连接 Gmail。 |
| Choose either the Haruno connection folder or My Drive before connecting Google Drive.(连接 Google 云端硬盘之前,请在 Haruno 连接文件夹和“我的云端硬盘”之间选择其一。) | 在“Google Drive access”(Google 云端硬盘访问)字段中选择一项。 |
每项权限分别解锁什么
成员可以在 Google 的授权页面上取消勾选某些项目。Gmail 必须具有发送权限,Google 云端硬盘至少需要一项云端硬盘权限;取消勾选其他权限仍可连接,只是能做的事更少。
| 范围 | 请求方 | 允许的操作 |
|---|---|---|
| openid、userinfo.email | 贵组织的应用 | 识别连接的是哪个 Google 账号。 |
| gmail.send(Google 页面上显示为“Send email on your behalf”,即“代表您发送电子邮件”) | 两种应用 | 发送带附件的邮件。必需。 |
| gmail.labels | 仅内置应用 | 创建和重命名标签(贵组织的应用改用 gmail.modify)。 |
| gmail.modify | 贵组织的应用 | 搜索、阅读和回复邮件,保存附件,管理标签,将邮件移到回收站。 |
| calendar.events | 两种应用 | 读取日历,以及创建、更改或取消日历活动。 |
| drive.file | 内置应用;在 Mac 上也包括贵组织的应用 | 只能访问 Haruno 在自己的文件夹中创建的文件。 |
| drive | 贵组织的应用 | 访问成员自己的“我的云端硬盘”;在 Mac 上仅限成员选择的文件夹。 |
成员取消勾选某项权限时
在 Mac 上,如果未授予以下权限:
- “Send email on your behalf”(代表您发送电子邮件):Gmail 无法连接,并显示“Google did not grant permission to send email, so Gmail was not connected. …”(Google 未授予发送电子邮件的权限,因此未连接 Gmail。…)。
- 读取邮件(gmail.modify):Gmail 只能发送邮件,其说明文字的末尾会显示“Reading mail needs the Google app your organization sets up.”(读取邮件需要您组织设置的 Google 应用。)
- 所有云端硬盘权限:Google 云端硬盘无法连接,并显示“Google did not grant access to Drive, so the connection was not created. …”(Google 未授予云端硬盘访问权限,因此未创建连接。…)。
- 仅完整的云端硬盘访问权限:云端硬盘只能访问 Haruno 文件夹;以这种方式缩小了权限的现有连接会发出警告:“This connection now only sees the Haruno folder in your Google Drive. …”(此连接现在只能看到您 Google 云端硬盘中的 Haruno 文件夹。…)
每种情况的解决方法都一样:重新登录,并保持所有权限处于勾选状态。
这对定时任务意味着什么
在 Mac 上的定时任务中,贵组织的应用让 Haruno 可以不经询问就搜索、阅读邮件,并将其移到回收站;Gmail 会将移到回收站的邮件保留 30 天,之后便无法恢复。除非该任务获准自行发送,否则邮件和回复仍会在“Waiting”(待处理)中等待;在拥有读取邮件权限的情况下,每封暂存的邮件还会同时出现在成员的 Gmail 草稿中。参见“哪些操作会等待,哪些会立即执行”。
替换或移除组织应用
目前,账户控制台同样不提供替换或移除组织应用的功能:请联系我们,或发送邮件至 info@inferara.com。解散组织也会移除其应用。没有组织应用时,新的 Gmail 和 Google 日历登录都会使用 Haruno 内置的应用,因此 Gmail 无法读取邮件;在 Mac 上,新的 Google 云端硬盘连接只能访问一个 Haruno 文件夹;在 Windows 上,重新保存组织应用之前,无法连接“My Drive”(我的云端硬盘)。
成员的连接会怎样
Google 那边不会有任何改变;Mac 上的连接会按下表处理。Mac 会在 Haruno 启动或打开“Connectors”(连接器)窗口时获知变更;成员无需退出登录 Haruno,也无需重新启动它。
| 变更 | 在 Mac 上 |
|---|---|
| 更换密钥,客户端 ID 不变 | 连接继续有效。 |
| 换成另一个客户端 | 经由旧应用建立的连接停止工作:“Gmail was connected through an older Google app. Sign in again to move it to the one your organization uses now.”(Gmail 是通过较早的 Google 应用连接的。请重新登录,将其转到您组织当前使用的应用。) |
| 移除了应用,或解散了组织 | 经由该应用建立的连接停止工作:“Gmail was connected through a Google app that is no longer set up. Sign in again to reconnect through Haruno's built-in app, which has less access.”(Gmail 是通过一个已不再设置的 Google 应用连接的。请重新登录,改为通过 Haruno 内置的应用连接,但其访问权限较少。) |
| 成员退出登录 Haruno、离开组织或被移出组织 | 经由贵组织应用建立的连接会停止工作,直到该成员以组织成员的身份重新登录 Haruno。 |
| 经由内置应用建立的连接,遇到以上任一情况 | 连接继续有效。 |
请让成员重新登录:在该行的 ⋯ 菜单中选择 Sign in again(重新登录);如果是 Google 云端硬盘,则依次点击 Edit…(编辑…)、Continue to Google Drive(继续前往 Google 云端硬盘)和 Save(保存)。云端硬盘所在行可能显示 This connection was set up through a Google app that is no longer configured. Sign in again to reconnect.(此连接是通过一个已不再配置的 Google 应用建立的。请重新登录以重新连接。)移除组织应用后,云端硬盘重新连接时只能访问 Haruno 自己的文件夹,并且需要重新选择要使用的文件夹。在此之前,新对话中该连接器的工具处于关闭状态。
在 Windows 上,Gmail 和 Google 日历的连接会沿用建立时所用的应用;成员需要重新连接,才会改用贵组织当前的应用。
遇到问题时
大多数登录问题都出在 Google Cloud 项目上,只有管理员才能解决。
在账户控制台中
账户控制台目前没有 Google 应用卡片,因此那里不会出现有关该应用的任何消息。如有任何与已保存的应用有关的问题,请联系我们,或发送邮件至 info@inferara.com。
在成员的 Mac 上
| 成员看到的内容 | 含义与处理方法 |
|---|---|
| Google didn't finish the sign-in. If you didn't cancel it yourself, …(Google 未完成登录。如果不是您自己取消的,…),或者 Google 页面上显示 Error 403: access_denied | 成员取消了登录,或者该账号不是测试用户。请在“Test users”(测试用户)中添加该账号。 |
| 在“Waiting”(待处理)中发送时显示 Google didn't accept the Google app this sign-in used, …(Google 未接受本次登录所使用的 Google 应用,…),或者出现 Google 错误页面,而不是授权页面 | 该客户端已被删除或停用,或者其密钥已不匹配。如有需要,请创建一个新的桌面应用类型客户端,并请我们替换组织应用。成员随后重新登录;如果该行仍显示“Finish signing in in your browser…”(请在浏览器中完成登录…),请先点击“Cancel”(取消)。 |
| 聊天中、暂存项目上(显示“Google refused it (403).”,即 Google 拒绝了请求(403))或云端硬盘对话框中(显示“Request failed (403) …”,即请求失败(403)…)提示该 API 此前未在项目中使用过或已被停用 | 启用该服务的 API。无需重新登录。 |
| Your Google Workspace administrator blocks this app, so it can't be connected. …(您的 Google Workspace 管理员阻止了此应用,因此无法连接。…) | 必须由该邮箱地址所属的 Workspace(可能是某家公司的 Workspace)允许此应用。 |
| This Google account isn't part of your organization's Google Workspace, …(此 Google 账号不属于您组织的 Google Workspace,…) | 贵组织的应用是 Internal(内部)类型。请使用工作账号登录;其他邮箱地址需要 External(外部)应用。 |
| Haruno couldn't read your organization's Google app just now, …(Haruno 刚才无法读取您组织的 Google 应用,…) | Haruno 会停止登录,而不会改用其他应用登录。请过几分钟再试。 |
| This connection can't be used right now — … Unlock your keychain and try again.(此连接目前无法使用——… 请解锁钥匙串后重试。) | 解锁这台 Mac 的登录钥匙串。 |
| Google returned no refresh token. …(Google 没有返回刷新令牌。…) | 在该 Google 账号的设置中移除 Haruno 的访问权限,然后重新登录。 |
已保存的登录被拒绝时,该行会显示 Credential rejected — sign in again to reconnect.(凭据被拒绝——请重新登录以重新连接。)。这种情况以及其他连接器问题,参见“故障排除 ▸ 连接器”。