Usługi Google Apps Script mają dzienne limity i ograniczenia dotyczące niektórych funkcji. Jeśli przekroczysz limit lub ograniczenie, skrypt zgłosi wyjątek i wykonanie zostanie zatrzymane.
Niektóre funkcje mają dodatkowe limity pochodzące z powiązanej usługi Google. Korzystanie z usługi Apps Script produktu jest wliczane do wszystkich powiązanych rezerw limitów. Funkcja staje się niedostępna, jeśli osiągniesz którykolwiek z powiązanych limitów.
Obecne limity
Limity są ustawiane na różnych poziomach dla użytkowników kont indywidualnych (np. gmail.com) i kont Google Workspace. Limity są przypisane do użytkownika i resetują się 24 godziny po pierwszym żądaniu.
Podczas testowania skryptów korzystaj z tych limitów. Wszystkie limity mogą zostać w dowolnym momencie zniesione, zmniejszone lub zmienione bez powiadomienia.
| Funkcja | konta indywidualne (np. gmail.com), | konta Google Workspace ; |
|---|---|---|
| Wydarzenia utworzone w kalendarzu | 5000 PLN dziennie | 10 000 / dzień |
| Utworzone kontakty | 1000 / dzień | 2000 na dzień |
| Utworzone dokumenty | 250 na dzień | 1500 PLN dziennie |
| Przekonwertowane pliki | 2000 na dzień | 4000 PLN dziennie |
| Liczba adresatów e-maili na dzień (np. w przypadku MailApp) | 100* dziennie | 1500* dziennie |
| Liczba adresatów e-maili dziennie w domenie (np. w przypadku MailApp) | 100* dziennie | 2000 na dzień |
| Odczytywanie i zapisywanie e-maili (z wyłączeniem wysyłania) | 20 000 / dzień | 50 000 PLN dziennie |
| Odczyt Grup | 2000 na dzień | 10 000 / dzień |
| Połączenia JDBC | 10 000 / dzień | 50 000 PLN dziennie |
| Nieudane połączenia JDBC | 100 na dzień | 500 na dzień |
| Utworzone prezentacje | 250 na dzień | 1500 PLN dziennie |
| Właściwości odczytu/zapisu | 50 000 PLN dziennie | 500 000 / dzień |
| Utworzono slajdy | 250 na dzień | 1500 PLN dziennie |
| Utworzone arkusze kalkulacyjne | 250 na dzień | 3200 PLN dziennie |
| Łączny czas działania reguł | 90 minut dziennie | 6 godz./dzień |
| Wywołania URL-a | 20 000 / dzień | 100 000 / dzień |
| Renderowanie mapy statycznej | 1000 / dzień | 10 000 / dzień |
| Zapytanie dotyczące wskazówek dojazdu w Mapach Google | 1000 / dzień | 10 000 / dzień |
| Wywołania geokodowania w Mapach Google | 1000 / dzień | 10 000 / dzień |
| Tłumaczenie rozmów | 5000 PLN dziennie | 20 000 / dzień |
| Zapytanie o próbki wysokości w Mapach Google | 1000 / dzień | 10 000 / dzień |
| Projekty Apps Script | 50 na dzień | 50 na dzień |
Na kontach próbnych obowiązują dodatkowe limity. Jeśli przejdziesz z bezpłatnego konta próbnego na płatną subskrypcję, limity na koncie automatycznie ulegają zwiększeniu. Dzieje się tak jednak tylko wówczas, gdy spełnione są oba poniższe warunki:
- łączna płatność za Twoją domenę wyniosła co najmniej 100 USD (lub równowartość tej kwoty w innej walucie),
- od osiągnięcia tego progu płatności minęło co najmniej 60 dni.
Obecne ograniczenia
Podczas testowania skryptów korzystaj z tych limitów. Wszystkie limity mogą zostać w dowolnym momencie zniesione, zmniejszone lub zmienione bez powiadomienia.
| Funkcja | konta indywidualne (np. gmail.com), | konta Google Workspace ; |
|---|---|---|
| Środowisko wykonawcze skryptu | 6 min / wykonanie | 6 min / wykonanie |
| Środowisko wykonawcze funkcji niestandardowej | 30 s / wykonanie | 30 s / wykonanie |
| Środowisko wykonawcze dodatku do Google Workspace | 30 s / wykonanie | 30 s* / wykonanie |
| Jednoczesne wykonywanie na użytkownika | 30 zł / użytkownik | 30 zł / użytkownik |
| Jednoczesne wykonania skryptu | 1000 | 1000 |
| Załączniki do e-maili | 250 / wiadomość | 250 / wiadomość |
| Rozmiar treści e-maila | 200 KB na wiadomość | 400 KB / wiadomość |
| Liczba odbiorców e-maila | 50 / wiadomość | 50 / wiadomość |
| Całkowity rozmiar załączników e-maila | 25 MB / wiadomość | 25 MB / wiadomość |
| Rozmiar wartości właściwości | 9 KB / wartość | 9 KB / wartość |
| Łączna ilość miejsca na usługi | 500 KB na sklep usługi | 500 KB na sklep usługi |
| Aktywatory | 20 / użytkownik / skrypt | 20 / użytkownik / skrypt |
| Rozmiar odpowiedzi URL Fetch | 50 MB / połączenie | 50 MB / połączenie |
| Nagłówki URL Fetch | 100 / wywołanie | 100 / wywołanie |
| Rozmiar nagłówka URL Fetch | 8 KB / połączenie | 8 KB / połączenie |
| Rozmiar URLFetch POST | 50 MB / połączenie | 50 MB / połączenie |
| Długość adresu URL pobierania | 2 KB na wywołanie | 2 KB na wywołanie |
| Wersje | 200 zł za skrypt | 200 zł za skrypt |
Monitorowanie wykorzystania limitu
Aby monitorować wykorzystanie limitu i stan wykonania skryptu, użyj tych metod:
- Limit e-maili: użyj
MailApp.getRemainingDailyQuota()aby sprawdzić liczbę pozostałych adresatów e-maili, do których możesz wysłać wiadomości w ciągu dnia. - Monitorowanie wykonania: użyj panelu Apps Script, aby wyświetlić historię wykonania i stan skryptu. Na stronie Moje wykonania wyświetla się stan (np.
Completed,FailedlubRunning) każdego wykonania skryptu. Liczbę jednoczesnych wykonań możesz monitorować, filtrując wykonania o stanieRunning. - Konsola Google Cloud: jeśli Twój projekt Apps Script korzysta ze standardowego projektu w chmurze Google, możesz monitorować limity dotyczące poszczególnych usług i wykorzystanie interfejsu API w konsoli Google Cloud.
Komunikaty dotyczące wyjątku
Jeśli skrypt osiągnie limit lub ograniczenie, zgłosi wyjątek z komunikatem podobnym do tego:
Limit exceeded: Email Attachments Per Message.Oznacza to, że skrypt przekroczył jeden z limitów lub ograniczeń wymienionych w sekcjach Aktualne limity lub Aktualne ograniczenia.Service invoked too many times: Calendar.Oznacza to, że skrypt wywołał daną usługę zbyt wiele razy w ciągu jednego dnia.Service invoked too many times in a short time: Calendar. Try Utilities.sleep(1000) between calls.Oznacza to, że skrypt zbyt wiele razy w krótkim czasie wywołał daną usługę.Service using too much computer time for one day.Oznacza to, że skrypt przekroczył łączny dopuszczalny czas wykonywania w ciągu jednego dnia. Najczęściej występuje w przypadku skryptów uruchamianych przez wyzwalacz, które mają niższy dzienny limit niż skrypty wykonywane ręcznie.Script invoked too many times per second for this Google user account.Oznacza to, że skrypt był uruchamiany zbyt wiele razy w krótkim czasie. Najczęściej występuje w przypadku funkcji niestandardowych, które są wielokrotnie wywoływane w jednym arkuszu kalkulacyjnym. Aby uniknąć tego błędu, napisz kod funkcji niestandardowych tak, aby trzeba było je wywoływać tylko raz na zakres danych, jak wyjaśniono w przewodniku po funkcjach niestandardowych.There are too many scripts running simultaneously for this Google user account.Oznacza to, że wykonujesz zbyt wiele skryptów jednocześnie, choć niekoniecznie ten sam skrypt. Podobnie jak w przypadku poprzedniego wyjątku, najczęściej dotyczy to funkcji niestandardowych, które są wielokrotnie wywoływane w jednym arkuszu kalkulacyjnym.