Für Google Apps Script-Dienste gelten tägliche Kontingente und Einschränkungen für einige Funktionen. Wenn Sie ein Kontingent oder eine Beschränkung überschreiten, löst Ihr Skript eine Ausnahme aus und die Ausführung wird beendet.
Für einige Funktionen gelten zusätzliche Kontingente aus dem zugehörigen Google-Produkt. Die Nutzung des Apps Script-Dienstes eines Produkts wird auf alle zugehörigen Kontingentreserven angerechnet. Eine Funktion ist nicht mehr verfügbar, wenn Sie eines der zugehörigen Kontingente erreichen.
Aktuelle Kontingente
Kontingente werden für Nutzer von Privatnutzerkonten (z. B. gmail.com) und Google Workspace-Konten auf unterschiedlichen Ebenen festgelegt. Kontingente gelten pro Nutzer und werden 24 Stunden nach der ersten Anfrage zurückgesetzt.
Verwenden Sie die folgenden Kontingente, um Ihre Skripts zu testen. Alle Kontingente können jederzeit ohne Vorankündigung aufgehoben, reduziert oder geändert werden.
| Funktion | Privatnutzerkonten (z. B. gmail.com) | Google Workspace -Konten |
|---|---|---|
| Erstellte Kalendertermine | 5.000 pro Tag | 10.000 pro Tag |
| Erstellte Kontakte | 1.000 pro Tag | 2.000 pro Tag |
| Erstellte Dokumente | 250 pro Tag | 1.500 pro Tag |
| Konvertierte Dateien | 2.000 pro Tag | 4.000 / Tag |
| E-Mail-Empfänger pro Tag (z. B. mit MailApp) | 100* pro Tag | 1.500* / Tag |
| E‑Mail-Empfänger pro Tag innerhalb der Domain (z. B. mit MailApp) | 100* pro Tag | 2.000 pro Tag |
| E‑Mail-Lese-/Schreibvorgänge (ohne Senden) | 20.000 pro Tag | 50.000 pro Tag |
| Google Groups-Leseanforderungen | 2.000 pro Tag | 10.000 pro Tag |
| JDBC-Verbindungen | 10.000 pro Tag | 50.000 pro Tag |
| Fehlgeschlagene JDBC-Verbindungen | 100 pro Tag | 500 pro Tag |
| Erstellte Präsentationen | 250 pro Tag | 1.500 pro Tag |
| Eigenschaften mit Lese-/Schreibzugriff | 50.000 pro Tag | 500.000 pro Tag |
| Erstellte Folien | 250 pro Tag | 1.500 pro Tag |
| Erstellte Tabellen | 250 pro Tag | 3.200 pro Tag |
| Gesamtlaufzeit für Trigger | 90 Min./Tag | 6 Std./Tag |
| URL-Abrufe | 20.000 pro Tag | 100.000 / Tag |
| Rendern statischer Karten | 1.000 pro Tag | 10.000 pro Tag |
| Anfrage zur Wegbeschreibung von Google Maps | 1.000 pro Tag | 10.000 pro Tag |
| Google Map Geocode-Aufrufe | 1.000 pro Tag | 10.000 pro Tag |
| Anrufe übersetzen | 5.000 pro Tag | 20.000 pro Tag |
| Abfrage von Höhendaten entlang von Pfaden in Google Maps | 1.000 pro Tag | 10.000 pro Tag |
| Apps Script-Projekte | 50 pro Tag | 50 pro Tag |
Für Testkonten gelten zusätzliche Beschränkungen. Nachdem Sie ein Konto im kostenlosen Testzeitraum in ein bezahltes Konto umgewandelt haben, werden Ihre Kontobeschränkungen automatisch angehoben, wenn die beiden folgenden Bedingungen zutreffen:
- Für Ihre Domain wurden Zahlungen in Höhe von mindestens 100 $ (oder dem entsprechenden Betrag in Ihrer Währung) geleistet.
- Seit dem Überschreiten dieses Zahlungsbetrags sind mindestens 60 Tage vergangen.
Aktuelle Beschränkungen
Die folgenden Limits können Ihnen beim Testen Ihrer Scripts helfen. Alle Limits können jederzeit ohne Vorankündigung aufgehoben, reduziert oder geändert werden.
| Funktion | Privatnutzerkonten (z.B. gmail.com) | Google Workspace -Konten |
|---|---|---|
| Scriptlaufzeit | 6 Minuten pro Ausführung | 6 Minuten pro Ausführung |
| Laufzeit benutzerdefinierter Funktionen | 30 Sekunden pro Ausführung | 30 Sekunden pro Ausführung |
| Laufzeit von Google Workspace-Add-ons | 30 Sekunden pro Ausführung | 30 Sek.* / Ausführung |
| Gleichzeitige Ausführungen pro Nutzer | 30 / Nutzer | 30 / Nutzer |
| Gleichzeitige Ausführungen pro Script | 1.000 | 1.000 |
| E-Mail-Anhänge | 250 / msg | 250 / msg |
| E-Mail-Textlänge | 200 KB / Nachricht | 400 KB pro Nachricht |
| E‑Mail-Empfänger pro Nachricht | 50 / msg | 50 / msg |
| Gesamtgröße aller E-Mail-Anhänge | 25 MB / Nachricht | 25 MB / Nachricht |
| Größe des Attributwerts | 9 KB / val | 9 KB / val |
| Gesamtspeicher für Properties | 500 KB pro Property-Speicher | 500 KB pro Property-Speicher |
| Trigger | 20 / Nutzer / Skript | 20 / Nutzer / Skript |
| URL-Abrufantwortgröße | 50 MB / Anruf | 50 MB / Anruf |
| URLFetch-Header | 100 / Anruf | 100 / Anruf |
| URLFetch-Headergröße | 8 KB / Anruf | 8 KB / Anruf |
| URLFetch-Beitragsgröße | 50 MB / Anruf | 50 MB / Anruf |
| URL-Länge für URL-Abruf | 2 KB / Anruf | 2 KB / Anruf |
| Versionen | 200 / Skript | 200 / Skript |
Kontingentnutzung überwachen
Verwenden Sie die folgenden Methoden, um den Kontingentverbrauch und den Ausführungsstatus Ihres Skripts zu überwachen:
- E‑Mail-Kontingent: Mit
MailApp.getRemainingDailyQuota()können Sie die Anzahl der verbleibenden E‑Mail-Empfänger prüfen, an die Sie für den Rest des Tages E‑Mails senden können. - Ausführungsüberwachung: Im Apps Script-Dashboard können Sie den Ausführungsverlauf und den Zustand Ihres Skripts einsehen. Auf der Seite Meine Ausführungen wird der Status (z. B.
Completed,FailedoderRunning) jeder Skriptausführung angezeigt. Sie können die Anzahl der gleichzeitigen Ausführungen überwachen, indem Sie nach Ausführungen mit dem StatusRunningfiltern. - Google Cloud Console: Wenn Ihr Apps Script-Projekt ein Standard-Google Cloud-Projekt verwendet, können Sie dienstspezifische Kontingente und die API-Nutzung in der Google Cloud Console überwachen.
Ausnahmenachrichten
Wenn ein Skript ein Kontingent oder eine Beschränkung erreicht, wird eine Ausnahme mit einer Meldung wie der folgenden ausgelöst:
Limit exceeded: Email Attachments Per Message.: Dies weist darauf hin, dass das Skript eines der Kontingente oder Limits überschritten hat, die in den Abschnitten Aktuelle Kontingente oder Aktuelle Einschränkungen aufgeführt sind.Service invoked too many times: Calendar.: Das Skript hat den angegebenen Dienst zu oft an einem Tag aufgerufen.Service invoked too many times in a short time: Calendar. Try Utilities.sleep(1000) between calls.: Das Skript hat den angegebenen Dienst innerhalb kurzer Zeit zu oft aufgerufen.Service using too much computer time for one day.: Das Skript hat die zulässige Gesamtausführungszeit für einen Tag überschritten. Das Problem tritt am häufigsten bei Skripts auf, die über einen Trigger ausgeführt werden und ein niedrigeres Tageslimit als manuell ausgeführte Skripts haben.Script invoked too many times per second for this Google user account.Das bedeutet, dass das Skript in kurzer Zeit zu oft ausgeführt wurde. Das Problem tritt am häufigsten bei benutzerdefinierten Funktionen auf, die in einer einzelnen Tabelle wiederholt aufgerufen werden. Um diesen Fehler zu vermeiden, müssen Sie Ihre benutzerdefinierten Funktionen so programmieren, dass sie nur einmal pro Datenbereich aufgerufen werden müssen. Weitere Informationen finden Sie im Leitfaden zu benutzerdefinierten Funktionen.There are too many scripts running simultaneously for this Google user account.Das bedeutet, dass zu viele Scripts gleichzeitig ausgeführt werden, auch wenn es sich nicht unbedingt um dasselbe Script handelt. Wie bei der vorherigen Ausnahme tritt dies am häufigsten bei benutzerdefinierten Funktionen auf, die in einer einzelnen Tabelle wiederholt aufgerufen werden.