Ta strona została przetłumaczona przez Cloud Translation API.

Script Service

Ta usługa zapewnia dostęp do aktywatorów skryptów i publikowania skryptów.

Zajęcia

Nazwa	Krótki opis
`AuthMode`	Wyliczenie, które określa kategorie autoryzowanych usług, które Apps Script może wykonywać za pomocą funkcji wyzwalanej.
`AuthorizationInfo`	Obiekt, który sprawdza, czy użytkownik przyznał autoryzację w wymaganych zakresach skryptu.
`AuthorizationStatus`	Wyliczenie określające stan autoryzacji skryptu.
`CalendarTriggerBuilder`	Kreator wyzwalaczy kalendarza.
`ClockTriggerBuilder`	Kreator wyzwalaczy zegarowych.
`DocumentTriggerBuilder`	Kreator aktywatorów dokumentów.
`EventType`	Wyliczenie oznaczające typ wywołanego zdarzenia.
`FormTriggerBuilder`	Narzędzie do tworzenia aktywatorów formularzy.
`InstallationSource`	Wyliczenie wskazujące, w jaki sposób skrypt został zainstalowany jako dodatek dla bieżącego użytkownika.
`ScriptApp`	Dostęp do publikowania skryptów i aktywatorów oraz możliwość manipulowania nimi.
`Service`	Dostęp do publikowania skryptów i manipulowanie nim.
`SpreadsheetTriggerBuilder`	Kreator wyzwalaczy arkusza kalkulacyjnego.
`StateTokenBuilder`	Umożliwia skryptom tworzenie tokenów stanu, które mogą być używane w interfejsach API wywołania zwrotnego (np. w przypadku przepływów OAuth).
`Trigger`	aktywator skryptu.
`TriggerBuilder`	Ogólny konstruktor aktywatorów skryptu.
`TriggerSource`	Wyliczenie oznaczające źródło zdarzenia, które powoduje uruchomienie reguły.

`AuthMode`

Właściwości

Właściwość	Typ	Opis
`NONE`	`Enum`	Tryb, który nie zezwala na dostęp do żadnych usług wymagających autoryzacji.
`CUSTOM_FUNCTION`	`Enum`	Tryb, który umożliwia dostęp do ograniczonego podzbioru usług do użycia w funkcjach niestandardowych arkusza kalkulacyjnego.
`LIMITED`	`Enum`	Tryb, który umożliwia dostęp do ograniczonego podzbioru usług.
`FULL`	`Enum`	Tryb, który umożliwia dostęp do wszystkich usług wymagających autoryzacji.

`AuthorizationInfo`

Metody

Metoda	Zwracany typ	Krótki opis
`getAuthorizationStatus()`	`AuthorizationStatus`	Zwraca wartość wskazującą, czy użytkownik musi autoryzować ten skrypt, aby używać co najmniej 1 usługi (np. `ScriptApp.AuthorizationStatus.REQUIRED`).
`getAuthorizationUrl()`	`String\|null`	Pobiera adres URL autoryzacji, którego można użyć do przyznania dostępu do skryptu.
`getAuthorizedScopes()`	`String[]\|null`	Pobiera listę autoryzowanych zakresów skryptu.

`AuthorizationStatus`

Właściwości

Właściwość	Typ	Opis
`REQUIRED`	`Enum`	Użytkownik musi zezwolić temu skryptowi na korzystanie z co najmniej jednej usługi.
`NOT_REQUIRED`	`Enum`	Użytkownik przyznał temu skryptowi wszystkie wymagane obecnie uprawnienia.

`CalendarTriggerBuilder`

Metody

Metoda	Zwracany typ	Krótki opis
`create()`	`Trigger`	Tworzy aktywator i go zwraca.
`onEventUpdated()`	`CalendarTriggerBuilder`	Określa regułę, która uruchamia się, gdy wpis w kalendarzu zostanie utworzony, zaktualizowany lub usunięty.

`ClockTriggerBuilder`

Metody

