Method: files.delete

永久刪除使用者擁有的檔案,且不會移至垃圾桶。詳情請參閱「將檔案和資料夾移至垃圾桶或刪除」。

如果檔案屬於共用雲端硬碟,使用者必須是上層資料夾的 organizer。如果目標是資料夾,系統也會刪除使用者擁有的所有後代項目。

HTTP 要求

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

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

路徑參數

參數
fileId

string

檔案的 ID。

查詢參數

參數
supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

已淘汰:請改用 supportsAllDrives

enforceSingleParent
(deprecated)

boolean

已淘汰:如果項目不在共用雲端硬碟中,且最後一個上層資料夾已刪除,但項目本身未刪除,則該項目會放在擁有者的根目錄下。

要求主體

要求主體必須為空白。

回應主體

如果成功,回應主體會是空白的 JSON 物件。

授權範圍

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

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file

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