يتضمّن هذا الدليل مهامًا متعلّقة بإدارة مساحات التخزين السحابي المشتركة، مثل إنشاء مساحات تخزين سحابي مشتركة وإدارة الأعضاء والأذونات باستخدام Google Drive API.
لمزيد من المعلومات حول حدود مجلدات مساحة التخزين السحابي المشتركة، يُرجى الاطّلاع على حدود المجلدات.
إنشاء مساحات تخزين سحابي مشتركة
لإنشاء مساحة تخزين سحابي مشتركة، استخدِم الطريقة
drives.create
.
Java
Python
Node.js
PHP
NET.
تكون طلبات الطريقة drives.create
متكررة.
تحدّد المَعلمة requestId
المحاولة المنطقية لإنشاء مساحة التخزين المشتركة. إذا انتهت مهلة الطلب أو عرض خطأ غير محدّد من الخلفية، يمكن تكرار الطلب نفسه. يجب أن يظل requestId
ونص الطلب كما هما.
إذا تم إنشاء مساحة التخزين السحابي المشتركة بنجاح في طلب سابق أو بسبب إعادة المحاولة، سيتم عرض الردّ العادي. في بعض الأحيان، مثل بعد فترة طويلة أو إذا تم تغيير نص الطلب، قد يتم عرض الخطأ 409
للإشارة إلى أنّه يجب تجاهل requestId
.
إضافة أعضاء مساحة التخزين السحابي المشتركة أو إزالتهم
يمكنك إضافة أعضاء مساحة التخزين السحابي المشتركة أو إزالتهم باستخدام المورد
permissions
.
لإضافة عضو، يجب إنشاء الإذن في مساحة التخزين السحابي المشتركة. يمكن أيضًا استخدام طرق منح الأذونات على الملفات الفردية داخل مساحة التخزين السحابي المشتركة لمنح الأعضاء امتيازات إضافية أو السماح لغير الأعضاء بالتعاون في عناصر معيّنة.
لمزيد من المعلومات ونموذج الرمز البرمجي، يُرجى الاطّلاع على مشاركة الملفات والمجلدات ومساحات التخزين.
حذف مساحة تخزين سحابي مشتركة
استخدِم طريقة drives.delete
لحذف مساحة تخزين سحابي مشتركة. يجب نقل كل المحتوى في مساحة التخزين السحابي المشتركة إلى المهملات أو حذفه قبل حذف مساحة التخزين السحابي المشتركة.
إدارة مساحات التخزين السحابي المشتركة لمشرفي النطاق
طبِّق المَعلمة useDomainAdminAccess
مع الموردَين drives
وpermissions
لإدارة مساحات التخزين السحابي المشتركة في جميع أنحاء المؤسسة.
يجب أن يكون لدى المستخدمين الذين يستدعون هذه الطرق باستخدام useDomainAdminAccess=true
امتيازات المشرف Drive and Docs
.
يمكن للمشرفين البحث عن مساحات تخزين سحابي مشتركة أو تعديل أذونات مساحات التخزين السحابي المشتركة التي تملكها مؤسستهم، بغض النظر عن عضوية المشرف في أي مساحة تخزين سحابي مشتركة.
استرداد مساحة تخزين سحابي مشتركة ليس لديها منظِّم
يوضّح المثال التالي كيفية استخدام هذه المراجع لاسترداد مساحات التخزين السحابي المشتركة التي لم يعُد لديها منظّم.
Java
Python
Node.js
PHP
NET.
منع المستخدمين من تنزيل ملفك أو طباعته أو نسخه
يمكنك فرض قيود على طريقة تنزيل المستخدمين للملفات وطباعتها ونسخها داخل مساحات التخزين السحابي المشتركة.
لتحديد ما إذا كان بإمكان المستخدم تغيير قيود التنزيل التي فرضها المنظّم على مساحة تخزين سحابي مشتركة، تحقّق من الحقل المنطقي capabilities.canChangeDownloadRestriction
. إذا تم ضبط
capabilities.canChangeDownloadRestriction
على true
، يمكن تطبيق قيود التنزيل على مساحة التخزين السحابي المشتركة. لمزيد من المعلومات، يُرجى الاطّلاع على التعرّف على إمكانات الملفات.
يحتوي المرجع drives
على مجموعة من حقول restrictions
من النوع المنطقي تُستخدَم لتحديد ما إذا كان يمكن تنفيذ إجراء في مساحة تخزين سحابي مشتركة.
تنطبق القيود على مساحة تخزين سحابي مشتركة أو العناصر داخل مساحة تخزين سحابي مشتركة.
يمكن ضبط القيود باستخدام طريقة drives.update
.
لتطبيق قيود التنزيل على مساحة تخزين سحابي مشتركة، يمكن لمدير مساحة التخزين السحابي المشتركة ضبط حقل restrictions.downloadRestriction
الخاص بمورد drives
باستخدام عنصر DownloadRestriction
.
يؤدي ضبط الحقل المنطقي restrictedForReaders
على true
إلى الإشارة إلى أنّ التنزيل والنسخ محظوران على القرّاء. يؤدي ضبط الحقل المنطقي restrictedForWriters
على true
إلى الإشارة إلى أنّ ميزتَي التنزيل والنسخ محظورتان على
الكتّاب. يُرجى العِلم أنّه إذا كان الحقل restrictedForWriters
هو true
، سيتم أيضًا حظر التنزيل والنسخ على القرّاء. وبالمثل، فإنّ ضبط restrictedForWriters
على true
وrestrictedForReaders
على false
يعادل ضبط كل من restrictedForWriters
وrestrictedForReaders
على true
.
التوافق مع الإصدارات السابقة
مع طرح العنصر DownloadRestriction
، تم تعديل وظيفة الحقل المنطقي restrictions.copyRequiresWriterPermission
.
الآن، يؤدي ضبط restrictions.copyRequiresWriterPermission
على true
إلى تعديل الحقل المنطقي restrictedForReaders
الخاص بالكائن DownloadRestriction
إلى true
للإشارة إلى أنّ التنزيل والنسخ محظوران على القرّاء.
يؤدي ضبط الحقل copyRequiresWriterPermission
على false
إلى تعديل الحقلين restrictedForWriters
وrestrictedForReaders
إلى false
. وهذا يعني أنّه ستتم إزالة إعدادات القيود المفروضة على التنزيل أو النسخ لجميع المستخدمين.
الحقول التي تتحكّم في ميزات التنزيل والطباعة والنسخ
يسرد الجدول التالي حقول موارد drives
التي تؤثّر في وظائف التنزيل والطباعة والنسخ:
الحقل | الوصف | الإصدار |
---|---|---|
capabilities.canCopy |
تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي نسخ الملفات في مساحة تخزين سحابي مشتركة. | الإصداران 2 و3 |
capabilities.canDownload |
تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي تنزيل الملفات في مساحة تخزين سحابي مشتركة. | الإصداران 2 و3 |
capabilities.canChangeCopyRequiresWriterPermission |
تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي تغيير copyRequiresWriterPermission مساحة تخزين سحابي مشتركة. |
الإصداران 2 و3 |
capabilities.canResetDriveRestrictions |
تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي إعادة ضبط قيود مساحة التخزين السحابي المشتركة على الإعدادات التلقائية. | الإصداران 2 و3 |
capabilities.canChangeDownloadRestriction |
تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي تغيير قيود التنزيل في مساحة تخزين سحابي مشتركة. | الإصدار 3 فقط |
restrictions.copyRequiresWriterPermission |
تحديد ما إذا كانت خيارات نسخ الملفات أو طباعتها أو تنزيلها داخل مساحة تخزين سحابي مشتركة غير متاحة للقراء والمعلِّقين عندما تكون القيمة true ، يتم ضبط الحقل الذي يحمل الاسم نفسه على true لأي ملف داخل مساحة التخزين السحابي المشتركة هذه. |
الإصداران 2 و3 |
restrictions.downloadRestriction |
قيود التنزيل التي يفرضها مديرو مساحة التخزين السحابي المشتركة | الإصدار 3 فقط |
حدود المجلدات
تخضع مجلدات مساحة التخزين السحابي المشتركة لبعض القيود المتعلقة بمساحة التخزين. للحصول على معلومات، يُرجى الاطّلاع على مقالة حدود مساحة التخزين السحابي المشتركة في Google Drive.
الحد الأقصى لعدد العناصر
يبلغ الحد الأقصى لعدد العناصر في كل مجلد في مساحة التخزين السحابي المشتركة الخاصة بالمستخدم 500,000 عنصر، بما في ذلك الملفات والمجلدات والاختصارات.
عند بلوغ الحدّ الأقصى، لن تتمكّن مساحة التخزين السحابي المشتركة من قبول العناصر. لتلقّي الملفات مرة أخرى، على المستخدمين حذف بعض العناصر نهائيًا من المجلد. يُرجى العِلم أنّ العناصر الموجودة في المهملات تُحتسب ضمن الحدّ الأقصى، ولكن لا تُحتسب العناصر المحذوفة نهائيًا. لمزيد من المعلومات، يُرجى الاطّلاع على نقل الملفات والمجلدات إلى المهملات أو حذفها.
الحدّ الأقصى لعمق المجلد
لا يمكن أن يحتوي مجلد في مساحة تخزين سحابي مشتركة على أكثر من 100 مستوى من المجلدات المُدمجة. وهذا يعني أنّه لا يمكن تخزين مجلد فرعي ضمن مجلد يتضمّن أكثر من 99 مستوى. لا ينطبق هذا الحدّ إلا على المجلدات الفرعية.
تؤدي محاولات إضافة أكثر من 100 مستوى من المجلدات إلى عرض رمز حالة HTTP teamDriveHierarchyTooDeep
.