انواع افزونه ها
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
این صفحه یک نمای کلی از دو نوع افزونه‌هایی که می‌توانید بسازید ارائه می‌کند: افزونه‌های Google Workspace و افزونه‌های ویرایشگر . این انواع افزودنی در اینکه چه برنامه هایی را گسترش می دهند، چگونه ایجاد می شوند و چه محدودیت هایی دارند متفاوت هستند.
افزونه های Google Workspace
افزونه‌های Google Workspace جدیدترین نسل افزونه‌ها هستند و قابلیت‌های بسیاری از جمله:
فقط یک افزونه برای چندین برنامه Google Workspace بسازید : به جای ایجاد افزونه‌های جداگانه برای هر برنامه Google Workspace، می‌توانید یک افزونه Google Workspace را بسازید و مدیریت کنید که در سراسر Google Workspace کار می‌کند. یک افزونه Google Workspace می‌تواند برنامه‌های میزبان زیر را گسترش دهد:
- جیمیل
- تقویم گوگل
- Google Chat (پیش‌نمایش برنامه‌نویس)
- Google Docs
- گوگل درایو
- Google Meet
- Google Sheets
- اسلایدهای گوگل
آگاهی از برند خود را افزایش دهید : نمادهای افزونه ها به طور پیش فرض در پانل سمت راست برنامه های میزبان افزونه قابل مشاهده هستند.
ایجاد تجربه‌های صفحه اصلی : می‌توانید برای هر برنامه Google Workspace که افزونه شما گسترش می‌یابد، صفحات اصلی جداگانه ایجاد کنید یا از یک صفحه اصلی برای چندین برنامه استفاده کنید.
زمینه کاربر را در برافزای خود منعکس کنید : می‌توانید افزونه Google Workspace خود را طوری طراحی کنید که رابط‌های مخصوص برنامه میزبان برافزا را نشان دهد. به عنوان مثال، برافزای شما می‌تواند اطلاعات یک ایمیل یا رویداد تقویم را نمایش دهد یا بر اساس صفحه فعلی برنامه Google Workspace، اقدامی را پیشنهاد کند.
از رابط های استاندارد استفاده کنید : رابط های کاربری را از عناصر ویجت داخلی ارائه شده توسط سرویس Apps Script Card بسازید. برای تعریف این رابط ها نیازی به تخصص در HTML یا CSS ندارید.
توسعه سرویس گیرندگان دسکتاپ و تلفن همراه برای Gmail : اگر یک افزونه Google Workspace Gmail را گسترش دهد، می‌توانید از آن در نسخه دسکتاپ و موبایل Gmail استفاده کنید. اگر یک افزونه Google Workspace می‌سازید که Gmail را گسترش می‌دهد، نیازی به طراحی نسخه تلفن همراه جداگانه این افزونه ندارید. رابط کاربری یکسان در همه جا استفاده می شود.
از زمان اجرا دلخواه خود استفاده کنید. می‌توانید افزونه‌های Google Workspace را با زیرساخت میزبانی دلخواه، زنجیره ابزار توسعه، سیستم کنترل منبع، زبان کدنویسی و کتابخانه‌های کد توسعه دهید.
افزونه های ویرایشگر
افزونه‌های ویرایشگر یکی از برنامه‌های ویرایشگر Google مانند Docs، Sheets، Slides یا Forms را گسترش می‌دهند. هر نوع افزودنی ویرایشگر (مثلاً افزونه‌های برگه‌ها) می‌تواند مجموعه‌ای از قابلیت‌ها، محدودیت‌ها و ملاحظات خاص نوع خاص خود را داشته باشد. هنگام ساخت افزونه های ویرایشگر، درک این جزئیات خاص ویرایشگر مهم است. برای جزئیات بیشتر در مورد افزونه‌ها برای ویرایشگرهای خاص، بخش‌های مربوطه را ببینید:
افزونه‌های ویرایشگر می‌توانند کارهای رایج ویرایشگر مانند ایجاد فایل، ویرایش، قالب‌بندی و انتقال داده‌ها بین برنامه‌ها را خودکار کنند. رابط های افزودنی ویرایشگر برای کارهای در دست بسیار قابل تنظیم هستند.
افزودنی‌های ویرایشگر برای خودکارسازی وظایف در Google Docs، Sheets، Slides یا Forms برای استفاده فردی یا داخلی ایده‌آل هستند. برای افزونه‌هایی که نیاز به قابلیت‌های مقیاس بزرگی دارند و نیاز به مدیریت بسیاری از کاربران دارند، به تأخیر کم نیاز دارند یا نیاز به کنترل کامل بر زیرساخت شما دارند، برای کنترل بهتر روی زیرساخت‌ها، استقرار و فرآیندهای انتشار، افزونه‌های Google Workspace را در یک محیط زمان اجرا متفاوت بسازید.
افزونه‌های ویرایشگر به روش‌های زیر متفاوت از افزونه‌های Google Workspace عمل می‌کنند:
- افزودنی های ویرایشگر می توانند رابط هایی متشکل از آیتم های منو، دیالوگ ها و نوارهای کناری ایجاد کنند. دیالوگ های افزودنی و نوارهای کناری با استفاده از HTML و CSS استاندارد تعریف می شوند.
- افزونه‌های ویرایشگر قوانین مجوز خاصی دارند زیرا فایل‌هایی را در Google Drive ایجاد می‌کنند، تغییر می‌دهند یا با آنها تعامل دارند. درک مجوز افزودنی ویرایشگر هنگام توسعه یک افزونه ویرایشگر مهم است.
- فایل هایی که در هر ویرایشگر ایجاد و به روز می شوند ساختار خاصی دارند. برای مثال، ارائه‌های Google Slides از صفحاتی تشکیل شده‌اند که می‌توانند اسلاید، اصلی یا طرح‌بندی باشند. شما باید ساختارهای فایل را درک کنید، زیرا افزونه‌ها اغلب هنگام خواندن یا ویرایش فایل‌ها با آنها تعامل دارند.
- افزونه‌های ویرایشگر فقط در کلاینت‌های دسکتاپ کار می‌کنند، نه Android یا iOS.
- افزودنی های ویرایشگر باید در Apps Script پیاده سازی شوند.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eGoogle Workspace add-ons offer a unified solution, extending functionalities across multiple Google Workspace applications like Gmail, Calendar, and Docs with a single add-on.\u003c/p\u003e\n"],["\u003cp\u003eEditor add-ons focus on enhancing specific Google Editors (Docs, Sheets, Slides, Forms) with custom interfaces and automation capabilities but are limited to desktop use.\u003c/p\u003e\n"],["\u003cp\u003eWhile Workspace add-ons utilize standardized interfaces and work seamlessly across platforms, Editor add-ons require HTML/CSS knowledge and adhere to specific authorization rules.\u003c/p\u003e\n"],["\u003cp\u003eBoth add-on types provide distinct advantages; Workspace add-ons enhance cross-application workflows, while Editor add-ons offer deep, editor-specific customization and task automation.\u003c/p\u003e\n"]]],["There are two add-on types: Google Workspace and Editor add-ons. Google Workspace add-ons offer a single build for multiple apps (Gmail, Calendar, Chat, Docs, Drive, Sheets, Slides), and they feature standardized interfaces, mobile and desktop compatibility, and customizable homepages. Editor add-ons extend Docs, Sheets, Slides, and Forms, allowing for highly customizable interfaces using HTML and CSS, but require specific authorization and only function on desktop. They are built to automate common editor tasks.\n"],null,["This page provides a general overview of the two types of add-ons\nyou can build:\n*Google Workspace add-ons* and *Editor add-ons*. These\nadd-on types differ in what applications they extend,\nhow they are created, and what restrictions they have.\n\nGoogle Workspace add-ons\n\n*Google Workspace add-ons* are the latest generation of add-ons, and\nprovide many capabilities, including:\n\n- **Build just one add-on for multiple\n Google Workspace apps**: Instead of creating separate\n add-ons for\n each Google Workspace application, you can build and manage a single\n Google Workspace add-on that works across Google Workspace.\n A Google Workspace add-on can extend the following host applications:\n\n - Gmail\n - Google Calendar\n - Google Chat (Developer Preview)\n - Google Docs\n - Google Drive\n - Google Meet\n - Google Sheets\n - Google Slides\n- **Increase your brand awareness**: Add-ons icons are by\n default visible in the right-side panel of the\n add-on's host apps.\n\n- **Build homepage experiences** : You can create individual [homepages](/workspace/add-ons/concepts/homepages)\n for each Google Workspace app your add-on\n extends, or use the same homepage for multiple apps.\n\n- **Reflect the user's context in your add-on**: You\n can design your Google Workspace add-on to show interfaces specific to the\n add-on's host app. For example, your\n add-on can display info from an email or calendar\n event, or suggest an action based on the current Google Workspace app\n page.\n\n- **Use standardized interfaces** : Construct user interfaces from built-in\n widget elements provided by the Apps Script\n [`Card`](/apps-script/reference/card-service/card) service. You don't need\n any expertise with HTML or CSS to define these interfaces.\n\n- **Extend desktop and mobile clients for Gmail**: If a\n Google Workspace add-on extends Gmail, you can use it in both the\n desktop and mobile versions of Gmail. If you build a\n Google Workspace add-on that extends Gmail, you don't need to\n design a separate mobile version of the add-on. The\n same interface is used everywhere.\n\n- **Use your preferred runtime.** You can develop Google Workspace add-ons with your\n preferred hosting infrastructure, development tool chain, source control\n system, coding language, and code libraries.\n\nEditor add-ons\n\n*Editor add-ons* extend one of the Google Editor applications,\nsuch as Docs, Sheets, Slides, or\nForms. Each Editor add-on type (for\nexample, Sheets add-ons) can have its own set of\ntype-specific capabilities, restrictions, and special considerations. When\nbuilding Editor add-ons, it's important to understand these\nEditor-specific details. For more details on add-ons for specific\nEditors, see the corresponding sections:\n\n- [Google Docs](/workspace/add-ons/editors/docs)\n- [Google Forms](/workspace/add-ons/editors/forms)\n- [Google Sheets](/workspace/add-ons/editors/sheets)\n- [Google Slides](/workspace/add-ons/editors/slides)\n\nEditor add-ons can automate common editor tasks such as file\ncreation, editing, formatting, and moving data between applications.\nEditor add-on interfaces are highly-customizable for\nthe tasks at hand.\n\nEditor add-ons are ideal for automating tasks within Google\nDocs, Sheets, Slides, or\nForms for individual or internal use. For add-ons\nrequiring large-scale capabilities that need to handle many users, require low\nlatency, or demands full control over your infrastructure, consider building a\nGoogle Workspace add-ons on a [different runtime](/workspace/add-ons/guides/alternate-runtimes)\nenvironment for better control over infrastructure, deployment and release\nprocesses.\n\nEditor add-ons behave differently from Google Workspace add-ons in the\nfollowing ways:\n\n- Editor add-ons can create interfaces consisting of menu items, dialogs, and sidebars. Add-ons dialogs and sidebars are defined using standard [HTML and\n CSS](/workspace/add-ons/concepts/html-interfaces).\n- Editor add-ons have special authorization rules because they create, modify, or otherwise interact with files within Google Drive. It is important to understand the [Editor add-on\n authorization](/workspace/add-ons/concepts/editor-auth-lifecycle) while developing an Editor add-on.\n- Files created and updated in each editor have specific structures. For example, Google Slides presentations are composed of pages which can be slides, masters, or layouts. You should understand these file structures, as add-ons often interact with them when reading or editing files.\n- Editor add-ons only function in desktop clients, not Android or iOS.\n- Editor add-ons must be implemented in Apps Script."]]