Metoda	Zwracany typ	Krótki opis
`after(durationMilliseconds)`	`ClockTriggerBuilder`	Określa minimalny czas (w milisekundach) po bieżącym czasie, po którym ma zostać uruchomiony wyzwalacz.
`at(date)`	`ClockTriggerBuilder`	Określa, kiedy wyzwalacz jest uruchamiany.
`atDate(year, month, day)`	`ClockTriggerBuilder`	Określa, że reguła zostanie uruchomiona w danym dniu, domyślnie około północy (±15 minut).
`atHour(hour)`	`ClockTriggerBuilder`	Określa godzinę, o której wyzwalacz jest uruchamiany.
`create()`	`Trigger`	Tworzy aktywator.
`everyDays(n)`	`ClockTriggerBuilder`	Określa, że wyzwalacz ma być uruchamiany co `n` dni.
`everyHours(n)`	`ClockTriggerBuilder`	Określa, że aktywator ma być uruchamiany co `n` godziny.
`everyMinutes(n)`	`ClockTriggerBuilder`	Określa, że reguła ma być uruchamiana co `n` minut.
`everyWeeks(n)`	`ClockTriggerBuilder`	Określa, że wyzwalacz ma być uruchamiany co `n` tygodni.
`inTimezone(timezone)`	`ClockTriggerBuilder`	Określa strefę czasową dla podanych dat i godzin, w których uruchamia się reguła.
`nearMinute(minute)`	`ClockTriggerBuilder`	Określa minutę, w której wyzwalacz jest uruchamiany (plus lub minus 15 minut).
`onMonthDay(day)`	`ClockTriggerBuilder`	Określa dzień miesiąca, w którym ma się uruchamiać wyzwalacz.
`onWeekDay(day)`	`ClockTriggerBuilder`	Określa dzień tygodnia, w którym wyzwalacz jest uruchamiany.

`DocumentTriggerBuilder`

Metody

Metoda	Zwracany typ	Krótki opis
`create()`	`Trigger`	Tworzy i zwraca nowy warunek.
`onOpen()`	`DocumentTriggerBuilder`	Określa regułę, która zostanie uruchomiona po otwarciu dokumentu.

`EventType`

Właściwości

Właściwość	Typ	Opis
`CLOCK`	`Enum`	Reguła uruchamia się, gdy zdarzenie oparte na czasie osiągnie określony moment.
`ON_OPEN`	`Enum`	Reguła jest uruchamiana, gdy użytkownik otworzy plik Dokumentów, Arkuszy lub Formularzy Google.
`ON_EDIT`	`Enum`	Reguła uruchamia się, gdy użytkownik edytuje plik Arkuszy Google (np. wpisuje nową wartość w komórce, co jest traktowane jako edycja, a nie zmiana).
`ON_FORM_SUBMIT`	`Enum`	Reguła jest uruchamiana, gdy użytkownik odpowie na formularz Google.
`ON_CHANGE`	`Enum`	Reguła wyzwalająca jest uruchamiana, gdy użytkownik zmieni plik Arkuszy Google (np. doda wiersz, co jest traktowane jako zmiana, a nie edycja).
`ON_EVENT_UPDATED`	`Enum`	Aktywator uruchamia się, gdy w określonym Kalendarzu Google zostanie utworzone, zaktualizowane lub usunięte wydarzenie.

`FormTriggerBuilder`

Metody

Metoda	Zwracany typ	Krótki opis
`create()`	`Trigger`	Tworzy i zwraca nowy warunek.
`onFormSubmit()`	`FormTriggerBuilder`	Określa regułę, która zostanie uruchomiona po przesłaniu odpowiedzi w formularzu.
`onOpen()`	`FormTriggerBuilder`	Określa regułę, która zostanie uruchomiona po otwarciu widoku edycji formularza.

`InstallationSource`

Właściwości

Właściwość	Typ	Opis
`APPS_MARKETPLACE_DOMAIN_ADD_ON`	`Enum`	Dodatek został zainstalowany przez administratora w domenie użytkownika.
`NONE`	`Enum`	Skrypt nie jest uruchomiony jako dodatek.
`WEB_STORE_ADD_ON`	`Enum`	Dodatek został zainstalowany przez użytkownika z Chrome Web Store.

`ScriptApp`

Właściwości

