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

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

ملف الموارد

لا تتم تعبئة الحقول التالية في مرجع File إلا للملفات الموجودة في مساحة تخزين سحابي مشتركة:

  • hasAugmentedPermissions: ما إذا تم منح أي مستخدمين إذن الوصول إلى الملف مباشرةً.
  • capabilities/canAddFolderFromAnotherDrive: ما إذا كان بإمكان المستخدم الحالي إضافة مجلد من مساحة تخزين أخرى (مساحة تخزين سحابي مشتركة مختلفة أو "ملفاتي") إلى هذا المجلد.
  • capabilities/canDeleteChildren: تشير إلى ما إذا كان بإمكان المستخدم الحالي حذف العناصر الفرعية لهذا المجلد.
  • ‫capabilities/canMoveChildrenOutOfDrive: ما إذا كان بإمكان المستخدم الحالي نقل العناصر الفرعية لهذا المجلد خارج مساحة التخزين السحابي المشتركة.
  • capabilities/canMoveChildrenWithinDrive: ما إذا كان بإمكان المستخدم الحالي نقل عناصر فرعية من هذا المجلد داخل مساحة التخزين السحابي المشتركة.
  • ‫capabilities/canMoveItemWithinDrive: ما إذا كان بإمكان المستخدم الحالي نقل عنصر مساحة التخزين السحابي المشتركة هذا داخل مساحة التخزين السحابي المشتركة.
  • ‫capabilities/canReadDrive: ما إذا كان لدى المستخدم الحالي إذن الوصول للقراءة إلى مساحة التخزين السحابي المشتركة التي ينتمي إليها هذا الملف.
  • capabilities/canTrashChildren: ما إذا كان بإمكان المستخدم الحالي نقل العناصر الفرعية لهذا المجلد إلى المهملات.
  • driveId: رقم تعريف مساحة التخزين السحابي المشتركة التي يوجد فيها الملف
  • trashingUser: إذا تم نقل الملف إلى المهملات بشكل صريح، يظهر المستخدم الذي نقل الملف إلى المهملات.
  • ‫trashedTime: الوقت الذي تم فيه نقل العنصر إلى المهملات إذا كنت تستخدم الإصدار القديم من Drive API 2، يُطلق على هذا الحقل الاسم trashedDate.

لا تتم تعبئة الحقول التالية للملفات الموجودة داخل مساحة تخزين سحابي مشتركة:

  • permissions: بسبب الحجم المحتمل لملفات ACL في مساحات التخزين السحابي المشتركة، لا يتم عرض الأذونات كجزء من الملفات. استخدِم طريقة permissions.list() التي تتيح تقسيم النتائج إلى صفحات، وذلك لعرض أذونات ملف ضمن مساحة تخزين سحابي مشتركة أو مجلد مساحة التخزين السحابي المشتركة.
  • ‫owners وownerNames وownedByMe: تمتلك مساحة التخزين السحابي المشتركة الملفات الموجودة فيها، وليس المستخدمون الفرديون.
  • folderColorRgb: لا يمكن تلوين المجلدات بشكل فردي.
  • shared: تتم مشاركة جميع الملفات في مساحة تخزين سحابي مشتركة.
  • ‫writersCanShare: لا يمكن تقييد المشاركة حسب الدور في مساحات Drive المشتركة.

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

  • sharedWithMeDate
  • sharingUser

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

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

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

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

مورد الإذن

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

  • تم تحديد دورَين جديدَين هما organizer وfileOrganizer.
  • تتيح طريقة permissions.list() تقسيم النتائج إلى صفحات.

تغيير المرجع

تتوفّر الحقول الجديدة التالية في المرجع Change الخاص بمساحة التخزين السحابي المشتركة:

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

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