Rozszerzanie Arkuszy Google o dodatki

Arkusze Google to usługa działająca w chmurze arkuszy kalkulacyjnych z zaawansowanymi narzędziami do współpracy w czasie rzeczywistym wizualizować, przetwarzać i przekazywać dane.

Możesz rozszerzyć możliwości Arkuszy za pomocą dodatków, które pozwalają tworzyć własne ulepszenia przepływu pracy, nawiązywać połączenia z systemami innych firm i integrować dane z Arkuszy. z innymi aplikacjami Google Workspace (takimi jak Prezentacje Google).

Możesz zobaczyć dodatki do Arkuszy utworzone przez innych użytkowników na Google Workspace Marketplace

Co możesz zrobić

Oto kilka rzeczy, które możesz zrobić dzięki dodatkowi, który rozszerza możliwości Arkuszy Google:

Dodatki do Arkuszy tworzy się za pomocą Apps Script. Aby dowiedzieć się, jak uzyskać dostęp i zarządzać Arkuszami Google za pomocą Apps Script, patrz Przedłużanie dostępu do Arkuszy Google.

Struktura arkusza

Arkusz kalkulacyjny Arkuszy Google składa się z jednego lub wielu arkuszy. Każdy arkusz jest to siatka 2D komórek, w której tekst, liczby, linki . Grupa jednej lub kilku sąsiednich komórek jest nazywana zakres.

Apps Script – usługa Arkuszy Google udostępnia kilka klas reprezentujących struktury organizacyjne w Arkuszach (takie jak Sheet i Range). Możesz użyć tych klas do odczytywania i modyfikowania danych oraz zachowania Arkuszy.

Reguły

Reguły Apps Script umożliwiają projekt skryptu i wykonuje określoną funkcję, gdy są spełnione określone warunki, na przykład jest otwarty arkusz kalkulacyjny lub zainstalowany dodatek.

Więcej informacji znajdziesz w artykule dotyczącym aktywatorów dodatkowych. które reguły mogą być używane z dodatkami do Arkuszy i jakie obowiązują ograniczenia. ich wykorzystanie.

Funkcje niestandardowe

Arkusze Google zawierają wiele funkcji wbudowane funkcje takie jak SUM i AVERAGE, które można wywołać z komórki Arkuszy Google. Dodatki do Arkuszy mogą definiować dodatkowe funkcje niestandardowe, które uzupełniają te z wbudowanymi funkcjami. Gdy użytkownik instaluje dodatek, dowolne zdefiniowane w nim funkcje niestandardowe, będą dostępne natychmiast. Dodatek może zawierać: tylko niestandardowe definicje funkcji. Definicje funkcji niestandardowych to przede wszystkim udostępniać innym osobom, publikując dodatek z tymi definicjami.

Tworzenie niestandardowych funkcji dodatkowych

Każdą funkcję zdefiniowaną w projekcie skryptu dodatkowego można użyć jako niestandardowej . Po zaimplementowaniu funkcji i zainstalowaniu dodatku funkcję niestandardową, tak samo jak każdą inną wbudowaną funkcję Arkuszy: Komórka arkusza, wpisz =, a po nim nazwę funkcji i wszystkie wymagane . Jeśli nie ma błędów, wynik zwrócony przez funkcję to znajduje się w komórce arkusza, ale w razie potrzeby rozszerza się do sąsiednich komórek.

Tworząc funkcje niestandardowe w dodatku, postępuj zgodnie z ogólne wytyczne dotyczące funkcji niestandardowych:

Ponadto funkcje niestandardowe zdefiniowane w dodatkach mają pewne specjalne Uwagi:

  • Nazywając funkcję, postaraj się utworzyć unikalną nazwę, która może być związana z nazwa Twojego dodatku. Jeśli co najmniej dwa zainstalowane dodatki definiują niestandardowe o tej samej nazwie, użytkownicy mogą używać tylko jednej z nich.
  • Dodatek powinien jasno informować o dostępnych niestandardowych funkcjach. Zadbaj o to, aby dodać dokładne komentarze JSDoc dla funkcji niestandardowych, Apps Script może prezentować informacje autouzupełniania, po stronie użytkownika. Rozważ też przesłanie dodatkowej dokumentacji niestandardowych funkcji w samym dodatku lub na stronie jego obsługi.
  • Funkcje niestandardowe, które nie kończą się w czasie krótszym niż 30 sekund, kończą się niepowodzeniem, Internal error executing the custom function błąd. Tworzenie dobrego użytkownika przez ograniczenie ilości przetwarzania wykonywanych w funkcji niestandardowej. Zoptymalizuj funkcję. w miarę możliwości.
  • Funkcje niestandardowe nie mogą używać usług Apps Script, które wymagają autoryzacji. i zakończy się błędem You do not have permission to call X service, jeśli podjęto próbę wprowadzenia zmian. Korzystaj tylko z dozwolone usługi w funkcji niestandardowej.
  • Każda funkcja niestandardowa w arkuszu powoduje oddzielne wywołanie do Apps Script serwerów. Jeśli użytkownik spróbuje użyć niestandardowych funkcji w zbyt wielu komórkach, funkcja mogą działać wolniej. Aby temu zaradzić, zachowaj funkcje niestandardowe jak najprostszych. Jeśli potrzebujesz funkcji do wykonywania złożonej lub rozszerzonej nie przetwarzaj danych, nie używaj niestandardowych funkcji. zamiast elementu menu, okna dialogowego lub interakcji na pasku bocznym.

Makra Arkuszy

Makra umożliwiają rejestrowanie działań w Arkuszach Google i powtórzyć je później za pomocą skrótu klawiszowego. Gdy zostanie utworzone w arkuszu, dodane jako funkcja makra w Google Apps. Projekt skryptu powiązany z tym arkuszem. Więcej o makrach, zobacz Makra Arkuszy Google.

Niestety makr Arkuszy nie można rozpowszechniać z dodatkami. Jeśli podasz definicji makra w pliku manifestu dodatku, użytkownicy tego dodatku nie będą Google Analytics.