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