應用程式資料資料夾是應用程式可用來儲存應用程式專屬資料 (例如設定檔案) 的特殊隱藏資料夾。當您嘗試在應用程式資料資料夾中建立檔案時,系統會自動建立該資料夾。使用這個資料夾儲存使用者不應直接互動的任何檔案。這個資料夾只能由您的應用程式存取,且其內容會隱藏起來,使用者和其他 Google 雲端硬碟應用程式都無法存取。
當使用者從「我的雲端硬碟」中解除安裝您的應用程式時,系統會刪除應用程式資料資料夾。使用者也可以手動刪除應用程式的資料資料夾。
應用程式資料資料夾範圍
您必須先要求存取 https://www.googleapis.com/auth/drive.appdata
非敏感範圍,才能存取應用程式資料資料夾。如要進一步瞭解範圍和如何要求存取權,請參閱「選擇 Google Drive API 範圍」。如要進一步瞭解特定 OAuth 2.0 範圍,請參閱「Google API 適用的 OAuth 2.0 範圍」。
應用程式資料資料夾與 Google 雲端硬碟備份資料夾的差異
應用程式資料資料夾與雲端硬碟備份資料夾分開。
應用程式資料資料夾是每個第三方應用程式建立的設定資料夾,每個第三方應用程式都可以在其中儲存資料。只有在 appDataFolder
中建立資料的應用程式才能存取資料。使用雲端硬碟使用者介面 (UI) 無法存取該資料夾。
雲端硬碟備份資料夾是雲端硬碟寫入裝置備份的預留資料夾,可在雲端硬碟 UI 中查看。
應用程式資料資料夾的限制
使用應用程式資料資料夾時,系統會強制執行下列限制:
您無法共用應用程式資料資料夾中的檔案或資料夾。嘗試這麼做會產生
notSupportedForAppDataFolderFiles
錯誤,並顯示以下錯誤訊息:「Application Data 資料夾中的檔案不支援此方法。」您無法在儲存空間 (空間) 之間移動
appDataFolder
中的檔案。嘗試這麼做會產生notSupportedForAppDataFolderFiles
錯誤,並顯示以下錯誤訊息:「不支援應用程式資料資料夾內的檔案。」詳情請參閱「檔案組織」。您無法將應用程式資料資料夾中的檔案或資料夾移至垃圾桶。嘗試這麼做會產生
notSupportedForAppDataFolderFiles
錯誤,並顯示以下錯誤訊息:「無法將應用程式資料資料夾中的檔案移至垃圾桶。」
在應用程式資料資料夾中建立檔案
如要在應用程式資料資料夾中建立檔案,請在檔案的 parents
屬性中指定 appDataFolder
,然後使用 files.create
方法在資料夾中建立檔案。
以下程式碼範例說明如何使用用戶端程式庫和 curl 指令,將檔案插入資料夾。
Java
Python
Node.js
PHP
.NET
curl
Request 讀取電子郵件的資料:
curl --request POST \
'https://content.googleapis.com/drive/v3/files' \
-H 'authorization: Bearer ACCESS_TOKEN' \
-H 'content-type: application/json' \
-H 'x-origin: https://explorer.apis.google.com' \
--data-raw '{"name": "config.json", "parents":["appDataFolder"]}'
將 ACCESS_TOKEN 替換為應用程式的 OAuth 2.0 權杖。
回覆:
{
"kind": "drive#file",
"id": FILE_ID,
"name": "config.json",
"mimeType": "application/json"
}
如要進一步瞭解如何在資料夾中建立檔案,請參閱「建立及填入資料夾」一文。
在應用程式資料資料夾中搜尋檔案
如要搜尋應用程式資料資料夾中的檔案,請將 spaces
欄位設為 appDataFolder
,然後使用 files.list
方法。
以下程式碼範例說明如何使用用戶端程式庫和 curl 指令,在應用程式資料資料夾中搜尋檔案。
Java
Python
Node.js
PHP
.NET
curl
Request 讀取電子郵件的資料:
curl \
-X GET \
-H "Authorization: Bearer ACCESS_TOKEN" \
"https://www.googleapis.com/drive/v3/files?spaces=appDataFolder&fields=files(id,name,mimeType,size,modifiedTime)"
將 ACCESS_TOKEN 替換為應用程式的 OAuth 2.0 權杖。
回覆:
{
"files": [
{
"mimeType": "application/json",
"size": "256",
"id": FILE_ID,
"name": "config.json",
"modifiedTime": "2025-04-03T23:40:05.860Z"
},
{
"mimeType": "text/plain",
"size": "128",
"id": FILE_ID,
"name": "user_settings.txt",
"modifiedTime": "2025-04-02T17:52:29.020Z"
}
]
}
從應用程式資料資料夾下載檔案
如要從應用程式資料資料夾下載檔案,請使用 files.get
方法搭配 alt=media
網址參數,擷取回應主體中的檔案內容。如需更多資訊,並查看程式碼範例,請參閱「下載 Blob 檔案內容」。
以下程式碼範例說明如何使用 curl 指令下載應用程式資料資料夾中的檔案。回應主體會因儲存的內容而異。
curl
Request 讀取電子郵件的資料:
curl \
-X GET \
-H "Authorization: Bearer ACCESS_TOKEN" \
"https://www.googleapis.com/drive/v3/files/FILE_ID?alt=media"
更改下列內容:
- ACCESS_TOKEN:應用程式的 OAuth 2.0 權杖。
- FILE_ID:要下載的檔案 ID。