Usługi Apps Script mają limity dzienne i ograniczenia dotyczące niektórych funkcji. Jeśli przekroczysz limit lub ograniczenie, skrypt zgłosi wyjątek i wykonanie zostanie zatrzymane.
Ważne: niektóre funkcje mają dodatkowe limity w usłudze Google, z którą są powiązane. Korzystanie z usługi Apps Script w produkcie 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 osobistych (np. gmail.com) lub wycofanej bezpłatnej wersji G Suite oraz kont Google Workspace. Limity są przypisane do użytkownika i resetują się 24 godziny po pierwszym żądaniu.
Podane niżej limity pomogą Ci w testowaniu skryptów. Wszystkie limity mogą zostać w dowolnym momencie zniesione, zmniejszone lub zmienione bez powiadomienia.
| Funkcja | konsumenckie (np. gmail.com) i bezpłatna wersja G Suite (starsza); |
konta Google Workspace ; |
|---|---|---|
| Wydarzenia utworzone w kalendarzu | 5000 / dzień | 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 / dzień | 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ń |
Obecne ograniczenia
Podane niżej limity pomogą Ci w testowaniu skryptów. Wszystkie limity mogą zostać w dowolnym momencie zniesione, zmniejszone lub zmienione bez powiadomienia.
| Funkcja | konsumenckie (np. gmail.com) i bezpłatna wersja G Suite (starsza); |
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 / użytkownik | 30 / 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 powyżej.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 zdarza się to w przypadku skryptów uruchamianych przez wyzwalacz, które mają niższy limit dzienny 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. Zdarza się to najczęściej 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 w przypadku zakresu 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 wyjątku powyżej, najczęściej występuje to w przypadku funkcji niestandardowych, które są wielokrotnie wywoływane w jednym arkuszu kalkulacyjnym.