افزونههای Google Workspace میتوانند رابطهای کاربری سفارشیسازیشدهای را هنگام استفاده کاربر از Google Drive ارائه دهند. این به شما امکان میدهد اطلاعات مرتبط بیشتری را در اختیار کاربر قرار دهید، وظایف را خودکار کنید و سیستمهای شخص ثالث را به Google Drive متصل کنید.
دسترسی به رابط کاربری افزونه
اگر نماد افزونهی Google Workspace در ستون نمادها در سمت راست رابط کاربری Drive ظاهر شود، میتوانید آن را در Google Drive باز کنید. یک افزونهی Google Workspace میتواند یک رابط صفحه اصلی، یک رابط انتخاب آیتم یا هر دو را تعریف کند:
- اگر کاربری در گوگل درایو روی آیکون افزونه کلیک کند، افزونه تابع
drive.homepageTriggerمربوطه (در صورت وجود) را اجرا میکند. این تابع یک کارت صفحه اصلی میسازد و برای نمایش به گوگل درایو برمیگرداند. اگر هیچ تابعdrive.homepageTriggerتعریف نشده باشد، به جای آن یک کارت صفحه اصلی عمومی نمایش داده میشود. - اگر کاربر یک یا چند مورد را در گوگل درایو انتخاب کند و سپس روی آیکون افزونه کلیک کند، یا در حالی که افزونه باز است، مواردی را انتخاب کند، افزونه تابع زمینهای
drive.onItemsSelectedTriggerمربوطه را (در صورت وجود) اجرا میکند. این تابع رابط زمینهای "items selected" گوگل درایو افزونه را میسازد و آن را برای نمایش به گوگل درایو برمیگرداند.
ساخت رابط کاربری افزونهی Drive
شما میتوانید با دنبال کردن این مراحل کلی، رابطهایی بسازید که گوگل درایو را گسترش میدهند:
- تصمیم بگیرید که آیا میخواهید افزونه شما یک صفحه اصلی مخصوص درایو داشته باشد یا خیر. همچنین تصمیم بگیرید که آیا میخواهید یک رابط کاربری متنی برای زمانی که کاربر موارد درایو را انتخاب میکند، ارائه دهید یا خیر.
- فیلدهای
addOns.commonوaddOns.driveمناسب را به مانیفست پروژه اسکریپت افزونه، شامل هرگونه محدوده Drive مورد نیاز، اضافه کنید. - اگر یک صفحه اصلی مخصوص Drive ارائه میدهید، تابع
drive.homepageTriggerرا برای ساخت این رابط پیادهسازی کنید. همچنین میتوانید از رابطcommon.homepageTriggerبرای چندین میزبان Google Workspace استفاده کنید. - اگر یک رابط انتخاب آیتم متنی Drive ارائه میدهید، باید یک تابع محرک متنی
drive.onItemsSelectedTriggerرا برای ساخت این رابط پیادهسازی کنید. برای جزئیات بیشتر به رابط متنی Drive برای آیتمهای انتخاب شده مراجعه کنید. - توابع فراخوانی مرتبط مورد نیاز برای پاسخ به تعاملات رابط کاربری کاربر، مانند کلیک دکمهها، را پیادهسازی کنید.
صفحات اصلی درایو
گوگل درایو از نمایش صفحات اصلی افزونههای گوگل ورکاسپیس پشتیبانی میکند. برای نمایش صفحه اصلی مشترک افزونه خود در گوگل درایو، کافیست مطمئن شوید که فیلد addOns.drive در فایل مانیفست افزونه وجود دارد.
روش دیگر، اضافه کردن یک drive.homepageTrigger به مانیفست افزونه برای ارائه یک صفحه اصلی مخصوص درایو است.
در هر صورت، شما باید نام تابع تریگر صفحه اصلی را در پروژه اسکریپت افزونه خود ارائه دهید. این تابع به طور خودکار برای ساخت صفحه اصلی Drive در صورت نیاز فراخوانی میشود. شما باید این تابع را برای ساخت و بازگرداندن یک Card یا آرایهای از اشیاء Card که صفحه اصلی را تشکیل میدهند، پیادهسازی کنید. تابع تریگر صفحه اصلی یک شیء رویداد را به عنوان پارامتر ارسال میکند که حاوی برخی اطلاعات کلی مانند پلتفرم کلاینت است. میتوانید از دادههای شیء رویداد برای سفارشیسازی ساخت صفحه اصلی استفاده کنید.
رابط متنی را برای موارد انتخاب شده هدایت کنید
گوگل درایو برای تعیین اینکه چه رابطی (در صورت وجود) هنگام انتخاب یک یا چند مورد از موارد گوگل درایو توسط کاربر نمایش داده شود، به یک تریگر زمینهای متکی است. وقتی تریگر فعال میشود، تابع تریگر زمینهای مشخص شده توسط فیلد drive.onItemsSelectedTrigger.runFunction در مانیفست افزونه را اجرا میکند.
برای ایجاد یک رابط انتخاب آیتم زمینهای برای Drive، باید موارد زیر را انجام دهید:
مطمئن شوید که مانیفست افزونه شامل محدودهی
https://www.googleapis.com/auth/drive.addons.metadata.readonlyمیشود.مطمئن شوید که فایل مانیفست شامل بخش
drive.onItemsSelectedTriggerباشد.تابعی که در فیلد
drive.onItemsSelectedTriggerنامگذاری شده است را پیادهسازی کنید. این تابع یک شیء رویداد را به عنوان آرگومان میپذیرد و باید یا یک شیءCardواحد یا آرایهای از اشیاءCardرا برگرداند.مانند هر کارت دیگری، شما باید هر تابع فراخوانی که برای ارائه تعامل ویجت برای رابط کاربری استفاده میشود را پیادهسازی کنید. برای مثال، اگر یک دکمه در رابط کاربری قرار میدهید، باید یک اکشن (Action) متصل و یک تابع فراخوانی پیادهسازی شده داشته باشد که هنگام کلیک روی دکمه اجرا شود.
اشیاء رویداد
یک شیء رویداد ایجاد میشود و هنگام فراخوانی توابع trigger مانند drive.homepageTrigger یا drive.onItemsSelectedTrigger به آن ارسال میشود. تابع trigger میتواند از اطلاعات موجود در این شیء رویداد برای تعیین نحوه ساخت کارتهای افزونه یا کنترل رفتار افزونه استفاده کند.
ساختار کامل اشیاء رویداد در اشیاء رویداد شرح داده شده است. وقتی Drive برنامه میزبان فعال افزونه است، اشیاء رویداد زمینهای شامل فیلد شیء رویداد Drive میشوند که اطلاعات کلاینت مخصوص Drive را حمل میکند.
اشیاء رویداد Contextual Drive برای تریگرهای انتخاب آیتم شامل اطلاعاتی در مورد آیتمهایی هستند که کاربر هنگام فعال شدن تریگر انتخاب کرده است. هنگامی که کاربر بیش از یک آیتم را در Drive انتخاب میکند، یکی از آیتمها به عنوان آیتم مورد علاقه اصلی در نظر گرفته میشود؛ این آیتم به عنوان آیتم مکاننمای فعال شناخته میشود.
مثال زیر یک شیء رویداد Drive را نشان میدهد که به تابع drive.onItemsSelectedTrigger ارسال میشود:
{
"commonEventObject": { ... },
"drive": {
"activeCursorItem":{
"addonHasFileScopePermission": true,
"id":"0B_sX1fXRRU6Ac3RhcnRlcl9maWxl",
"iconUrl": "https://drive-thirdparty.googleusercontent.com...",
"mimeType":"application/pdf",
"title":"How to get started with Drive"
},
"selectedItems": [
{
"addonHasFileScopePermission": true,
"id":"0B_sX1fXRRU6Ac3RhcnRlcl9maWxl",
"iconUrl":"https://drive-thirdparty.googleusercontent.com...",
"mimeType":"application/pdf",
"title":"How to get started with Drive"
},
...
]
},
...
}