Skrypt jest powiązany z plikiem Arkuszy, Dokumentów, Prezentacji lub Formularzy Google, jeśli został utworzony na podstawie tego dokumentu, a nie jako samodzielny skrypt. Plik, do którego jest dołączony powiązany skrypt, jest nazywany „kontenerem”. Powiązane skrypty działają zwykle jak samodzielne skrypty, z tym że nie są widoczne na Dysku Google i nie można ich odłączyć od pliku, z którym są powiązane, oraz zyskują kilka specjalnych uprawnień nad plikiem nadrzędnym.
Pamiętaj, że skrypty można też powiązać z Witrynami Google, ale są one prawie zawsze wdrażane jako aplikacje internetowe. Skrypty powiązane z Arkuszami, Dokumentami, Prezentacjami lub Formularzami Google też mogą stać się aplikacjami internetowymi, choć zdarza się to rzadko.
Utwórz powiązany skrypt
Dokumenty, Arkusze lub Prezentacje Google
Aby utworzyć powiązany skrypt w Dokumentach, Arkuszach lub Prezentacjach Google, otwórz plik w Dokumentach, Arkuszach lub Prezentacjach Google i kliknij Rozszerzenia > Apps Script. Aby ponownie otworzyć skrypt w przyszłości, zrób to samo lub otwórz skrypt w panelu Apps Script.
Formularze Google
Aby utworzyć powiązany skrypt w Formularzach Google, otwórz formularz i kliknij Więcej > Edytor skryptów. Aby w przyszłości ponownie otworzyć skrypt, zrób to samo lub otwórz skrypt w panelu Apps Script.
Metody specjalne
Powiązane skrypty mogą wywoływać kilka metod, których samodzielne skrypty nie mogą:
getActiveSpreadsheet()
,getActiveDocument()
,getActivePresentation()
igetActiveForm()
zezwalają powiązane skryptom na odwoływanie się do pliku nadrzędnego bez podawania identyfikatora pliku.getUi
umożliwia powiązanym skryptom dostęp do interfejsu pliku nadrzędnego w celu dodawania niestandardowych menu, okien i pasków bocznych.- W Arkuszach Google
getActiveSheet()
,getActiveRange()
igetActiveCell()
skrypt może określić bieżący arkusz użytkownika, wybrany zakres komórek lub wybraną komórkę.setActiveSheet(sheet)
isetActiveRange(range)
pozwalają skryptowi zmieniać te wybory. - W Dokumentach Google
getCursor()
igetSelection()
pozwalają skryptowi określić położenie kursora użytkownika lub zaznaczonego tekstu.setCursor(position)
isetSelection(range)
zezwól skryptowi na zmianę tych lokalizacji.
Więcej informacji znajdziesz w przewodniku po rozszerzaniu plików Arkuszy Google lub w przewodniku po rozszerzaniu plików Dokumentów Google.
Niestandardowe menu, okna i paski boczne
Powiązane skrypty mogą dostosowywać Arkusze, Dokumenty i Formularze Google, dodając menu niestandardowe oraz pola okienne i paski boczne. Pamiętaj jednak, że skrypt może współdziałać z interfejsem tylko w przypadku bieżącej instancji otwartego pliku. Oznacza to, że skrypt powiązany z jednym dokumentem nie może wpływać na interfejs innego dokumentu.
Dodatki
Dodatki działają w Gmailu, Arkuszach, Dokumentach, Prezentacjach i Formularzach Google. Jeśli masz już przygotowany lub samodzielny skrypt i chcesz go udostępnić całemu światu, możesz publish go jako dodatek, dzięki czemu inni użytkownicy będą mogli go zainstalować ze sklepu z dodatkami.
Aktywatory
Powiązane skrypty mogą używać prostych reguł, np. specjalnej funkcji onOpen()
, która uruchamia się automatycznie, gdy użytkownik z uprawnieniami do edycji otwiera plik. Tak jak wszystkie rodzaje skryptów, mogą one też używać reguł możliwych do zainstalowania.
Funkcje niestandardowe
Funkcja niestandardowa to funkcja w skrypcie powiązanym z Arkuszami Google, którą wywołujesz bezpośrednio z komórki za pomocą składni =myFunctionName()
. Funkcje niestandardowe są więc podobne do setek funkcji wbudowanych w Arkuszach, takich jak AVERAGE
czy SUM
, z wyjątkiem tego, że zdefiniujesz ich działanie.
Dostęp do powiązanych skryptów
Tylko użytkownicy z uprawnieniami do edytowania kontenera mogą uruchamiać powiązany z nim skrypt. Współpracownicy, którzy mają uprawnienia tylko do wyświetlania, nie mogą otworzyć edytora skryptów, ale jeśli utworzą kopię pliku kontenera, stają się jego właścicielem oraz mogą wyświetlać i uruchamiać kopię skryptu.
Informacje o tym, jak udostępnić plik kontenera skryptu, znajdziesz w artykule Udostępnianie plików na Dysku Google.