تنفيذ دعم مساحة Drive المشتركة

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

للبدء، عليك تضمين مَعلمة طلب البحث supportsAllDrives=true في طلباتك عندما ينفِّذ تطبيقك العمليات المذكورة أدناه:

الإصدار 3 من Drive API

  • files.get
  • files.list
  • files.create
  • files.update
  • files.copy
  • files.delete
  • changes.list
  • changes.getStartPageToken
  • permissions.list
  • permissions.get
  • permissions.create
  • permissions.update
  • permissions.delete

الإصدار الثاني من Drive API

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

تُعلِم المعلَمة supportsAllDrives=true Google Drive بأنّ تطبيقك مصمَّم للتعامل مع الملفات في مساحات التخزين السحابي المشتركة.

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

البحث عن محتوى في مساحة تخزين سحابي مشتركة

يمكنك استخدام طريقة files.list للبحث عن مساحات التخزين السحابي المشتركة. يتناول هذا القسم الحقول الخاصة بمساحات التخزين السحابي المشترَكة في طريقة files.list. للبحث عن مساحة تخزين سحابي مشتركة، يُرجى الاطّلاع على البحث عن الملفات والمجلدات.

تحتوي الطريقة files.list على أوضاع طلبات البحث والحقول الخاصة بمساحات التخزين السحابي المشتركة التالية:

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

  • corpora — مجموعات العناصر (الملفات/المستندات) التي ينطبق عليها طلب البحث النصوص المتوافقة هي user وdomain وdrive وallDrives. أفضِّل user أو drive على allDrives لتوفير الطاقة.

  • supportsAllDrives - ما إذا كان التطبيق الذي يرسِل الطلب متوافقًا مع كل من "ملفاتي" ومساحات التخزين السحابي المشتركة في حال اختيار "خطأ"، لن يتم تضمين عناصر مساحة التخزين السحابي المشتركة في الرد.

إنّ أوضاع طلبات البحث التالية مخصّصة لمساحات التخزين السحابي المشتركة:

includeItemsFromAllDrives corpora وصف الاستفسار
true user ملفات طلبات البحث التي وصل إليها المستخدم، بما في ذلك ملفات مساحة التخزين السحابي المشتركة والملفات في "ملفاتي".
true drive للبحث عن جميع العناصر في مساحة التخزين السحابي المشتركة المحددة. يجب تحديد driveId في الطلب.
true allDrives طلبات البحث التي وصل إليها المستخدم وجميع مساحات التخزين السحابي المشتركة التي أصبح عضوًا فيها يُرجى العِلم أنّ الردّ قد يتضمّن incompleteSearch : true، ما يشير إلى أنّه لم يتم البحث عن بعض المجموعات عن هذا الطلب.
true domain طلبات البحث التي تمت مشاركتها مع النطاق، بما في ذلك كل من مساحة التخزين السحابي المشتركة والملفات في "ملفاتي".

تتبُّع التغييرات في مساحة تخزين سحابي مشتركة

يمكنك استخدام طريقة changes.list لتتبُّع التغييرات في مساحة تخزين سحابي مشتركة. يتناول هذا القسم الحقول الخاصة بمساحات التخزين السحابي المشترَكة في طريقة changes.list. لمزيد من المعلومات، يمكنك الاطّلاع على تتبُّع التغييرات للمستخدمين ومساحات التخزين السحابي المشتركة. تحتوي الطريقة changes.list على أوضاع طلبات البحث والحقول الخاصة بمساحات التخزين السحابي المشتركة التالية:

  • driveId - مساحة التخزين السحابي المشتركة التي يتم عرض التغييرات منها في حال تحديد أرقام تعريف التغيير، تشير إلى التغييرات في مساحة التخزين السحابي المشتركة، وليس إلى التغييرات في الملفات المعروضة للمستخدم. للإشارة إلى تغيير معيّن في مساحة التخزين السحابي المشتركة، يجب استخدام كل من رقم تعريف مساحة التخزين السحابي المشتركة ورقم تعريف التغيير كمعرّف.
  • supportsAllDrives - ما إذا كان التطبيق المطلوب متوافقًا مع مساحات التخزين السحابي المشتركة في حال اختيار القيمة "false"، لن يتم عرض عناصر مساحة التخزين السحابي المشتركة، بما في ذلك مساحات التخزين السحابي المشتركة والملفات الموجودة داخل مساحة تخزين سحابي مشتركة.
  • includeItemsFromAllDrives - ما إذا كان يجب تضمين ملفات مساحة التخزين السحابي المشتركة أو التغييرات في قائمة التغييرات.

إنّ أوضاع طلبات البحث التالية مخصّصة لمساحات التخزين السحابي المشتركة:

includeItemsFromAllDrives driveId وصف الاستفسار
true لا تعكس التغييرات التغييرات في الملفات داخل مساحات التخزين السحابي المشتركة التي وصل إليها المستخدم أو خارجها، بالإضافة إلى التغييرات في مساحات التخزين السحابي المشتركة التي يكون المستخدم عضوًا فيها.
true نعم تعكس التغييرات التغييرات التي تم إجراؤها على مساحة التخزين السحابي المشتركة التي تم تحديدها والعناصر المضمّنة فيها.

للحصول على تفاصيل إضافية حول سلوك سجلّ التغيير، يُرجى الاطّلاع على مقالة سجلّات التغيير.

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

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

استخدام "أداة اختيار الملفات" مع مساحات التخزين السحابي المشتركة

تتيح أداة اختيار الملفات اختيار العناصر في مساحات التخزين السحابي المشتركة. للحصول على تفاصيل حول تفعيل دعم مساحات التخزين السحابي المشتركة وإضافة طريقة عرض مساحات التخزين السحابي المشتركة في أداة اختيار الملفات، راجِع Google Picker API.

الخطوات التالية

يُرجى المتابعة إلى إدارة مساحات التخزين السحابي المشتركة للحصول على مساعدة بشأن إنشاء مساحات تخزين سحابي مشتركة وإدارة أذوناتها.