Typy dodatków
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Na tej stronie znajdziesz ogólne informacje o 2 rodzajach dodatków, które możesz tworzyć: dodatkach do Google Workspace i dodatkach edytora. Te typy dodatków różnią się tym, jakie aplikacje rozszerzają, jak są tworzone i jakie mają ograniczenia.
Dodatki do Google Workspace
Dodatki do Google Workspace to najnowsza generacja dodatków, która oferuje wiele funkcji, w tym:
Tworzenie tylko jednego dodatku do wielu aplikacji Google Workspace: zamiast tworzyć osobne dodatki do każdej aplikacji Google Workspace możesz utworzyć jeden dodatek do Google Workspace, który będzie działać w różnych aplikacjach Google Workspace, i nim zarządzać.
Dodatek do Google Workspace może rozszerzać te aplikacje hosta:
- Gmail
- Kalendarz Google
- Google Chat (wersja przedpremierowa dla programistów)
- Dokumenty Google
- Dysk Google
- Google Meet
- Arkusze Google
- Prezentacje Google
Zwiększanie świadomości marki: ikony dodatków są domyślnie widoczne w panelu po prawej stronie aplikacji hosta dodatku.
Tworzenie stron głównych: możesz utworzyć osobne strony główne dla każdej aplikacji Google Workspace, którą rozszerza Twój dodatek, lub użyć tej samej strony głównej w przypadku wielu aplikacji.
Dostosuj dodatek do kontekstu użytkownika: możesz zaprojektować dodatek do Google Workspace tak, aby wyświetlał interfejsy specyficzne dla aplikacji hosta. Na przykład dodatek może wyświetlać informacje z e-maila lub wydarzenia w kalendarzu albo sugerować działanie na podstawie bieżącej strony aplikacji Google Workspace.
Używaj standardowych interfejsów: twórz interfejsy użytkownika z wbudowanych elementów widżetu udostępnianych przez usługę Apps ScriptCard
. Do zdefiniowania tych interfejsów nie jest potrzebna żadna wiedza na temat HTML ani CSS.
Rozszerzanie klientów Gmaila na komputery i urządzenia mobilne: jeśli dodatek do Google Workspace rozszerza Gmaila, możesz go używać zarówno w wersji Gmaila na komputery, jak i na urządzenia mobilne. Jeśli tworzysz dodatek do Google Workspace, który rozszerza Gmaila, nie musisz projektować osobnej wersji mobilnej tego dodatku. Ten sam interfejs jest używany wszędzie.
Używaj preferowanego czasu działania. Dodatki do Google Workspace możesz tworzyć za pomocą preferowanej infrastruktury hostingu, łańcucha narzędzi deweloperskich, systemu kontroli źródła, języka programowania i bibliotek kodu.
Dodatki do edytora
Dodatki do edytorów rozszerzają jedną z aplikacji edytora Google, takich jak Dokumenty, Arkusze, Prezentacje lub Formularze. Każdy typ dodatku do edytora (np. dodatki do Arkuszy) może mieć własny zestaw funkcji, ograniczeń i szczególnych kwestii. Podczas tworzenia dodatków do Edytora ważne jest, aby znać te szczegóły dotyczące Edytora. Więcej informacji o dodatkach do poszczególnych edytorów znajdziesz w odpowiednich sekcjach:
Dodatki do edytora mogą automatyzować typowe zadania edytora, takie jak tworzenie, edytowanie, formatowanie i przenoszenie danych między aplikacjami.
Interfejsy dodatków do edytora można w dużym stopniu dostosowywać do wykonywanych zadań.
Dodatki do edytora idealnie nadają się do automatyzacji zadań w Dokumentach, Arkuszach, Prezentacjach lub Formularzach Google na potrzeby indywidualne lub wewnętrzne. W przypadku dodatków wymagających funkcji na dużą skalę, które muszą obsługiwać wielu użytkowników, charakteryzować się niskim opóźnieniem lub wymagać pełnej kontroli nad infrastrukturą, rozważ utworzenie dodatków do Google Workspace w innym środowisku wykonawczym, aby mieć większą kontrolę nad infrastrukturą, wdrażaniem i procesami publikowania.
Dodatki edytora różnią się od dodatków Google Workspace w następujących aspektach:
- Dodatki do edytorów mogą tworzyć interfejsy składające się z pozycji menu, okien i pasków bocznych. Okna i paski boczne dodatków są definiowane za pomocą standardowego HTML i CSS.
- Dodatki do edytorów mają specjalne reguły autoryzacji, ponieważ tworzą, modyfikują lub w inny sposób wchodzą w interakcję z plikami na Dysku Google. Podczas tworzenia dodatku do edytora ważne jest, aby zrozumieć autoryzację dodatku do edytora.
- Pliki utworzone i zaktualizowane w każdym edytorze mają określoną strukturę. Na przykład prezentacje w Prezentacjach Google składają się ze stron, które mogą być slajdami, wzorcami lub układami. Musisz znać te struktury plików, ponieważ dodatki często wchodzą z nimi w interakcje podczas odczytywania lub edytowania plików.
- Dodatki do edytora działają tylko na komputerach, a nie na urządzeniach z Androidem ani iOS.
- Dodatki do edytora muszą być zaimplementowane w Apps Script.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-26 UTC.
[null,null,["Ostatnia aktualizacja: 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."]]