如果使用 Google Drive API 第 2 版,Google Drive API 指南第 3 版中的大部分內容也適用於第 2 版。本節包含 v2 的所有資訊,且與第 3 版指南的特定頁面顯示的資訊不同。如要取得完整背景資訊,每個子部分都包含對應指南頁面的連結。
如需完整差異清單,請參閱 Drive API v2 和 v3 比較參考資料。
下載及發布檔案修訂版本
在「下載及發布檔案修訂版本」頁面,下列資訊專屬於第 2 版,並取代了第 3 版中顯示的下列部分:
列出及下載個別修訂版本
取得檔案修訂版本清單後,您可以將已授權的 GET
要求傳送至其 []downloadUrl
](/drive/api/reference/rest/v2/revisions) 屬性,藉此下載任何修訂版本內容。在您提出修訂版本要求時,Google 雲端硬碟會產生這個短期網址。
請勿以此做為日後使用。
您也可以查看 exportLinks
屬性,使用其中一種支援的格式匯出修訂版本。
自訂檔案屬性
除了「新增自訂檔案屬性」頁面上的資訊,以下是第 2 版的專屬資訊:
屬性可使用 properties
資源存取。
這是一般屬性的結構,可用於儲存雲端硬碟檔案的資料庫 ID。
{
'key': 'additionalID',
'value': 'ID',
'visibility': 'PRIVATE'
}
如要進一步瞭解相關限制,請參閱參考說明文件中的 properties
。
啟用共用雲端硬碟支援功能
除了「實作共用雲端硬碟支援」頁面中的資訊之外,也請取代第 2 版的這個額外欄位 trashedDate
。
在「實作共用雲端硬碟支援」中,下列方法在處理共用雲端硬碟內容時需要 supportsAllDrives=true
:
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
changes.get
和 changes.list
方法有多個共用雲端硬碟專用的參數。如需參數清單,請參閱「追蹤共用雲端硬碟上的變更」一節。
上傳檔案
在「Upload file data」(上傳檔案資料) 頁面上,請注意以下提供第 2 版的資訊:
匯入 Google 文件類型
在 Google 雲端硬碟中建立檔案時,您可以將某些類型的檔案轉換成 Google 文件、Google 試算表或 Google 簡報文件。加入 files.insert
convert
查詢參數,並設定檔案的 (workspace_name) mimeType
屬性。詳情請參閱「上傳檔案資料」。
共用檔案、資料夾和雲端硬碟
請注意,在「Share files,資料夾和雲端硬碟」頁面上,v3 中只有一個欄位 role
,能指定使用者、群組或網域的有效角色。在 v2 中,您需要權限的 role
和 additionalRoles
欄位反映使用者、群組或網域針對特定項目擁有的有效角色。
第 2 版的搜尋查詢差異
第 2 版 title
欄位在第 3 版中為 name
。如需範例,請參閱「搜尋檔案和資料夾」。
第 2 版 createdDate
欄位在第 3 版中為 createdTime
。如需範例,請參閱「搜尋共用雲端硬碟」。
第 2 版 modifiedDate
欄位在第 3 版中為 modifiedTime
。第 2 版 lastViewedByMeDate
欄位在第 3 版中為 viewedByMeTime
。詳情請參閱「搜尋查詢與運算子」。