Skrypt jest powiązany z plikiem Arkuszy, Dokumentów, Prezentacji lub Formularzy Google, jeśli został utworzony w tym dokumencie, a nie jako skrypt autonomiczny. Plik, do którego jest dołączony skrypt powiązany, nazywa się „kontenerem”. Skrypty powiązane działają zwykle jak skrypty samodzielne, z tym wyjątkiem, że nie są widoczne na Dysku Google, nie można ich odłączyć od pliku, z którym są powiązane, i mają pewne specjalne uprawnienia w stosunku do pliku nadrzędnego.
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 również mogą stać się aplikacjami internetowymi, choć jest to rzadkie.
Tworzenie skryptu powiązanego
Dokumenty, Arkusze lub Prezentacje Google
Aby utworzyć skrypt powiązany w Dokumentach, Arkuszach lub Prezentacjach Google, otwórz dokument w Dokumentach, arkusz kalkulacyjny w Arkuszach lub prezentację w Prezentacjach i kliknij Rozszerzenia > Apps Script. Aby ponownie otworzyć skrypt w przyszłości, wykonaj te same czynności lub otwórz skrypt z panelu Apps Script.
Formularze Google
Aby utworzyć skrypt powiązany 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 go na panelu Apps Script.
Metody specjalne
Skrypty powiązane mogą wywoływać kilka metod, których nie mogą wywoływać skrypty samodzielne:
getActiveSpreadsheet(),getActiveDocument(),getActivePresentation(), igetActiveForm()umożliwiają skryptom powiązanym odwoływanie się do pliku nadrzędnego bez podawania identyfikatora pliku.getUiumożliwia skryptom powiązanym dostęp do interfejsu użytkownika 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 wybranej komórki.setActiveSheet(sheet)isetActiveRange(range)umożliwiają skryptowi zmianę tych wyborów. - W Dokumentach Google
getActiveTab(),getCursor()igetSelection()umożliwiają skryptowi określenie bieżącej karty użytkownika, położenia kursora lub zaznaczonego tekstu.setActiveTab(tabId),setCursor(position)isetSelection(range)umożliwiają skryptowi zmianę tych wyborów.
Więcej informacji znajdziesz w przewodniku po rozszerzaniu Arkuszy Google lub przewodniku po rozszerzaniu Dokumentów Google.
Menu, okna i paski boczne
Skrypty powiązane mogą dostosowywać Arkusze, Dokumenty i Formularze Google, dodając niestandardowe menu oraz okna dialogowe lub paski boczne. Pamiętaj jednak, że skrypt może wchodzić w interakcje z interfejsem użytkownika 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.
Reguły
Skrypty powiązane mogą używać prostych wyzwalaczy, takich jak specjalna funkcja onOpen(), która jest uruchamiana automatycznie za każdym razem, gdy plik zostanie otwarty przez użytkownika z uprawnieniami do edycji. Podobnie jak wszystkie typy skryptów mogą one też używać instalowanych wyzwalaczy.
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ą podobne do setek wbudowanych funkcji w Arkuszach, takich jak AVERAGE czy SUM, z tym że to Ty określasz ich działanie.
Dostęp do skryptów powiązanych
Skrypt powiązany z kontenerem mogą uruchamiać tylko użytkownicy, którzy mają uprawnienia do edytowania tego kontenera. Współpracownicy, którzy mają tylko uprawnienia do wyświetlania, nie mogą otworzyć edytora skryptów, ale jeśli utworzą kopię pliku kontenera, staną się właścicielami kopii i będą mogli wyświetlać i uruchamiać kopię skryptu.
Aby dowiedzieć się, jak udostępnić plik kontenera skryptu, przeczytaj artykuł Udostępnianie plików z Dysku Google.