添加 Google Drive 账户
Google Drive 设置
Section titled “Google Drive 设置”以下步骤需要在 Google Cloud Console 中完成,用于创建 PlaidCloud 访问 Google Drive 所用的服务账户。
创建 Google Cloud 项目
Section titled “创建 Google Cloud 项目”- 登录 Google Cloud Console
- 创建新项目或选择现有项目
启用 Google Drive API
Section titled “启用 Google Drive API”- 导航到 APIs & Services > Library
- 搜索 Google Drive API
- 选择它并点击 Enable
创建服务账户
Section titled “创建服务账户”- 导航到 APIs & Services > Credentials
- 选择 + Create Credentials > Service account
- 输入服务账户的名称(例如
plaidcloud-drive) - 选择 Create and Continue
- 可选择授予角色(例如只读授予 Viewer,读写授予 Editor)。选择 Continue。
- 选择 Done
生成服务账户密钥
Section titled “生成服务账户密钥”- 在 Service Accounts 列表中,选择刚创建的服务账户
- 导航到 Keys 选项卡
- 选择 Add Key > Create new key
- 选择 JSON 格式并选择 Create
- 系统将下载一个 JSON 密钥文件。请妥善保存该文件,其中包含 PlaidCloud 将使用的凭据。
与服务账户共享 Drive 内容
Section titled “与服务账户共享 Drive 内容”- 复制服务账户的电子邮件地址(例如
plaidcloud-drive@your-project.iam.gserviceaccount.com) - 在 Google Drive 中,将希望 PlaidCloud 访问的文件夹与该电子邮件地址共享,并授予 Editor 访问权限。若要使用共享云端硬盘,请改为将服务账户添加为其成员。
现在,已具备将 Google Drive 账户添加到 PlaidCloud 文档 所需的一切。
PlaidCloud 文档设置
Section titled “PlaidCloud 文档设置”- 登录 PlaidCloud
- 选择新文档账户所在的工作区
- 转到
Document > Manage - 选择新建账户按钮
- 选择
Google Drive作为服务类型 - 填写名称和说明
- 在起始路径字段中输入共享文件夹路径,或留空以访问所有共享内容
- 根据使用场景选择合适的安全模型。如果不确定,请保留
Private。 - 将 JSON 密钥文件的全部内容粘贴到“身份验证凭据”下的“OAuth2 凭据 JSON”字段中
- 选择“保存”按钮,新的文档账户即可使用
在工作流中使用该账户
Section titled “在工作流中使用该账户”Google Drive 账户既可在文档浏览器中使用,也可在工作流中使用。步骤可以列出、导入、导出、复制、移动、重命名和删除文件,并创建文件夹。
- 地点。 账户的顶层地点是与服务账户共享的文件夹,以及该服务账户所属的共享云端硬盘。路径为文件夹名称,例如
Finance/Reports/2026。如果两个共享文件夹或共享云端硬盘同名,账户将拒绝打开该名称。请重命名或取消共享其中除一个以外的所有项。 - Google 表格。 Google 表格会以
.xlsx导出的形式读取,并显示为Name.xlsx。其他 Google Workspace 文件(如文档和幻灯片)无法读取。 - 我的云端硬盘中的新文件。 服务账户没有自己的存储空间,因此在位于某人个人“我的云端硬盘”中的文件夹里,它可以覆盖现有文件,但无法创建新文件。请先在该处创建文件,或使用共享云端硬盘中的文件夹,后者可以接受新文件和文件夹。
- 缺失的文件夹。 不存在的文件夹会列为空,而不会引发错误。
- 限流。 当 Google 对请求限流或返回临时错误时,PlaidCloud 会自动重试。