使用您自己的 Google 应用
通过您自己创建的 Google 应用连接 Gmail、Google 日历和 Google 云端硬盘，由您决定 Haruno 可以做什么。
这是什么
当您连接 Gmail、Google 日历或 Google 云端硬盘时，Haruno 会先向 Google 请求您的授权。通常它是通过 Haruno 自己的 Google 应用来请求的，而该应用刻意只申请很小的一组权限。
您也可以改为注册自己的 Google 应用。这是免费的，在 Google 自己的网站上一次性完成。之后 Haruno 通过您的应用连接，授权页面就属于您。您可以按需授予更多权限：阅读邮件，以及访问整个 Google 云端硬盘，而不仅仅是一个 Haruno 文件夹。
您需要准备什么
- 一个 Google 账号。普通的 Gmail 地址即可，不需要 Google Workspace。
- 大约 15 到 30 分钟，只需一次。
- 无需付费。创建自己的 Google 应用是免费的。
- 已在 Mac 或 PC 上安装的 Haruno，以及最后 Google 提供给您的文件。
这项设置只做一次。之后连接 Gmail、Google 日历和 Google 云端硬盘的方式与以前完全相同。
开始之前：需要有心理准备的两点
在花时间之前，有两点值得了解，它们都取决于您在第 3 步中的一个选择。
在该警告页面上，请选择“高级”，然后选择继续。Google 警告的这个应用就是您自己的应用。
您也可以请 Google 审核并发布您的应用，从而取消每周重新登录。但审核需要时间，而且申请阅读邮件的应用还需要通过一项安全评估，这需要由您自行安排并承担费用。对于个人自用的应用，保持测试状态并每周重新登录通常更简单。
创建您的 Google 应用
- 打开 Google Cloud 控制台，用您想使用的 Google 账号登录。新建一个项目，名称随意，例如“Haruno”。
- 在新项目中打开“API 和服务”，启用其中三项：Gmail API、Google Calendar API 和 Google Drive API。即使您只打算连接其中一项，也请三项都启用，以免之后还要回来。
- 打开授权页面（同意屏幕）设置，填写应用名称和您的电子邮件地址。在受众类型中，如果使用普通 Gmail 账号请选择“外部”；如果您有 Google Workspace 并希望免去每周重新登录，请选择“内部”。
- 如果选择了“外部”，请找到测试用户列表，把您打算连接到 Haruno 的每一个 Google 账号都加进去，包括您自己的账号。这是最容易被忽略的一步。不在该列表中的账号无法登录，无论其他设置多么正确——而且每新增一个要连接的账号，都需要在这里单独添加。
- 打开“凭据”，选择创建凭据，选择“OAuth 客户端 ID”，并将应用类型选为“桌面应用”。网页应用类型的客户端无法与 Haruno 配合使用。
- 在客户端创建后 Google 立即提供的下载按钮处，马上下载 JSON 文件。密钥只会显示这一次。
- 在 Haruno 中打开“设置”，然后是“连接器”，选择使用您自己的 Google 应用。上传刚才下载的文件，或从中复制客户端 ID 和客户端密钥。之后照常连接 Gmail、Google 日历或 Google 云端硬盘——您看到的授权页面现在属于您自己的应用。
Google 会不时修改这些页面的名称。如果某个页面的措辞与上述步骤略有不同，请按含义查找，而不是逐字对照。
每项权限分别解锁什么
连接时，Google 会显示一份带复选框的权限列表，您可以逐项选择。取消勾选某一项，只是意味着 Haruno 无法执行该行中的操作。
| Google 页面上的权限 | Haruno 因此可以做什么 |
|---|---|
| 代表您发送邮件 | 撰写并发送邮件，以及发送您已批准的回复。 |
| 阅读、撰写和删除您的邮件 | 搜索和阅读邮件、打开附件、在会话中回复、用标签整理邮件，以及把邮件移到回收站。 |
| 管理您的邮件标签 | 创建、重命名和应用标签。如果已授予上一行权限，则已包含在内。 |
| 查看和编辑您所有日历上的事件 | 查看日程，并创建、修改或取消事件。 |
| 仅查看、编辑、创建和删除您在此应用中使用的 Google 云端硬盘文件 | 在云端硬盘中的一个 Haruno 文件夹内工作，外加您自己选定的文件。 |
| 查看、编辑、创建和删除您全部的 Google 云端硬盘文件 | 使用整个 Google 云端硬盘，并保持您选择的文件夹处于同步状态。 |
切换回去或移除您的应用
您可以随时改变主意。在 Haruno 的设置中移除您的 Google 应用后，新建的连接会重新使用 Haruno 内置的应用。
已经建立的连接会继续使用创建它们的那个应用，所以切换的瞬间不会有任何东西中断。当某个连接确实需要迁移时，Haruno 会在该连接器上说明原因，而重新登录只需要几秒钟。
遇到问题时
| 您看到的内容 | 含义与处理方法 |
|---|---|
| Error 403: access_denied | 您登录所用的账号不在应用的测试用户列表中。请在 Google Cloud 控制台中添加——每个要连接的账号都需要单独添加——然后重试。 |
| 浏览器显示错误页面，而不是 Google 的登录页面 | 您创建的客户端是网页应用类型。请重新创建一个，并把应用类型选为“桌面应用”。 |
| Haruno 大约每周要求您重新登录 Google | 您的应用仍处于测试状态。这是 Google 的规则，不是故障。重新登录只需几秒钟；使用 Google Workspace 的内部应用可以完全取消该限制。 |
| 提示中包含 accessNotConfigured | 三项服务中有一项未在您的项目中启用。请回到“API 和服务”，启用 Gmail、Google Calendar 和 Google Drive API。 |
| “Google 尚未验证此应用” | 这在此处是预期且安全的：这是您自己的应用，只是尚未经过 Google 审核。请选择“高级”，然后继续。 |
| Haruno 要求您重新登录以完成切换 | 该连接是用另一个应用建立的——可能是 Haruno 内置的应用，或您先前的应用。在该连接器上重新登录即可迁移。 |