يتضمّن هذا الدليل مهامًا متعلّقة بإدارة مساحات التخزين السحابي المشتركة، مثل إنشاء مساحات تخزين سحابي مشتركة وإدارة الأعضاء والأذونات باستخدام Google Drive API.
إذا أردت تحديد الحقول التي سيتم عرضها في الردّ، يمكنك ضبط المَعلمة
fields
system
باستخدام أي طريقة من طرق المورد drives
. في حال عدم تحديد المَعلمة fields
، يعرض الخادم مجموعة تلقائية من الحقول الخاصة بالطريقة. على سبيل المثال، تعرض الطريقة
list
الحقول kind
وid
وname
فقط لكل مساحة تخزين سحابي مشتركة. لمزيد من المعلومات، يُرجى الاطّلاع على عرض حقول معيّنة.
لمزيد من المعلومات عن حدود مجلدات مساحة التخزين السحابي المشتركة، يُرجى الاطّلاع على المقالة حدود مجلدات مساحة التخزين السحابي المشتركة.
إنشاء "مساحة تخزين سحابي مشتركة"
لإنشاء مساحة تخزين سحابي مشتركة، استخدِم طريقة create
في مورد drives
مع المَعلمة requestId
.
تحدّد المَعلمة requestId
المحاولة المنطقية لإنشاء مساحة تخزين سحابي مشتركة بشكل متكرر. إذا انتهت مهلة الطلب أو عرض خطأ غير محدّد من الخلفية، يمكن تكرار الطلب نفسه ولن يؤدي ذلك إلى إنشاء نسخ مكررة. يجب أن يظل
requestId
ونص الطلب كما هما.
يوضّح نموذج الرمز البرمجي التالي كيفية إنشاء مساحة تخزين سحابي مشتركة:
Java
Python
Node.js
PHP
NET.
تكون طلبات الطريقة create
متكررة.
إذا تم إنشاء مساحة التخزين السحابي المشتركة بنجاح في طلب سابق أو بسبب إعادة المحاولة، ستعرض الطريقة مثيلاً لمورد drives
. في بعض الأحيان، مثل بعد فترة طويلة أو إذا تم تغيير نص الطلب، قد يتم عرض خطأ يشير إلى أنّه يجب تجاهل requestId
.409
الحصول على مساحة تخزين سحابي مشتركة
للحصول على البيانات الوصفية لمساحة تخزين سحابي مشتركة، استخدِم طريقة
get
في مورد drives
مع مَعلمة المسار driveId
. إذا كنت لا تعرف معرّف مساحة التخزين، يمكنك إدراج جميع مساحات التخزين السحابي المشتركة باستخدام طريقة list
.
تعرض الطريقة get
مساحة تخزين سحابي مشتركة كمثيل لمورد drives
.
لإصدار الطلب بصفتك مشرف نطاق، اضبط معلَمة طلب البحث useDomainAdminAccess
على true
. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة مساحات التخزين السحابي المشتركة بصفتك مشرف نطاق.
عرض قائمة بمساحات التخزين السحابي المشتركة
لعرض قائمة بمساحات التخزين السحابي المشتركة الخاصة بمستخدم، استخدِم طريقة list
في المورد drives
. تعرض الطريقة
قائمة بمساحات التخزين السحابي المشتركة.
مرِّر مَعلمات طلب البحث التالية لتخصيص تقسيم الصفحات أو فلترة مساحات Drive المشتركة:
pageSize
: الحد الأقصى لعدد مساحات التخزين المشتركة التي سيتم عرضها في كل صفحةpageToken
: رمز مميز للصفحة تم تلقّيه من طلب قائمة سابق. قدِّم هذا الرمز المميز لاسترداد الصفحة التالية.q
: سلسلة طلب البحث للبحث في مساحات Drive المشتركة. لمزيد من المعلومات، يُرجى الاطّلاع على البحث عن مساحات التخزين السحابي المشتركة.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 بأكمله، لن تتم مشاركتها مع حسابات الخدمة. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على حسابات الخدمة.
استرداد مساحة تخزين سحابي مشتركة ليس لديها منظِّم
يوضّح نموذج الرمز التالي كيفية استرداد مساحات التخزين السحابي المشتركة التي لم يعُد لديها منظِّم.
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
.