المجلدات هي ملفات تحتوي على بيانات وصفية فقط ويمكن استخدامها لتنظيم الملفات في Google Drive. ولديه السمات التالية:
- المجلد هو ملف من نوع MIME
application/vnd.google-apps.folder
، ولا يحتوي على إضافة. - يمكن استخدام الاسم المستعار
root
للإشارة إلى المجلد الجذر في أي مكان يتم فيه توفير معرِّف ملف.
لمزيد من المعلومات عن حدود مجلدات Drive، يُرجى الاطّلاع على حدود الملفات والمجلدات.
يشرح هذا الدليل كيفية تنفيذ بعض المهام الأساسية المتعلقة بالمجلد.
إنشاء مجلد
لإنشاء مجلّد، استخدِم الطريقة files.create
مع application/vnd.google-apps.folder
نوع MIME وعنوان. يوضح نموذج التعليمات البرمجية التالي
كيفية إنشاء مجلد باستخدام مكتبة برامج:
Java
Python
Node.js
PHP
NET.
إنشاء ملف في مجلد معين
لإنشاء ملف في مجلد معيّن، استخدِم الطريقة files.create
وحدِّد رقم تعريف المجلد في السمة parents
للملف. تحتوي السمة parents
على معرّفات المجلد الرئيسي التي تحتوي على الملف. يوضح عينة التعليمات البرمجية التالية كيفية إنشاء
ملف في مجلد معين باستخدام مكتبة برامج:
Java
Python
Node.js
PHP
NET.
يمكن استخدام السمة parents
عند إنشاء ملفات في مجلد بمستوى أعلى أو أي مجلد آخر.
نقل الملفات بين المجلدات
لنقل الملفات، عليك تعديل رقم تعريف السمة parents
.
لإضافة العناصر الرئيسية أو إزالتها من ملف حالي، يمكنك استخدام الطريقة files.update
مع مَعلمتَي طلب البحث addParents
وremoveParents
. يوضح نموذج التعليمات البرمجية التالي كيفية نقل
ملف بين المجلدات باستخدام مكتبة برامج:
Java
Python
Node.js
PHP
NET.
حدود الملفات والمجلدات
هناك حدود لمساحة التخزين في ملفات ومجلدات Drive.
الحد الأقصى لعناصر المستخدم
يمكن أن يمتلك كل مستخدم ما يصل إلى 500 مليون عنصر تم إنشاؤه من خلال هذا الحساب. عند الوصول إلى الحد الأقصى، لن يعود بإمكان المستخدم إنشاء عناصر أو تحميلها في Drive. سيظل بإمكانه الاطّلاع على العناصر الحالية وتعديلها. لإنشاء ملفات مرة أخرى، يجب على المستخدمين حذف العناصر نهائيًا أو استخدام حساب مختلف. لمزيد من المعلومات، يُرجى الاطّلاع على المهملات أو حذف الملفات والمجلدات.
العناصر التي يتم احتسابها ضمن هذا الحد هي:
- الملفات التي أنشأها المستخدم أو حمّلها في Drive
- عناصر أنشأها المستخدم ولكنها مملوكة الآن لشخص آخر
- العناصر في المهملات
- الاختصارات
- الاختصارات التابعة لجهات خارجية
العناصر التي لا يتم احتسابها ضمن هذا الحد هي:
- العناصر المحذوفة نهائيًا
- عناصر تمت مشاركتها مع المستخدم ولكنها مملوكة لشخص آخر
- العناصر التي يملكها المستخدم ولكن أنشأها شخص آخر
تؤدي محاولة إضافة أكثر من 500 مليون عنصر إلى عرض استجابة رمز حالة HTTP
activeItemCreationLimitExceeded
.
وتجدر الإشارة إلى أنّه على الرغم من عدم وجود حدّ أقصى لعدد العناصر التي يمكن أن يمتلكها حساب الخدمة، ينطبق الحدّ الأقصى المسموح به الذي يبلغ 500 مليون عنصر على عدد العناصر التي يمكن لحساب الخدمة إنشاؤها.
الحدّ الأقصى المسموح به لعناصر المجلد
يبلغ الحد الأقصى لعدد العناصر في كل مجلد في "ملفاتي" لدى المستخدم 500,000 ملف. لا ينطبق هذا الحد على المجلد الجذر في "ملفاتي". العناصر التي يتم احتسابها ضمن هذا الحد هي:
- المجلدات
- الملفات جميع أنواع الملفات، بغض النظر عن ملكية الملفات.
- الاختصارات/3}. يتم احتسابه كعنصر واحد داخل مجلد، حتى إذا كان العنصر الذي يشير إليه ليس داخل ذلك المجلد. لمزيد من المعلومات، يُرجى الاطِّلاع على إنشاء اختصار لملف Drive.
- الاختصارات التابعة لجهات خارجية يتم احتسابه كعنصر واحد داخل مجلد، حتى إذا كان العنصر الذي يشير إليه ليس داخل ذلك المجلد. لمعرفة مزيد من المعلومات، يُرجى الاطّلاع على إنشاء ملف اختصار للمحتوى المُخزَّن من خلال تطبيقك.
لمزيد من المعلومات عن حدود المجلدات، يمكنك الاطّلاع على حدود المجلدات في Google Drive.
حد عمق المجلد
لا يمكن أن تحتوي "ملفاتي" في حساب المستخدم على أكثر من 100 مستوى من المجلدات المتداخلة. ويعني هذا أنّه لا يمكن تخزين مجلد فرعي ضمن مجلد يزيد عمقه عن 99 مستوى. وينطبق هذا القيد على المجلدات الفرعية فقط. يُستثنى من هذا التقييد أي ملف فرعي
من نوع MIME غير
application/vnd.google-apps.folder
.
على سبيل المثال، في الرسم التخطيطي التالي، يمكن دمج مجلد جديد داخل المجلد رقم 99 ولكن ليس داخل المجلد رقم 100. ومع ذلك، يمكن للمجلد رقم 100 تخزين الملفات مثل أي مجلد آخر في Drive:
تؤدي محاولة إضافة أكثر من 100 مستوى من المجلدات إلى عرض استجابة رمز حالة HTTP
myDriveHierarchyDepthLimitExceeded
.