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

實作共用雲端硬碟支援

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

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

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

應用程式如果要讀取或修改權限、追蹤變更，或需要跨多個字典搜尋，就需要額外的共用雲端硬碟功能。本文的其餘部分會強調執行這些工作所需的其他變更。

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

使用 files.list 方法搜尋共用雲端硬碟。本節將說明 files.list 方法中的共用雲端硬碟專屬欄位。如要搜尋共用雲端硬碟，請參閱「搜尋檔案和資料夾」。

files.list 方法包含下列共用特定車輛欄位和查詢模式：

driveId：要搜尋的共用雲端硬碟 ID。
includeItemsFromAllDrives：是否應在結果中加入共用雲端硬碟項目。如果未提供或設為 false，系統就不會傳回共用雲端硬碟項目。
corpora：查詢適用的項目 (檔案/文件) 內容。支援的內容為 user、domain、drive 和 allDrives。為提高效率，請盡量使用 user 或 drive 而非 allDrives。
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 存取共用雲端硬碟內容，請務必在 Google API 控制台中勾選「共用雲端硬碟支援」。詳情請參閱「設定 Drive UI 整合」。

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

如需建立共用雲端硬碟和管理共用雲端硬碟權限的相關說明，請參閱「管理共用雲端硬碟」一文。