共用雲端硬碟會遵循「我的雲端硬碟」中 不同的機構、共用和擁有權模式如果應用程式要在共用雲端硬碟上建立及管理檔案,您必須在應用程式中實作共用雲端硬碟支援。實作的複雜度取決於應用程式的功能。
首先,您需要在應用程式執行下列作業時,在要求中加入 supportsAllDrives=true
查詢參數:
Drive API v3
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
:是否要在結果中包含共用雲端硬碟項目。如果沒有,則不會傳回共用雲端硬碟項目。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 控制台中檢查「共用雲端硬碟支援」。詳情請參閱「設定雲端硬碟 UI 整合」。
搭配共用雲端硬碟使用檔案選擇器
檔案選擇器支援選取共用雲端硬碟中的項目。如要進一步瞭解如何在檔案選擇器中啟用共用雲端硬碟支援功能,以及如何在檔案選擇器中新增共用雲端硬碟檢視畫面,請參閱 Google Picker API。
後續步驟
如需建立共用雲端硬碟及管理共用雲端硬碟權限的相關說明,請繼續閱讀管理共用雲端硬碟。