Skrypty powiązane z kontenerem

Skrypt jest powiązany z plikiem Arkuszy, Dokumentów, Prezentacji lub Formularzy Google, jeśli został utworzony na podstawie tego dokumentu, a nie jako samodzielny skrypt. Plik, do którego jest dołączony skrypt, nazywa się „kontenerem”. Scenariusze połączone działają podobnie 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ą połączone, i mają kilka specjalnych uprawnień w porównaniu z plikiem nadrzędnym.

Pamiętaj, że skrypty mogą być też powiązane z Witrynami Google, ale prawie zawsze są one wdrażane jako aplikacje internetowe. Skrypty powiązane z Arkuszami, Dokumentami, Prezentacjami lub Formularzami Google mogą też stać się aplikacjami internetowymi, choć jest to rzadkie.

Uwaga: powiązane skrypty to w istocie nieopublikowane dodatki, które działają tylko w przypadku pliku, z którym są powiązane.

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, Arkuszach lub Prezentacjach Google i kliknij Rozszerzenia > Apps Script. Aby ponownie otworzyć skrypt w przyszłości, zrób 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 ponownie otworzyć skrypt w przyszłości, wykonaj te same czynności lub otwórz go na panelu Apps Script.

Uwaga: narzędzie clasp nie może tworzyć powiązanych skryptów, ale może je klonować i edytować.

Metody specjalne

Powiązane skrypty mogą wywoływać kilka metod, których nie można wywoływać w samodzielnych skryptach:

• getActiveSpreadsheet(), getActiveDocument(), getActivePresentation() i getActiveForm() pozwalają powiązanym skryptom odwoływać się do ich pliku nadrzędnego bez podawania jego identyfikatora.
• getUi umożliwia powiązanym skryptom dostęp do interfejsu pliku nadrzędnego w celu dodawania niestandardowych menu, okien i pasków bocznych.
• W Arkuszach Google zmienne getActiveSheet(), getActiveRange() i getActiveCell() pozwalają skryptowi określić bieżący arkusz użytkownika, wybrany zakres komórek lub wybraną pojedynczą komórkę. setActiveSheet(sheet) i setActiveRange(range) pozwalają skryptowi zmienić te wybory.
• W Dokumentach Google, getActiveTab(), getCursor() i getSelection()skrypt może określać bieżącą kartę użytkownika, położenie kursora lub zaznaczony tekst. setActiveTab(tabId), setCursor(position) i setSelection(range) pozwalają skryptowi zmienić te wybory.

Więcej informacji znajdziesz w przewodniku po rozszerzaniu Arkuszy Google lub przewodniku po rozszerzaniu Dokumentów Google.

Uwaga: te metody są dostępne tylko w przypadku powiązanych skryptów uruchamianych z edytora skryptów, elementów menu, dialogów, pasków bocznych lub wyzwalaczy. Gdy powiązany skrypt jest uruchamiany jako aplikacja internetowa lub za pomocą interfejsu Apps Script API, te metody są niedostępne.

Menu, okna i paski boczne niestandardowe

Powiązane skrypty mogą dostosowywać Arkusze Google, Dokumenty i Formularze Google przez dodawanie niestandardowych menu oraz okien dialogowych lub pasków bocznych. Pamiętaj jednak, że skrypt może wejść w interakcję z interfejsem 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.

Dodatki mogą zawierać niestandardowe menu, okna i paski boczne. Zalecamy tworzenie dodatków za pomocą samodzielnych skryptów.

Dodatki

Dodatki działają w Gmailu, Arkuszach Google, Dokumentach, Prezentacjach i Formularzach. Jeśli masz połączony lub samodzielny skrypt i chcesz udostępnić go innym, możesz to zrobić za pomocą Apps Script. Możesz opublikować skrypt jako dodatek, aby inni użytkownicy mogli go zainstalować ze sklepu z dodatkami.

Reguły

Powiązane skrypty mogą używać prostych wyzwalaczy, takich jak specjalna funkcja onOpen(), która działa automatycznie za każdym razem, gdy plik otwiera użytkownik z uprawnieniami do edycji. Podobnie jak inne skrypty, 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ą więc podobne do setek wbudowanych funkcji w Arkuszach, takich jak AVERAGE czy SUM, z tą różnicą, że to Ty definiujesz działanie funkcji niestandardowej.

Dostęp do powiązanych skryptów

Tylko użytkownicy, którzy mają uprawnienia do edytowania kontenera, mogą uruchamiać powiązany skrypt. Współpracownicy, którzy mają uprawnienia tylko do wyświetlania, nie mogą otworzyć edytora skryptów, ale jeśli utworzą kopię pliku kontenera, stają się jego właścicielem oraz 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.

Wszystkie skrypty powiązane z kontenerem korzystają z tej samej listy dostępu właściciela, widza i edytującego zdefiniowanej dla pliku kontenera. Właściciel kontenera przejmuje własność nowego projektu skryptu niezależnie od tego, kto go utworzył.