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

تتبع مساحات التخزين السحابي المشتركة نماذج مختلفة للتنظيم والمشاركة والملكية من "ملفاتي". إذا كان تطبيقك سينشئ ملفات على مساحات 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 - ما إذا كان التطبيق الذي يقدّم الطلب يتوافق مع مساحات التخزين السحابي المشتركة وفي حال اختيار القيمة "خطأ"، لن يتم عرض عناصر مساحة التخزين السحابي المشتركة، بما في ذلك كل من مساحات التخزين السحابي المشتركة والملفات في مساحة التخزين السحابي المشتركة.
  • includeItemsFromAllDrives - ما إذا كان يجب تضمين ملفات مساحة التخزين السحابي المشتركة أو التغييرات في قائمة التغييرات.

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

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

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

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

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

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

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

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

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