Google Drive API 支援多種下載和匯出動作, 列於下表:
下載內容 |
|
|||
匯出 |
|
請先確認使用者能夠下載或匯出檔案內容,再下載或匯出
編輯檔案時,capabilities.canDownload
files
資源。
本指南的其餘部分提供了執行這些類型的詳細操作說明 下載及匯出動作
下載 blob 檔案內容
如要下載儲存在雲端硬碟中的 blob 檔案,請使用含有要下載檔案 ID 的 files.get
方法
和 alt=media
網址參數alt=media
網址參數會告訴系統
要求下載內容做為替代回應的伺服器
格式。
alt=media
網址參數是一個系統
參數
且所有 Google REST API 均提供相同格式的檔案如果針對
Drive API,您不需要明確設定這個參數。
以下程式碼範例說明如何使用 files.get
方法下載
連結至 Drive API 用戶端程式庫
Java
Python
Node.js
PHP
.NET
此程式碼範例使用程式庫方法新增 alt=media
網址參數
指向基礎 HTTP 要求
從應用程式下載檔案的作業範圍,必須允許範圍
可以讀取檔案內容。舉例來說,如果應用程式使用
drive.readonly.metadata
範圍權限不足,無法下載檔案內容。
這個程式碼範例使用了受限制的「雲端硬碟」檔案範圍,方便使用者
查看及管理所有雲端硬碟檔案。如要進一步瞭解
雲端硬碟範圍,請參閱「選擇 Google Drive API」
範圍。
具有編輯權限的使用者可限制唯讀使用者下載
將 copyRequiresWriterPermission
新增至 false
。
識別為檔案
濫用
(例如有害軟體),只能由檔案擁有者下載。
而且也必須加入 get
查詢參數 acknowledgeAbuse=true
表示使用者已瞭解下載風險
垃圾軟體或其他不當檔案您的應用程式應具有互動性
在使用查詢參數前發出警告
已下載部分內容
部分下載只涉及下載檔案的特定部分。個人中心
可以使用 byte:
範圍
並加上 Range
標頭。例如:
Range: bytes=500-999
下載較舊版本的 blob 檔案內容
如要下載舊版的 blob 檔案內容,請使用
revisions.get
方法,ID 為
要下載的檔案、修訂版本 ID 以及 alt=media
網址參數。
alt=media
網址參數會告知伺服器系統下載的內容
做為替代回應格式的要求與 files.get
類似,
revisions.get
方法也接受選用的查詢參數
acknowledgeAbuse
和 Range
標頭。進一步瞭解下載
修訂版本,請參閱下載及發布檔案
修訂版本。
在瀏覽器中下載 blob 檔案內容
如要下載儲存在雲端硬碟的 blob 檔案內容,
而不是透過 API 使用
webContentLink
欄位,
files
資源。如果使用者下載了
檔案存取權、下載檔案的連結及其內容
。您可以將使用者重新導向至這個網址,或提供可點擊的網址
連結。
匯出 Google Workspace 文件內容
如要匯出 Google Workspace 文件位元組的內容,請使用 files.export
方法搭配要匯出的檔案 ID
以及正確的 MIME 類型。已匯出
大小上限為 10 MB。
以下程式碼範例說明如何使用 files.export
方法匯出
透過 Drive API 用戶端使用 PDF 格式的 Google Workspace 文件
程式庫:
Java
Python
Node.js
PHP
.NET
這個程式碼範例使用了受限制的 drive
範圍,可讓使用者查看及
管理所有雲端硬碟檔案如要進一步瞭解
雲端硬碟範圍,請參閱「選擇 Google Drive API」
範圍。
程式碼範例也會將匯出的 MIME 類型宣告為 application/pdf
。換
各種 Google Workspace 支援匯出 MIME 類型的完整清單
文件,請參閱「匯出 Google Workspace 的 MIME 類型」
文件。
在瀏覽器中匯出 Google Workspace 文件內容
如要在瀏覽器中匯出 Google Workspace 文件內容,請使用
exportLinks
欄位,
files
資源。視文件內容而定
類型,下載檔案的連結,以及每個 MIME 都會傳回其內容
可用的類型。您可以將使用者重新導向至特定網址,或以網址的形式提供
可點擊的連結。
在瀏覽器中將 Google Workspace 文件內容匯出到較舊版本
如何將 Google Workspace 文件內容匯出至
瀏覽器,請使用 revisions.get
方法
附加下載檔案的 ID 和修訂版本 ID。如果使用者
檔案的下載權限、下載檔案的連結及其內容
。您可以將使用者重新導向至這個網址,或提供可點擊的網址
連結。