Damit der Assistent Post in Google Workspace lesen und dort Entwürfe anlegen kann, braucht er Zugriff über die Gmail API. Dafür legt die Organisation etwas in ihrer eigenen Google Cloud an; draften hat keine gemeinsame App, der Sie nur zustimmen müssten. Das gilt für unseren Dienst ebenso wie für eine Installation auf dem eigenen Server.
Alles hier gilt nur für Konten von Google Workspace mit eigener Domain. Mit einem privaten Konto @gmail.com kann man sich nicht bei draften anmelden; ein privates Gmail verbinden Sie aber über IMAP mit einem App-Passwort – siehe Unterstützte Anbieter und Grenzen.
Was Sie möchten und was Sie einrichten
| Was Sie möchten | Was Sie einrichten |
|---|---|
| Die Mitglieder melden sich mit dem Google-Konto an, und jedes hat ein eigenes Postfach | Client der Organisation – das genügt |
| Dazu Postfächer, bei denen sich niemand anmeldet (etwa info@), oder einen zentral eingerichteten Zugriff auf die Postfächer, ohne deren Inhaber | zusätzlich die Registrierung der Organisation (Dienstkonto) |
| Sie möchten keine Anmeldung mit dem Google-Konto | die Mitglieder melden sich mit dem Passwort aus der Einladung an, die Post verbindet die Registrierung der Organisation (oder IMAP) |
Zwei verschiedene Dinge bei Google
Der Client der Organisation und die Registrierung der Organisation sind zwei getrennte Dinge in der Google Cloud. Jedes erledigt etwas anderes, und keines ersetzt das andere:
| Client der Organisation | Registrierung der Organisation | |
|---|---|---|
| Was es ist | OAuth-Client mit einem Consent Screen vom Typ Internal | Dienstkonto mit Schlüssel und Domain-wide Delegation |
| Was es tut | Anmeldung der Mitglieder mit der Schaltfläche Mit Google anmelden und die Schaltfläche Gmail verbinden beim eigenen Postfach | Zugriff des Assistenten auf die Postfächer, ohne dass sich deren Inhaber anmelden |
| Wo in draften | Organisation → Anmeldung und Zugriff auf die Post → Karte Kontoanmeldung und Postfachverbindungen | Organisation → Anmeldung und Zugriff auf die Post → Karte Registrierungen für freigegebene Postfächer und zentrale Verwaltung |
| Wer es in draften einrichtet | der Inhaber der Organisation | der Inhaber oder ein Manager der Organisation |
| Wer es bei Google anlegt | ein Administrator der Google Cloud | ein Administrator der Google Cloud und ein Super Admin in Google Admin |
| Wer sich beim Postfach anmeldet | der Inhaber jedes Postfachs, einmal | niemand |
| Welche Postfächer erreicht werden | nur die, die die Mitglieder selbst verbinden | alle Postfächer der Domain |
Es sind absichtlich zwei Dinge. Die Zustimmung zum Client gibt nur Rechte an den Postfächern, die die Mitglieder selbst verbinden – nie an der Post der ganzen Domain. Das Dienstkonto erreicht dagegen jedes Postfach der Domain, und deshalb bekommt draften es nur für den Zugriff auf die Postfächer, nicht für die Anmeldung. Legen Sie die beiden nicht zusammen.
Jedes Postfach verwendet einen der beiden Zugänge; beides können Sie gleichzeitig haben. draften verlangt nur den Berechtigungsbereich gmail.modify – Lesen und Anlegen von Entwürfen, es sendet nichts.
Client der Organisation: Anmeldung und Gmail verbinden
Der Inhaber des Postfachs meldet sich mit seinem Google-Konto an und erlaubt den Zugriff nur auf seine eigene Post. Derselbe Client dient auch der Anmeldung bei draften mit dem Google-Konto.
In der Google Cloud
Sie arbeiten in https://console.cloud.google.com, angemeldet mit dem Konto eines Administrators Ihrer Workspace-Domain. Alles geschieht in einem Projekt – das gewählte Projekt sehen Sie oben links neben dem Logo von Google Cloud; dort wechseln Sie es auch oder legen ein neues an. Das Hauptmenü öffnen Sie mit dem Symbol ☰ oben links.
- Öffnen Sie zuerst in draften Organisation → Anmeldung und Zugriff auf die Post, Karte Kontoanmeldung und Postfachverbindungen. Sie zeigt zwei Redirect URIs genau für Ihre Adresse von draften – sie enden auf
/auth/google/callbackund/mailboxes/connect/google/callback. Kopieren Sie sie von dort; sie müssen Zeichen für Zeichen stimmen. - Wählen Sie ein Projekt, oder legen Sie ein neues an (etwa
draften), und schalten Sie darin die Gmail API ein: ☰ → APIs & Services → Library, suchen Sie Gmail API, öffnen Sie sie und klicken Sie auf Enable. Direkt: https://console.cloud.google.com/apis/library/gmail.googleapis.com - Legen Sie fest, wie sich die App den Benutzern vorstellt (Consent Screen): ☰ → APIs & Services → OAuth consent screen. Es öffnet sich die Seite Google Auth Platform; direkt: https://console.cloud.google.com/auth/overview (prüfen Sie, dass oben das richtige Projekt gewählt ist). Klicken Sie auf Get started und gehen Sie die Schritte durch:
- App Information – App name
draftenund User support email (Ihre E-Mail-Adresse oder eine Gruppe der Administratoren). Next. - Audience – wählen Sie Internal. Anmelden kann sich dann nur ein Konto Ihrer Workspace-Domain, und Google muss die App nicht überprüfen. Next.
- Contact Information – die E-Mail-Adresse, an die Google Ihnen Hinweise zur App schickt. Next.
- Finish – haken Sie das Kästchen mit der Zustimmung zu den Richtlinien von Google an (I agree to the Google API Services: User Data Policy), klicken Sie auf Continue und dann auf Create.
- App Information – App name
- Erlauben Sie der App die Berechtigungsbereiche. Öffnen Sie in Google Auth Platform im Menü links Data Access (direkt: https://console.cloud.google.com/auth/scopes) → Add or remove scopes. Haken Sie in der Liste
openid,.../auth/userinfo.emailund.../auth/userinfo.profilean. Den Berechtigungsbereich für Gmail tragen Sie in das Feld Manually add scopes ein:https://www.googleapis.com/auth/gmail.modify→ Add to table. Klicken Sie auf Update und unten auf Save. - Legen Sie den Client an. Öffnen Sie in Google Auth Platform im Menü links Clients (direkt: https://console.cloud.google.com/auth/clients) → Create client. Application type: Web application, Name etwa
draften. Klicken Sie bei Authorized redirect URIs auf Add URI und fügen Sie die erste Adresse aus der Karte ein, dann wieder Add URI und die zweite. Klicken Sie auf Create. - Es erscheinen Client ID und Client secret – kopieren Sie sich sofort beides. Das Client secret zeigt Google später nicht mehr an; wenn Sie es verlieren, legen Sie beim Client ein neues an.
In draften
- Der Inhaber der Organisation öffnet Organisation → Anmeldung und Zugriff auf die Post, trägt in der Karte Kontoanmeldung und Postfachverbindungen unter Google-OAuth-Client die Client ID und das Client secret aus Schritt 6 ein und klickt auf Speichern.
- Die Anmeldung mit dem Google-Konto schaltet er auf derselben Seite in der Karte Wie sich Mitglieder anmelden ein: Er trägt unter E-Mail-Domains der Organisation seine Workspace-Domain ein – die primäre, keine Alias-Domain (die sendet Google bei der Anmeldung nicht). Sobald die Organisation den Client und die Domain hat, melden sich die Mitglieder mit dem Google-Konto an, und ihre Passwörter gelten nicht mehr – siehe Wie sich Mitglieder anmelden.
- Der Inhaber des Postfachs öffnet die Seite des Postfachs und klickt in der Karte Zugriff auf die Post in der Zeile Mit dem Konto des Postfachs verbinden: auf Gmail verbinden. Er meldet sich mit dem Konto dieses Postfachs an – ein anderes Konto lehnt draften ab – und erlaubt den Zugriff. Die Schaltfläche sieht nur der Inhaber des Postfachs, und nur wenn die Organisation den Client hat; ohne ihn steht in der Karte statt der Schaltfläche, dass die Verbindung mit dem Konto möglich ist, sobald der Inhaber der Organisation den Client hinzufügt.
- Dann Verbindung testen.
Wenn das Postfach getrennt wird
- Das Konto wurde gelöscht oder gesperrt, oder der Zugriff wurde widerrufen – Google stellt keine Tokens mehr aus, und draften trennt das Postfach. Verbinden Sie es erneut (Gmail neu verbinden) oder über die Registrierung der Organisation (unten).
- „Der Anbieter hat kein Refresh-Token ausgestellt“ – der Inhaber des Postfachs entfernt die App in den Einstellungen seines Google-Kontos (Sicherheit → Drittanbieter-Apps) und verbindet das Postfach erneut.
- „Es hat sich ein anderes Konto angemeldet als die Adresse des Postfachs“ – wählen Sie beim Verbinden das Konto genau dieses Postfachs.
Registrierung der Organisation: Zugriff ohne Anmeldung
Ein Dienstkonto mit Domain-wide Delegation gibt dem Assistenten Zugriff auf die Postfächer der Domain, ohne dass sich jemand anmeldet. Es eignet sich für Postfächer, bei denen sich niemand anmeldet (etwa info@), und für Organisationen, die den Zugriff zentral verwalten möchten. Mit der Anmeldung bei draften hat es nichts zu tun.
In der Google Cloud
Sie arbeiten in https://console.cloud.google.com, im selben Projekt, in dem die Gmail API eingeschaltet ist (Schritt 2 beim Client der Organisation; ohne Client schalten Sie sie genauso ein). Prüfen Sie das Projekt oben links neben dem Logo von Google Cloud.
- Öffnen Sie die Liste der Dienstkonten: ☰ → IAM & Admin → Service accounts. Direkt: https://console.cloud.google.com/iam-admin/serviceaccounts
- Klicken Sie oben auf + Create service account und gehen Sie drei Schritte durch:
- Service account details – Service account name etwa
draften-post(die ID wird von selbst ergänzt). Klicken Sie auf Create and continue. - Permissions (optional) – wählen Sie nichts; Rollen im Projekt braucht es keine, Zugriff auf die Post erhält es erst durch die Delegation in Google Admin. Klicken Sie auf Continue.
- Principals with access (optional) – tragen Sie nichts ein, klicken Sie auf Done.
- Service account details – Service account name etwa
- Klicken Sie in der Liste auf das neue Dienstkonto. Kopieren Sie auf der Registerkarte Details die Unique ID – eine lange Zahl; das ist die Client-ID für Google Admin.
- Registerkarte Keys → Add key → Create new key → Key type: JSON → Create. Der Browser lädt eine Datei mit dem Schlüssel herunter (
….json).
Lehnt Google das Anlegen des Schlüssels ab, hat Ihre Organisation die Richtlinie Disable service account key creation (iam.disableServiceAccountKeyCreation; neue Organisationen haben sie standardmäßig) eingeschaltet. Ein Administrator der Organisation schaltet sie für dieses Projekt aus: ☰ → IAM & Admin → Organization policies (https://console.cloud.google.com/iam-admin/orgpolicies), sucht iam.disableServiceAccountKeyCreation → Manage policy → Override parent's policy → Enforcement: Off → Set policy. Wiederholen Sie dann Schritt 4.
In Google Admin
Sie brauchen ein Konto als Super Admin von Google Workspace.
- Öffnen Sie https://admin.google.com → im Menü links Security → Access and data control → API controls → unten Domain wide delegation → Manage domain wide delegation. Direkt: https://admin.google.com/ac/owl/domainwidedelegation
- Klicken Sie auf Add new und füllen Sie aus:
- Client ID – die numerische Unique ID aus Schritt 3,
- OAuth scopes (comma-delimited) –
https://www.googleapis.com/auth/gmail.modify.
Klicken Sie auf Authorize. Die Delegation erscheint in der Liste. Sie wirkt meist innerhalb weniger Minuten, in Ausnahmefällen erst nach einigen Stunden.
In draften
- Öffnen Sie Organisation → Anmeldung und Zugriff auf die Post, Karte Registrierungen für freigegebene Postfächer und zentrale Verwaltung. Registrierungen verwalten der Inhaber und die Manager der Organisation.
- System: Google Workspace. Füllen Sie Name aus, wählen Sie bei Schlüssel des Dienstkontos (JSON) die heruntergeladene Datei und klicken Sie auf Registrierung hinzufügen. Der Schlüssel wird verschlüsselt gespeichert; in der Karte sind danach nur die E-Mail-Adresse des Dienstkontos und seine Client-ID zu sehen.
- Wählen Sie auf der Seite jedes Postfachs in der Karte Zugriff auf die Post bei Registrierung der Organisation diese Registrierung, klicken Sie auf Übernehmen und dann auf Verbindung testen. Den Ablauf mit Bildschirmfotos zeigt die Anleitung Ein Postfach hinzufügen und verbinden.
Löschen Sie danach die heruntergeladene Schlüsseldatei. Wer sie hat, kommt in jedes Postfach der Domain. Einen neuen Schlüssel desselben Dienstkontos (Schritt 4 oben) laden Sie bei der Registrierung über neuer Schlüssel (JSON) hoch; den Schlüssel eines anderen Dienstkontos fügen Sie als neue Registrierung hinzu. Löschen Sie danach den alten Schlüssel in der Google Cloud: Dienstkonto → Registerkarte Keys → Papierkorbsymbol beim alten Schlüssel.
Ist Postfach automatisch eingeschaltet (Wie sich Mitglieder anmelden), wird ein neues Postfach von selbst an die Registrierung gebunden, wenn für Google Workspace genau eine aktiv ist.
Fehler beim Verbindungstest
Der Test prüft drei Schritte: Zugriff, Token und Berechtigung und Lesen des Posteingangs.
| In der Meldung | Was es bedeutet | Was zu tun ist |
|---|---|---|
die Delegation für den Berechtigungsbereich ist nicht erlaubt (unauthorized_client) | in Google Admin fehlt die Domain-wide Delegation, oder sie hat eine andere Client-ID oder einen anderen Berechtigungsbereich | die Delegation in Google Admin prüfen: die numerische ID und den genauen Berechtigungsbereich gmail.modify |
invalid_grant beim Dienstkonto | ein solches Postfach gibt es in der Workspace-Domain nicht | die Adresse des Postfachs prüfen |
| „Gmail API has not been used…“ | im Projekt ist die Gmail API nicht eingeschaltet | die Gmail API einschalten |
Token ohne gmail.modify | der Delegation oder dem Consent Screen fehlt der Berechtigungsbereich gmail.modify | den Berechtigungsbereich ergänzen |
invalid_grant, deleted_client bei einem verbundenen Konto | die Verbindung wurde widerrufen oder der Client gelöscht | Gmail neu verbinden |
Weitere Fehler beschreibt Fehlerbehebung.