Skrypt jest powiązany z plikiem Dokumentów, Dokumentów, Prezentacji lub Formularzy Google, jeśli został utworzony na podstawie tego dokumentu, a nie jako samodzielny skrypt. Plik, do którego jest powiązany powiązany skrypt, nosi nazwę „"container." Ograniczenia do skryptów zwykle działają jak samodzielne skrypty, ale nie pojawiają się na Dysku Google, nie można ich odłączyć od pliku, z którym są powiązane, i uzyskują kilka specjalnych uprawnień względem pliku nadrzędnego.
Skrypty mogą być też powiązane z Witrynami Google, ale niemal zawsze są wdrażane jako aplikacje internetowe. Skrypty powiązane z Arkuszami, Dokumentami, Prezentacjami i Formularzami mogą też stać się aplikacjami internetowymi, co zdarza się dość 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, arkuszu kalkulacyjnym w Prezentacjach Google lub w Prezentacjach i kliknij Rozszerzenia > Apps Script. Aby w przyszłości ponownie otworzyć skrypt, wykonaj te same czynności lub otwórz skrypt z 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
Powiązane skrypty mogą wywoływać kilka metod, których nie mogą używać samodzielne skrypty:
getActiveSpreadsheet(),getActiveDocument(),getActivePresentation()igetActiveForm()umożliwiają powiązany skrypt odwoływanie się do pliku nadrzędnego bez odwołania do identyfikatora pliku.getUiumożliwia powiązanym skryptom dostęp do interfejsu pliku nadrzędnego w celu dodania 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 wybranej komórki.setActiveSheet(sheet)isetActiveRange(range)umożliwiają wybór odpowiednich skryptów. - W Dokumentach Google
getCursor()igetSelection()umożliwiają skryptowi określenie pozycji kursora użytkownika lub zaznaczonego tekstu.setCursor(position)isetSelection(range)umożliwiają skryptom zmianę tych lokalizacji.
Więcej informacji znajdziesz w przewodniku po rozszerzaniu Arkuszy Google lub w przewodniku po rozszerzeniach Dokumentów Google.
Niestandardowe menu, okna i paski boczne
Skrypty powiązane mogą dostosowywać Arkusze, Dokumenty i Formularze Google przez dodanie niestandardowych menu i oknach bocznych lub pasków bocznych. Pamiętaj, że skrypt może wchodzić w interakcje z interfejsem 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 utworzony powiązany skrypt lub samodzielny skrypt, który chcesz udostępnić światu, skrypt Apps Script umożliwia opublikowanie skryptu jako dodatku, dzięki czemu inni użytkownicy będą mogli go zainstalować ze sklepu z dodatkami.
Aktywatory
Skrypty powiązane mogą używać prostych reguł, takich jak specjalna funkcja onOpen(), która uruchamia się automatycznie za każdym razem, gdy plik zostaje otwarty przez użytkownika z uprawnieniami do edycji. Tak jak w przypadku wszystkich typów skryptów, mogą one też używać reguł uruchamiających.
Funkcje niestandardowe
Funkcja niestandardowa to funkcja w skrypcie powiązanym z Arkuszami Google, którą można wywoływać bezpośrednio z komórki za pomocą składni =myFunctionName(). Dlatego funkcje niestandardowe są 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żytkownik z uprawnieniami do edytowania kontenera może uruchomić powiązany z nim skrypt. Współpracownicy, którzy mają uprawnienia tylko do wyświetlania, nie mogą otworzyć edytora skryptu, ale jeśli utworzą kopię pliku nadrzędnego, staną się właścicielem kopii i będą mogli zobaczyć i uruchomić kopię skryptu.