تنفيذ دعم مساحة 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 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 للبحث عن مساحات Drive المشتركة. يتناول هذا القسم الحقول الخاصة بمساحة التخزين السحابي المشتركة في طريقة files.list. للبحث عن مساحة تخزين سحابي مشتركة، يُرجى الاطّلاع على مقالة البحث عن الملفات والمجلدات.

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

• استبدِل driveId بمعرّف مساحة التخزين السحابي المشتركة التي تريد البحث فيها.

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

• corpora: تشير إلى نصوص العناصر (الملفات أو المستندات) التي ينطبق عليها طلب البحث. الجهات المتوافقة هي user وdomain وdrive وallDrives. استخدِم user أو drive بدلاً من allDrives لتوفير الطاقة.

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

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

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

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

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

ملاحظة: إذا كنت تستخدم الإصدار القديم من Drive API‏ (v2)، يتضمّن كل من الطريقتَين changes.get وchanges.list عدة مَعلمات خاصة بمساحات التخزين السحابي المشتركة.

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

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

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

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

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

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

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

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

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

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