雲端硬碟 - 列出工作

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

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

事前準備

請務必先在 Google Cloud 專案中執行下列工作，再設定「雲端硬碟 - 清單」工作：

啟用 Google Drive API (drive.googleapis.com)。
啟用 Google Drive API
建立驗證設定檔。Application Integration 會使用驗證設定檔，連線至「雲端硬碟 - 列出」工作的驗證端點。
如要瞭解如何授予服務帳戶其他角色或權限，請參閱「授予、變更及撤銷存取權」。

設定「雲端硬碟 - 清單」工作

前往 Google Cloud 控制台的「Application Integration」頁面。
前往「Application Integration」
在導覽選單中，按一下「整合」。
系統隨即會顯示「整合」頁面，列出 Google Cloud 專案中可用的所有整合功能。
選取現有整合，或按一下「建立整合」建立新整合。
如要建立新的整合項目：
1. 在「建立整合」窗格中輸入名稱和說明。
2. 選取整合作業的區域。
  注意：「區域」下拉式選單只會列出 Google Cloud 專案中佈建的區域。如要佈建新區域，請按一下「啟用區域」。詳情請參閱「啟用新區域」。
3. 選取整合的服務帳戶。如要變更或更新整合的服務帳戶詳細資料，請隨時前往整合工具列的「整合摘要」窗格。
  注意：只有在您為所選區域啟用整合控管功能時，系統才會顯示選取服務帳戶的選項。
4. 按一下「建立」，新建立的整合服務會在整合服務編輯器中開啟。
在整合編輯器的導覽列中，按一下「Tasks」(工作)，即可查看可用工作和連結器的清單。
在整合服務編輯器中，點按並放置「雲端硬碟 - 清單」元素。
按一下設計工具中的「雲端硬碟 - 清單」元素，即可查看「雲端硬碟 - 清單」任務設定窗格。
前往「驗證」，然後選取要使用的現有驗證設定檔。
(選用步驟) 如果您尚未建立驗證設定檔，請在設定工作前按一下「+ 新增驗證設定檔」，然後按照「建立新的驗證設定檔」一文中的步驟操作。
前往「Task Input」(任務輸入內容)，然後使用下列「Task input parameters」(任務輸入參數) 表格，設定所需的輸入欄位。
系統會自動儲存輸入欄位的變更。

工作輸入參數

下表說明「雲端硬碟 - 列出」工作的輸入參數：

資源	資料類型	說明
`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` 注意：如果依`recency`遞減順序排序檔案，且您上次執行的動作是檢視檔案，則該檔案會顯示在`files.list`結果頂端。
`PageSize`	整數	每頁傳回的檔案數量上限。可接受的值為 `1` 到 `1000`。預設值為 `100`。
`PageToken`	字串	用於接續先前的「雲端硬碟 - 列出」工作。將這個值設為先前回應中的 `nextPageToken` 值。
`Q`	字串	用於篩選檔案結果的查詢。詳情請參閱「搜尋檔案」。
`Spaces`	字串	以半形逗號分隔的清單，列出要在語料庫中查詢的空格。可接受的值為 `drive` 和 `appDataFolder`。
`SupportsAllDrives`	布林值	如果要求應用程式同時支援「我的雲端硬碟」和「共用雲端硬碟」，請將值設為 `true`。預設值為 `false`。

工作輸出

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

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

錯誤處理策略

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

配額與限制

如要瞭解配額和限制，請參閱配額和限制。