配置Google Drive同步(自备凭据)

要在Plainva中把本地仓库与你的Google Drive同步,你可以使用自己的Google API凭据。由于Plainva尚未通过Google的中心化CASA验证,这种**自备凭据(BYO)**方式为同步你的私人文件提供了一种安全的途径。

你实际上是在Google那边为自己搭建了一个只属于你自己、也只有你能访问的小型”开发者项目”。

分步指南

1. 在Google Cloud Console中创建一个项目

  1. 前往Google Cloud Console
  2. 使用你的Google账户登录。
  3. 在左上角(Google Cloud标志旁边),打开项目下拉菜单,选择新建项目
  4. 输入一个名称(例如”Plainva Sync”),然后点击创建

2. 启用Google Drive API

  1. 在顶部的下拉菜单中选择你刚创建的项目。
  2. 在顶部搜索栏中搜索Google Drive API,并在”Marketplace”下选择该条目。
  3. 点击启用

3. 配置OAuth同意屏幕

为了让Plainva使用你的凭据,需要设置一个同意屏幕(“OAuth Consent Screen”)。由于只有你自己使用这个应用,它可以一直保持在”测试”模式。

  1. 在左侧菜单的APIs & Services下,打开OAuth consent screen
  2. 在”User Type”下选择External(外部,除非你使用Google Workspace),然后点击创建
  3. 应用信息:
    • 应用名称:例如”Plainva”
    • 用户支持电子邮件:你自己的邮箱
    • 开发者联系信息:你自己的邮箱
    • 点击保存并继续
  4. 权限范围(Scopes):
    • 点击添加或移除范围
    • 搜索.../auth/drive(Google Drive API,完全访问权限)并勾选。
    • 背景说明:需要完全访问权限,这样Plainva才能同步你通过Google Drive网页界面直接放入同步文件夹的文件。
    • 点击更新,然后保存并继续
  5. 测试用户:
    • 点击添加用户
    • 准确输入你之后将在Plainva中用于同步的那个Google邮箱地址。
    • 点击保存并继续,然后返回控制台首页。

重要提示:请把状态保持在”测试中”。你不需要发布这个应用。在测试模式下,令牌会在7天后过期——Plainva会在后台自动续期,但在做出重大更改或切换权限范围之后,你可能需要重新登录。

4. 创建凭据(客户端ID和密钥)

  1. 在左侧菜单中打开凭据
  2. 点击顶部的创建凭据,选择OAuth客户端ID
  3. “应用类型”选择桌面应用(或”其他UI”)。
  4. 名称:例如”Plainva Desktop Client”。
  5. 点击创建
  6. 弹出窗口会显示你的客户端ID客户端密钥

5. 在Plainva中填入

  1. 打开Plainva,进入相应仓库的设置(该仓库的齿轮图标)。
  2. 打开同步分区。
  3. 选择Google Drive作为服务商。
  4. 把复制好的客户端ID客户端密钥粘贴到对应的字段中。
  5. 点击连接Google
  6. 会打开一个Google浏览器窗口。使用你在”测试用户”中添加的账户登录。
  7. Google可能会提示该应用未经验证。点击高级,然后点击继续前往Plainva(不安全)
  8. 确认所请求的权限。

现在,你的仓库已经通过你自己的凭据安全地与Google Drive同步了。