组织 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 找到某家公司的邮件,并保存其中作为附件的导出文件:

text
找到 Acme Corp 本周发来的、附有 QuickBooks 导出文件的邮件,保存这些附件,并告诉我保存在哪里。

除非您指定其他文件夹,Haruno 会把附件保存在当前聊天所用文件夹内的一个隐藏文件夹中(即 Workspace 文件夹,除非您打开了别的文件夹),所以请向 Haruno 询问保存路径。两种 Google 应用都不会把任何内容放进公司的账簿,文件需要您自己添加:科目映射建立之前,使用 Add data(添加数据);科目映射建立之后,使用 Books ▸ Import Exports…(账簿 ▸ 导入导出文件…)。要找到已保存的附件,请在“Upload company files”(上传公司文件)窗口中按 ⇧⌘G,然后粘贴路径。两种应用都能发送邮件,因此通过邮件向公司索取导出文件并不需要组织应用。

把每家公司的云端硬盘文件夹放在您自己的“我的云端硬盘”中
在 Mac 上,Haruno 只能访问成员自己“我的云端硬盘”中的文件夹:公司共享给您的文件夹(位于“与我共享”中)即使通过快捷方式也无法访问,共享云端硬盘同样无法访问。因此,请在您自己的“我的云端硬盘”中为每家公司创建文件夹,共享给该公司,并在“Folders Haruno can use”(Haruno 可以使用的文件夹)中勾选它。内置应用只能看到它自己创建的文件夹,而且看不到其他人在 Google 云端硬盘中向该文件夹添加的文件。
Haruno 读取的邮件会成为对话的一部分
读取邮件的权限覆盖成员的整个邮箱,无法把 Haruno 限定在某一个标签或某一家公司的邮件范围内。聊天或定时任务读取的内容会成为对话的一部分,并经由 Inferara 的托管服务发送给模型提供方。请告诉成员,哪些邮件可以让 Haruno 读取,哪些不可以。

您需要准备什么

作为成员,您只需要一个属于该组织的 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 Workspace 的邮箱地址
Internal(内部)应用只接受贵机构自己 Workspace 中的账号;而公司的 Workspace 管理员可以阻止其未批准的应用。只有该管理员才能解除阻止。

设置组织应用

目前,账户控制台不提供登记、替换或移除组织 Google 应用的功能。如需设置或更改,请联系我们,或发送邮件至 info@inferara.com。贵组织此前保存的应用仍然有效。

成员如何连接

成员无需做任何设置:照常连接即可,Google 的授权页面上会显示该组织应用的名称。

在 Mac 上

  1. 用组织中的账户登录 Haruno。

    查看侧边栏底部的账户行,必要时先登录。未登录 Haruno 时,Google 登录会经由 Haruno 内置的应用进行,而内置应用无法读取邮件。

  2. 点击账户行,选择“Connectors…”(连接器…)。

    如果应用发生变化时该窗口已经打开,请关闭后重新打开。

  3. 点击 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.(凭据被拒绝——请重新登录以重新连接。)。这种情况以及其他连接器问题,参见“故障排除 ▸ 连接器”。

后续步骤

成员在“Connectors”(连接器)窗口中连接。