Method: files.get

依 ID 取得檔案的中繼資料或內容。詳情請參閱「搜尋檔案和資料夾」。

如果您提供網址參數 alt=media，回應主體就會包含檔案內容。如要使用 alt=media 下載內容，檔案必須儲存在雲端硬碟中。如要下載 Google 文件、試算表和簡報，請改用 files.export。詳情請參閱「下載及匯出檔案」。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
fileId

string

檔案的 ID。

查詢參數

參數
acknowledgeAbuse

boolean

使用者是否瞭解下載已知惡意軟體或其他濫用檔案的風險。只有在 alt 參數設為 media，且使用者是檔案擁有者或檔案所在共用雲端硬碟的主辦人時，這項設定才適用。
supportsAllDrives

boolean

要求存取的應用程式是否同時支援「我的雲端硬碟」和共用雲端硬碟。
supportsTeamDrives
(deprecated)

boolean

已淘汰：請改用 supportsAllDrives。
includePermissionsForView

string

指定要在回應中加入哪些額外檢視畫面權限。系統僅支援 published。
includeLabels

string

以半形逗號分隔的標籤 ID 清單，用於在回應的 labelInfo 部分中納入標籤。

要求主體

要求主體必須為空白。

回應主體

如果成功，回應主體會包含 File 的執行例項。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

部分範圍受到限制，應用程式必須通過安全性評估才能使用。詳情請參閱授權指南。