مجلد بيانات التطبيق هو مجلد مخفي خاص يمكن لتطبيقك استخدامه لتخزين البيانات الخاصة بالتطبيق، مثل ملفات الإعدادات. يتم إنشاء مجلد data الخاص بالتطبيق تلقائيًا عند محاولة إنشاء ملف فيه. استخدِم هذا المجلد لتخزين أي ملفات لا يجب أن يتفاعل معها المستخدم مباشرةً. لا يمكن الوصول إلى هذا المجلد إلا من خلال تطبيقك، وتكون محتوياته مخفية عن المستخدم وتطبيقات Drive الأخرى.
لا يمكن نقل الملفات في appDataFolder
بين مواقع التخزين (المساحات). لمزيد من المعلومات، يُرجى الاطّلاع على تنظيم الملفات.
يتم حذف مجلد بيانات التطبيق عندما يلغي مستخدم تثبيت تطبيقك من ملف MyDrive. يمكن للمستخدمين أيضًا حذف مجلد بيانات تطبيقك يدويًا.
نطاق مجلد بيانات التطبيق
قبل أن تتمكّن من الوصول إلى مجلد بيانات التطبيق، عليك طلب الوصول إلى
نطاق https://www.googleapis.com/auth/drive.appdata
. لمزيد من المعلومات
عن النطاقات وكيفية طلب الوصول إليها، يُرجى الرجوع إلى معلومات
المصادقة والتفويض
الخاصة بواجهة برمجة التطبيقات. لمزيد من المعلومات حول
نطاقات OAuth 2.0 المحدّدة، يُرجى الاطّلاع على نطاقات OAuth 2.0 لواجهات برمجة التطبيقات
في Google.
إنشاء ملف في مجلد بيانات التطبيق
لإنشاء ملف في مجلد بيانات التطبيق، حدِّد appDataFolder
في سمة
parents
للملف واستخدِم الطريقة files.create
لتحميل الملف إلى المجلد. يوضّح رمز الالتقاط التالي كيفية إدراج ملف في مجلد باستخدام مكتبة عملاء.
Java
Python
Node.js
PHP
NET.
لمزيد من المعلومات عن إنشاء ملفات في المجلدات، يُرجى الاطّلاع على مقالة إنشاء المجلدات و ملؤها.
البحث عن الملفات في مجلد بيانات التطبيق
للبحث عن الملفات في مجلد بيانات التطبيق، اضبط الحقل spaces
على
appDataFolder
واستخدِم الطريقة files.list
. يوضّح نموذج الرمز البرمجي التالي كيفية استخدام البحث عن الملفات في مجلّد data
التطبيق باستخدام مكتبة العميل.
Java
Python
Node.js
PHP
NET.
تنزيل الملفات من مجلد بيانات التطبيق
لتنزيل ملف من مجلد بيانات التطبيق، استخدِم الطريقة files.get
. لمزيد من المعلومات وعرض
عيّنات التعليمات البرمجية، انتقِل إلى مقالة تنزيل محتوىملف ملف برمجي دوار.