تتّبع مساحات التخزين السحابي المشتركة نماذج مختلفة للتنظيم والمشاركة والملكية عن "ملفاتي". وبالتالي، لا يُسمح ببعض عمليات "ملفاتي" للمحتوى في مساحة تخزين سحابي مشتركة.
يوضّح هذا الدليل الاختلافات في واجهة برمجة التطبيقات الخاصة بمساحات التخزين السحابي المشتركة في مَوردَي files وchanges.
مَورد الملف
لا تتم تعبئة الحقول التالية في مَورد files إلا للملفات الموجودة ضمن مساحة تخزين سحابي مشتركة:
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: لا يمكن تقييد المشاركة حسب الدور في مساحات التخزين السحابي المشتركة.
لا يتم ضبط الحقول التالية إلا عندما يتم منح المستخدم أذونات الوصول إلى الملف في أحد العناصر:
sharedWithMeDatesharingUser
تتطلب الحقول التالية اهتمامًا خاصًا عند استخدامها مع مساحات التخزين السحابي المشتركة:
parents.isRoot: لا تكون قيمة هذا الحقل صحيحة إلا لمجلد الجذر في "ملفاتي"، وتكون قيمته غير صحيحة لمجلد المستوى الأعلى في مساحة التخزين السحابي المشتركة.parents: لا يظهر مجلد رئيسي في قائمة المجلدات الرئيسية إذا لم يكن المستخدم الذي يطلب الوصول عضوًا في مساحة التخزين السحابي المشتركة وليس لديه إذن الوصول إلى المجلد الرئيسي. بالإضافة إلى ذلك، يجب أن تحتوي قائمة المجلدات الرئيسية على عنصر واحد فقط إذا كان الملف موجودًا ضمن مساحة تخزين سحابي مشتركة، باستثناء مجلد المستوى الأعلى.capabilities/canRemoveChildren: استخدِمcapabilities/canDeleteChildrenأوcapabilities/canTrashChildren.
مَورد التغيير
تتوفّر الحقول الجديدة التالية في الـ
changes لمساحة تخزين سحابي مشتركة:
changeType: نوع التغيير القيمتان المحتملتان هماfileوdrive.driveId: رقم تعريف مساحة التخزين السحابي المشتركة المرتبطة بهذا التغييرdrive: الحالة المعدَّلة لمساحة التخزين السحابي المشتركة يظهر هذا الحقل إذا كانchangeTypeهوdriveوكان المستخدم لا يزال عضوًا في مساحة التخزين السحابي المشتركة.
قد تكون هناك حاجة إلى إجراء تغييرات إضافية للتطبيقات التي تحتاج إلى مزامنة المحتوى مع مساحات التخزين السحابي المشتركة أو تتبُّع النشاط. لمعرفة التفاصيل، يُرجى الاطّلاع على تتبُّع التغييرات للمستخدمين ومساحات التخزين السحابي المشتركة.