이 페이지에서는 Google Workspace 부가기능과 Editor 부가기능이라는 두 가지 유형의 부가기능을 간략하게 설명합니다. 이러한 부가기능 유형은 확장하는 애플리케이션, 생성 방법, 제한사항이 서로 다릅니다.
Google Workspace 부가기능
Google Workspace 부가기능은 최신 세대의 부가기능으로, 다음과 같은 다양한 기능을 제공합니다.
여러 Google Workspace 앱용 부가기능 하나만 빌드: 각 Google Workspace 애플리케이션용 부가기능을 별도로 만드는 대신 Google Workspace 전반에서 작동하는 단일 Google Workspace 부가기능을 빌드하고 관리할 수 있습니다.
Google Workspace 부가기능은 다음 호스트 애플리케이션을 확장할 수 있습니다.
Gmail
Google Calendar
Google Chat (개발자 프리뷰)
Google Docs
Google Drive
Google Meet
Google Sheets
Google Slides
브랜드 인지도 향상: 부가기능 아이콘은 기본적으로 부가기능의 호스트 앱 오른쪽 패널에 표시됩니다.
홈페이지 환경 빌드: 부가기능이 확장하는 각 Google Workspace 앱에 대해 개별 홈페이지를 만들거나 여러 앱에 동일한 홈페이지를 사용할 수 있습니다.
부가기능에 사용자 컨텍스트 반영: 부가기능의 호스트 앱에 특정한 인터페이스를 표시하도록 Google Workspace 부가기능을 설계할 수 있습니다. 예를 들어 부가기능은 이메일 또는 일정 이벤트의 정보를 표시하거나 현재 Google Workspace 앱 페이지에 따라 작업을 제안할 수 있습니다.
표준화된 인터페이스 사용: Apps Script Card 서비스에서 제공하는 내장 위젯 요소로 사용자 인터페이스를 구성합니다. 이러한 인터페이스를 정의하는 데 HTML이나 CSS에 대한 전문 지식이 필요하지 않습니다.
Gmail용 데스크톱 및 모바일 클라이언트 확장: Google Workspace 부가기능이 Gmail을 확장하는 경우 Gmail의 데스크톱 및 모바일 버전에서 모두 사용할 수 있습니다. Gmail을 확장하는 Google Workspace 부가기능을 빌드하는 경우 부가기능의 별도 모바일 버전을 설계할 필요가 없습니다. 동일한 인터페이스가 어디에서나 사용됩니다.
원하는 런타임을 사용합니다. 선호하는 호스팅 인프라, 개발 도구 체인, 소스 관리 시스템, 코딩 언어, 코드 라이브러리를 사용하여 Google Workspace 부가기능을 개발할 수 있습니다.
편집자 부가기능
편집기 부가기능은 Docs, Sheets, Slides, Forms와 같은 Google 편집기 애플리케이션 중 하나를 확장합니다. 각 편집기 부가기능 유형 (예: Sheets 부가기능)에는 유형별 기능, 제한사항, 특별 고려사항이 있을 수 있습니다. Editor 부가기능을 빌드할 때는 이러한 Editor 관련 세부정보를 이해하는 것이 중요합니다. 특정 편집기의 부가기능에 대한 자세한 내용은 해당 섹션을 참고하세요.
편집기 부가기능은 파일 생성, 편집, 서식 지정, 애플리케이션 간 데이터 이동과 같은 일반적인 편집기 작업을 자동화할 수 있습니다.
편집기 부가기능 인터페이스는 현재 작업에 맞게 맞춤설정할 수 있습니다.
편집기 부가기능은 개인 또는 내부용으로 Google 문서, Sheets, Slides 또는 Forms 내에서 작업을 자동화하는 데 적합합니다. 많은 사용자를 처리해야 하거나, 지연 시간이 짧아야 하거나, 인프라를 완전히 제어해야 하는 대규모 기능이 필요한 부가기능의 경우 인프라, 배포, 출시 프로세스를 더 잘 제어할 수 있도록 다른 런타임 환경에서 Google Workspace 부가기능을 빌드하는 것이 좋습니다.
편집기 부가기능은 다음과 같은 방식으로 Google Workspace 부가기능과 다르게 작동합니다.
편집기 부가기능은 메뉴 항목, 대화상자, 사이드바로 구성된 인터페이스를 만들 수 있습니다. 부가기능 대화상자와 사이드바는 표준 HTML 및 CSS를 사용하여 정의됩니다.
편집기 부가기능은 Google Drive 내에서 파일을 생성하거나 수정하거나 파일과 상호작용하므로 특별한 승인 규칙이 있습니다. 편집자 부가기능을 개발하는 동안 편집자 부가기능 승인을 이해하는 것이 중요합니다.
각 편집기에서 생성되고 업데이트된 파일에는 특정 구조가 있습니다. 예를 들어 Google Slides 프레젠테이션은 슬라이드, 마스터 또는 레이아웃이 될 수 있는 페이지로 구성됩니다. 파일을 읽거나 수정할 때 부가기능이 이러한 파일 구조와 상호작용하는 경우가 많으므로 이러한 파일 구조를 이해해야 합니다.
[[["이해하기 쉬움","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-08-26(UTC)"],[[["\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."]]