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

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

مورد الملف

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

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

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

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

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

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

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