با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
چند محدودیت در مورد کارهایی که افزونه ها می توانند انجام دهند وجود دارد. با اجتناب از این مشکلات، تجربه کلی کاربران خود را بهبود بخشید.
محدودیت های عمومی
محدودیت های زیر برای همه افزونه ها اعمال می شود. کارهای زیر را انجام ندهید:
ویژگی‌ها را در Google Workspace تغییر دهید
چارچوب افزودنی برای بهبود برنامه‌های Google Workspace طراحی شده است، نه برای افزودن محدودیت. در نتیجه، نمی‌توانید ویژگی‌های موجود را تغییر دهید یا مدل اشتراک‌گذاری سند Google Workspace را قفل کنید.
شارژ کاربران برای نصب
ما راهی برای دریافت هزینه از کاربران برای نصب افزونه ها ارائه نمی دهیم و افزونه ها نمی توانند شامل تبلیغات شوند . با این حال، می‌توانید سیستم پرداخت خود را راه‌اندازی کنید یا با پایگاه داده صورت‌حساب موجود تماس بگیرید. برافزای شما می‌تواند به سرویس‌های غیر Google که به کاربران صورت‌حساب می‌دهند متصل شود.
بسیاری از رویدادها را شناسایی کنید
به جز برخی محرک‌ها ، افزونه‌ها نمی‌توانند تشخیص دهند که کاربر خارج از خود افزونه چه می‌کند. به عنوان مثال، نمی توانید تشخیص دهید که کاربر روی نوار ابزار برنامه میزبان کلیک می کند. امکان نظرسنجی برای تغییرات در محتویات فایل از کد سمت سرویس گیرنده نوار کناری وجود دارد، اگرچه همیشه کمی تاخیر خواهید داشت.
افزونه های Google Workspace
محدودیت‌های زیر فقط برای افزونه‌های Google Workspace و استفاده از سرویس کارت اعمال می‌شود. کارهای زیر را انجام ندهید:
همه برنامه‌های Google Workspace را گسترش دهید
افزونه‌های Google Workspace فقط می‌توانند Gmail، Calendar، Drive، Meet، Docs، Sheets و Slides را گسترش دهند. در نهایت افزونه های Google Workspace می توانند سایر برنامه های Google Workspace را گسترش دهند.
زمینه سند در ویرایشگرها
افزونه‌های Google Workspace هنوز از استفاده از زمینه سند در ویرایشگرها پشتیبانی نمی‌کنند. یعنی نمی توانید از روش هایی مانند SpreadsheetApp.getActiveSpreadsheet() برای به دست آوردن سند فعلی استفاده کنید.
از HTML/CSS یا اسکریپت سمت سرویس گیرنده استفاده کنید
افزونه‌های Google Workspace باید از رابط‌های مبتنی بر کارت استفاده کنند. رابط های HTML/CSS که توسط افزونه های ویرایشگر پشتیبانی می شوند قابل استفاده نیستند. افزونه‌های Google Workspace از رویکردی مبتنی بر ویجت برای ایجاد رابط کاربری استفاده می‌کنند. این به این افزونه اجازه می دهد تا به خوبی روی پلتفرم های دسکتاپ و تلفن همراه بدون نیاز به ساخت رابط کاربری برای هر یک از آنها کار کند.
پشتیبانی کامل از موبایل
در حال حاضر، افزونه‌های Google Workspace در سرویس‌گیرندگان وب دسکتاپ کار می‌کنند. راه‌اندازی متنی (یعنی خواندن پیام Gmail) از داخل برنامه تلفن همراه Gmail نیز پشتیبانی می‌شود. صفحات اصلی غیر متنی هنوز از برنامه های تلفن همراه Gmail، Calendar یا Drive در دسترس نیستند. افزونه‌های Google Workspace از مرورگرهای وب تلفن همراه در دسترس نیستند.
از راه‌اندازهای Apps Script استفاده کنید
نمی‌توانید راه‌اندازهای ساده Apps Script را در افزونه Google Workspace ایجاد یا استفاده کنید.
از تصاویر SVG استفاده کنید
در حال حاضر نمی‌توانید از تصاویر SVG با کارت‌های خدمات کارت و ویجت‌ها استفاده کنید.
بیش از 100 ویجت داشته باشید
به دلایل عملکرد، نمی توانید بیش از 100 ویجت یا 100 بخش کارت را به یک کارت اضافه کنید.
تاریخ آخرین بهروزرسانی 2025-01-30 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-01-30 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eGoogle Workspace add-ons enhance, but do not fundamentally change, existing Google Workspace features.\u003c/p\u003e\n"],["\u003cp\u003eAdd-ons cannot directly charge users for installation or include ads but can integrate with external billing systems.\u003c/p\u003e\n"],["\u003cp\u003eAdd-on functionality is limited in terms of event detection and contextual triggering within certain Google Workspace apps.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Workspace add-ons use a card-based interface system, rather than traditional HTML, CSS, or client-side scripting.\u003c/p\u003e\n"],["\u003cp\u003eWhile add-ons are largely desktop-focused, some contextual triggering is supported within the Gmail mobile app.\u003c/p\u003e\n"]]],["Add-ons are restricted from altering Google Workspace features, charging users for installation, or detecting user actions outside the add-on. Google Workspace add-ons are limited to Gmail, Calendar, Drive, Meet, Docs, Sheets, and Slides, and must use card-based interfaces, not HTML/CSS. They cannot access document context in editors or utilize Apps Script triggers. Additionally, SVG images and exceeding 100 widgets per card are prohibited. Full mobile support is also unavailable, and only desktop web clients are supported.\n"],null,["# Restrictions\n\nThere are a few restrictions on what add-ons can do. Improve your users'\noverall experience by avoiding these pitfalls.\n\nGeneral restrictions\n--------------------\n\nThe following restrictions apply to all add-ons. Don't do the following:\n\n### Change features in Google Workspace\n\nThe add-ons framework is designed to enhance\nGoogle Workspace applications---not to\nadd limits. Consequently, you can't alter existing features or lock down the\nGoogle Workspace document sharing model.\n\n### Charge users to install\n\nWe don't provide a way to charge users for installing add-ons, and add-ons\n[can't include ads](/apps-script/terms). However, you can roll your own payment\nsystem or call into an existing billing database. Your add-on can connect to\nnon-Google services that bill users.\n\n### Detect many events\n\nExcept for [certain triggers](/workspace/add-ons/concepts/triggers), add-ons can't\ntell what a user does outside the add-on itself. For example, you can't detect\nwhen the user clicks on the host application toolbar. It is possible to poll for\nchanges in a file's contents from a sidebar's client-side code, although\nyou'll always have a slight delay.\n\nGoogle Workspace add-ons\n------------------------\n\nThe following restrictions only apply to\nGoogle Workspace add-ons and the use of the\n[Card service](/apps-script/reference/card-service/card-service). Don't do the following:\n\n### Extend all Google Workspace apps\n\nGoogle Workspace add-ons can only extend Gmail,\nCalendar, Drive, Meet, Docs, Sheets, and Slides. Eventually Google Workspace add-ons will be able to extend other Google Workspace\napplications.\n\n### Document context in editors\n\nGoogle Workspace add-ons don't yet support the use of\ndocument context in editors. That is, you can't use methods such as\n[`SpreadsheetApp.getActiveSpreadsheet()`](/apps-script/reference/spreadsheet/spreadsheet-app#getactivespreadsheet)\nto acquire the current document.\n\n### Use HTML/CSS or client-side scripting\n\nGoogle Workspace add-ons must use card-based\ninterfaces. The HTML/CSS interfaces supported by Editor add-ons can't be used.\nGoogle Workspace add-ons use a\n[widget-based](/workspace/add-ons/concepts/widgets) approach to building user\ninterfaces. This lets the add-on work well on desktop and mobile platforms\nwithout requiring you to build an interface for each.\n\n### Full mobile support\n\nFor the time being, Google Workspace add-ons function\non desktop web clients. Contextual triggering (that is, Gmail message reading)\nis also supported from within the Gmail mobile app. Non-contextual homepages\nare not yet available from the Gmail, Calendar, or Drive mobile apps.\nGoogle Workspace add-ons are not\navailable from mobile web browsers.\n\n### Use Apps Script triggers\n\nYou can't create or use Apps Script\n[simple triggers](/apps-script/guides/triggers) in a\nGoogle Workspace add-on.\n\n### Use SVG Images\n\nYou can't currently use SVG images with\n[Card service](/apps-script/reference/card-service/card-service) cards and widgets.\n\n### Have more than 100 widgets\n\nFor performance reasons, you can't add more than 100 widgets or 100 card\nsections to a card."]]
