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

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

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

Drive API v3

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

التطبيقات التي تقرأ أو تعدِّل الأذونات أو تتتبّع التغييرات أو تحتاج إلى البحث عبر مجموعات متعددة تتطلب وظائف مساحة 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 API: لمزيد من المعلومات، راجع إعداد دمج واجهة المستخدم في Drive

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

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

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

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