查看 Application Integration 支援的連接器。

雲端硬碟 - 列出工作

雲端硬碟 - 清單 工作可讓你搜尋及擷取儲存在 Google 雲端硬碟帳戶中的檔案和資料夾。

Google 雲端硬碟是一項雲端檔案儲存服務，可提供個人儲存空間，讓您儲存及存取雲端中的協作共用檔案和資料夾。

事前準備

設定「Drive - 列出」工作前，請務必在 Google Cloud 專案中執行下列工作：

  1. 啟用 Google Drive API (drive.googleapis.com)。

    啟用 Google Drive API

  2. 建立驗證設定檔。Application Integration 會使用驗證設定檔，連線至「Drive - 清單」工作專用的驗證端點。

    如要進一步瞭解如何為服務帳戶授予其他角色或權限，請參閱「授予、變更及撤銷存取權」一文。

設定 Drive - 清單工作

  1. 前往 Google Cloud 控制台的「Application Integration」頁面。

    前往「應用程式整合」

  2. 在導覽選單中，按一下「整合」。

    系統隨即會顯示「Integrations」頁面，列出 Google Cloud 專案中可用的所有整合項目。

  3. 選取現有的整合，或按一下「建立整合」來建立新的整合。

    如果您要建立新的整合功能：

    1. 在「Create Integration」窗格中輸入名稱和說明。
    2. 選取整合作業的區域。
    3. 選取要用於整合的服務帳戶。您隨時可以透過整合工具列的 「整合摘要」窗格，變更或更新整合作業的服務帳戶詳細資料。
    4. 按一下「建立」，新建立的整合服務會在整合服務編輯器中開啟。

  4. 在整合編輯器的導覽列中，按一下「Tasks」，即可查看可用任務和連接器的清單。
  5. 在整合服務編輯器中，按一下並放置「Drive - 清單」元素。
  6. 按一下設計工具中的「Drive - List」元素，即可查看「Drive - List」任務設定窗格。
  7. 前往「驗證」，然後選取要使用的現有驗證設定檔。

    (非必要) 如果您在設定工作前尚未建立驗證設定檔，請按一下「+ 新驗證設定檔」，然後按照「建立新的驗證設定檔」一節所述的步驟操作。

  8. 前往「Task Input」，然後使用下列「Task input parameters」表格設定所需的輸入欄位。

    系統會自動儲存輸入欄位的變更。

工作輸入參數

下表說明「Drive - 列出」工作中的輸入參數：

資源 資料類型 說明
Corpora 字串 用於搜尋corpora 內檔案的選用參數。
DriveId 字串 Google 共用雲端硬碟的 ID。
IncludeItemsFromAllDrives 布林值 如要將個人雲端硬碟和共用雲端硬碟項目一併納入搜尋結果，請將值設為 true。

預設值：false。
IncludeLabels 字串 以半形逗號分隔的標籤 ID 清單，包含在回應的 labelInfo 部分。如要進一步瞭解標籤 ID，請參閱「標籤總覽」。
IncludePermissionsForView 字串 指定 published。詳情請參閱「共用檔案、資料夾和雲端硬碟」。
OrderBy 字串 檔案排序的順序。每個鍵的預設排序方式為遞增。詳情請參閱 files.list 方法。

以下是有效值：

  • createdTime
  • folder
  • modifiedByMeTime
  • modifiedTime
  • name
  • name_natural
  • quotaBytesUsed
  • recency
  • sharedWithMeTime
  • starred
  • viewedByMeTime
PageSize 整數 每頁傳回的檔案數量上限。

可接受的值為 1 到 1000。

預設值：100。
PageToken 字串 用於接續先前 Drive - 列出 工作階段的符記。將這個值設為上一個回應中的 nextPageToken 值。
Q 字串 用於篩選檔案結果的查詢。詳情請參閱「搜尋檔案」。
Spaces 字串 以半形逗號分隔的清單，列出要查詢的語料庫內空格。

可接受的值為 drive 和 appDataFolder。
SupportsAllDrives 布林值 如果要求的應用程式同時支援「我的雲端硬碟」和共用雲端硬碟，請將值設為 true。

預設值：false。

任務輸出

雲端硬碟 - 列出 工作會傳回包含檔案清單的回應輸出內容。以下是輸出內容範例：

  {
    "nextPageToken": string,
    "kind": string,
    "incompleteSearch": boolean,
    "files": [
      {
        object (File)
      }
    ]
  }

錯誤處理策略

工作錯誤處理策略會指定在工作因暫時性錯誤而失敗時，應採取的動作。如要瞭解如何使用錯誤處理策略，以及各種錯誤處理策略，請參閱「錯誤處理策略」。

配額與限制

如要進一步瞭解配額和限制，請參閱「配額與限制」。

後續步驟