Skrypt jest powiązany z plikiem Arkuszy, Dokumentów, Prezentacji lub Formularzy Google, jeśli został utworzona na podstawie danego dokumentu, a nie jako samodzielny skrypt. Plik, do którego jest dołączony powiązany skrypt, jest nazywany „kontenerem”. Powiązane skrypty zachowują się zwykle jak samodzielne skrypty, z tą różnicą, że nie są widoczne na Dysku Google, nie można ich odłączyć od pliku z którymi są powiązane, i zyskają kilka specjalnych uprawnień nad plikiem nadrzędnym.
Skrypty można też powiązać z Witrynami Google, ale nie są one są prawie zawsze wdrażane jako aplikacje internetowe. Skrypty powiązane z Arkuszami, Dokumentami, Prezentacjami lub Formularzami Google mogą też stać się aplikacjami internetowymi, jest to bardzo rzadkie.
Utwórz powiązany skrypt
Dokumenty, Arkusze lub Prezentacje Google
Aby utworzyć powiązany skrypt w Dokumentach, Arkuszach lub Prezentacjach Google, otwórz dokument w Dokumenty, arkusz kalkulacyjny w Arkuszach lub prezentację w Prezentacjach i kliknij Rozszerzenia > Apps Script. Aby ponownie otworzyć skrypt w przyszłości, zrób to samo lub otwórz skrypt z poziomu Panel Apps Script.
Formularze Google
Aby utworzyć powiązany skrypt w Formularzach Google, otwórz formularz i kliknij Więcej > Skrypt redaktorem. Aby ponownie otworzyć skrypt w zrobić to samo lub otworzyć skrypt z poziomu Panel Apps Script.
Metody specjalne
Powiązane skrypty mogą wywoływać kilka metod, których samodzielne skrypty nie mogą:
getActiveSpreadsheet()getActiveDocument(),getActivePresentation(), orazgetActiveForm()zezwól powiązanym skryptom na odwoływanie się do pliku nadrzędnego bez odwoływania się do identyfikator pliku.getUipozwala powiązane skrypty uzyskują dostęp do interfejsu użytkownika w celu dodania pliku nadrzędnego niestandardowe menu, okna i paski boczne.- W Arkuszach Google
getActiveSheet()getActiveRange(), igetActiveCell()pozwól skryptowi określić bieżący arkusz użytkownika, zaznaczony zakres komórek lub zaznaczoną pojedynczą komórkę.setActiveSheet(sheet)isetActiveRange(range)i pozwól skryptowi zmienić te wybory. - W Dokumentach Google
getCursor()igetSelection()pozwolić skryptowi na określenie pozycji kursora użytkownika lub zaznaczonego tekstu.setCursor(position)isetSelection(range)niech skrypt zmieni te lokalizacje.
Więcej informacji: przewodnika po rozszerzeniu Arkuszy Google lub zapoznaj się z przewodnikiem po rozszerzeniu Dokumentów Google.
Niestandardowe menu, okna i paski boczne
Skrypty powiązane mogą dostosowywać Arkusze, Dokumenty i Formularze Google przez dodanie menu niestandardowe okna dialogowe lub boki boczne. Pamiętaj: ale skrypt może wchodzić w interakcje tylko z interfejsem użytkownika w bieżącej instancji otwartego pliku. Oznacza to, że skrypt powiązany z jednym dokumentem nie może wpłynąć na interfejs innego dokumentu.
Dodatki
Dodatki działają w Gmailu, Arkuszach, Dokumentach, Prezentacje i Formularze. Jeśli masz określone granice lub samodzielnie i chcesz ją udostępnić światu, Apps Script umożliwia opublikuj skrypt jako aby inni użytkownicy mogli go zainstalować ze sklepu z dodatkami.
Reguły
Powiązane skrypty mogą używać prostych reguł
np. specjalną funkcję onOpen(), która uruchamia się automatycznie za każdym razem,
została otwarta przez użytkownika z uprawnieniami do edycji. Podobnie jak w przypadku wszystkich typów skryptów,
używasz też reguł możliwych do zainstalowania.
Funkcje niestandardowe
Funkcja niestandardowa to funkcja w atrybucie
powiązany z Arkuszami Google, który zostanie wywołany bezpośrednio z komórki za pomocą
składnię =myFunctionName(). Funkcje niestandardowe są więc podobne do setek funkcji
wbudowanych funkcji Arkuszy
jak AVERAGE lub
SUM oprócz tych określonych przez Ciebie
do zachowania funkcji niestandardowej.
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ć skryptu Google, ale jeśli utworzy kopię pliku kontenera, i może wyświetlać oraz uruchamiać kopię skryptu.
Aby dowiedzieć się, jak udostępnić plik kontenera skryptu, zapoznaj się z sekcją Udostępnianie plików z Dysk Google.