يحتوي هذا الدليل على مهام متعلقة بإدارة مساحات التخزين السحابي المشتركة، مثل إنشاء مساحات تخزين سحابي مشتركة وإدارة الأعضاء والأذونات، باستخدام Google Drive API.
إذا أردت تحديد الحقول التي سيتم عرضها في الاستجابة، يمكنك ضبط الـ
fields مَعلمة
النظام
مع أي طريقة من طرق مورد الـdrives. إذا لم تحدّد المَعلمة fields، يعرض الخادم مجموعة تلقائية من الحقول الخاصة بالطريقة. على سبيل المثال، لا تعرض الطريقة
list سوى الحقول kind وid و
و name لكل مساحة تخزين سحابي مشتركة. لمزيد من المعلومات، يُرجى الاطّلاع على عرض
حقول معيّنة.
لمزيد من المعلومات عن الحدود القصوى المسموح بها لمجلدات مساحة التخزين السحابي المشتركة، يُرجى الاطّلاع على حدود مجلدات مساحة التخزين السحابي المشتركة.
إنشاء "مساحة تخزين سحابي مشتركة"
لإنشاء مساحة تخزين سحابي مشتركة، استخدِم الطريقة create
في مورد drives مع المَعلمة
requestId.
تحدّد المَعلمة requestId المحاولة المنطقية لإنشاء مساحة تخزين سحابي مشتركة بشكل متكرّر. إذا انتهت مهلة الطلب أو عرض خطأ غير محدّد في الخلفية، يمكن تكرار الطلب نفسه ولن يؤدي ذلك إلى إنشاء نُسخ مكرّرة. يجب أن تظل المَعلمة requestId ونص الطلب كما هما.
يوضّح نموذج التعليمات البرمجية التالي كيفية إنشاء مساحة تخزين سحابي مشتركة:
جافا
Python
Node.js
PHP
NET.
تكون عمليات استدعاء الطريقة create متكرّرة.
إذا تم إنشاء مساحة التخزين السحابي المشتركة بنجاح في طلب سابق أو بسبب إعادة المحاولة، تعرض الطريقة مثيلاً من مورد drives. في بعض الأحيان، مثل بعد فترة طويلة أو إذا تغيّر نص الطلب، قد يتم عرض الخطأ 409 الذي يشير إلى أنّه يجب تجاهل requestId.
الحصول على مساحة تخزين سحابي مشتركة
للحصول على بيانات مساحة تخزين سحابي مشتركة، استخدِم الـ
get method على الـ drives resource مع الـ driveId path parameter. إذا كنت
لا تعرف رقم تعريف مساحة التخزين السحابي المشتركة، يمكنك عرض جميع مساحات التخزين السحابي المشتركة
باستخدام الطريقة list.
تعرض الطريقة get مساحة تخزين سحابي مشتركة كمثيل من مورد drives.
لإرسال الطلب بصفتك مشرف نطاق، اضبط مَعلمة طلب البحث useDomainAdminAccess على true. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة مساحات التخزين السحابي المشتركة بصفتك
مشرف نطاق.
عرض مساحات التخزين السحابي المشتركة
لعرض مساحات التخزين السحابي المشتركة الخاصة بمستخدم، استخدِم الطريقة list
في مورد drives. تعرض الطريقة قائمة بمساحات التخزين السحابي المشتركة.
مرِّر مَعلمات طلب البحث التالية لتخصيص ترقيم الصفحات لمساحات التخزين السحابي المشتركة أو لفلترتها:
pageSize: الحد الأقصى لعدد مساحات التخزين السحابي المشتركة التي سيتم عرضها في كل صفحة.pageToken: رمز صفحة تم استلامه من طلب سابق لعرض القائمة. قدِّم هذا الرمز لاسترداد الصفحة التالية.q: سلسلة طلب بحث للبحث عن مساحات التخزين السحابي المشتركة. لمزيد من المعلومات، يُرجى الاطّلاع على البحث عن مساحات تخزين سحابي مشتركة.useDomainAdminAccess: اضبط هذه المَعلمة علىtrueلإرسال الطلب بصفتك مشرف نطاق لعرض جميع مساحات التخزين السحابي المشتركة في النطاق الذي تكون فيه مقدِّم الطلب مشرفًا. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة مساحات التخزين السحابي المشتركة بصفتك مشرف نطاق.
تعديل مساحة تخزين سحابي مشتركة
لتعديل بيانات مساحة تخزين سحابي مشتركة، استخدِم الطريقة update في مورد
drives مع مَعلمة المسار driveId.
تعرض الطريقة مساحة تخزين سحابي مشتركة كمثيل من مورد drives.
لإرسال الطلب بصفتك مشرف نطاق، اضبط مَعلمة طلب البحث useDomainAdminAccess على true. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة مساحات التخزين السحابي المشتركة بصفتك
مشرف نطاق.
إخفاء مساحة تخزين سحابي مشتركة وإظهارها
لإخفاء مساحة تخزين سحابي مشتركة من العرض التلقائي، استخدِم الطريقة hide في المورد
drives مع المَعلمة driveId.
عند إخفاء مساحة تخزين سحابي مشتركة، يضع Drive علامة على مورد مساحة التخزين السحابي المشتركة على أنّه hidden=true. لا تظهر مساحات التخزين السحابي المشتركة المخفية في واجهة مستخدم Drive أو في قائمة الملفات المعروضة.
لاستعادة مساحة تخزين سحابي مشتركة إلى العرض التلقائي، استخدِم الطريقة unhide في مورد
drives مع المَعلمة driveId.
تعرض كلتا الطريقتَين مساحة تخزين سحابي مشتركة كمثيل من مورد drives.
حذف مساحة تخزين سحابي مشتركة
لحذف مساحة تخزين سحابي مشتركة نهائيًا، استخدِم الطريقة
delete في مورد drives مع المَعلمة driveId.
قبل حذف مساحة تخزين سحابي مشتركة، يجب نقل جميع المحتويات في مساحة التخزين السحابي المشتركة إلى المهملات أو حذفها. يجب أن يكون لدى المستخدم أيضًا role=organizer في مجلد مساحة التخزين السحابي المشتركة. لمزيد من المعلومات، يُرجى الاطّلاع على نقل الملفات والمجلدات إلى المهملات أو حذفها.
مرِّر مَعلمات طلب البحث التالية لفلترة مساحات التخزين السحابي المشتركة:
useDomainAdminAccess: اضبط هذه المَعلمة علىtrueلإرسال الطلب بصفتك مشرف نطاق لعرض جميع مساحات التخزين السحابي المشتركة في النطاق الذي تكون فيه مقدِّم الطلب مشرفًا. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة مساحات التخزين السحابي المشتركة بصفتك مشرف نطاق.allowItemDeletion: اضبط هذه المَعلمة علىtrueلحذف العناصر داخل مساحة التخزين السحابي المشتركة. لا يتم دعم هذه المَعلمة إلا عندما يتم ضبطuseDomainAdminAccessأيضًا علىtrue.
إضافة أعضاء مساحة تخزين سحابي مشتركة أو إزالتهم
يمكنك إضافة أعضاء مساحة تخزين سحابي مشتركة أو إزالتهم باستخدام مورد
permissions.
لإضافة عضو، أنشئ الإذن في مساحة التخزين السحابي المشتركة. يمكن أيضًا استخدام طرق الأذونات في الملفات الفردية داخل مساحة تخزين سحابي مشتركة لمنح الأعضاء امتيازات إضافية أو السماح لغير الأعضاء بالتعاون في عناصر معيّنة.
لمزيد من المعلومات ورمز نموذجي، يُرجى الاطّلاع على مشاركة الملفات والمجلدات ومساحات التخزين السحابي.
إدارة مساحات التخزين السحابي المشتركة بصفتك مشرف نطاق
طبِّق المَعلمة useDomainAdminAccess مع الموردَين drives وpermissions
لإدارة مساحات التخزين السحابي المشتركة على مستوى المؤسسة.
يجب أن يكون لدى المستخدمين الذين يستدعون هذه الطرق مع useDomainAdminAccess=true امتياز المشرف
Drive and Docs .
يمكن للمشرفين البحث عن مساحات التخزين السحابي المشتركة أو تعديل أذونات مساحات التخزين السحابي المشتركة التي تملكها مؤسستهم، بغض النظر عن عضوية المشرف
في أي مساحة تخزين سحابي مشتركة معيّنة.
عند استخدام حسابات الخدمة، قد تحتاج إلى انتحال صفة مشرف مصادَق عليه باستخدام انتحال صفة حساب الخدمة. يُرجى العِلم أنّ حسابات الخدمة لا تنتمي إلى نطاقك على Google Workspace، على عكس حسابات المستخدمين. إذا شاركت مواد Google Workspace، مثل المستندات أو الأحداث، مع نطاق Google Workspace بالكامل، لن تتم مشاركتها مع حسابات الخدمة. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على حسابات الخدمة.
استرداد مساحة تخزين سحابي مشتركة لا تتضمّن منظِّمًا
توضّح عينة التعليمات البرمجية التالية كيفية استرداد مساحات التخزين السحابي المشتركة التي لم تعُد تتضمّن منظِّمًا.
جافا
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 |
ما إذا كان بإمكان المستخدم الحالي نسخ الملفات في مساحة تخزين سحابي مشتركة | الإصداران v2 وv3 |
capabilities.canDownload |
ما إذا كان بإمكان المستخدم الحالي تنزيل الملفات في مساحة تخزين سحابي مشتركة | الإصداران v2 وv3 |
capabilities.canChangeCopyRequiresWriterPermission |
ما إذا كان بإمكان المستخدم الحالي تغيير قيد copyRequiresWriterPermission لمساحة تخزين سحابي مشتركة |
الإصداران v2 وv3 |
capabilities.canResetDriveRestrictions |
ما إذا كان بإمكان المستخدم الحالي إعادة ضبط قيود مساحة التخزين السحابي المشتركة على الإعدادات التلقائية | الإصداران v2 وv3 |
capabilities.canChangeDownloadRestriction |
ما إذا كان بإمكان المستخدم الحالي تغيير قيد التنزيل لمساحة تخزين سحابي مشتركة | الإصدار v3 فقط |
restrictions.copyRequiresWriterPermission |
ما إذا كانت خيارات نسخ الملفات أو طباعتها أو تنزيلها داخل مساحة تخزين سحابي مشتركة غير مفعّلة للقرّاء والمعلِّقين عندما تكون القيمة true، يتم ضبط الحقل الذي يحمل الاسم نفسه على true لأي ملف داخل مساحة التخزين السحابي المشتركة هذه. |
الإصداران v2 وv3 |
restrictions.downloadRestriction |
قيود التنزيل التي يفرضها مديرو مساحات التخزين السحابي المشتركة | الإصدار v3 فقط |
حدود المجلدات
تفرض مساحات التخزين السحابي المشتركة بعض الحدود القصوى على مساحة التخزين. لمزيد من المعلومات، يُرجى الاطّلاع على حدود مساحة التخزين السحابي المشتركة في Google Drive.
الحد الأقصى لعدد العناصر
يبلغ الحد الأقصى لعدد عناصر كل مساحة تخزين سحابي مشتركة لكل مستخدم 500,000 عنصر، بما في ذلك الملفات والمجلدات والاختصارات.
عند الوصول إلى هذا الحدّ الأقصى، لن تتمكّن مساحة التخزين السحابي المشتركة من قبول العناصر بعد ذلك. لمواصلة تلقّي الملفات، على المستخدمين حذف العناصر نهائيًا من مساحة التخزين السحابي المشتركة. يُرجى العِلم أنّ العناصر في المهملات تُحتسب ضمن الحدّ الأقصى، ولكن لا تُحتسب العناصر المحذوفة نهائيًا. لمزيد من المعلومات، يُرجى الاطّلاع على نقل الملفات والمجلدات إلى المهملات أو حذفها.
الحد الأقصى لعمق المجلد
لا يمكن أن يحتوي مجلد في مساحة تخزين سحابي مشتركة على أكثر من 100 مستوى من المجلدات المُدمجة. وهذا يعني أنّه لا يمكن تخزين مجلد فرعي ضمن مجلد يزيد عمقه عن 99 مستوى. لا ينطبق هذا القيد إلا على المجلدات الفرعية.
تؤدي محاولات إضافة أكثر من 100 مستوى من المجلدات إلى عرض استجابة رمز حالة
teamDriveHierarchyTooDeep
HTTP.