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

宏

範例