跳转到主要内容
Google Drive 端口从 Google Drive 云存储服务中上传和下载文件。

核心功能

  • 基于 OAuth 的 Google Drive 集成,具备自动令牌(Token)管理功能
  • 支持多种格式的 Google Workspace 文档导出(Docs、Sheets、Slides)
  • 可针对不同的 Google Drive 区域配置发送和接收范围(Scopes)
  • 高级文件过滤及递归目录操作
  • 提供可选的缓存功能,确保仅下载新增或更新的文件

概述

每个 Google Drive 端口与一个特定的 Google Drive 账号连接。在远程存储中,有一个单独的文件夹作为上传目标,可以使用逗号分隔列表指定多个下载目标。 工作流中到达 Google Drive 端口的文件将被上传至上传目标文件夹,在下载目标文件夹下的文件会被下载并进入 工作流。该端口支持上传和下载过滤规则,即只发送和接收特定文件名和/或文件扩展名的文件。 账号认证基于 OAuth,因此首次连接时必须在外部站点门户中输入账号凭据。外部门户生成端口用来连接的 OAuth 令牌,且端口会自动处理令牌刷新。

端口配置

本部分包含所有可配置的端口属性。

设置

授权

与授权访问远程存储有关的设置。
Google 在生成 OAuth 认证时可能需要 OAuth 回调/重定向 URL。 的回调/重定向 URL 与应用程序托管处的地址和端口相同,加下面的源路径:src/oauthCallback.rst。例如,如果 托管在 ‘mydomain.com’ 的 8001 端口,应指定下面的 URL 为回调/重定向 URL:http://mydomain.com:8001/src/oauthCallback.rst

发送

与上传文件到远程存储服务有关的设置。
当您上传到已验证账号为_贡献者_(而非_所有者_或_组织者_)的共享驱动器时,覆盖远程文件功能不受支持。这是 Google Drive API 权限模型的限制。

接收

与从远程存储中下载文件有关的设置。

缓存

与缓存和比较多次下载之间文件相关的设置。
启用缓存时,文件名不区分大小写。例如,端口无法区分 TEST.TXTtest.txt

高级设置

高级设置

先前目录中没有包含的设置。

代理配置

消息

日志

杂项

自动化

自动化设置

与端口自动处理文件有关的设置。

性能

告警选项卡

SLA 选项卡

建立连接

Google Drive 需要 OAuth 认证以建立连接。OAuth 认证应该通过 Google Console 从 Google 直接获取,然后在设置选项卡上的以下端口字段中指定:
  • OAuth 客户端 ID
  • OAuth 客户端密码
Google 在生成 OAuth 认证时可能需要 OAuth 回调/重定向 URL。 的回调/重定向 URL 与应用程序托管处的地址和端口相同,加下面的源路径:src/oauthCallback.rst。例如,如果 托管在 ‘mydomain.com’ 的 8001 端口,应指定下面的 URL 为回调/重定向 URL:http://mydomain.com:8001/src/oauthCallback.rst 一旦与 Google 的认证完成,Google Drive 端口会处理刷新 OAuth 令牌的过程,以确保身份验证会一直持续。

上传和下载

上传

要上传文件,将发送部分的 远程文件夹 字段设置为文件应被上传的文件夹。每个 Google Drive 端口上传到一个特定的文件夹位置。 使用 覆盖远程文件 选项,可以确定是覆盖还是跳过远程文件夹中已存在的文件。
当您上传到已验证账号为_贡献者_(而非_所有者_或_组织者_)的共享驱动器时,覆盖远程文件功能不受支持。这是 Google Drive API 权限模型的限制。
配置之后,放置在端口 事务 选项卡中的文件将会被上传至远程存储。如果 发送自动化 启用,上传将会自动进行;否则,可以通过 事务 选项卡发送单个文件。

下载

要下载文件,将接收部分的 远程文件夹 字段设置为下载文件的文件夹。多个下载文件夹可以使用逗号分隔。 使用 文件掩码 可以设置全局模式过滤规则(例如 *.txt),只下载与过滤规则匹配的文件。要指定多个过滤规则,可以在高级设置选项卡上配置 接收过滤规则 使用 删除文件(接收后) 选项用于切换是否从远程存储中删除成功下载的文件。 配置之后,将会根据 接收自动化设置的设置下载文件,或者在 事务 选项卡中通过点击 接收 按钮手动下载。

示例