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 powiązane zwykle działają jak samodzielne skrypty, z tą różnicą, że 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ń do pliku nadrzędnego.
Pamiętaj, że skrypty też mogą być powiązane z Witrynami Google, ale te skrypty są prawie zawsze wdrażane jako aplikacje internetowe. Skrypty powiązane z Arkuszami, Dokumentami, Prezentacjami i Formularzami Google również mogą stać się aplikacjami internetowymi, choć zdarza się to rzadko.
Utwórz powiązany skrypt
pliki Dokumentów, Arkuszy i Prezentacji Google;
Aby utworzyć powiązany skrypt w Dokumentach, Arkuszach lub Prezentacjach Google, otwórz plik w Dokumentach, Arkuszach albo Prezentacjach Google i kliknij Rozszerzenia > Apps Script. Aby w przyszłości ponownie otworzyć skrypt, wykonaj 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, wykonaj 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ą:
- Skrypty
getActiveSpreadsheet(),getActiveDocument(),getActivePresentation()igetActiveForm()zezwalają skryptom powiązanym na odwoływanie się do pliku nadrzędnego bez odwołania do jego identyfikatora. getUizezwala powiązanych skryptom na dostęp do interfejsu pliku nadrzędnego w celu dodawania niestandardowych menu, okien i pasków bocznych.- W Arkuszach Google za pomocą poleceń
getActiveSheet(),getActiveRange()igetActiveCell()skrypt wskazuje bieżący arkusz użytkownika, wybrany zakres komórek lub wybraną komórkę. ZezwólsetActiveSheet(sheet)isetActiveRange(range)skryptowi na zmianę tych ustawień. - Zezwól na określanie pozycji kursora użytkownika lub zaznaczonego tekstu przez skrypt w Dokumentach Google
getCursor()igetSelection(). ZezwólsetCursor(position)isetSelection(range)skryptowi na zmianę tych lokalizacji.
Więcej informacji znajdziesz w przewodniku po rozszerzaniu Arkuszy Google i przewodniku po rozszerzaniu Dokumentów Google.
Niestandardowe menu, okna i paski boczne
Powiązane skrypty pozwalają dostosować Arkusze, Dokumenty i Formularze Google przez dodawanie niestandardowych menu oraz pól dialogowych i pasków bocznych. Pamiętaj jednak, że skrypt może wchodzić w interakcje z interfejsem tylko w przypadku bieżącej instancji otwartego pliku. Oznacza to, że skrypt powiązany z jednym dokumentem nie może mieć wpływu na interfejs innego dokumentu.
Dodatki
Dodatki działają w Gmailu, Arkuszach, Dokumentach, Prezentacjach i Formularzach Google. Jeśli masz powiązany lub samodzielny skrypt i chcesz go udostępnić, możesz publish go jako dodatek, aby inni użytkownicy mogli go zainstalować ze sklepu z dodatkami.
Aktywatory
Powiązane skrypty mogą korzystać z prostych aktywatorów, np. specjalnej funkcji onOpen(), która uruchamia się automatycznie za każdym razem, gdy użytkownik z uprawnieniami do edycji otworzy plik. Podobnie jak w przypadku innych typów skryptów, mogą także używać reguł z możliwością zainstalowania.
Funkcje niestandardowe
Funkcja niestandardowa to funkcja w skrypcie powiązany z Arkuszami Google, którą można wywoływać 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. Różnica polega na tym, że definiujesz sposób działania funkcji niestandardowej.
Dostęp do powiązanych skryptów
Tylko użytkownicy, którzy mają uprawnienia do edycji kontenera, mogą uruchamiać jego powiązany skrypt. Współpracownicy z uprawnieniami tylko do wyświetlania nie mogą otworzyć edytora skryptów, ale jeśli utworzą kopię pliku kontenera, stają się jej właścicielem i mogą wyświetlać i uruchamiać kopię skryptu.
Aby dowiedzieć się, jak udostępnić plik kontenera skryptu, przeczytaj artykuł Udostępnianie plików na Dysku Google.