Skip to main content
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.TXT 和 test.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),只下载与过滤规则匹配的文件。要指定多个过滤规则,可以在高级设置选项卡上配置 接收过滤规则。 使用 删除文件(接收后) 选项用于切换是否从远程存储中删除成功下载的文件。 配置之后,将会根据 接收自动化设置的设置下载文件,或者在 事务 选项卡中通过点击 接收 按钮手动下载。

宏

示例