Google-Verbindung der Automatisierung nach 7 Tagen weg
Kurz gesagt: Wenn Ihre Automatisierung mit Gmail, Google Kalender oder Drive alle paar Tage die Verbindung verliert und neu angemeldet werden muss, steht das zugehörige Google-Cloud-Projekt sehr wahrscheinlich noch im Status „Testing“. Laut Google-Entwicklerdokumentation (abgerufen November 2026) bekommen solche Projekte mit externem Nutzertyp Aktualisierungstoken, die nach 7 Tagen ablaufen. Die Lösung ist, den Veröffentlichungsstatus zu ändern oder die App als interne App für Ihre Google-Workspace-Domain einzurichten. Daneben nennt Google weitere Gründe, warum ein Token nicht mehr funktioniert, und eine gute Automatisierung sollte jeden davon sauber melden.
Das typische Bild im Betrieb
Ein selbst gebautes Skript oder eine Automatisierung auf einem eigenen Server holt jeden Morgen Bestellungen aus einem Postfach, legt Anhänge in Drive ab oder trägt Termine in Kalender ein. In der ersten Woche läuft alles. Dann bleiben die Ergebnisse aus. Im Protokoll steht ein Fehler wie „invalid_grant“ oder „Token has been expired or revoked“. Nach einer neuen Anmeldung läuft es wieder, genau sieben Tage lang.
Ein Beispiel zur Veranschaulichung: Eine Tischlerei in Graz hat sich ein Skript bauen lassen, das Anfragen aus dem Postfach info@ in eine Auftragsliste ihrer Web-App übernimmt. Jeden Montag muss der Chef „kurz neu verbinden“. Niemand hat das als Muster erkannt, bis die Anfragen einer ganzen Woche fehlten.
Warum gerade sieben Tage
Google-Dienste werden über OAuth verbunden. Die Automatisierung bekommt dabei ein kurzlebiges Zugriffstoken und ein Aktualisierungstoken („Refresh Token“), mit dem sie sich immer wieder neue Zugriffstoken holt, ohne dass jemand eingreifen muss. Solange das Aktualisierungstoken gültig ist, läuft die Automatisierung unbeaufsichtigt.
Die Google-Dokumentation beschreibt eine Ausnahme: Ist der Zustimmungsbildschirm eines Google-Cloud-Projekts für den Nutzertyp „Extern“ eingerichtet und steht der Veröffentlichungsstatus auf „Testing“, laufen Aktualisierungstoken nach 7 Tagen ab. Davon ausgenommen sind laut Dokumentation nur Apps, die ausschließlich Name, E-Mail-Adresse und Profil abfragen. Eine Automatisierung, die Mails liest oder Kalender schreibt, fällt also unter die Regel.
Viele Entwickler legen ein Projekt zum Ausprobieren an, lassen es auf „Testing“ und nehmen es später so in Betrieb. Genau dann beginnt der Sieben-Tage-Rhythmus.
Wie Sie den Status prüfen
Öffnen Sie in der Google-Cloud-Konsole das Projekt, unter dem die Automatisierung registriert ist, und dort den Bereich für den OAuth-Zustimmungsbildschirm. Dort sehen Sie zwei Angaben:
| Angabe | Bedeutung für Ihre Automatisierung |
|---|---|
| Nutzertyp „Intern“ | Nur Konten Ihrer Workspace-Domain; die 7-Tage-Regel für Testprojekte mit externem Nutzertyp gilt hier nicht |
| Nutzertyp „Extern“, Status „Testing“ | Aktualisierungstoken laufen nach 7 Tagen ab |
| Nutzertyp „Extern“, Status „In Produktion“ | Die 7-Tage-Regel entfällt; je nach Rechten kann eine Überprüfung durch Google nötig sein |
Haben Sie keinen Zugang zur Konsole, fragen Sie Ihren Entwickler, unter welchem Konto das Projekt liegt. Idealerweise gehört es einem Konto Ihres Betriebs.
Die passenden Lösungen
Interne App, wenn alle in Ihrer Domain sind
Nutzt die Automatisierung nur Konten Ihrer eigenen Google-Workspace-Domain, ist der Nutzertyp „Intern“ meist der einfachste Weg. Dann richtet sich die App nur an Ihre Domain. Mit einem privaten Gmail-Konto ist das nicht möglich.
Veröffentlichen, wenn externe Konten beteiligt sind
Arbeitet die Automatisierung mit einem privaten Gmail-Konto oder mit Konten außerhalb Ihrer Domain, muss das Projekt auf „In Produktion“ gestellt werden. Je nachdem, welche Rechte die App anfordert, verlangt Google dafür eine Überprüfung. Prüfen Sie vorher, ob alle angeforderten Rechte wirklich nötig sind.
Dienstkonto für reine Server-Aufgaben
Für manche Aufgaben ohne Nutzerkonto, etwa Zugriffe auf eine gemeinsame Ablage, kommt ein Dienstkonto in Frage. Ob das für Ihren Fall passt, hängt vom Dienst und von Ihrer Workspace-Einrichtung ab. Das klären Sie am besten mit Ihrem Entwickler.
Weitere Gründe, warum ein Token plötzlich nicht mehr geht
Die Google-Dokumentation stellt klar, dass Code immer damit rechnen muss, dass ein Aktualisierungstoken nicht mehr funktioniert. Sie nennt unter anderem diese Gründe:
- Die Nutzerin hat der App den Zugriff entzogen.
- Das Token wurde sechs Monate lang nicht verwendet.
- Das Passwort wurde geändert, und das Token umfasst Gmail-Rechte.
- Das Konto hat die Höchstzahl gleichzeitig gültiger Token überschritten.
- Ein Administrator hat einen Dienst eingeschränkt.
Zusätzlich gilt laut Dokumentation eine Grenze von 100 Aktualisierungstoken pro Google-Konto und Client-ID. Wird sie erreicht, macht jedes neue Token automatisch das älteste ungültig. Das passiert, wenn eine Automatisierung bei jedem Lauf eine neue Anmeldung anstößt, statt das gespeicherte Token weiterzuverwenden.
Der Passwortwechsel ist in Betrieben ein Klassiker: Jemand ändert nach einer Sicherheitswarnung das Passwort des Postfachs, und die Automatisierung, die Mails liest, steht still.
Die Automatisierung so bauen, dass Ausfälle auffallen
Selbst mit dem richtigen Status kann eine Verbindung abreißen. Wichtig ist, dass Sie es sofort merken:
- Bei einem Fehler wie „invalid_grant“ nicht stumm weiterprobieren, sondern eine Nachricht an eine feste Adresse oder in Ihren Team-Chat schicken.
- In der Meldung klar sagen, was zu tun ist, etwa „Verbindung zu Google neu herstellen unter …“.
- Einen täglichen Lebenszeichen-Eintrag schreiben. Bleibt er aus, schlägt eine einfache Überwachung Alarm.
- Festhalten, welches Google-Konto verbunden ist. Nach einem Personalwechsel weiß sonst niemand, wessen Zugang gebraucht wird.
Was Sie dem Entwickler mitgeben sollten
Wenn Sie die Umstellung beauftragen, helfen ein paar Angaben, damit nicht mehrfach nachgefragt werden muss. Nennen Sie das Google-Konto, mit dem die Automatisierung arbeitet, und ob es zu Ihrer Workspace-Domain gehört oder ein privates Gmail-Konto ist. Beschreiben Sie, was die Automatisierung tun soll, etwa „Mails mit Betreff Anfrage lesen und als Auftrag anlegen“, damit nur die dafür nötigen Rechte angefordert werden. Legen Sie fest, wer im Betrieb benachrichtigt wird, wenn die Verbindung abreißt, und wo die Anleitung zum Neuverbinden liegt.
Bitten Sie außerdem darum, dass das Google-Cloud-Projekt unter einem Konto Ihres Betriebs angelegt oder dorthin übertragen wird. Liegt es im privaten Konto eines früheren Mitarbeiters oder einer externen Entwicklerin, kann später niemand mehr den Status ändern. Eine kurze Notiz mit Projektname, verbundenem Konto und Ansprechperson in Ihrer internen Dokumentation erspart beim nächsten Ausfall viel Suchen.
Häufige Fragen
Muss ich die Automatisierung nach der Umstellung neu verbinden?
In der Regel ja. Bestehende Token aus der Testphase behalten ihr Ablaufdatum. Nach der Umstellung verbinden Sie einmal neu, danach greift der neue Status.
Ist der Testmodus unsicherer?
Nein, er ist zum Ausprobieren gedacht. Für den Dauerbetrieb ist er nur unpraktisch, weil die Verbindung regelmäßig abläuft.
Warum funktioniert meine Anmeldung bei anderen Apps dauerhaft?
Weil diese Apps veröffentlicht sind. Die Sieben-Tage-Regel betrifft nur Projekte im Status „Testing“ mit externem Nutzertyp.
Wenn Ihre Google-Automatisierung immer wieder den Anschluss verliert und Sie den Grund sauber beheben möchten, gehen wir die Einstellungen gern mit Ihnen durch: schreiben Sie uns.