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

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

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

الإصدار 3 من واجهة برمجة تطبيقات Drive

  • 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 v2

  • 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 على الحقول الخاصة بـ Drive المشتركة وأوضاع طلب البحث التالية:

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

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

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

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

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

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

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

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

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

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