本頁面由 Cloud Translation API 翻譯而成。

實作共用雲端硬碟支援

共用雲端硬碟的組織、共用和擁有權模式與「我的雲端硬碟」不同。如果應用程式要在共用雲端硬碟中建立及管理檔案，就必須在應用程式中實作共用雲端硬碟支援功能。實作的複雜程度取決於應用程式的功能。

首先，應用程式執行下列作業時，您必須在要求中加入 supportsAllDrives=true 查詢參數：

supportsAllDrives=true 參數會通知 Google 雲端硬碟，您的應用程式可處理共用雲端硬碟中的檔案。

如果應用程式會讀取或修改權限、追蹤變更，或在多個語料庫中搜尋，則需要額外的共用雲端硬碟功能。本文的其餘部分會重點說明執行這些工作時所需的其他變更。

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

使用 files 資源的 list 方法，找出共用雲端硬碟中的使用者檔案。如要搜尋共用雲端硬碟，請參閱「搜尋共用雲端硬碟」。

list 方法包含下列共用雲端硬碟專屬的查詢參數：

driveId：要搜尋的共用雲端硬碟 ID。
corpora：查詢適用的項目 (檔案或文件) 內文。支援的身體部位包括 user、domain、drive 和 allDrives。建議使用 user 或 drive，以達到最佳效率。allDrives根據預設，語料庫會設為 user。
includeItemsFromAllDrives：是否要在結果中同時納入「我的雲端硬碟」和共用雲端硬碟項目。如果未提供或設為 false，系統就不會傳回共用雲端硬碟項目。
supportsAllDrives：要求存取的應用程式是否同時支援「我的雲端硬碟」和共用雲端硬碟。如果為 false，回應中就不會包含共用雲端硬碟項目。

以下查詢模式專用於共用雲端硬碟：

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

使用 changes 資源的 list 方法，追蹤共用雲端硬碟的變更。詳情請參閱「追蹤使用者和共用雲端硬碟的變更」。

list 方法包含下列共用雲端硬碟專屬的查詢參數：

driveId：傳回變更的共用雲端硬碟。如果指定，變更 ID 會參照共用雲端硬碟中項目的變更，提供檔案的目前狀態。如要參照特定共用雲端硬碟變更，必須同時使用共用雲端硬碟 ID 和變更 ID 做為 ID。
includeItemsFromAllDrives：是否要在變更清單中加入共用雲端硬碟檔案或變更。
supportsAllDrives：要求應用程式是否支援共用雲端硬碟。如果為 false，系統就不會傳回共用雲端硬碟項目，包括共用雲端硬碟和共用雲端硬碟中的檔案。

以下查詢模式專用於共用雲端硬碟：

`includeItemsFromAllDrives`	`driveId`	查詢說明
`true`	否	使用者存取共用雲端硬碟內外檔案時，以及使用者是成員的共用雲端硬碟發生變更時，系統都會反映這些變更。
`true`	是	變更會反映指定共用雲端硬碟及其內部項目的變更。

如要進一步瞭解變更記錄的行為，請參閱「追蹤使用者和共用雲端硬碟的變更」。

如要使用 Drive UI 存取共用雲端硬碟內容，請務必在 Google Cloud 控制台的 Google Drive API Drive UI 整合分頁中，勾選「共用雲端硬碟支援」方塊。詳情請參閱「設定雲端硬碟 UI 整合」。

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