Drive API 第 2 版指南

如果您使用 Google Drive API 第 2 版，Google Drive API 中的內容 指南第 3 版也與第 2 版有關。這個區段 包含 v2 的所有資訊 這些標記顯示在第 3 版指南的特定網頁中。如要取得完整內容，每個子部分 包含對應指南頁面的連結。

如需完整差異清單，請參閱 Drive API v2 &第 3 版比較 參考資料。

下載和發布檔案修訂版本

透過下載和發布檔案修訂版本 頁面中，以下資訊將是第 2 版的專屬資訊，並取代這些部分 如下所示：

清單和下載個別修訂版本

取得檔案修訂版本清單後，即可下載 方法是傳送已授權的 GET 要求 []downloadUrl](/drive/api/reference/rest/v2/revisions) 屬性。 在您提出修訂版本要求時，Google 雲端硬碟會產生這個短期網址。 請勿以此做為日後使用。

您也可以使用任一支援的格式匯出修訂版本，方法是查看 exportLinks 屬性。

自訂檔案屬性

除了「新增自訂檔案屬性」頁面上的資訊，以下是第 2 版的專屬資訊：

屬性可透過 properties 資源。

這是一般屬性的結構，可能用來儲存 雲端硬碟檔案的資料庫 ID。

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

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

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

除了「導入共用雲端硬碟支援」頁面中的資訊之外，請替換這個額外欄位 trashedDate 代表第 2 版。

在「導入共用雲端硬碟支援功能」中， 下列方法在處理共用時需要 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 方法有多個專屬參數 。如需參數清單，請參閱「追蹤共用資料上的變更 雲端硬碟 專區。

上傳檔案

在「上傳檔案資料」頁面上，請留意這項資訊 是第 2 版的資訊：

匯入 Google 文件類型

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

共用檔案、資料夾和開車

「共用檔案、資料夾與」通知雲端硬碟 在第 3 版中只有一個欄位 role，可以指定使用者、群組 或網域在 v2 中，需要由 role 和 additionalRoles 權限反映出使用者、群組或網域在 設定。

第 2 版的搜尋查詢差異

第 2 版 title 欄位在第 3 版中為 name。如需範例，請參閱搜尋檔案和 資料夾。

第 2 版 createdDate 欄位在第 3 版中為 createdTime。如需範例，請參閱搜尋 共用雲端硬碟。

第 2 版 modifiedDate 欄位在第 3 版中為 modifiedTime。v2 lastViewedByMeDate 欄位在第 3 版中為 viewedByMeTime。詳情請參閱「搜尋查詢與 運算子。