Obsidian 插件新篇章：如何将 Gmail 订阅内容无缝同步至你的知识库

背景

最近在学习 AI 相关的内容，跟学习搭子们在讨论如何获取 AI 相关的信息来源时，发现一个小问题，就是没有办法把 Gmail 上订阅的 AI 信息邮件自动同步到 Obsidian 中，每次都需要手动将里面比较有价值的东西复制出来，所以有人提出是否可以利用 Obsidian 的第三方插件，实现自动将 Gmail 上订阅的内容，同步到我们本地的 Obsidian 里面。这样只需打开 Obsidian 一个应用，没必要来回切换应用，也不需要手动复制了。

本文以 obsidian-google-mail 插件为例，将安装 Obsidian 插件并应用的过程梳理出来，既算是一篇 Obsidian 第三方插件的安装教程，也算是一篇 obsidian-google-mail 插件配置的教程，希望大家各取所需。

本文不会涉及 Obsidian 软件本身的说明，默认你已经是 Obsidian 用户。同时默认在需要同步 Gmail 订阅内容的整个过程中，你都拥有访问 Gmail 的相关能力。

本文所有操作均基于 Win 11 系统 + Obsidian 1.5.3 版本。

将刚才下载的 3 个文件，放到一个目录中，可以命名为 obsidian-google-mail (其实无所谓，因为最终插件名是由 manifest.json 中的 name 字段决定)
将 obsidian-google-mail 目录放到步骤4中打开的第三方插件目录中，也就是 xxx\.obsidian\plugins 目录
重启 Obsidian ，刷新第三方插件，开启刚才导入的插件即可
如果插件正常安装，则效果应该如下所示

obsidian-google-mail 插件配置

obsidian-google-mail 插件的配置，主要包括3个部分，分别是申请可以调用 Gmail API 的 Credential，关联 Gmail 和 Obsidian 同步，配置 Gmail 中需要同步的邮件标签。

整个 obsidian-google-mail 插件的配置，其作者都在项目的 README.md 中有说明，如果你习惯于看项目原有的文档，也可以直接按照相关步骤操作。

获取 Google Credential

此处主要借助 Google Cloud 的免费应用，个人基本够用，如果是团队可以考虑是否购买 Google Cloud 相关服务。如果你已经拥有可用的 Credential，可以忽略此步骤。，

此处基本可以按照 obsidian-google-mail 作者的步骤操作，很简单，看视频即可。核心步骤包括：

创建项目，并选择新建的项目
启用 Gmail API 服务
设置 Google OAuth 页面
创建 Credentials
下载并保存下载好的 Credentials JSON 文件详细过程，强烈建议按着作者文档中的视频来操作，地址：Google Cloud 设置 Credential

配置 obsidian-google-mail 插件

在进行此步骤前，请确保你已经有 Credential JSON 文件，其内容包括以下字段：

点击 Obsidian 中第三方插件 Google Mail，点击 Setup 按钮，并输入 JSON 文件中复制出来的内容

点击 Submit 按钮，此时会自动打开浏览器，按顺序依次点击继续或确定，最终会遇到以下提示：
- 浏览器会显示：Authorization successed. You can close this window.关掉浏览器即可
- Obsidian 会提示 Successful Logined，此时出现如下页面，则证明配置成功。

Mail Folder 字段，表示你将 Gmail 中的邮件放到哪个目录下，可自定义
Fetch Interval 字段，表示你想要同步 Gmail 到 Obsidian 中的频率为多久一次
Labels 字段，表示你想把哪个标签下的邮件同步过来，From 表示将要同步的标签，To 表示已经同步过的标签，避免重复同步。因此 From 标签和 To 标签是互斥的。（需要注意，From 、To 应该修改为你想要命名的标签名）

设置 Gmail 的标签

如果你已经了解如何设置 Gmail 中邮件的标签，以及知道如何通过 Gmail 过滤器自动为符合条件的邮件设置标签，则可以略过此步骤。

官方有很详细的教程，只要你按照步骤多操作几遍，基本也就可以很熟练的明白如何通过 Gmail 过滤器来自动为符合条件的邮件打标签或其他操作，具体说明，请阅读：Gmail 设置过滤器

当然为了测试标签设置是否正确，你可以在需要测试的某封邮件中，为其设置对应的标签，示例如下：

效果演示

Gmail 设置 From 标签为 AI news to Obsidian、设置 To 标签为 Already read from Obsidian，可根据你的需要进行命名
在 AI news to Obsidian 标签下，存在一封邮件，如图所示：

在 Obsidian 的 obsidian-google-mail 插件中分别配置如下：
- Mail Folder 设置为 Google Mail ，可以根据你的需要自定义命名
- Labels 分别设置为 Gmail 中对应的标签
- Fetch Interval 更新时间设置为每 10 分钟更新一次

等待 obsidian-google-mail 插件更新，或主动点击一次同步，可以看到邮件内容已同步到 Obsidian 中对应的目录下：

此时再查看 Gmail 中两个标签下的内容：
- AI news to Obsidian 标签下：

- Already read from Obsidian 标签下：

至此，每 10 分钟， Obsidian 中的 obsidian-google-mail 插件，将把你 Gmail 中 AI news to Obsidian 标签下的邮件，同步到 Obsidian 的 Google Mail 目录下，同时 Gmail 中这封邮件将被移动至 Already read from Obsidian 标签下。

杂谈

非常感谢 obsidian-google-mail 插件的作者，不仅实现了上述功能，同时留下了非常完善的文档，甚至是演示视频。
如果你想进一步精炼同步过来的邮件，可以继续关注 obsidian-google-mail 文档中模板部分。
在 AI 时代，除了我们手动这样借助插件实现 Gmail 的内容同步外，可以考虑 AI + RPA 的深入探索。
拥抱未来，拥抱 AI。

参考资料

Gmail to Obsidian?
Github: obsidian-google-mail

浏览知识共享许可协议

本作品采用知识共享署名-相同方式共享 4.0 国际许可协议进行许可。