Skrypt jest powiązany z plikiem Arkuszy, Dokumentów, Prezentacji lub Formularzy Google, jeśli został utworzony z tego dokumentu, a nie jako samodzielny skrypt. Plik, do którego jest dołączony skrypt powiązany, jest nazywany „kontenerem”. Skrypty z limitem zwykle działają jak samodzielne skrypty, ale nie występują na Dysku Google. Nie można ich też odłączyć od pliku, który są powiązane, i uzyskać kilka specjalnych uprawnień zamiast pliku nadrzędnego.
Skrypty mogą być również powiązane z Witrynami Google, ale prawie zawsze są wdrażane jako aplikacje internetowe. Skrypty powiązane z Arkuszami Google, Dokumentami, Prezentacjami i Formularzami mogą też stać się aplikacjami internetowymi, choć nie zdarza się to często.
Tworzenie skryptu powiązanego
Dokumenty, Arkusze lub Prezentacje Google
Aby utworzyć powiązany skrypt w Dokumentach, Arkuszach lub Prezentacjach Google, otwórz plik w Dokumentach, arkuszu kalkulacyjnym lub prezentacji w Prezentacjach i kliknij Rozszerzenia > Apps Script. Aby ponownie otworzyć skrypt w przyszłości, zrób to samo lub otwórz go z poziomu panelu Apps Script.
Formularze Google
Aby utworzyć powiązany skrypt w Formularzach Google, otwórz formularz i kliknij Więcej > Edytor skryptów. Aby ponownie otworzyć skrypt w przyszłości, wykonaj te same czynności lub otwórz skrypt z panelu Apps Script.
Metody specjalne
Skrypty zależne mogą wywoływać kilka metod, których nie obsługują:
getActiveSpreadsheet()
,getActiveDocument()
,getActivePresentation()
igetActiveForm()
umożliwiają odniesienia się do pliku nadrzędnego bez określania 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()
umożliwiają skryptowi określenie bieżącego arkusza użytkownika, wybranego zakresu komórek lub pojedynczej komórki.setActiveSheet(sheet)
isetActiveRange(range)
pozwolą zmienić skrypt. - W Dokumentach Google
getCursor()
igetSelection()
umożliwiają skryptowi określenie pozycji kursora użytkownika lub zaznaczonego tekstu.setCursor(position)
isetSelection(range)
umożliwiają skryptowi zmianę tych lokalizacji.
Więcej informacji znajdziesz w przewodniku dotyczącym rozszerzania Arkuszy Google lub w przewodniku dotyczącym rozszerzania Dokumentów Google.
Niestandardowe menu, okna dialogowe i paski boczne
Skrypty powiązane mogą dostosowywać Arkusze Google, Dokumenty i Formularze, dodając menu niestandardowe i okna dialogowe lub paski boczne. Pamiętaj jednak, że skrypt może korzystać z interfejsu tylko w 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 własny skrypt lub jest on samodzielny i chcesz go udostępnić całemu światu, możesz go opublikować jako dodatek, by inni użytkownicy mogli go zainstalować ze sklepu z dodatkami.
Aktywatory
Skrypty z ograniczonym dostępem mogą używać prostych reguł, takich jak specjalna funkcja onOpen()
, która uruchamia się automatycznie za każdym razem, gdy użytkownik otworzy plik. Podobnie jak wszystkie rodzaje skryptów mogą też korzystać z instalacyjnych reguł.
Funkcje niestandardowe
Funkcja niestandardowa to funkcja w skrypcie powiązana z Arkuszami Google, która jest wywoływana bezpośrednio z komórki za pomocą składni =myFunctionName()
. Funkcje niestandardowe są więc podobne do setek wbudowanych funkcji w Arkuszach, takich jak AVERAGE
czy SUM
, z tą różnicą, że definiujesz działanie funkcji niestandardowej.
Dostęp do powiązanych skryptów
Tylko użytkownicy z uprawnieniami do edycji kontenera mogą uruchamiać powiązany skrypt. Współpracownicy, którzy mają dostęp tylko do wyświetlania, nie mogą otworzyć edytora skryptów, ale jeśli wykonają kopię pliku kontenera, stają się jego właścicielem i będą mogli zobaczyć oraz uruchomić kopię skryptu.
Aby dowiedzieć się, jak udostępnić plik kontenera skryptu, przeczytaj artykuł Udostępnianie plików na Dysku Google.