مجلد بيانات التطبيق هو مجلد مخفي خاص يمكن لتطبيقك استخدامه لتخزين البيانات الخاصة بالتطبيقات، مثل ملفات الإعداد. يتم إنشاء مجلد بيانات التطبيق تلقائيًا عند محاولة إنشاء ملف فيه. استخدم هذا المجلد لتخزين أي ملفات يجب ألا يتفاعل المستخدم معها مباشرةً. لا يمكن الوصول إلى هذا المجلد إلا من خلال تطبيقك ويتم إخفاء محتواه عن المستخدم ومن تطبيقات Drive الأخرى.
لا يمكن نقل الملفات في appDataFolder
بين مواقع التخزين (المساحات). لمزيد من المعلومات، يُرجى الاطّلاع على تنظيم الملفات.
يتم حذف مجلد بيانات التطبيق عندما يلغي المستخدم تثبيت التطبيق من ملفاتي. ويمكن للمستخدمين أيضًا حذف مجلد بيانات تطبيقك يدويًا.
نطاق مجلد بيانات التطبيق
قبل أن تتمكن من الوصول إلى مجلد بيانات التطبيق، يجب طلب الوصول إلى
نطاق 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
. يعرض نموذج التعليمات البرمجية التالي كيفية استخدام البحث عن الملفات في مجلد بيانات التطبيق باستخدام مكتبة عميل.
Java
Python
Node.js
PHP
NET.
تنزيل الملفات من مجلد بيانات التطبيق
لتنزيل ملف من مجلد بيانات التطبيق، استخدِم الطريقة files.get
. لمزيد من المعلومات، ولعرض نماذج التعليمات البرمجية، انتقِل إلى تنزيل محتوى ملف blob.