共用雲端硬碟採用與「我的雲端硬碟」不同的組織、共用和擁有權模式。如果應用程式打算建立及管理共用雲端硬碟中的檔案,您必須在應用程式中導入共用雲端硬碟支援功能。實作的複雜程度取決於應用程式的功能。
首先,當應用程式執行下列作業時,您必須在要求中加入 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
:查詢適用的項目 (檔案/文件) 內容。支援的主體包括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 中啟用共用雲端硬碟支援功能
如要使用雲端硬碟 UI 存取共用雲端硬碟內容,請務必在 Google API 控制台中勾選「共用雲端硬碟支援」。詳情請參閱「設定 Drive UI 整合」。
在共用雲端硬碟中使用檔案挑選工具
檔案挑選器支援選取共用雲端硬碟中的項目。如要進一步瞭解如何啟用共用雲端硬碟支援功能,並在檔案挑選器中新增共用雲端硬碟檢視畫面,請參閱 Google Picker API。
後續步驟
如需建立共用雲端硬碟和管理共用雲端硬碟權限的相關說明,請參閱「管理共用雲端硬碟」一文。