مجلد بيانات التطبيق هو مجلد مخفي خاص يمكن لتطبيقك استخدامه لتخزين البيانات الخاصة بالتطبيق، مثل ملفات الإعدادات. يتم إنشاء مجلد بيانات التطبيق تلقائيًا عند محاولة إنشاء ملف فيه. استخدِم هذا المجلد لتخزين أي ملفات لا يجب أن يتفاعل معها المستخدم مباشرةً. لا يمكن الوصول إلى هذا المجلد إلا من خلال تطبيقك ويكون محتواه مخفيًا عن المستخدم وعن تطبيقات 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
. لمزيد من المعلومات وعرض
عيّنات التعليمات البرمجية، انتقِل إلى مقالة تنزيل ملف ملف برمجي
المحتوى.