부가기능의 기능에는 몇 가지 제한사항이 있습니다. 이러한 함정을 피하여 사용자의 전반적인 환경을 개선하세요.
일반 제한사항
다음 제한사항은 모든 부가기능에 적용됩니다. 다음 작업은 하지 마세요.
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 부가기능은 카드 기반 인터페이스를 사용해야 합니다. 편집기 부가기능에서 지원하는 HTML/CSS 인터페이스는 사용할 수 없습니다.
Google Workspace 부가기능은 위젯 기반 접근 방식을 사용하여 사용자 인터페이스를 빌드합니다. 이렇게 하면 각 플랫폼에 맞는 인터페이스를 빌드하지 않고도 데스크톱 및 모바일 플랫폼에서 부가기능이 잘 작동합니다.
전체 모바일 지원
당분간 Google Workspace 부가기능은 데스크톱 웹 클라이언트에서 작동합니다. 문맥 트리거 (예: Gmail 메일 읽기)는 Gmail 모바일 앱 내에서도 지원됩니다. 컨텍스트가 아닌 홈페이지는 아직 Gmail, Calendar, Drive 모바일 앱에서 사용할 수 없습니다.
Google Workspace 부가기능은 모바일 웹브라우저에서 사용할 수 없습니다.
Apps Script 트리거 사용하기
Google Workspace 부가기능에서는 Apps Script 간단한 트리거를 만들거나 사용할 수 없습니다.
[[["이해하기 쉬움","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(UTC)"],[[["\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."]]
