Google Drive 是 Google 开发的一款文件存储和同步服务。它允许用户存储、同步和共享文件。Google Drive 是 Google Workspace 的重要组成部分,后者是 Google 面向企业推出的按月订阅服务。
你可以使用 Frappe 框架的文件选择器从 Google Drive 中选择任意文件,并将其附加到当前的 DocType 上。例如,你可以将存储在 Google Drive 中的发票 PDF 附加到 Frappe 应用中的采购发票上。
设置
Google Cloud Console
首先,我们需要获取一些凭据,以便访问 Google Drive。你可以使用设置工具,它会引导你在 Google Cloud Console 中创建项目、启用 API 并创建凭据。
如果你还没有创建应用的 API 密钥,请点击创建凭据 > API 密钥。接下来,在API 密钥部分找到你的 API 密钥。你可以打开 API 密钥并对其进行限制。
- 在应用限制下选择“HTTP 来源”,
- 在网站限制下添加你的 Frappe 实例的主机名,
- 在API 限制下选择“限制密钥”并勾选“Google Picker API”。
如果你还没有创建 OAuth 2.0 凭据,请点击创建凭据 > OAuth 客户端 ID。
- 在应用类型下选择“Web 应用”,
- 在已授权的 JavaScript 来源下添加你的 Frappe 实例的主机名。
创建凭据后,你可以在“凭据”页面上看到你的客户端 ID。
最后但同样重要的是,你需要配置 OAuth 同意屏幕。这是用户首次使用 Google Drive 选择器时会看到的页面。它会请求用户授权访问其 Google Drive。你可以根据自己的需要进行配置,只需注意在范围页面上添加范围 https://www.googleapis.com/auth/drive.readonly。
你还需要准备好你的应用 ID。这是你的项目编号,可以在IAM 和管理 > 设置下找到。
本节的某些内容基于 Google 创建并共享的作品进行了修改,并根据 Creative Commons 4.0 署名许可中描述的条款使用。
Frappe 实例
现在 Google Picker API 已启用,并且我们拥有了必要的凭据,接下来就可以在你的 Frappe 实例中配置Google 设置了。
- 打开Google 设置。
- 勾选启用复选框。
- 在“Google Drive 选择器”部分,勾选启用 Google Drive 选择器复选框。
- 输入你的应用 ID、客户端 ID 和 API 密钥。
- 保存Google 设置并重新加载浏览器窗口。
现在,当你点击侧边栏中的“附加文件”时,你应该能看到 Google Drive 图标。
如果你是第一次点击它,需要授权 Frappe 应用访问你的 Google Drive 文件。
然后 Google Drive 选择器会打开,你可以选择一个文件。
点击左下角的蓝色按钮,将该文件的链接附加到当前 DocType 上。
如果你在寻找技术细节,Google Drive 是在拉取请求 #12715 中引入的。