Files: get

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

根據 ID 取得檔案的中繼資料或內容。立即試用

如果您提供網址參數 alt=media,則回應會包含回應內容中的檔案內容。必須使用 alt=media 下載內容,檔案才能儲存到雲端硬碟。如要下載 Google 文件、試算表和簡報,請改用 files.export。如要進一步瞭解如何下載檔案,請參閱下載及匯出檔案

要求

HTTP 要求

GET https://www.googleapis.com/drive/v3/files/fileId

參數

參數名稱 說明
路徑參數
fileId string 檔案的 ID。
選用查詢參數
acknowledgeAbuse boolean 使用者是否瞭解下載已知惡意軟體或其他濫用檔案的風險。這個做法僅適用於 alt=media。 (預設:false)
fields string 您要在回應中加入的欄位路徑。如未指定,回應會包含這個方法專屬的一組預設欄位。在開發方面,您可以使用特殊值 * 傳回所有欄位,但僅選取您需要的欄位,就能提升成效。詳情請參閱傳回檔案的特定欄位
includeLabels string 回應中 labelInfo 部分包含的標籤 ID 逗號分隔清單。
includePermissionsForView string 指定要在回應中加入哪些額外資料檢視的權限。僅支援「發布」。
supportsAllDrives boolean 提出要求的應用程式同時支援「我的雲端硬碟」和共用雲端硬碟。 (預設:false)
supportsTeamDrives boolean 淘汰了 supportAllDrives。 (預設:false)

授權

這個要求需要下列至少一項範圍的授權:

範圍
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.photos.readonly

部分範圍會受到限制,需要應用程式進行安全性評估才能使用。詳情請參閱驗證和授權頁面。

要求主體

請不要透過此方法提供請求主體。

回應

根據預設,系統會在回應主體中以檔案資源回應。如果您提供網址參數 alt=media,則回應會包含回應內容中的檔案內容。必須使用 alt=media 下載內容,檔案才能儲存到雲端硬碟。如要下載 Google 文件、試算表和簡報,請改用 files.export。如要進一步瞭解如何下載檔案,請參閱下載及匯出檔案

試試看!

使用 APIs Explorer 針對即時資料呼叫這個方法,並查看回應。