Rozszerzanie Arkuszy Google o dodatki

Arkusze Google to działające w chmurze rozwiązanie do obsługi arkuszy kalkulacyjnych, które udostępnia współpracę w czasie rzeczywistym i zaawansowane narzędzia do wizualizowania, przetwarzania i przekazywania danych.

Możesz rozszerzyć Arkusze za pomocą dodatków, które pozwalają tworzyć niestandardowe usprawnienia przepływu pracy, łączyć się 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 w Google Workspace Marketplace.

Co można zrobić

Oto kilka przykładów tego, co możesz zrobić przy użyciu dodatku, który rozszerza Arkusze Google:

Dodatki do Arkuszy tworzy się 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 o rozszerzaniu Arkuszy Google.

Struktura arkusza

Arkusz kalkulacyjny Google składa się z jednego lub kilku arkuszy. Każdy arkusz jest zasadniczo 2D siatką komórek, w której można przechowywać tekst, liczby, linki i inne wartości. Grupa, która składa się z co najmniej jednej sąsiedniej komórki, jest nazywana zakresem.

Usługa arkusza kalkulacyjnego Apps Script udostępnia kilka klas do reprezentowania struktur organizacyjnych w Arkuszach (np. Sheet i Range). Możesz ich używać do odczytywania i modyfikowania danych oraz działania Arkuszy.

Aktywatory

Wyzwalacze Apps Script umożliwiają projektowi skryptu wykonanie określonej funkcji po spełnieniu określonych warunków, np. po otwarciu arkusza kalkulacyjnego lub zainstalowaniu dodatku.

Więcej informacji o regułach, których można używać z dodatkami do Arkuszy, oraz o ograniczeniach związanych z ich użyciem znajdziesz w artykule o regułach dodatków.

Funkcje niestandardowe

Arkusze Google mają wiele wbudowanych funkcji, takich jak SUM i AVERAGE, które można wywołać z komórki arkusza Google. Dodatki do Arkuszy mogą definiować dodatkowe funkcje niestandardowe, które uzupełniają te funkcje wbudowane. Gdy użytkownik zainstaluje dodatek, wszystkie zdefiniowane w nim funkcje niestandardowe staną się od razu dostępne. Dodatek może się składać tylko z definicji funkcji niestandardowych. Definicje funkcji niestandardowych są głównie udostępniane innym poprzez publikowanie dodatku zawierającego definicje.

Tworzenie niestandardowych funkcji dodatków

Każda funkcja zdefiniowana w projekcie skryptu dodatkowego 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 następnie nazwę funkcji i dowolne wymagane parametry. Jeśli nie ma błędów, wynik zwrócony przez funkcję jest umieszczany w komórce arkusza i przechodzi do sąsiednich komórek, jeśli to konieczne.

Podczas tworzenia funkcji niestandardowych w dodatku musisz przestrzegać ogólnych wskazówek dotyczących funkcji niestandardowych:

Poza tym niestandardowe funkcje zdefiniowane w dodatkach mają kilka szczególnych uwarunkowań:

  • Nadając nazwę funkcji, utwórz unikalną nazwę, która może być związana z nazwą dodatku. Jeśli co najmniej dwa zainstalowane dodatki definiują funkcje niestandardowe o tej samej nazwie, użytkownicy mogą używać tylko jednej z nich.
  • Dodatek powinien wyraźnie informować o dostępnych funkcjach niestandardowych. Pamiętaj, aby dodać dokładne komentarze w pliku JSDoc do funkcji niestandardowych, tak aby aplikacja Apps Script mogła przedstawiać użytkownikowi informacje dotyczące autouzupełniania. Możesz też dołączyć dodatkową dokumentację funkcji niestandardowych w samym dodatku lub na jego stronie internetowej.
  • W przypadku funkcji niestandardowych, które nie zostaną wykonane w ciągu mniej niż 30 sekund, pojawi się błąd Internal error executing the custom function. Aby zadbać o wygodę użytkowników, ogranicz ilość przetwarzania wykonywanego w funkcji niestandardowej. W miarę możliwości zoptymalizuj funkcję.
  • Funkcje niestandardowe nie mogą używać usług Apps Script, które wymagają autoryzacji, i w przypadku próby tej próby błąd You do not have permission to call X service kończy się niepowodzeniem. W funkcji niestandardowej używaj tylko dozwolonych usług.
  • Każda funkcja niestandardowa w arkuszu powoduje osobne wywołanie serwerów Apps Script. Jeśli użytkownik spróbuje użyć niestandardowych funkcji w zbyt wielu komórkach, ich wykonywanie może być powolne. Aby temu zapobiec, postaraj się, aby funkcje niestandardowe były jak najprostsze. Jeśli chcesz, aby funkcja działała złożonego lub rozszerzonego przetwarzania, nie używaj niestandardowej funkcji – udostępnij ją za pomocą pozycji menu, okna lub interakcji z paskiem bocznym.

Makra Arkuszy

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

Makra Arkuszy nie można rozpowszechniać z dodatkami. Jeśli uwzględnisz definicję makra w pliku manifestu dodatku, będzie ona niedostępna dla jego użytkowników.