애플리케이션 데이터 폴더는 앱에서 구성 파일과 같은 애플리케이션별 데이터를 저장하는 데 사용할 수 있는 특수한 숨겨진 폴더입니다. 애플리케이션 데이터 폴더는 폴더에서 파일을 만들려고 할 때 자동으로 생성됩니다. 사용자가 직접 상호작용해서는 안 되는 파일을 저장하는 데 이 폴더를 사용하세요. 이 폴더는 앱에서만 액세스할 수 있으며 콘텐츠는 사용자 및 다른 Google Drive 앱에서 숨겨집니다.
애플리케이션 데이터 폴더는 사용자가 내 드라이브에서 앱을 제거할 때 삭제됩니다. 사용자는 앱의 데이터 폴더를 수동으로 삭제할 수도 있습니다.
애플리케이션 데이터 폴더 범위
애플리케이션 데이터 폴더에 액세스하려면 먼저 민감하지 않은 https://www.googleapis.com/auth/drive.appdata
범위에 대한 액세스를 요청해야 합니다. 범위 및 액세스 권한 요청 방법에 관한 자세한 내용은 Google Drive API 범위 선택하기를 참고하세요. 특정 OAuth 2.0 범위에 관한 자세한 내용은 Google API의 OAuth 2.0 범위를 참고하세요.
애플리케이션 데이터 폴더와 Drive 백업 폴더의 차이점
애플리케이션 데이터 폴더는 Drive 백업 폴더와 별개입니다.
애플리케이션 데이터 폴더는 서드 파티 앱별로 생성되는 구성 폴더이며 각 서드 파티 앱은 이 폴더에 데이터를 저장할 수 있습니다. appDataFolder
에서 데이터를 만든 애플리케이션만 액세스할 수 있습니다. Drive 사용자 인터페이스 (UI)를 사용하여 폴더에 액세스할 수 없습니다.
Drive 백업 폴더는 Drive에서 기기 백업을 쓰는 예약된 폴더이며 Drive UI에 표시됩니다.
애플리케이션 데이터 폴더 제약조건
애플리케이션 데이터 폴더를 사용할 때는 다음 제약조건이 적용됩니다.
애플리케이션 데이터 폴더 내에서는 파일이나 폴더를 공유할 수 없습니다. 이렇게 하면
notSupportedForAppDataFolderFiles
오류가 발생하며 다음과 같은 오류 메시지가 표시됩니다. '애플리케이션 데이터 폴더 내 파일에 메서드가 지원되지 않습니다.'appDataFolder
의 파일을 저장소 위치(스페이스) 간에 이동할 수 없습니다. 이렇게 하면 '애플리케이션 데이터 폴더 내 파일에 메서드가 지원되지 않습니다.'라는 오류 메시지와 함께notSupportedForAppDataFolderFiles
오류가 발생합니다. 자세한 내용은 파일 구성을 참고하세요.애플리케이션 데이터 폴더 내의 파일이나 폴더는 휴지통에 버릴 수 없습니다. 이렇게 하면
notSupportedForAppDataFolderFiles
오류와 함께 '애플리케이션 데이터 폴더 내 파일을 휴지통에 버릴 수 없습니다'라는 오류 메시지가 표시됩니다.
애플리케이션 데이터 폴더에 파일 만들기
애플리케이션 데이터 폴더에 파일을 만들려면 파일의 parents
속성에 appDataFolder
를 지정하고 files.create
메서드를 사용하여 폴더에 파일을 만듭니다.
다음 코드 샘플은 클라이언트 라이브러리와 curl 명령어를 사용하여 폴더에 파일을 삽입하는 방법을 보여줍니다.
자바
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 명령어를 사용하여 애플리케이션 데이터 폴더에서 파일을 검색하는 방법을 보여줍니다.
자바
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"
}
]
}
애플리케이션 데이터 폴더에서 파일 다운로드
애플리케이션 데이터 폴더에서 파일을 다운로드하려면 alt=media
URL 매개변수와 함께 files.get
메서드를 사용하여 응답 본문에서 파일 콘텐츠를 가져옵니다. 자세한 내용과 코드 샘플을 보려면 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입니다.