اصطلاحات زیر در سراسر این مستندات استفاده میشوند.
افزونه کنفرانس تقویم
یک نوع افزونه خاص که به ارائهدهندگان کنفرانس اجازه میدهد گزینههای کنفرانس را در رویدادهای تقویم گوگل ارائه دهند. این افزونهها برای اتصال به یک راهکار کنفرانس توسعهیافته نیاز دارند. به دلیل این الزام، اکثر توسعهدهندگان هرگز نیازی به ایجاد افزونه کنفرانس تقویم ندارند.
برای اطلاعات بیشتر به افزونههای کنفرانس تقویم مراجعه کنید. همچنین برای کسب اطلاعات در مورد نحوه تبدیل افزونه کنفرانس تقویم به افزونه Google Workspace، به ارتقاء افزونههای منتشر شده خود مراجعه کنید.
کارت
یک «صفحه» از رابط کاربری افزونه. کارتها از اشیاء ویجت مختلف (دکمهها، فیلدهای متنی، هدرها و غیره) تشکیل شدهاند.
برای اطلاعات بیشتر به کارتها مراجعه کنید.
مبتنی بر کارت
افزونهای که رابط کاربری آن به صورت یک پنل در نوار کناری (یا در موبایل، به صورت یک پنجره فعالیت دیگر که از طریق منو قابل دسترسی است) ظاهر میشود. این افزونه دارای یک نوار ابزار در بالا است که افزونه را شناسایی کرده و یک کارت - اساساً یک "صفحه" از رابط کاربری افزونه - را نمایش میدهد.
افزونههای Google Workspace مبتنی بر کارت هستند.
دادههای کنفرانس
مجموعهای از اطلاعات مورد نیاز تقویم گوگل برای اینکه کاربران بتوانند کنفرانسهای شخص ثالثی را که توسط افزونهی Google Workspace یا افزونهی کنفرانس تقویم فعال شدهاند، ایجاد و به آنها بپیوندند.
برای اطلاعات بیشتر به دادههای کنفرانس مراجعه کنید.
راهکار کنفرانس
نمایشی از یک کنفرانس شخص ثالث که میتواند از طریق تقویم گوگل با استفاده از افزونهی Google Workspace یا افزونهی کنفرانس تقویم ایجاد شود.
برای اطلاعات بیشتر به راهکارهای کنفرانس مراجعه کنید.
زمینه
وضعیت فعلی برنامه میزبان. به عنوان مثال، کدام پیام در حال حاضر در Gmail باز است، کدام رویداد تقویم را ویرایش میکنید، یا کدام فایلهای Drive را انتخاب کردهاید که بخشی از context فعلی برنامه میزبان هستند. context، به همراه سایر اطلاعات، در یک شیء رویداد جمعآوری میشود که به عنوان پارامتر به تابع trigger ارسال میشود.
تحریک زمینهای
عمل تعریف تریگرهایی که وقتی کاربر وارد یک زمینه خاص میشود، مانند زمانی که یک رشته ایمیل را در Gmail باز میکند، فعال میشوند. تریگرهای زمینهای به افزونه شما اجازه میدهند تا رابط کاربری مرتبط با آن زمینه را ارائه دهد. تریگرهای زمینهای در مانیفست پروژه اسکریپت افزونه پیکربندی میشوند و بنابراین نوعی تریگر مانیفست هستند.
افزونههای ویرایشگر
مجموعه اصلی انواع افزونهها که فقط امکان افزودن افزونههای Google Docs، Sheets، Forms یا Slides را فراهم میکردند. افزونههای ویرایشگر مبتنی بر کارت نیستند؛ بلکه از توسعهدهنده میخواهند که یک رابط کاربری از HTML و CSS خام ایجاد کند. هر افزونه ویرایشگر فقط میتواند یک برنامه میزبان را گسترش دهد.
برای جزئیات بیشتر به افزونههای ویرایشگر مراجعه کنید.
شیء رویداد
شیء JSON که به طور خودکار هنگام درخواست صفحات اصلی، هنگامی که افزونه وارد زمینههایی میشود که باید به آنها پاسخ دهد، یا در نتیجه تعاملات کاربر با ویجتها در رابط افزونه ایجاد میشود. اشیاء رویداد پس از ایجاد، به یک تابع ماشه یا تابع فراخوانی مشخص شده منتقل میشوند. هدف اشیاء رویداد، انتقال اطلاعات از محیط سمت کلاینت کاربر (مانند اطلاعاتی که در ویجتهای رابط افزونه وارد کردهاند) به کد سمت سرور افزونه است، که سپس میتواند بر روی آن اطلاعات عمل کند و پاسخ مناسب را برگرداند.
برای جزئیات بیشتر به اشیاء رویداد مراجعه کنید.
افزونههای جیمیل
افزونهای که فقط جیمیل را گسترش میدهد. افزونههای جیمیل مبتنی بر کارت هستند. بسیاری از عملکردها، رفتار و جزئیات توسعهای که برای ایجاد افزونههای جیمیل استفاده میشوند، مشابه همان جزئیاتی هستند که برای ایجاد افزونههای Google Workspace استفاده میشوند.
برای اطلاعات بیشتر به افزونههای جیمیل مراجعه کنید. همچنین برای کسب اطلاعات در مورد نحوه تبدیل یک افزونه جیمیل به یک افزونه Google Workspace به ارتقاء افزونههای منتشر شده خود مراجعه کنید.
صفحه اصلی
کارت رابط کاربری ریشه یک افزونه. صفحات اصلی زمانی نمایش داده میشوند که کاربران افزونه را باز میکنند و به افزونه شما اجازه میدهند محتوایی را خارج از یک زمینه خاص نشان دهد (برای مثال، وقتی کاربر در حال مشاهده رشته ایمیلهای خود در Gmail است، اما آن را باز نکرده است). شما ظاهر و رفتار صفحه اصلی افزونه خود را مانند هر کارت دیگری تعریف میکنید.
برای اطلاعات بیشتر به صفحات اصلی مراجعه کنید.
میزبان یا برنامه میزبان
برنامه Google Workspace که افزونه Google Workspace آن را گسترش میدهد، مانند Gmail یا Google Calendar.
مبتنی بر HTML
افزونهای که رابط کاربری آن به جای سرویس کارت داخلی Apps Script، با استفاده از HTML و CSS تعریف شده است. فقط افزونههای قدیمیتر ویرایشگر مبتنی بر HTML هستند.
تریگر پیشنمایش لینک
پیشنمایش لینک زمانی فعال میشود که کاربران با یک URL شخص ثالث یا غیر گوگلی در یک برنامه میزبان گوگل، مانند Google Docs، تعامل داشته باشند. فعالسازی پیشنمایش لینک به شما امکان میدهد الگوهای URL را برای پیشنمایش از سرویس یا API خود تعریف کنید و محتوای پیشنمایش، از جمله تراشه هوشمند و کارت پیشنمایش را پیکربندی کنید. پیشنمایش لینک در مانیفست پروژه اسکریپت افزونه پیکربندی شده است و بنابراین نوعی ماشه مانیفست محسوب میشود.
برای اطلاعات بیشتر به لینکهای پیشنمایش با تراشههای هوشمند مراجعه کنید.
مانیفست
یک فایل JSON که به یک پروژه Apps Script متصل شده است. مانیفست برای تعریف اطلاعات پروژه که اسکریپت برای اجرای صحیح به آن نیاز دارد، استفاده میشود. برای افزونههای Google Workspace، مانیفست برای مشخص کردن میزبانهایی که افزونه میتواند آنها را گسترش دهد و ارائه تنظیمات کنترل رابط کاربری خاص، استفاده میشود.
ماشه آشکار
تریگری که در مانیفست پروژه تعریف شده است، مانند تریگر صفحه اصلی یا تریگر زمینهای. تریگرهای مانیفست منحصراً برای ایجاد و نمایش کارتهای جدید هنگام درخواست صفحه اصلی افزونه یا ورود افزونه به زمینهای که نیاز به بهروزرسانی نمایش دارد، استفاده میشوند.
تریگرهای Manifest با سایر تریگرهای موجود در Apps Script متفاوت هستند زیرا داخلی نیستند (مانند تریگرهای ساده ) و نمیتوان آنها را به صورت برنامهنویسی شده با سرویس Apps Script Script ایجاد کرد (مانند تریگرهای قابل نصب ).
کارتهای غیرمرتبط
کارتهایی که محتوا را زمانی که کاربر خارج از یک زمینه خاص است نشان میدهند؛ برای مثال، هنگام مشاهده رشته ایمیلهای خود در جیمیل، اما هنوز هیچ کدام را باز نکرده است. صفحات اصلی نوعی کارت غیرزمینهای هستند.
نوار کناری
بخشی در سمت راست رابط کاربری میزبان که رابط کاربری افزونهی Google Workspace در آن نمایش داده میشود. افزونههای Gmail و Editor همچنین میتوانند نوارهای کناری را تعریف کنند.
تراشه هوشمند
یک تراشه هوشمند، اشارهای به یک شخص، فایل، رویداد تقویم یا موجودیت دیگر در برنامه Google Workspace است. وقتی کاربران ماوس را روی یک تراشه نگه میدارند، میتوانند پیشنمایشی از محتوای اضافی در مورد فایل یا لینک نیز مشاهده کنند. به عنوان مثال، وقتی کاربران ماوس را روی یک تراشه به یک ارائه Google Slides میبرند، تصویری از یک اسلاید، مالک ارائه و اینکه آیا قبلاً آن ارائه را مشاهده کردهاند یا خیر را مشاهده میکنند.
میتوانید افزونه خود را طوری پیکربندی کنید که از تراشههای هوشمند برای پیشنمایش لینکهای یک سرویس شخص ثالث یا غیر گوگلی استفاده کند. به پیشنمایش لینکها در Google Docs مراجعه کنید.
ماشه
یک پاسخ شرطی و رویداد خودکار که توسط یک پروژه یا افزونه Apps Script تعریف شده است. محرکها زمانی فعال میشوند که رویداد مرتبط با آنها رخ دهد (برای مثال، وقتی یک افزونه باز میشود) و باعث میشوند یک تابع Apps Script مشخص (تابع trigger) به طور خودکار اجرا شود. برای افزونههای Google Workspace، توابع trigger اغلب کارتهای جدیدی میسازند تا کنترل کنند کدام بخش از رابط کاربری افزونه نمایش داده شود. فقط انواع خاصی از رویدادها میتوانند محرک داشته باشند.
برای اطلاعات بیشتر به محرکهای افزونه مراجعه کنید.
تابع ماشه
یک تابع اسکریپت برنامهها در یک پروژه که در پاسخ به فعال شدن یک تریگر اجرا میشود.
ویجت
یک عنصر رابط کاربری مانند یک دکمه، فیلد متنی یا کادر انتخاب. کارتها از دنبالهای از اشیاء ویجت ساخته میشوند که توسط سرویس Card داخلی Apps Script تعریف شدهاند.
برای اطلاعات بیشتر به بخش ویجتها مراجعه کنید.
تابع مدیریت ویجت
تابعی که یک ویجت خاص را به یک شیء اکشن خاص پیوند میدهد. هر نوع ویجت مجموعهای از توابع کنترلکننده ویجت تعریفشده دارد که میتواند برای اتصال به اکشنها از آنها استفاده کند. توابع کنترلکننده ویجت تعریف میکنند که چه نوع تعامل کاربری باعث ایجاد اکشن میشود و یک جزء حیاتی از تعامل ویجت هستند.
برای اطلاعات بیشتر به توابع کنترلکننده ویجت مراجعه کنید.