الاختلافات بين مساحات التخزين السحابي المشتركة وواجهة برمجة التطبيقات لـ "ملفاتي"

تتبع مساحات التخزين السحابي المشترَكة نماذج مختلفة للتنظيم والمشاركة والملكية مقارنةً بمساحة "ملفاتي". ولذلك، لا يُسمح ببعض عمليات "ملفاتي" في المحتوى المتوفّر في مساحة تخزين سحابي مشتركة. يوضّح هذا المستند الاختلافات في واجهة برمجة التطبيقات المتعلّقة بمساحة التخزين السحابي المشتركة.

مورد 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 - لا يمكن حاليًا تقييد المشاركة حسب الدور في مساحات التخزين السحابي المشتركة.

لا يتم ضبط الحقول التالية إلا عندما يتم منح المستخدم أذونات الوصول إلى الملفات على عنصر معيّن:

  • sharedWithMeDate
  • sharingUser

تتطلّب الحقول التالية اهتمامًا خاصًا عند استخدامها مع مساحات التخزين المشتركة:

  • ‫parents.isRoot: يكون هذا الحقل صحيحًا فقط للمجلد الجذر في "ملفاتي"، ويكون خطأ للمجلد الأعلى في مساحة التخزين السحابي المشتركة.

  • parents - لا يظهر المجلد الرئيسي في قائمة العناصر الرئيسية إذا كان المستخدم المُقدّم للطلب ليس عضوًا في مساحة التخزين السحابي المشتركة ولا يملك إذنًا بالوصول إلى المجلد الرئيسي. بالإضافة إلى ذلك، باستثناء المجلد ذي المستوى الأعلى، يجب أن تحتوي قائمة العناصر الرئيسية على عنصر واحد فقط إذا كان الملف مضمّنًا في محرك أقراص مشترَك.

  • capabilities/canRemoveChildren - استخدِم capabilities/canDeleteChildren أو capabilities/canTrashChildren.

مورد Permissions

لا تتم تعبئة حقل permissionDetails إلا للملفات المتوفّرة في مساحة تخزين سحابي مشتركة. هذا الحقل هو قائمة بالأذونات المكثّفة التي تم تفعيلها أو اكتسابها من خلال ملف مساحة التخزين السحابي المشتركة هذا. هذا الحقل هو حقل إخراج فقط ويُتاح لعناصر مساحة التخزين السحابي المشتركة فقط. بالإضافة إلى ذلك،

  • تم تحديد دورَين جديدَين organizer وfileOrganizer.
  • تتيح permissions.list الآن تقسيم الصفحات.

مورد Changes

تتوفّر الحقول الجديدة التالية في مورد Changes ل drive المشترَكة:

  • changeType: نوع التغيير القيم المحتمَلة هي file و drive.
  • driveId: معرّف مساحة التخزين السحابي المشتركة المرتبطة بهذا التغيير
  • drive: الحالة المعدَّلة لمساحة التخزين السحابي المشتركة. تظهر إذا كانت قيمة changeType هي drive ولا يزال المستخدم عضوًا في مساحة التخزين السحابي المشتركة.

قد تكون هناك تغييرات إضافية مطلوبة للتطبيقات التي تحتاج إلى مزامنة المحتوى مع مساحات التخزين السحابي المشتركة أو تتبُّع النشاط. لمعرفة التفاصيل، يُرجى الرجوع إلى مقالة تتبُّع التغييرات للمستخدمين ومساحات التخزين السحابي المشتركة.