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