共用雲端硬碟會追蹤不同的機構、共用情形和擁有權 「我的雲端硬碟」中的模型如果您的應用程式打算建立及管理共用的檔案 雲端硬碟,您必須在應用程式中導入共用雲端硬碟支援功能。複雜的 您必須根據應用程式的功能進行實作。
首先,您需要將 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 控制台。 詳情請參閱 設定雲端硬碟 UI 整合。
使用共用雲端硬碟的檔案選擇器
檔案選擇器支援選取共用雲端硬碟中的項目。 進一步瞭解如何啟用共用雲端硬碟支援功能,以及如何新增共用雲端硬碟檢視畫面 請參閱 Google Picker API。
後續步驟
前往「管理共用雲端硬碟」頁面,繼續取得以下權限: 瞭解如何建立共用雲端硬碟及管理共用雲端硬碟權限。