درایوهای اشتراکی از مدلهای سازماندهی، اشتراکگذاری و مالکیت متفاوتی نسبت به My Drive پیروی میکنند. اگر برنامه شما قرار است فایلها را روی درایوهای اشتراکی ایجاد و مدیریت کند، باید پشتیبانی از درایو اشتراکی را در برنامه خود پیادهسازی کنید. پیچیدگی پیادهسازی شما به عملکرد برنامه شما بستگی دارد.
برای شروع، باید پارامتر پرسوجوی supportsAllDrives=true را در درخواستهای خود، زمانی که برنامه شما عملیات زیر را انجام میدهد، وارد کنید:
درایو 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
درایو 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 به گوگل درایو اطلاع میدهد که برنامه شما برای مدیریت فایلهای موجود در درایوهای مشترک طراحی شده است.
برنامههایی که مجوزها را میخوانند یا تغییر میدهند، تغییرات را ردیابی میکنند یا در چندین مجموعه داده جستجو میکنند، به قابلیتهای درایو اشتراکی اضافی نیاز دارند. ادامه این سند تغییرات اضافی مورد نیاز برای انجام این وظایف را برجسته میکند.
جستجوی محتوا در درایو مشترک
از متد list روی منبع files برای یافتن فایلهای کاربر در درایوهای مشترک استفاده کنید. برای جستجوی یک درایو مشترک، به «جستجوی درایوهای مشترک» مراجعه کنید.
متد list شامل پارامترهای کوئری مختص درایو زیر است:
driveId: شناسه درایو مشترک برای جستجو.corpora: بدنههایی از آیتمها (فایلها یا اسناد) که کوئری روی آنها اعمال میشود. بدنههای پشتیبانیشده عبارتند ازuser،domain،driveوallDrives. برای کارایی بیشترuserیاdriveبهallDrivesترجیح دهید. بهطور پیشفرض، پیکرهها رویuserتنظیم شدهاند.includeItemsFromAllDrives: آیا آیتمهای My Drive و shared drive باید در نتایج گنجانده شوند یا خیر. اگر ارائه نشود یا روی false تنظیم شود، آیتمهای shared drive برگردانده نمیشوند.supportsAllDrives: آیا برنامه درخواستکننده از هر دو درایو My Drive و shared drive پشتیبانی میکند یا خیر. اگر مقدار false باشد، آیتمهای درایو shared در پاسخ لحاظ نمیشوند.
حالتهای پرسوجوی زیر مختص درایوهای اشتراکی هستند:
includeItemsFromAllDrives | corpora | شرح پرس و جو |
|---|---|---|
true | user | فایلهایی را که کاربر به آنها دسترسی داشته است، از جمله فایلهای درایو مشترک و My Drive، جستجو میکند. |
true | domain | فایلهایی را که در دامنه به اشتراک گذاشته شدهاند، از جمله فایلهای درایو مشترک و فایلهای My Drive، جستجو میکند. |
true | drive | تمام موارد موجود در درایو مشترک مشخص شده را جستجو میکند. driveId باید در درخواست مشخص شود. |
true | allDrives | فایلهایی که کاربر به آنها دسترسی داشته و تمام درایوهای اشتراکی که در آنها عضو است را جستجو میکند. توجه داشته باشید که پاسخ ممکن است شامل incompleteSearch:true که نشان میدهد برخی از مجموعهها برای این درخواست جستجو نشدهاند. |
پیگیری تغییرات در یک درایو مشترک
برای ردیابی تغییرات در یک درایو مشترک، از متد list در منبع changes استفاده کنید. برای اطلاعات بیشتر، به بخش ردیابی تغییرات برای کاربران و درایوهای مشترک مراجعه کنید.
متد list شامل پارامترهای کوئری مختص درایو زیر است:
driveId: درایو مشترکی که تغییرات از آن بازگردانده میشوند. در صورت مشخص شدن، شناسههای تغییر به تغییرات در موارد درون درایو مشترک اشاره دارند که وضعیت فعلی یک فایل را ارائه میدهند. برای اشاره به یک تغییر خاص در درایو مشترک، باید از شناسه درایو مشترک و شناسه تغییر به عنوان شناسه استفاده شود.includeItemsFromAllDrives: مشخص میکند که آیا فایلها یا تغییرات درایو اشتراکی باید در لیست تغییرات گنجانده شوند یا خیر.supportsAllDrives: آیا برنامه درخواستکننده از درایوهای مشترک پشتیبانی میکند یا خیر. اگر مقدار آن نادرست باشد، آیتمهای درایو مشترک، شامل درایوهای مشترک و فایلهای درون یک درایو مشترک، بازگردانده نمیشوند.
حالتهای پرسوجوی زیر مختص درایوهای اشتراکی هستند:
includeItemsFromAllDrives | driveId | شرح پرس و جو |
|---|---|---|
true | خیر | تغییرات، منعکسکنندهی تغییرات در فایلهای داخل یا خارج از درایوهای اشتراکی هستند که کاربر به آنها دسترسی داشته است، و همچنین تغییرات در درایوهای اشتراکی که کاربر عضو آنهاست. |
true | بله | تغییرات، منعکسکنندهی تغییرات در درایو مشترک خاص مشخصشده و موارد درون آن درایو مشترک هستند. |
برای جزئیات بیشتر در مورد رفتار گزارش تغییرات، به پیگیری تغییرات برای کاربران و درایوهای مشترک مراجعه کنید.
پشتیبانی از درایو اشتراکی را در رابط کاربری Drive فعال کنید
برای دسترسی به محتوای درایو اشتراکی با استفاده از رابط کاربری درایو، مطمئن شوید که کادر پشتیبانی از درایوهای اشتراکی را در برگه ادغام رابط کاربری درایو از API گوگل درایو در کنسول گوگل کلود علامت زدهاید. برای اطلاعات بیشتر، به پیکربندی ادغام رابط کاربری درایو مراجعه کنید.
از Google Picker با درایوهای اشتراکی استفاده کنید
ابزار انتخابگر گوگل (Google Picker) از انتخاب آیتمها در درایوهای اشتراکی پشتیبانی میکند. برای جزئیات بیشتر در مورد فعالسازی پشتیبانی از درایو اشتراکی و افزودن نماهای درایوهای اشتراکی در انتخابگر، به API انتخابگر گوگل (Google Picker API) مراجعه کنید.