核心功能
- 基於 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 權限模型的限制。
接收
與從遠端儲存中下載檔案有關的設定。快取
與快取和比較多次下載之間檔案相關的設定。知行之橋會自動清理資源快取。此過程在每次接收週期的後臺執行，刪除遠端伺服器上已不存在的檔案對應的過期快取項目。這使得快取大小始終保持在可管理範圍內，無需任何手動操作。
預設情況下，檔案保留 30 天，但您可以在進階索引標籤的其他設定欄位中使用 ResourceCacheRetentionDays 設定來調整保留時間以適應您的環境。例如，ResourceCacheRetentionDays=15 表示檔案保留 15 天后將被刪除。
TEST.TXT 和 test.txt。進階設定
進階設定
先前目錄中沒有包含的設定。代理配置
這是一組用於識別連線所經代理並對其進行身分驗證的設定。預設情況下，本節使用 安全設定 頁面的 代理設定 部分中的全域設定。清除此核取方塊可為您的端口提供特定的設定。
| 設定 | 描述 |
|---|---|
| 代理型別 | 基於代理的防火牆使用的協議。 |
| 代理主機 | 基於代理的防火牆的名稱或 IP 地址。 |
| 代理端口 | 基於代理的防火牆的 TCP 端口。 |
| 代理使用者 | 用於透過基於代理的防火牆進行身分驗證的使用者名稱。 |
| 代理密碼 | 用於對基於代理的防火牆進行身分驗證的密碼。 |
| 身分驗證方案 | 保留預設值 None 或選擇以下身分驗證方案之一：Basic、Digest、Proprietary 或 NTLM。 |
訊息
訊息設定確定端口如何搜尋訊息並在處理後管理它們。
注意：以下設定已棄用，預設處於隱藏狀態。只有先前已啟用這些設定或將其配置為非預設值的端口才會顯示它們。若要保留成功處理的檔案副本，請在工作流程中右鍵單擊該端口，選擇顯示成功路徑，然後將成功路徑連線到 File 端口。
| 設定 | 描述 |
|---|---|
| 儲存到已傳送資料夾（已棄用） | 將端口處理的檔案複製到 Sent 資料夾。預設停用。儲存到 Sent 資料夾中的檔案不受靜態加密保護。 |
| 已傳送資料夾方案（已棄用） | 按所選時間間隔對 Sent 資料夾中的檔案進行分組。僅在啟用儲存到已傳送資料夾時適用。 |
日誌
用於管理日誌建立和儲存的設定。
| 設定 | 描述 |
|---|---|
| 日誌級別 | 指定要記錄在端口日誌目錄中的資訊型別：
|
| 日誌資料夾結構 | 指示端口根據選定的時間間隔將日誌資料夾中的檔案分組。例如，Weekly 選項指示端口每週建立一個新的子資料夾，並將該周的所有日誌儲存在該資料夾中。空白設定告訴端口將所有日誌直接儲存在日誌資料夾中。對於處理許多交易的端口，使用子資料夾有助於保持日誌的有序性並提高效能。 |
| 保留訊息副本 | 指示端口在日誌目錄中儲存最新訊息副本的切換。請注意，端口每個子資料夾只保留一個訊息，並且端口在再次執行時會覆蓋以前儲存的訊息。 |
雜項
特殊設定適用於特定用例。
| 設定 | 描述 |
|---|---|
| 其他設定 | 允許在以分號分隔的清單中配置隱藏的端口設定，例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用這些設定。 |
自動化
自動化設定
與端口自動處理檔案有關的設定。自動化狀態
效能
與端口資源分配相關的設定。
| 設定 | 描述 |
|---|---|
| 最大工作執行緒數 | 此端口上處理檔案時從執行緒池中消耗的最大工作執行緒數。如果設定，則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。 |
| 最大檔案數 | 分配給端口的每個執行緒傳送的最大檔案數。如果設定，則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。 |
告警索引標籤
SLA 索引標籤
建立連線
Google Drive 需要 OAuth 認證以建立連線。OAuth 認證應該透過 Google Console 從 Google 直接取得，然後在設定索引標籤上的以下端口欄位中指定：- OAuth 用戶端 ID
- OAuth 用戶端密碼
src/oauthCallback.rst。例如，如果 知行之橋 託管在 ‘mydomain.com’ 的 8001 端口，應指定下面的 URL 為回呼／重新導向 URL：http://mydomain.com:8001/src/oauthCallback.rst。
一旦與 Google 的認證完成，Google Drive 端口會處理重新整理 OAuth 權杖的過程，以確保身分驗證會一直持續。
上傳和下載
上傳
要上傳檔案，將傳送部分的 遠端資料夾 欄位設定為檔案應被上傳的資料夾。每個 Google Drive 端口上傳到一個特定的資料夾位置。 使用 覆蓋遠端檔案 選項，可以確定是覆蓋還是跳過遠端資料夾中已存在的檔案。當您上傳到已驗證帳號為_貢獻者_（而非_所有者_或_組織者_）的共享驅動器時，覆蓋遠端檔案功能不受支援。這是 Google Drive API 權限模型的限制。