Właściwość	Typ	Opis
`AuthMode`	`AuthMode`	Wyliczenie, które określa kategorie autoryzowanych usług, które Apps Script może wykonywać za pomocą funkcji wyzwalanej.
`AuthorizationStatus`	`AuthorizationStatus`	Wyliczenie określające stan autoryzacji skryptu.
`EventType`	`EventType`	Wyliczenie oznaczające typ wywołanego zdarzenia.
`InstallationSource`	`InstallationSource`	Wyliczenie określające, w jaki sposób skrypt został zainstalowany u użytkownika jako dodatek.
`TriggerSource`	`TriggerSource`	Wyliczenie oznaczające źródło zdarzenia, które powoduje uruchomienie reguły.
`WeekDay`	`Weekday`	Wyliczenie reprezentujące dni tygodnia.

Metody

Metoda	Zwracany typ	Krótki opis
`deleteTrigger(trigger)`	`void`	Usuwa podany wyzwalacz, aby nie był już uruchamiany.
`getAuthorizationInfo(authMode)`	`AuthorizationInfo`	Zwraca obiekt, który sprawdza, czy użytkownik przyznał autoryzację dla wszystkich wymagań skryptu.
`getAuthorizationInfo(authMode, oAuthScopes)`	`AuthorizationInfo`	Pobiera obiekt, który sprawdza, czy użytkownik przyznał autoryzację w przypadku żądanych zakresów.
`getIdentityToken()`	`String\|null`	Pobiera token tożsamości OpenID Connect dla efektywnego użytkownika, jeśli przyznano zakres `openid`.
`getInstallationSource()`	`InstallationSource`	Zwraca wartość wyliczeniową, która wskazuje, w jaki sposób skrypt został zainstalowany jako dodatek dla bieżącego użytkownika (np. czy użytkownik zainstalował go osobiście w Chrome Web Store, czy administrator domeny zainstalował go dla wszystkich użytkowników).
`getOAuthToken()`	`String`	Pobiera token dostępu OAuth 2.0 dla użytkownika.
`getProjectTriggers()`	`Trigger[]`	Pobiera wszystkie wyzwalacze, które można zainstalować, powiązane z bieżącym projektem i bieżącym użytkownikiem.
`getScriptId()`	`String`	Pobiera unikalny identyfikator projektu skryptu.
`getService()`	`Service`	Zwraca obiekt używany do kontrolowania publikowania skryptu jako aplikacji internetowej.
`getUserTriggers(document)`	`Trigger[]`	Pobiera wszystkie wyzwalacze, które można zainstalować i których właścicielem jest ten użytkownik w danym dokumencie, tylko dla tego skryptu lub dodatku.
`getUserTriggers(form)`	`Trigger[]`	Pobiera wszystkie instalowane wyzwalacze należące do tego użytkownika w danym formularzu, tylko dla tego skryptu lub dodatku.
`getUserTriggers(spreadsheet)`	`Trigger[]`	Pobiera wszystkie instalowane wyzwalacze należące do tego użytkownika w danym arkuszu kalkulacyjnym, tylko dla tego skryptu lub dodatku.
`invalidateAuth()`	`void`	Unieważnia autoryzację, którą użytkownik ma do wykonania bieżącego skryptu.
`newStateToken()`	`StateTokenBuilder`	Tworzy narzędzie do tworzenia tokena stanu, którego można używać w interfejsie API wywołania zwrotnego (np. w przepływie OAuth).
`newTrigger(functionName)`	`TriggerBuilder`	Rozpoczyna proces tworzenia aktywatora, który można zainstalować i który po uruchomieniu wywołuje daną funkcję.
`requireAllScopes(authMode)`	`void`	Sprawdza, czy użytkownik wyraził zgodę na wszystkie zakresy, o które prosi skrypt.
`requireScopes(authMode, oAuthScopes)`	`void`	Sprawdza, czy użytkownik wyraził zgodę na żądane zakresy.

`Service`

Metody

Metoda	Zwracany typ	Krótki opis
`getUrl()`	`String`	Zwraca adres URL aplikacji internetowej, jeśli została wdrożona. W przeciwnym razie zwraca `null`.
`isEnabled()`	`Boolean`	Zwraca wartość `true`, jeśli skrypt jest dostępny jako aplikacja internetowa.

`SpreadsheetTriggerBuilder`

Metody

