Uygulama verisi klasörü, uygulamanızın yapılandırma dosyaları gibi uygulamaya özgü verileri depolamak için kullanabileceği özel bir gizli klasördür. Uygulama veri klasörü, içinde dosya oluşturmaya çalıştığınızda otomatik olarak oluşturulur. Kullanıcının doğrudan etkileşime geçmemesi gereken tüm dosyaları saklamak için bu klasörü kullanın. Bu klasöre yalnızca uygulamanız tarafından erişilebilir ve içeriği kullanıcıdan ve diğer Google Drive uygulamalarından gizlenir.
Bir kullanıcı uygulamanızı Drive'ım klasöründen kaldırdığında uygulama verileri klasörü silinir. Kullanıcılar, uygulamanızın veri klasörünü manuel olarak da silebilir.
Uygulama verileri klasörü kapsamı
Uygulama verileri klasörüne erişebilmek için https://www.googleapis.com/auth/drive.appdata
hassas olmayan kapsama erişim isteğinde bulunmanız gerekir. Kapsamlar ve bunlara erişim isteğinde bulunma hakkında daha fazla bilgi için Google Drive API kapsamlarını seçme başlıklı makaleyi inceleyin. Belirli OAuth 2.0 kapsamları hakkında daha fazla bilgi için Google API'leri için OAuth 2.0 Kapsamları başlıklı makaleyi inceleyin.
Uygulama verileri klasörünün Drive yedekleme klasörlerinden farkı
Uygulama verileri klasörü, Drive yedekleme klasörünüzden ayrıdır.
Uygulama verileri klasörü, her üçüncü taraf uygulaması için oluşturulan bir yapılandırma klasörüdür ve her üçüncü taraf uygulaması bu klasörde veri depolayabilir. Yalnızca appDataFolder
içinde verileri oluşturan uygulama bu verilere erişebilir. Klasöre Drive kullanıcı arayüzü (UI) kullanılarak erişilemez.
Drive yedekleme klasörünüz, Drive'ın cihaz yedeklerini yazdığı ayrılmış bir klasördür ve Drive kullanıcı arayüzünde görünür.
Uygulama verileri klasöründeki kısıtlamalar
Uygulama verileri klasörüyle çalışırken aşağıdaki kısıtlamalar uygulanır:
Uygulama verileri klasöründeki dosyaları veya klasörleri paylaşamazsınız. Bunu yapmaya çalıştığınızda şu hata mesajını içeren bir
notSupportedForAppDataFolderFiles
hatası oluşur: "Uygulama Verileri klasöründeki dosyalar için yöntem desteklenmiyor."appDataFolder
'teki dosyaları depolama konumları (alanlarda) arasında taşıyamazsınız. Bunu yapmaya çalıştığınızda şu hata mesajını içeren birnotSupportedForAppDataFolderFiles
hatası oluşur: "Yöntem, Uygulama Verileri klasöründeki dosyalar için desteklenmiyor." Daha fazla bilgi için Dosya düzenleme bölümüne bakın.Uygulama verileri klasöründeki dosyaları veya klasörleri çöp kutusuna gönderemezsiniz. Bunu yapmaya çalıştığınızda şu hata mesajını içeren bir
notSupportedForAppDataFolderFiles
hatası oluşur: "Uygulama Verileri klasöründeki dosyalar çöp kutusuna taşınamaz."
Uygulama verileri klasöründe dosya oluşturma
Uygulama verileri klasöründe dosya oluşturmak için dosyanın parents
mülkünde appDataFolder
değerini belirtin ve dosyayı klasörde oluşturmak için files.create
yöntemini kullanın.
Aşağıdaki kod örneğinde, istemci kitaplığı ve curl komutu kullanılarak bir klasöre nasıl dosya ekleneceği gösterilmektedir.
Java
Python
Node.js
PHP
.NET
curl
İstek:
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 yerine uygulamanızın OAuth 2.0 jetonunu girin.
Yanıt:
{
"kind": "drive#file",
"id": FILE_ID,
"name": "config.json",
"mimeType": "application/json"
}
Klasörlerde dosya oluşturma hakkında daha fazla bilgi için Klasör oluşturma ve doldurma başlıklı makaleyi inceleyin.
Uygulama verileri klasöründe dosya arama
Uygulama verileri klasöründeki dosyaları aramak için spaces
alanını appDataFolder
olarak ayarlayın ve files.list
yöntemini kullanın.
Aşağıdaki kod örneğinde, istemci kitaplığı ve curl komutu kullanılarak uygulama verileri klasöründe dosya arama işlemi gösterilmektedir.
Java
Python
Node.js
PHP
.NET
curl
İstek:
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 yerine uygulamanızın OAuth 2.0 jetonunu girin.
Yanıt:
{
"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"
}
]
}
Uygulama verileri klasöründen dosya indirme
Uygulama verileri klasöründen bir dosya indirmek için alt=media
URL parametresini kullanarak files.get
yöntemini kullanın ve yanıt gövdesinde dosya içeriğini alın. Daha fazla bilgi edinmek ve kod örneklerini görüntülemek için Blob dosya içeriğini indirme başlıklı makaleyi inceleyin.
Aşağıdaki kod örneğinde, curl komutu kullanılarak uygulama verileri klasöründeki dosyaların nasıl indirileceği gösterilmektedir. Yanıt gövdesi, kaydedilen öğeye bağlı olarak değişir.
curl
İstek:
curl \
-X GET \
-H "Authorization: Bearer ACCESS_TOKEN" \
"https://www.googleapis.com/drive/v3/files/FILE_ID?alt=media"
Aşağıdakini değiştirin:
- ACCESS_TOKEN: Uygulamanızın OAuth 2.0 jetonu.
- FILE_ID: İndirmek istediğiniz dosyanın kimliği.