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