Rozszerzanie Arkuszy Google o dodatki

Arkusze Google to działające w chmurze narzędzie do obsługi arkuszy kalkulacyjnych, które umożliwia współpracę w czasie rzeczywistym oraz zaawansowane narzędzia do wizualizacji, przetwarzania i komunikacji danych.

Możesz rozszerzyć Arkusze za pomocą dodatków, które poprawiają przepływ pracy, łączą się z systemami innych firm i integrują dane z Arkuszy z innymi aplikacjami Google Workspace (takimi jak Prezentacje Google).

Dodatki do Arkuszy utworzone przez innych użytkowników znajdziesz w Google Workspace Marketplace.

Co można zrobić

Oto dodatek, który pozwala dodać dodatek do Arkuszy Google:

  • Dane możesz odczytywać, edytować, wizualizować i formatować w arkuszach kalkulacyjnych w Arkuszach Google przy użyciu wbudowanej usługi Arkusze Google Apps Script. Usługa umożliwia też tworzenie i modyfikowanie reguł formatowania warunkowego i reguł weryfikacji danych.
  • Aby uzyskać bezpośredni dostęp do interfejsu Google Sheets API, możesz użyć zaawansowanej usługi Arkusze Apps Script.
  • Możesz tworzyć menu niestandardowe oraz definiować wiele własnych okien i pasków bocznych przy użyciu standardowego kodu HTML i CSS.
  • W dodatku możesz umieścić definicje funkcji niestandardowych.
  • Możesz używać dodatkowych reguł, które uruchamiają określone funkcje po wystąpieniu określonych zdarzeń.

Dodatki do Arkuszy są tworzone przy użyciu Apps Script. Więcej informacji o uzyskiwaniu dostępu do Arkuszy Google i zarządzaniu nimi za pomocą Apps Script znajdziesz w artykule Rozszerzanie Arkuszy Google.

Struktura arkusza

Arkusz kalkulacyjny Arkuszy Google składa się z co najmniej jednego arkusza. Zasadniczo każdy arkusz to siatka komórek 2D, w której można przechowywać tekst, liczby, linki i inne wartości. Grupa zawierający co najmniej 1 sąsiadująca komórkę jest nazywana zakresem.

Usługa Arkusze Google Apps Script oferuje kilka klas, które odpowiadają strukturom organizacyjnym w Arkuszach: Sheet i Range. Te klasy pozwalają odczytywać i modyfikować dane oraz działanie Arkuszy.

Aktywatory

Aktywatory Apps Script umożliwiają wykonanie skryptu zgodnie z określonymi funkcjami po spełnieniu określonych warunków, takich jak otwarcie arkusza kalkulacyjnego lub zainstalowanie dodatku.

W artykule na temat wyzwalaczy dodatków znajdziesz więcej informacji o tym, których reguł można używać z dodatkami do Arkuszy oraz jakie są ograniczenia ich użycia.

Funkcje niestandardowe

Arkusze Google mają kilka wbudowanych funkcji, takich jak SUM i AVERAGE, które można wywołać z poziomu komórki Arkuszy Google. Dodatki do Arkuszy mogą definiować dodatkowe funkcje niestandardowe, które uzupełniają te funkcje wbudowane. Gdy użytkownik zainstaluje dodatek, wszystkie zdefiniowane przez niego funkcje niestandardowe staną się dostępne od razu. Dodatek może zawierać tylko definicje funkcji niestandardowych. Definicje funkcji niestandardowych są udostępniane innym osobom, publikując dodatek zawierający definicje.

Tworzenie dodatkowych funkcji niestandardowych

Dowolna funkcja zdefiniowana w projekcie skryptu dodatku może być używana jako funkcja niestandardowa. Po zaimplementowaniu funkcji i zainstalowaniu dodatku możesz wywołać funkcję niestandardową, tak jak każdą inną wbudowaną funkcję Arkuszy: w komórce arkusza wpisz =, a potem nazwę funkcji i wszystkie wymagane parametry. Jeśli nie ma błędów, wynik zwrócony przez funkcję jest umieszczany w komórce arkusza i w razie potrzeby przechodzi do sąsiednich komórek.

Tworząc funkcje niestandardowe w dodatku, postępuj zgodnie z ogólnymi wytycznymi dotyczącymi funkcji niestandardowych:

Zwróć też uwagę na specjalne funkcje zdefiniowane w dodatkach:

  • Nazwając funkcję, spróbuj utworzyć unikalną nazwę, która może być powiązana z nazwą dodatku. Jeśli co najmniej 2 zainstalowane dodatki definiują funkcje niestandardowe o tej samej nazwie, użytkownicy mogą używać tylko jednej z nich.
  • Dodatek powinien jasno informować o tym, jakie funkcje niestandardowe są dostępne. Pamiętaj, aby podać dokładne komentarze JSDoc do funkcji niestandardowych, aby skrypt Apps Script mógł prezentować użytkownikowi informacje pochodzące z autouzupełniania. Rozważ też przedstawienie dodatkowych funkcji niestandardowych w samym dodatku lub na stronie pomocy.
  • Funkcje niestandardowe, które nie zostaną ukończone w mniej niż 30 sekund, zakończą się błędem Internal error executing the custom function. Zadbaj o dobre wrażenia użytkowników, ograniczając liczbę operacji przetwarzania wykonywanych w funkcji niestandardowej. Zoptymalizuj funkcję tam, gdzie możesz.
  • Funkcje niestandardowe nie mogą korzystać z usług Apps Script, które wymagają autoryzacji, i w razie próby wystąpi błąd You do not have permission to call X service. W funkcji niestandardowej używaj tylko dozwolonych usług.
  • Każda funkcja niestandardowa w arkuszu skutkuje osobnym wywołaniem serwerów Apps Script. Jeśli użytkownik spróbuje użyć funkcji niestandardowych w zbyt wielu komórkach, mogą one działać powoli. Aby tego uniknąć, zadbaj o to, aby Twoje funkcje niestandardowe były jak najprostsze. Jeśli potrzebujesz funkcji do wykonania złożonego lub rozszerzonego przetwarzania, nie używaj funkcji niestandardowej – zamiast tego dodaj w menu element, okno lub pasek boczny.

Makra Arkuszy

Makra umożliwiają rejestrowanie działań wykonywanych w Arkuszach Google i powtarzanie ich później za pomocą skrótu klawiszowego. Gdy makro jest tworzone w arkuszu, jest dodawane jako funkcja makra w projekcie Apps Script powiązanym z tym arkuszem. Więcej informacji o makrach znajdziesz w artykule o makrach Arkuszy Google.

Makra Arkuszy nie można rozpowszechniać za pomocą dodatków. Jeśli w pliku manifestu dodatku umieścisz definicję makra, będzie on niedostępny dla użytkowników tego dodatku.