Metoda	Zwracany typ	Krótki opis
`create()`	`Trigger`	Tworzy aktywator i go zwraca.
`onChange()`	`SpreadsheetTriggerBuilder`	Określa regułę, która zostanie uruchomiona, gdy zmieni się zawartość lub struktura arkusza kalkulacyjnego.
`onEdit()`	`SpreadsheetTriggerBuilder`	Określa regułę, która zostanie uruchomiona po edycji arkusza kalkulacyjnego.
`onFormSubmit()`	`SpreadsheetTriggerBuilder`	Określa regułę, która zostanie uruchomiona po przesłaniu formularza do arkusza kalkulacyjnego.
`onOpen()`	`SpreadsheetTriggerBuilder`	Określa regułę, która zostanie uruchomiona po otwarciu arkusza kalkulacyjnego.

`StateTokenBuilder`

Metody

Metoda	Zwracany typ	Krótki opis
`createToken()`	`String`	Tworzy zaszyfrowany ciąg znaków reprezentujący token stanu.
`withArgument(name, value)`	`StateTokenBuilder`	Dodaje argument do tokena.
`withMethod(method)`	`StateTokenBuilder`	Ustawia funkcję wywołania zwrotnego.
`withTimeout(seconds)`	`StateTokenBuilder`	Ustawia czas (w sekundach), przez jaki token jest ważny.

`Trigger`

Metody

Metoda	Zwracany typ	Krótki opis
`getEventType()`	`EventType`	Zwraca typ zdarzenia, które uruchamia regułę.
`getHandlerFunction()`	`String`	Zwraca funkcję, która zostanie wywołana po zadziałaniu czynnika uruchamiającego.
`getTriggerSource()`	`TriggerSource`	Zwraca źródło zdarzeń, które spowodują uruchomienie reguły.
`getTriggerSourceId()`	`String`	Zwraca identyfikator specyficzny dla źródła.
`getUniqueId()`	`String`	Zwraca unikalny identyfikator, który można wykorzystać do rozróżniania wyzwalaczy.

`TriggerBuilder`

Metody

Metoda	Zwracany typ	Krótki opis
`forDocument(document)`	`DocumentTriggerBuilder`	Tworzy i zwraca `DocumentTriggerBuilder` powiązany z danym dokumentem.
`forDocument(key)`	`DocumentTriggerBuilder`	Tworzy i zwraca obiekt `DocumentTriggerBuilder` powiązany z dokumentem o podanym identyfikatorze.
`forForm(form)`	`FormTriggerBuilder`	Tworzy i zwraca obiekt `FormTriggerBuilder` powiązany z danym formularzem.
`forForm(key)`	`FormTriggerBuilder`	Tworzy i zwraca `FormTriggerBuilder` powiązany z formularzem o podanym identyfikatorze.
`forSpreadsheet(sheet)`	`SpreadsheetTriggerBuilder`	Tworzy i zwraca `SpreadsheetTriggerBuilder` powiązany z danym arkuszem kalkulacyjnym.
`forSpreadsheet(key)`	`SpreadsheetTriggerBuilder`	Tworzy i zwraca `SpreadsheetTriggerBuilder` powiązany z arkuszem o podanym identyfikatorze.
`forUserCalendar(emailId)`	`CalendarTriggerBuilder`	Zwraca narzędzie do tworzenia wyzwalaczy kalendarza.
`timeBased()`	`ClockTriggerBuilder`	Tworzy i zwraca obiekt `ClockTriggerBuilder` do tworzenia aktywatorów opartych na czasie.

`TriggerSource`

Właściwości

Właściwość	Typ	Opis
`SPREADSHEETS`	`Enum`	Arkusze Google powodują uruchomienie reguły.
`CLOCK`	`Enum`	Reguła jest uruchamiana przez zdarzenie oparte na czasie.
`FORMS`	`Enum`	Formularze Google powodują uruchomienie wyzwalacza.
`DOCUMENTS`	`Enum`	Dokumenty Google powodują uruchomienie reguły.
`CALENDAR`	`Enum`	Kalendarz Google powoduje uruchomienie wyzwalacza.

O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.

Ostatnia aktualizacja: 2025-12-11 UTC.

Blog
Przeczytaj bloga Google Workspace Developers
Stack Overflow
Zadaj pytanie pod tagiem google-apps-script
Próbki kodu
Zobacz nasze przykładowe kody lub skopiuj je, aby utworzyć własny
Pliki wideo
Obejrzyj samouczki dotyczące Apps Script