實作共用雲端硬碟支援

共用雲端硬碟會追蹤不同的機構、共用情形和擁有權 「我的雲端硬碟」中的模型如果您的應用程式打算建立及管理共用的檔案 雲端硬碟,您必須在應用程式中導入共用雲端硬碟支援功能。複雜的 您必須根據應用程式的功能進行實作。

首先,您需要將 supportsAllDrives=true 查詢參數 會在應用程式執行以下作業時傳回要求:

Drive API 第 3 版

  • files.get
  • files.list
  • files.create
  • files.update
  • files.copy
  • files.delete
  • changes.list
  • changes.getStartPageToken
  • permissions.list
  • permissions.get
  • permissions.create
  • permissions.update
  • permissions.delete

Drive API 第 2 版

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

supportsAllDrives=true 參數會通知 Google 雲端硬碟 應用程式的設計宗旨是處理共用雲端硬碟中的檔案。

讀取或修改權限、追蹤變更,或是需要 在多個語料庫中搜尋時,需要額外的共用雲端硬碟功能。 本文的其餘部分說明瞭需要進行的其他變更 這些工作

搜尋共用雲端硬碟中的內容

使用 files.list 方法搜尋 。本節介紹的 files.list 方法。如要搜尋共用雲端硬碟,請參閱 搜尋檔案和資料夾

files.list 方法包含下列共用項目 雲端硬碟專屬欄位和查詢模式:

  • driveId - 要搜尋的共用雲端硬碟 ID。
  • includeItemsFromAllDrives:是否應納入共用雲端硬碟項目 結果。如果沒有顯示或設為 false,表示共用雲端硬碟項目 。

  • corpora - 將項目 (檔案/文件) 的主體 查詢適用的政策支援的主體包括 userdomaindriveallDrives。 比較偏好 userdriveallDrives,藉此提高效率。

  • supportsAllDrives:要求的應用程式是否支援 包括「我的雲端硬碟」和共用雲端硬碟如果設為 False,則不會排除共用雲端硬碟項目 其他類別。

以下查詢模式僅適用於共用雲端硬碟:

includeItemsFromAllDrives corpora 查詢說明
true user 查詢使用者存取過的檔案,包括共用雲端硬碟和「我的雲端硬碟」中的檔案。
true drive 查詢指定共用雲端硬碟中的所有項目。必須在要求中指定 driveId。
true allDrives 查詢使用者存取的檔案,以及他們所屬的所有共用雲端硬碟。請注意,回應可能包含 incompleteSearch : true,表示此要求並未搜尋某些語料庫。
true domain 查詢與網域共用的檔案,包括共用雲端硬碟和「我的雲端硬碟」中的檔案。

追蹤共用雲端硬碟上的變更

使用 changes.list 方法追蹤變更 。本節介紹的 changes.list 方法。如需更多資訊,請參閱 追蹤使用者和共用雲端硬碟的異動changes.list 方法包含下列共用項目 雲端硬碟專屬欄位和查詢模式:

  • driveId:傳回變更的共用雲端硬碟。如果 已指定,變更 ID 代表共用雲端硬碟中的變更,而非 對向使用者顯示的檔案所做的變更如何參照特定共用雲端硬碟 ,就必須將共用雲端硬碟 ID 和變更 ID 做為 ID 使用。
  • supportsAllDrives:要求的應用程式是否支援共用要求 磁碟機。如果設為 False,即表示共用雲端硬碟項目,包括共用雲端硬碟和 檔案也不會傳回。
  • includeItemsFromAllDrives:請說明應為共用雲端硬碟檔案或變更是否應變更 加入變更清單中

以下查詢模式僅適用於共用雲端硬碟:

includeItemsFromAllDrives driveId 查詢說明
true 反映使用者存取的共用雲端硬碟中或外部檔案所做的變更,以及使用者所屬共用雲端硬碟的變更。
true 變更會反映指定的特定共用雲端硬碟和當中的項目。

如要進一步瞭解變更記錄行為,請參閱 變更記錄

在雲端硬碟 UI 中啟用共用雲端硬碟支援功能

如要使用雲端硬碟 UI 存取共用雲端硬碟內容,請務必檢查 「支援共用雲端硬碟」的 Google API 控制台。 詳情請參閱 設定雲端硬碟 UI 整合

使用共用雲端硬碟的檔案選擇器

檔案選擇器支援選取共用雲端硬碟中的項目。 進一步瞭解如何啟用共用雲端硬碟支援功能,以及如何新增共用雲端硬碟檢視畫面 請參閱 Google Picker API

後續步驟

前往「管理共用雲端硬碟」頁面,繼續取得以下權限: 瞭解如何建立共用雲端硬碟及管理共用雲端硬碟權限。