مجلد بيانات التطبيق هو مجلد مخفي خاص يمكن أن يستخدمه تطبيقك لتخزين البيانات الخاصة بالتطبيق، مثل ملفات الإعداد. يتم إنشاء مجلد بيانات التطبيق تلقائيًا عند محاولة إنشاء ملف فيه. استخدِم هذا المجلد لتخزين أي ملفات لا يجب أن يتفاعل معها المستخدم مباشرةً. لا يمكن الوصول إلى هذا المجلد إلا من خلال تطبيقك، ويكون محتواه مخفيًا عن المستخدم وعن تطبيقات Google Drive الأخرى.
يتم حذف مجلد بيانات التطبيق عندما يزيل المستخدم تطبيقك من "ملفاتي". يمكن للمستخدمين أيضًا حذف مجلد بيانات تطبيقك يدويًا.
نطاق مجلد بيانات التطبيق
قبل أن تتمكّن من الوصول إلى مجلد بيانات التطبيق، يجب أن تطلب الوصول إلى النطاق https://www.googleapis.com/auth/drive.appdata
غير الحسّاس. لمزيد من المعلومات حول النطاقات وكيفية طلب الوصول إليها، يُرجى الاطّلاع على اختيار نطاقات Google Drive API. لمزيد من المعلومات حول نطاقات OAuth 2.0 المحدّدة، يُرجى الاطّلاع على نطاقات OAuth 2.0 لواجهات Google APIs.
الاختلافات بين مجلد بيانات التطبيق ومجلدات النسخ الاحتياطي في Drive
يختلف مجلد بيانات التطبيق عن مجلد النسخ الاحتياطي في Drive.
مجلد بيانات التطبيق هو مجلد إعدادات يتم إنشاؤه لكل تطبيق تابع لجهة خارجية، ويمكن لكل تطبيق تابع لجهة خارجية تخزين البيانات فيه. ويمكن للتطبيق الذي أنشأ البيانات في appDataFolder
فقط الوصول إليها. لا يمكن الوصول إلى المجلد باستخدام واجهة مستخدم Drive.
مجلد النسخ الاحتياطي في Drive هو مجلد محجوز يكتب فيه Drive النُسخ الاحتياطية من بيانات الجهاز، ويمكنك الاطّلاع عليه في واجهة مستخدم Drive.
القيود المفروضة على مجلد بيانات التطبيق
يتم فرض القيود التالية عند العمل مع مجلد بيانات التطبيق:
لا يمكنك مشاركة الملفات أو المجلدات داخل مجلد بيانات التطبيق. سيؤدي ذلك إلى ظهور الخطأ
notSupportedForAppDataFolderFiles
مع رسالة الخطأ التالية: "الطريقة غير متاحة للملفات في مجلد بيانات التطبيق".لا يمكنك نقل الملفات في
appDataFolder
بين مساحات التخزين. وستؤدي محاولة إجراء ذلك إلى ظهور الخطأnotSupportedForAppDataFolderFiles
مع رسالة الخطأ التالية: "الطريقة غير متاحة للملفات داخل مجلد بيانات التطبيق". لمزيد من المعلومات، يمكنك الاطّلاع على تنظيم الملفات.لا يمكنك نقل الملفات أو المجلدات إلى المهملات داخل مجلد بيانات التطبيق. وستؤدي محاولة إجراء ذلك إلى ظهور الخطأ
notSupportedForAppDataFolderFiles
مع رسالة الخطأ التالية: "لا يمكن نقل الملفات داخل مجلد Application Data إلى المهملات".
إنشاء ملف في مجلد بيانات التطبيق
لإنشاء ملف في مجلد بيانات التطبيق، حدِّد appDataFolder
في السمة
parents
للملف واستخدِم الطريقة
files.create
لإنشاء الملف في المجلد.
يوضّح نموذج الرمز البرمجي التالي كيفية إدراج ملف في مجلد باستخدام مكتبة برامج للعملاء وأمر curl.
Java
Python
Node.js
PHP
NET.
curl
الطلب:
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
الطلب:
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
مع مَعلمة عنوان URL alt=media
لاسترداد محتوى الملف في نص الاستجابة. لمزيد من المعلومات وللاطّلاع على عيّنات التعليمات البرمجية، انتقِل إلى تنزيل محتوى ملف blob.
يوضّح نموذج الرمز البرمجي التالي كيفية تنزيل الملفات في مجلد بيانات التطبيق باستخدام أمر curl. سيختلف نص الرد حسب ما تم حفظه.
curl
الطلب:
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: معرّف الملف الذي تريد تنزيله