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. getUi
zezwala 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.