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.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),只下載與過濾規則匹配的檔案。要指定多個過濾規則,可以在進階設定索引標籤上配置 接收過濾規則 使用 刪除檔案(接收後) 選項用於切換是否從遠端儲存中刪除成功下載的檔案。 配置之後,將會根據 接收自動化設定的設定下載檔案,或者在 交易 索引標籤中透過點選 接收 按鈕手動下載。

範例