Gmail 插件
Gmail 插件 将 Odoo 数据库与 Gmail 收件箱集成，用户可以在 Gmail 与 Odoo 之间同步工作信息，避免信息丢失。
::: seealso
了解 Odoo 如何处理您的数据，请阅读 Odoo 的 隐私政策 和 使用条款 <../../../../legal>。
:::
Odoo Online 用户
针对托管在 Odoo Online（或 Odoo.sh）上的数据库，按以下步骤配置 Gmail 插件。
安装 Gmail 插件
- 首先登录用户希望连接到 Odoo 的 Gmail 帐号。
- 在 Gmail 收件箱的右侧面板点击加号图标以获取插件。如果侧边面板不可见，点击收件箱右下角的箭头图标将其展开。
{.align-center}
- 使用搜索栏搜索 Odoo，找到
Odoo Inbox Addin。
{.align-center}
- 或者直接前往 Google Workspace Marketplace 的
Odoo Inbox Addin页面。 - 找到插件后点击 Install，再点击 Continue 开始安装。
- 选择要连接到 Odoo 的 Gmail 帐号，然后点击 Allow 允许 Odoo 访问该 Google 帐号。Google 将弹出窗口确认安装成功。
配置 Odoo 数据库
必须在 Odoo 数据库中启用 Mail Plugin 功能才能使用 Gmail 插件。操作路径：设置 --> 常规设置，在 集成 区域激活 Mail Plugin，随后点击 保存。
{.align-center}
配置 Gmail 收件箱
在 Gmail 收件箱右侧面板会出现紫色的 Odoo 图标，点击该图标打开插件窗口。随后点击任意邮件，再在插件窗口点击 Authorize Access 授权 Odoo 访问 Gmail 收件箱。
{.align-center}
接着点击 Login，输入用户希望连接的 Odoo 数据库 URL 并登录。
:::: note
::: title
注意
:::
使用数据库的通用 URL，而不是特定页面的 URL。例如使用 https://mycompany.odoo.com，而不是 https://mycompany.odoo.com/web#cids=1&action=menu。
::::
最后点击 Allow 允许 Gmail 访问 Odoo 数据库，浏览器会显示 Success! 提示。关闭窗口后，Gmail 收件箱与 Odoo 数据库即已连接。
Odoo 本地部署用户
针对托管在除 Odoo Online（或 Odoo.sh）之外的服务器上的数据库，按以下步骤配置 Gmail 插件。
:::: note
::: title
注意
:::
根据 Google 的安全指南，插件开发者必须提供可在插件动作和重定向中使用的 URL 列表，以防止插件将用户重定向至恶意网站。详情请阅读 Google Apps Script。
由于 Odoo 只能列出 odoo.com 域名，无法列出每个本地部署客户的唯一服务器域名，故本地部署客户无法直接从 Google Workspace Marketplace 安装 Gmail 插件。
::::
安装 Gmail 插件
- 访问 Odoo 邮件插件的 GitHub 仓库。
- 点击绿色的 Code 按钮，再点击 Download ZIP 下载插件文件到本地。
{.align-center}
- 解压 ZIP 文件，进入
mail-client-extensions-master --> gmail --> src --> views，使用任意文本编辑器（如记事本、TextEdit、VS Code）打开login.ts文件。 - 删除以下三行代码：
if (!/^https:\/\/([^\/?]*\.)?odoo\.com(\/|$)/.test(validatedUrl)) {
return notify("The URL must be a subdomain of odoo.com");
}此操作去除对 odoo.com 子域的限制。
- 在 ZIP 包中进入
mail-client-extensions-master --> gmail，打开appsscript.json，将urlFetchWhitelist部分中所有odoo.com的引用替换为客户自有服务器域名。 - 同目录下打开
README.md，按照其中说明将插件文件推送为 Google 项目。
:::: note
::: title
注意
:::
执行 README.md 中的步骤前，电脑必须能够运行 Linux 命令。
::::
- 将创建好的 Google 项目共享给希望连接 Odoo 的 Gmail 帐号。随后点击 Publish → Deploy from manifest，最后点击 Install the add‑on 完成插件安装。
配置 Odoo 数据库
同上，在 Odoo 数据库的 设置 --> 常规设置 中激活 Mail Plugin 并保存。
{.align-center}
配置 Gmail 收件箱
在 Gmail 收件箱右侧面板出现紫色 Odoo 图标后，点击打开插件窗口，选中任意邮件并点击 Authorize Access 授权访问。随后点击 Login，输入 Odoo 数据库的通用 URL 并登录。
:::: note
::: title
注意
:::
使用数据库的通用 URL，例如 https://mycompany.odoo.com，而非具体页面的 URL。
::::
最后点击 Allow 允许 Gmail 访问 Odoo 数据库，浏览器显示 Success! 后关闭窗口，即完成 Gmail 与 Odoo 的连接。