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

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

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

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