واژه نامه

عبارات زیر در سراسر این مستندات استفاده می شود.

افزونه کنفرانس تقویم

نوع خاصی از افزودنی که به ارائه دهندگان کنفرانس اجازه می دهد تا گزینه های کنفرانس را در رویدادهای تقویم Google ارائه دهند. این افزونه ها برای اتصال افزونه به یک راه حل کنفرانسی توسعه یافته نیاز دارند. به دلیل این نیاز، اکثر توسعه دهندگان هرگز نیازی به ایجاد افزونه کنفرانس Calendar ندارند.

برای اطلاعات بیشتر به افزونه های کنفرانس تقویم مراجعه کنید. همچنین برای اطلاع از نحوه تبدیل افزونه کنفرانس Calendar به افزونه Google Workspace به ارتقای افزونه های منتشر شده خود مراجعه کنید.

کارت

یک "صفحه" از یک رابط کاربری افزودنی. کارت ها از اشیاء مختلف ویجت (دکمه ها، فیلدهای متنی، سرصفحه ها و غیره) تشکیل شده اند.

برای اطلاعات بیشتر به کارت ها مراجعه کنید.

مبتنی بر کارت

افزونه‌ای که رابط کاربری آن به‌عنوان یک صفحه در نوار کناری ظاهر می‌شود (یا در تلفن همراه، به‌عنوان پنجره فعالیت دیگری که از طریق منو به آن دسترسی دارید). این افزونه دارای یک نوار ابزار بالایی است که افزونه را شناسایی می کند و یک کارت را نمایش می دهد - اساساً یک "صفحه" از رابط کاربری افزونه.

افزونه‌های Google Workspace مبتنی بر کارت هستند.

داده های کنفرانس

مجموعه اطلاعاتی که Google Calendar به آن نیاز دارد تا به کاربران اجازه دهد کنفرانس‌های شخص ثالث را ایجاد کرده و به آن بپیوندند که توسط افزونه Google Workspace یا برافزای کنفرانس Calendar فعال شده است.

برای اطلاعات بیشتر به داده های کنفرانس مراجعه کنید.

راه حل کنفرانس

نمایشی از یک کنفرانس شخص ثالث که می تواند از Google Calendar با استفاده از افزونه Google Workspace یا افزونه کنفرانس Calendar ایجاد شود.

برای اطلاعات بیشتر به راهکارهای کنفرانس مراجعه کنید.

متن نوشته

وضعیت فعلی برنامه میزبان. به عنوان مثال، پیامی که در حال حاضر در Gmail باز می شود، کدام رویداد Calendar را ویرایش می کنید، یا کدام فایل Drive را که انتخاب کرده اید بخشی از زمینه فعلی برنامه میزبان است. متن، همراه با اطلاعات دیگر، در یک شی رویداد جمع آوری می شود که به عنوان یک پارامتر به تابع ماشه ارسال می شود.

تحریک متنی

وقتی کاربر وارد یک زمینه خاص می‌شود، مانند زمانی که یک رشته ایمیل در Gmail باز می‌کند، تعریف آن باعث شروع آن می‌شود. راه‌اندازی متنی به افزونه شما امکان می‌دهد رابط کاربری مرتبط با آن زمینه را ارائه دهد. راه‌اندازهای متنی در مانیفست پروژه اسکریپت افزودنی پیکربندی می‌شوند و بنابراین نوعی راه‌انداز مانیفست هستند.

افزونه های ویرایشگر

مجموعه اصلی انواع افزونه‌ها که فقط به افزونه‌های Google Docs، Sheets، Forms یا Slides اجازه می‌دهد. افزودنی های ویرایشگر مبتنی بر کارت نیستند. در عوض، آنها از توسعه‌دهنده می‌خواستند که یک UI از HTML خام و CSS ایجاد کند. هر افزونه ویرایشگر فقط می تواند یک برنامه میزبان را گسترش دهد.

برای جزئیات بیشتر به افزونه های ویرایشگر مراجعه کنید.

شی رویداد

