根據 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 針對即時資料呼叫這個方法,並查看回應。