Uygulama verileri klasörü, uygulamanızın yapılandırma dosyaları gibi uygulamaya özel verileri depolamak için kullanabileceği özel bir gizli klasördür. Uygulama verileri klasörü, bu klasörde dosya oluşturmaya çalıştığınızda otomatik olarak oluşturulur. Kullanıcının doğrudan etkileşimde bulunmaması gereken dosyaları saklamak için bu klasörü kullanın. Bu klasöre yalnızca uygulamanız erişebilir ve içeriği kullanıcıdan ve diğer Google Drive uygulamalarından gizlenir.
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ünün kapsamı
Uygulama verileri klasörüne erişebilmek için https://www.googleapis.com/auth/drive.appdata
hassas olmayan kapsamına 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ü, üçüncü taraf uygulaması başına 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 verilere erişebilir. Klasöre Drive kullanıcı arayüzü (UI) kullanılarak erişilemez.
Drive yedekleme klasörünüz, Drive'ın cihaz yedeklemelerini yazdığı ayrılmış bir klasördür ve Drive kullanıcı arayüzünde görünür.
Uygulama verileri klasörü üzerindeki kısıtlamalar
Uygulama verileri klasörüyle çalışırken aşağıdaki kısıtlamalar uygulanır:
Uygulama verileri klasöründeki dosya veya klasörleri paylaşamazsınız. Bunu yapmaya çalıştığınızda
notSupportedForAppDataFolderFiles
hatası ve "Yöntem, Application Data klasöründeki dosyalar için desteklenmiyor." hata mesajı gösterilir.appDataFolder
alanındaki dosyaları depolama konumları (alanlar) arasında taşıyamazsınız. Bunu yapmaya çalıştığınızda aşağıdaki hata mesajını içeren birnotSupportedForAppDataFolderFiles
hatası oluşturulur: "Yöntem, Application Data 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 dosya veya klasörleri çöp kutusuna taşıyamazsınız. Bunu yapmaya çalıştığınızda
notSupportedForAppDataFolderFiles
hatası oluşur ve şu hata mesajı gösterilir: "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 appDataFolder
özelliğinde parents
değerini belirtin ve klasörde dosya oluşturmak için files.create
yöntemini kullanın.
Aşağıdaki kod örneğinde, istemci kitaplığı ve curl komutu kullanarak bir dosyayı klasöre nasıl ekleyeceğiniz 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 klasörlere içerik ekleme 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 kullanarak uygulama verileri klasöründeki dosyaların nasıl aranacağı 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 dosya indirmek için yanıt gövdesindeki dosya içeriklerini almak üzere alt=media
URL parametresiyle birlikte files.get
yöntemini kullanın. Daha fazla bilgi edinmek ve kod örneklerini görüntülemek için Blob dosyası içeriğini indirme başlıklı makaleyi inceleyin.
Aşağıdaki kod örneğinde, curl komutu kullanarak uygulama verileri klasöründeki dosyaların nasıl indirileceği gösterilmektedir. Yanıt gövdesi, kaydedilenlere 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.