شی JSON که به طور خودکار هنگام درخواست صفحات اصلی، زمانی که افزونه وارد زمینه هایی می شود که باید به آنها پاسخ دهد یا در نتیجه تعامل کاربر با ویجت ها در رابط افزودنی ایجاد می شود. پس از ایجاد، اشیاء رویداد به یک تابع ماشه یا تابع تماس برگشتی مشخص ارسال می شوند. هدف اشیاء رویداد انتقال اطلاعات از محیط سمت سرویس گیرنده کاربر (مانند اطلاعاتی که در ویجت های رابط افزودنی وارد کرده اند) به کد سمت سرور افزونه است، که سپس می تواند بر روی آن اطلاعات عمل کند و پاسخ مناسب را برگردانید.

برای جزئیات بیشتر به اشیاء رویداد مراجعه کنید.

افزونه های جیمیل

افزونه ای که فقط Gmail را گسترش می دهد. افزونه های جیمیل مبتنی بر کارت هستند. بسیاری از جزئیات عملکرد، رفتار و توسعه مورد استفاده برای ایجاد افزونه‌های Gmail با همان جزئیاتی که برای ایجاد افزونه‌های Google Workspace استفاده می‌شوند، یکسان است.

برای اطلاعات بیشتر به افزونه های Gmail مراجعه کنید. همچنین برای اطلاع از نحوه تبدیل افزونه Gmail به افزونه Google Workspace به ارتقای افزونه های منتشر شده خود مراجعه کنید.

صفحه نخست

کارت رابط کاربری ریشه یک افزونه. هنگامی که کاربران افزونه را باز می‌کنند، صفحات اصلی نمایش داده می‌شوند و به افزونه شما اجازه می‌دهند محتوایی را خارج از یک زمینه خاص نشان دهد (به عنوان مثال، زمانی که کاربر در حال مشاهده رشته‌های ایمیل خود در Gmail است، اما یکی را باز نکرده است). شما ظاهر و رفتار صفحه اصلی افزونه خود را مانند هر کارت دیگری تعریف می کنید.

برای اطلاعات بیشتر به صفحات اصلی مراجعه کنید.

Host یا Host اپلیکیشن

برنامه Google Workspace یک افزونه Google Workspace است، مانند Gmail یا Google Calendar.

مبتنی بر HTML

افزونه ای که رابط کاربری آن با استفاده از HTML و CSS به جای سرویس کارت داخلی Apps Script تعریف شده است. فقط افزونه‌های ویرایشگر قدیمی‌تر مبتنی بر HTML هستند.

پیش‌نمایش پیوند زمانی فعال می‌شود که کاربران با یک URL شخص ثالث یا غیر Google در یک برنامه میزبان Google مانند Google Docs تعامل داشته باشند. راه‌اندازی پیش‌نمایش پیوند به شما امکان می‌دهد الگوهای URL را برای پیش‌نمایش از سرویس یا API خود تعریف کنید و محتوای پیش‌نمایش، از جمله تراشه هوشمند و کارت پیش‌نمایش را پیکربندی کنید. راه‌اندازهای پیش‌نمایش پیوند در مانیفست پروژه اسکریپت الحاقی پیکربندی می‌شوند و بنابراین یک نوع ماشه مانیفست هستند.

برای اطلاعات بیشتر به پیوندهای پیش‌نمایش در Google Docs مراجعه کنید.

آشکار

یک فایل JSON پیوست شده به پروژه Apps Script. مانیفست برای تعریف اطلاعات پروژه مورد نیاز اسکریپت برای اجرای صحیح استفاده می شود. برای افزودنی‌های Google Workspace، مانیفست برای تعیین میزبان‌هایی که افزونه می‌تواند گسترش دهد و تنظیمات کنترل رابط کاربری خاصی را ارائه کند، استفاده می‌شود.

ماشه آشکار

