تتبع مساحات التخزين السحابي المشتركة نماذج مختلفة للمؤسسات والمشاركة والملكية من "ملفاتي". وبناءً على ذلك، لا يُسمح ببعض عمليات "ملفاتي" للمحتوى في مساحة تخزين سحابي مشتركة. يوضح هذا المستند الاختلافات في واجهات برمجة التطبيقات الخاصة بمساحات التخزين السحابي المشتركة.
مرجع Files
تتم تعبئة الحقول التالية فقط للملفات الموجودة في مساحة تخزين سحابي مشتركة:
hasAugmentedPermissions
— ما إذا تم منح أي مستخدمين الإذن بالوصول إلى الملفات مباشرةً في هذا الملفcapabilities/canAddFolderFromAnotherDrive
— ما إذا كان يمكن للمستخدم الحالي إضافة مجلد من مساحة تخزين سحابي مشتركة أخرى (مساحة تخزين سحابي مشتركة مختلفة أو مختلفة) إلى هذا المجلد.capabilities/canDeleteChildren
— ما إذا كان بإمكان المستخدم الحالي حذف العناصر الثانوية لهذا المجلدcapabilities/canMoveChildrenOutOfDrive
- ما إذا كان يمكن للمستخدم الحالي نقل العناصر الثانوية لهذا المجلد خارج مساحة التخزين السحابي المشتركةcapabilities/canMoveChildrenWithinDrive
- ما إذا كان يمكن للمستخدم الحالي نقل العناصر الثانوية لهذا المجلد إلى مساحة التخزين السحابي المشتركةcapabilities/canMoveItemWithinDrive
— ما إذا كان يمكن للمستخدم الحالي نقل عنصر مساحة التخزين السحابي المشتركة هذا في مساحة التخزين السحابي المشتركةcapabilities/canReadDrive
- ما إذا كان المستخدم الحالي لديه إذن وصول للقراءة إلى مساحة التخزين السحابي المشتركة التي ينتمي إليها هذا الملفcapabilities/canTrashChildren
— ما إذا كان المستخدم الحالي يمكنه إضافة العناصر الثانوية لهذا المجلد إلى المهملات.driveId
- رقم تعريف مساحة التخزين السحابي المشتركة التي يوجد فيها الملف.trashingUser
— إذا تم نقل الملف إلى المهملات بشكل صريح، على المستخدم الذي نقله إلى المهملات.trashedTime
- الوقت الذي تم فيه نقل العنصر إلى المهملات
لا تتم تعبئة الحقول التالية للملفات الموجودة في مساحة تخزين سحابي مشتركة:
permissions
: بسبب الحجم المحتمل لقوائم التحكم في الوصول (ACL) في مساحة التخزين السحابي المشتركة، لا يتم عرض الأذونات كجزء من الملفات. يمكنك استخدام الطريقةpermissions.list
التي تتيح تقسيم النتائج على عدّة صفحات لإدراج أذونات ملف ضمن مساحة تخزين سحابي مشتركة أو مساحة التخزين السحابي المشتركة نفسها.owners
وownerNames
وownedByMe
: الملفات في مساحة تخزين سحابي مشتركة مملوكة لمساحة التخزين السحابي المشتركة وليس مستخدمين فرديين.folderColorRgb
: لا يمكن تلوين المجلدات بشكل فرديshared
- تتم مشاركة جميع العناصر في مساحة التخزين السحابي المشتركة.writersCanShare
- لا يمكن حاليًا حظر المشاركة حسب الدور في مساحات التخزين السحابي المشتركة.
لا يتم ضبط الحقول التالية إلا عندما يتم منح المستخدم أذونات الوصول إلى الملفات لأحد العناصر:
sharedWithMeDate
sharingUser
تتطلب الحقول التالية مراعاة خاصة عند استخدامها مع مساحات التخزين السحابي المشتركة:
parents.isRoot
— لا ينطبق هذا الحقل إلا على المجلد الجذر في "ملفاتي"، ولا ينطبق على مجلد المستوى الأعلى في مساحة التخزين السحابي المشتركة.parents
- لا يظهر العنصر الرئيسي في قائمة العناصر الرئيسية إذا كان المستخدم الطالب ليس عضوًا في مساحة التخزين السحابي المشتركة ولا يمكنه الوصول إلى أحد الوالدين. بالإضافة إلى ذلك، باستثناء مجلد المستوى الأعلى، يجب أن تحتوي قائمة العناصر الرئيسية على عنصر واحد فقط إذا كان الملف موجودًا في مساحة تخزين سحابي مشتركة.capabilities/canRemoveChildren
: استخدِمcapabilities/canDeleteChildren
أوcapabilities/canTrashChildren
.
مرجع Permissions
تتم تعبئة الحقل permissionDetails
فقط للملفات الموجودة في
مساحة تخزين سحابي مشتركة. هذا الحقل عبارة عن قائمة بالأذونات المكثّفة المفعّلة أو المكتسَبة من خلال ملف "مساحة التخزين السحابي المشتركة" هذا. هذا الحقل مخصص للمخرجات فقط
ولا يتوفّر إلا لعناصر مساحة التخزين السحابي المشتركة. بالإضافة إلى ذلك،
- تم تحديد دورين جديدين لكل من
organizer
وfileOrganizer
. - يمكن الآن تقسيم النتائج على عدّة صفحات في
permissions.list
.
مرجع Changes
تتوفّر الحقول الجديدة التالية في مورد "Changes
" لمساحة التخزين السحابي المشتركة:
changeType
— نوع التغيير القيمتان المتاحتان هماfile
وdrive
.driveId
— رقم تعريف مساحة التخزين السحابي المشتركة المرتبطة بهذا التغييرdrive
— الحالة المحدَّثة لمساحة التخزين السحابي المشتركة. تظهر إذا كانت قيمةchangeType
هيdrive
ولا يزال المستخدم عضوًا في مساحة التخزين السحابي المشتركة.
قد يكون مطلوبًا إجراء تغييرات إضافية للتطبيقات التي تحتاج إلى مزامنة المحتوى مع مساحات التخزين السحابي المشتركة أو تتبُّع النشاط. لمعرفة التفاصيل، يُرجى الرجوع إلى تتبُّع التغييرات للمستخدمين ومساحات التخزين السحابي المشتركة.