Arkusze Google to działające w chmurze rozwiązanie do obsługi arkuszy kalkulacyjnych, które umożliwia współpracę w czasie rzeczywistym i zawiera zaawansowane narzędzia do wizualizacji, przetwarzania i przekazywania danych.
Możesz rozszerzyć funkcjonalność Arkuszy za pomocą dodatków, które umożliwiają dostosowywanie przepływów pracy, nawiązywanie połączeń z systemami innych firm i integrowanie danych z Arkuszy z innymi aplikacjami Google Workspace (np. Prezentacjami Google).
Dodatki do Arkuszy utworzone przez innych użytkowników możesz zobaczyć w Google Workspace Marketplace.
Co możesz zrobić
Oto kilka rzeczy, które możesz zrobić za pomocą dodatku rozszerzającego Arkusze Google:
- Możesz odczytywać, edytować, wizualizować i formatować dane w arkuszach kalkulacyjnych Google za pomocą wbudowanej usługi Arkusze Apps Script. Usługa umożliwia też tworzenie i modyfikowanie reguł formatowania warunkowego i weryfikacji danych.
- Możesz użyć zaawansowanej usługi Arkuszy Apps Script, aby uzyskać bezpośredni dostęp do interfejsu Google Sheets API.
- Możesz tworzyć menu niestandardowe i definiować wiele niestandardowych okien i pasków bocznych za pomocą standardowego kodu HTML i CSS.
- W dodatku możesz umieścić definicje funkcji niestandardowych.
- Możesz używać wyzwalaczy dodatków, które uruchamiają określone funkcje, gdy wystąpią pewne zdarzenia wywołujące.
Dodatki do Arkuszy są tworzone za pomocą Apps Script. Więcej informacji o tym, jak uzyskiwać dostęp do Arkuszy Google i zarządzać nimi za pomocą Apps Script, znajdziesz w artykule Rozszerzanie Arkuszy Google.
Struktura arkusza
Arkusz kalkulacyjny w Arkuszach Google składa się z co najmniej 1 arkusza. Każdy arkusz to w zasadzie dwuwymiarowa siatka komórek, w których można przechowywać tekst, liczby, linki i inne wartości. Grupa co najmniej 1 sąsiadującej komórki to zakres.
Usługa Arkuszy w Apps Script udostępnia kilka klas do reprezentowania struktur organizacyjnych w Arkuszach (np. Sheet i Range). Możesz używać tych klas do odczytywania i modyfikowania danych oraz zachowań Arkuszy.
Reguły
Wyzwalacze Apps Script umożliwiają uruchamianie określonej funkcji w projekcie skryptu po spełnieniu określonych warunków, np. po otwarciu arkusza kalkulacyjnego lub zainstalowaniu dodatku.
Więcej informacji o tym, jakich wyzwalaczy można używać w dodatkach do Arkuszy i jakie ograniczenia obowiązują w przypadku ich używania, znajdziesz w artykule Wyzwalacze 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 wbudowane funkcje. Gdy użytkownik zainstaluje dodatek, wszystkie zdefiniowane funkcje niestandardowe dołączone do dodatku staną się od razu dostępne. Dodatek może składać się tylko z definicji funkcji niestandardowych. Definicje funkcji niestandardowych są udostępniane innym osobom głównie przez opublikowanie dodatku zawierającego te definicje.
Tworzenie funkcji niestandardowych dodatku
Każda funkcja zdefiniowana w projekcie skryptu dodatku może być używana jako funkcja niestandardowa. Gdy funkcja zostanie zaimplementowana, a dodatek zainstalowany, możesz wywołać funkcję niestandardową tak samo jak każdą inną wbudowaną funkcję Arkuszy: w komórce arkusza wpisz =, a następnie nazwę funkcji i wymagane parametry. Jeśli nie ma błędów, wynik zwrócony przez funkcję jest umieszczany w komórce arkusza i w razie potrzeby rozlewa się na sąsiednie komórki.
Podczas tworzenia funkcji niestandardowych w dodatku należy postępować zgodnie z ogólnymi wytycznymi dotyczącymi funkcji niestandardowych:
- Wytyczne dotyczące nazewnictwa funkcji
- Określanie argumentów funkcji
- Określanie wartości zwracanej przez funkcję
- Typy danych funkcji niestandardowych
- Włączanie autouzupełniania za pomocą JSDoc
- Usługi, w których można używać funkcji niestandardowych
- Optymalizowanie funkcji niestandardowych
Dodatkowo w przypadku funkcji niestandardowych zdefiniowanych w dodatkach obowiązują pewne specjalne zasady:
- Podczas nadawania nazwy funkcji staraj się utworzyć unikalną nazwę, być może powiązaną 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 udostępnia. Pamiętaj, aby podać dokładne komentarze JSDoc do funkcji niestandardowych, aby Apps Script mógł wyświetlać użytkownikowi informacje o autouzupełnianiu. Dodatkowo możesz udostępnić dodatkową dokumentację funkcji niestandardowych w samym dodatku lub na stronie pomocy dotyczącej dodatku.
- Funkcje niestandardowe, które nie zostaną wykonane w ciągu 30 sekund, zwracają błąd
Internal error executing the custom function. Zadbaj o dobre wrażenia użytkowników, ograniczając ilość przetwarzania w funkcji niestandardowej. Optymalizuj funkcję w miarę możliwości. - Funkcje niestandardowe nie mogą używać usług Apps Script, które wymagają autoryzacji, i w przypadku próby użycia takich usług zwracają 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 powoduje oddzielne wywołanie serwerów Apps Script. Jeśli użytkownik spróbuje użyć funkcji niestandardowych w zbyt wielu komórkach, funkcje mogą działać wolno. Aby temu zapobiec, staraj się, aby funkcje niestandardowe były jak najprostsze. Jeśli funkcja ma wykonywać złożone lub rozbudowane przetwarzanie, nie używaj funkcji niestandardowej. Zamiast tego udostępnij tę funkcję za pomocą elementu menu, okna dialogowego lub interakcji na pasku bocznym.
Makra Arkuszy
Makra umożliwiają rejestrowanie działań wykonywanych w Arkuszach Google i powtarzanie ich później za pomocą skrótu klawiszowego. Gdy w arkuszu zostanie utworzone makro, zostanie ono dodane jako funkcja makra w projekcie Apps Script powiązanym z tym arkuszem. Więcej informacji o makrach znajdziesz w artykule Makra w Arkuszach Google.
Niestety makr Arkuszy nie można rozpowszechniać z dodatkami. Jeśli w pliku manifestu dodatku umieścisz definicję makra, będzie ona niedostępna dla użytkowników tego dodatku.