راه‌اندازی که در مانیفست پروژه تعریف می‌شود، مانند راه‌انداز صفحه اصلی یا راه‌انداز زمینه. هنگامی که یک صفحه اصلی افزونه درخواست می‌شود یا افزونه وارد زمینه‌ای می‌شود که نیاز به به‌روزرسانی نمایشگر دارد، محرک‌های مانیفست منحصراً برای ایجاد و نمایش کارت‌های جدید استفاده می‌شوند.

راه‌اندازهای مانیفست از دیگر محرک‌ها در Apps Script متمایز هستند، زیرا داخلی نیستند (مانند راه‌اندازهای ساده ) و نمی‌توان آنها را به‌صورت برنامه‌ریزی با سرویس Apps Script ایجاد کرد (مانند محرک‌های قابل نصب ).

کارت های غیر متنی

کارت‌هایی که وقتی کاربر خارج از یک زمینه خاص است، محتوا را نشان می‌دهد. به عنوان مثال، هنگام مشاهده رشته های ایمیل خود در جیمیل، اما یکی را باز نکرده است. صفحات اصلی نوعی کارت غیر متنی هستند.

بخشی در سمت راست رابط کاربری میزبان که در آن رابط کاربری افزونه Google Workspace ظاهر می شود. افزونه‌های Gmail و Editor نیز می‌توانند نوارهای کناری را تعریف کنند.

تراشه هوشمند

تراشه هوشمند ذکر یک شخص، فایل، رویداد تقویم یا موجودیت دیگر در برنامه Google Workspace است. هنگامی که کاربران ماوس را روی یک تراشه می‌برند، می‌توانند محتوای اضافی مربوط به فایل یا پیوند را نیز پیش‌نمایش کنند. به عنوان مثال، هنگامی که کاربران ماوس را روی یک تراشه روی یک ارائه Google Slides قرار می‌دهند، تصویری از یک اسلاید، مالک ارائه، و اینکه آیا قبلاً ارائه را مشاهده کرده‌اند، می‌بینند.

می‌توانید افزونه خود را طوری پیکربندی کنید که از تراشه‌های هوشمند برای پیش‌نمایش پیوندها برای یک سرویس شخص ثالث یا غیر Google استفاده کند. پیوندهای پیش‌نمایش را در Google Docs ببینید.

ماشه

یک وضعیت و پاسخ رویداد خودکار که توسط یک پروژه یا افزونه Apps Script تعریف شده است. هنگامی که رویداد مرتبط با آنها رخ می دهد (به عنوان مثال، هنگامی که یک افزونه باز می شود) فعال می شود و باعث می شود یک تابع برنامه اسکریپت مشخص شده (عملکرد ماشه) به طور خودکار اجرا شود. برای افزونه‌های Google Workspace، توابع راه‌اندازی اغلب کارت‌های جدیدی می‌سازند تا کنترل کنند چه بخشی از رابط کاربری افزودنی نمایش داده می‌شود. فقط انواع خاصی از رویداد می توانند محرک داشته باشند.

برای اطلاعات بیشتر به محرک های افزودنی مراجعه کنید.

عملکرد ماشه

یک تابع Apps Script در یک پروژه که در پاسخ به یک ماشه اجرا می شود.

ویجت

یک عنصر رابط کاربری مانند یک دکمه، فیلد نوشتاری یا کادر تأیید. کارت ها از دنباله ای از اشیاء ویجت ساخته می شوند که توسط سرویس کارت داخلی Apps Script تعریف شده اند.

برای اطلاعات بیشتر به ابزارک ها مراجعه کنید.

عملکرد کنترل کننده ویجت

تابعی که یک ویجت خاص را به یک شی اقدام خاص پیوند می دهد. هر نوع ویجت دارای مجموعه ای از توابع کنترل کننده ویجت تعریف شده است که می تواند برای اتصال به عملکردها استفاده کند. توابع نشانگر ویجت تعریف می‌کنند که چه نوع تعاملی با کاربر باعث ایجاد کنش در نتیجه می‌شود و یک جزء حیاتی از تعامل ویجت است.

برای اطلاعات بیشتر به توابع کنترل کننده ویجت مراجعه کنید.