Drive API 第 2 版指南

如果您使用 Google Drive API 第 2 版，Google Drive API 指南第 3 版的大部分內容也適用於第 2 版。本節包含所有 v2 專屬資訊，與 v3 指南特定頁面顯示的資訊不同。如要瞭解完整脈絡，每個子章節都包含對應指南頁面的連結。

如需完整差異清單，請參閱 Drive API v2 和 v3 比較參考資料。

下載及發布檔案修訂版本

在「下載及發布檔案修訂版本」頁面中，下列資訊專屬於第 2 版，並取代第 3 版顯示的這些部分：

列出及下載個別修訂版本

取得檔案的修訂版本清單後，您可以將授權的 GET 要求傳送至檔案的 []downloadUrl](/workspace/drive/api/reference/rest/v2/revisions) 屬性，下載任何修訂版本的內容。您要求修訂版本時，Google 雲端硬碟會產生這個短效網址。 請勿依賴這項功能。

您也可以檢查 exportLinks 屬性，以其中一種支援的格式匯出修訂版本。

自訂檔案屬性

除了「新增自訂檔案屬性」頁面上的資訊外，下列資訊也適用於第 2 版：

屬性是使用 properties 資源存取。

這是典型屬性的結構，可用於在檔案中儲存 Google 雲端硬碟檔案的資料庫 ID。

{
  'key':        'additionalID',
  'value':      'ID',
  'visibility': 'PRIVATE'
}

如要進一步瞭解限制，請參閱參考說明文件中的 properties。

啟用共用雲端硬碟支援功能

除了「實作共用雲端硬碟支援功能」頁面上的資訊，請為 v2 替換這個額外欄位 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 方法有幾個與共用雲端硬碟相關的參數。如需參數清單，請參閱「追蹤共用雲端硬碟中的各項變更」一節。

上傳檔案

在「上傳檔案資料」頁面中，請注意以下 v2 專屬資訊：

可匯入 Google 文件的檔案類型

在 Google 雲端硬碟中建立檔案時，您可以將某些類型的檔案轉換為 Google 文件、Google 試算表或 Google 簡報。加入 files.insert convert 查詢參數，並設定檔案的 (workspace_name) mimeType 屬性。詳情請參閱「上傳檔案資料」。

共用檔案、資料夾和雲端硬碟

在「共用檔案、資料夾和雲端硬碟」頁面中，只有一個欄位 role (僅限第 3 版)，可指定使用者、群組或網域的有效角色。在第 2 版中，您需要權限的 role 和 additionalRoles 欄位，才能反映使用者、群組或網域對特定項目擁有的有效角色。

第 2 版的搜尋查詢差異

v2 的 title 欄位在 v3 中為 name。如需範例，請參閱「搜尋檔案和資料夾」。

v2 的 createdDate 欄位在 v3 中為 createdTime。如需範例，請參閱「搜尋共用雲端硬碟」。

v2 的 modifiedDate 欄位在 v3 中為 modifiedTime。v2 的 lastViewedByMeDate 欄位在 v3 中為 viewedByMeTime。詳情請參閱「搜尋查詢字詞和運算子」。