Registrieren Sie sich auf der Google-Entwickler-Konsole und erstellen Sie entweder ein neues Projekt oder verwenden Sie ein bestehendes Google-Projekt.

Navigieren Sie zum Abschnitt "Anmeldeinformationen" in der Google Developers Console.
Erstellen Sie "OAuth Client ID"-Zugangsdaten, um Zugriff auf Ihre aktivierten APIs zu erhalten:
Art der Anwendung: Webanwendung
Name: Ihr interner Name
2 autorisierte Umleitungs-URIs hinzufügen:
https://{{YOUR_DSN}}/api/v1/hosted/google_auth_request_callback (Sie finden Ihren DSN oben rechts in Unipile Dashboard, Beispiel https://api1.unipile.com:13211/api/v1/hosted/google_auth_request_callback
https://{{YOUR_DSN less port}}/api/v1/hosted/google_auth_request_callback/port{{YOUR_DSN less domain}} (Sie finden Ihren DSN oben rechts im Unipile Dashboard, Beispiel https://api1.unipile.com/api/v1/hosted/google_auth_request_callback/port13211

Klicken Sie auf "CREATE".
Client-ID und Client-Geheimnis zu Unipile Dashboard > Einstellungen > Google OAuth hinzufügen

Gehen Sie zum Abschnitt "Bibliothek" in der Google Developers Console.
Erforderliche API-Bibliotheken aktivieren:
Suchen und aktivieren Sie alle API-Bibliotheken, die Ihre Anwendung benötigen wird: Gmail-API

Während der Implementierung können Sie Ihr Google Project in verschiedenen Zuständen halten:

Nutzertyp' als 'Intern': In diesem Modus ist Ihre App auf Google Workspace-Nutzer innerhalb Ihrer Organisation beschränkt.
Benutzertyp" als "Extern" und "Veröffentlichungsstatus" als "In Prüfung":
Hinweis: Während der "Testphase" müssen Sie Testbenutzer hinzufügen. Die Token laufen nach 7 Tagen ab und erfordern eine erneute Authentifizierung der Benutzer.
Weitere Informationen zum Veröffentlichungsstatus finden Sie hier.
Für Details zu den Benutzertypen, hier klicken.

Stellen Sie sicher, dass Sie den richtigen Benutzertyp und Veröffentlichungsstatus für die Test- und Bereitstellungsphase Ihres Projekts auswählen.

Rufen Sie den Abschnitt "Aktivierte APIS und Dienste" in der Google Developers Console auf.
Aktivierte APIs prüfen: Überprüfen Sie die vollständige Liste der APIs, die Sie in Ihrem Google-Projekt aktiviert haben, und verifizieren Sie sie.
Das Dashboard bietet einen Überblick über alle aktivierten APIs und ermöglicht es Ihnen, den Status der ausgewählten APIs für Ihr Projekt zu überprüfen. Nutzen Sie diesen Bereich, um sicherzustellen, dass die erforderlichen APIs für eine nahtlose Integration in Ihre Anwendung aktiviert sind.

Vergewissern Sie sich, dass die folgenden Angaben gemacht werden:

Geben Sie den Namen Ihrer Anwendung ein: Geben Sie den Namen Ihrer Anwendung an.
Benutzer-Support-E-Mail: Geben Sie eine E-Mail-Adresse an, an die sich die Nutzer bei Fragen zu ihrer Einwilligung wenden können. Empfehlen Sie die Verwendung eines Alias oder einer Verteilerliste, in der die betreffenden Personen enthalten sind.
Fügen Sie Ihr App-Logo hinzu: Laden Sie Ihr Anwendungslogo zur visuellen Identifizierung hoch.

Das Ausfüllen dieser Informationen im Abschnitt des OAuth-Zustimmungsbildschirms ist wichtig, damit die Nutzer Ihre Anwendung während des Zustimmungsprozesses verstehen und ihr vertrauen. Geben Sie genaue Details und Branding-Elemente an, um eine reibungslose Benutzererfahrung zu gewährleisten.

Geben Sie unter dem Abschnitt App-Domäne die folgenden Informationen an:

URL der Anwendungshomepage: Fügen Sie die URL für die Homepage Ihrer Anwendung hinzu.
Stellen Sie sicher, dass es sich um eine echte Homepage handelt und nicht nur um eine "Login"-Seite.
Link zur Datenschutzrichtlinie der Anwendung: Fügen Sie einen Link zu den Datenschutzrichtlinien Ihrer Anwendung ein.
Wichtig: Stellen Sie sicher, dass Ihr Rechtsteam die Datenschutzrichtlinie überprüft, um die Die besonderen Anforderungen von Googleinsbesondere aus dem Abschnitt "Begrenzte Verwendung" des bereitgestellten Dokuments.
Link zu den Nutzungsbedingungen der Anwendung: Fügen Sie einen Link zu den Nutzungsbedingungen Ihrer Anwendung hinzu.

Gehen Sie folgendermaßen vor, um autorisierte Domänen hinzuzufügen:

• Fügen Sie die von Ihnen genutzte App-Domain in Ihr Google-Projekt ein. Vergewissern Sie sich, dass es sich bei Ihrer Domain um die Produktions-Domain handelt und nicht um die Dev/Staging-Domain.
• Domain unipile.com hinzufügen

• Geben Sie eine E-Mail Adresse ein:
  • Geben Sie eine E-Mail-Adresse für Entwickler-Kontaktinformationen an.
  • Wichtig: Dies sollte eine E-Mail-Adresse für eine Verteilerliste sein, um sicherzustellen, dass alle relevanten Parteien E-Mails im Zusammenhang mit der Google-Verifizierung und Benachrichtigungen über Änderungen an Ihrem Projekt erhalten. Halten Sie diese Verteilerliste auf dem neuesten Stand, wenn Teammitglieder kommen und gehen.
• Überwachung nach der Verifizierung:
  • Überwachen Sie das Google-Projekt nach der Einreichung zur Überprüfung genau auf etwaige Maßnahmen von Google.
  • Hinweis: Google sendet E-Mails an diese Adresse, aber sie können in Spam-Ordnern landen oder von Servern blockiert werden. Prüfen Sie regelmäßig auf Aktualisierungen, um keine wichtigen Mitteilungen zu verpassen.

Stellen Sie sicher, dass Sie eine aktiv überwachte und regelmäßig geprüfte E-Mail-Adresse angeben, um über den Status Ihres Google-Projekts und alle erforderlichen Maßnahmen nach der Überprüfung informiert zu bleiben.

• Klicken Sie auf die Schaltfläche "BEREICH HINZUFÜGEN ODER ENTFERNEN", um das Menü aufzurufen.
• Fügen Sie die folgenden Bereiche hinzu (wenn sie nicht in der Liste erscheinen, aktualisieren Sie die Seite):
  ./auth/gmail.send
  ./auth/gmail.labels
  ./auth/gmail.readonly
  ./auth/gmail.modify (nicht erforderlich, wenn Sie keine E-Mails verschieben oder löschen wollen. Sie müssen Google zeigen, dass Sie es wirklich benutzen. Informieren Sie uns, damit wir es in Ihrem Unipile-Konto manuell entfernen können)

Sie können mit diesem Schritt erst fortfahren, wenn Ihre Integration vollständig abgeschlossen und in der Produktion betriebsbereit ist.

Produzieren und hosten Sie ein Demonstrationsvideo, das die Google-Vorgaben erfüllt. Um Ihre App bei Google zu validieren, müssen Sie auch ein Video einreichen, das die Funktionalität Ihrer App zeigt. Dieses Video sollte zu Überprüfungszwecken als "nicht gelistetes" YouTube-Video hochgeladen werden, und es ist nur ein Videolink zulässig.

• Ihre App und der OAuth-Flow werden auf Englisch dargestellt, wie in der Google-Dokumentation unter "Apps, die sensible Bereiche anfordern" und "Apps, die eingeschränkte Bereiche anfordern" angegeben.
• Die Demonstration wird in einer Domäne auf Produktionsebene durchgeführt.
• Navigieren Sie in Ihren Google Project-Einstellungen zu Navigationsmenü -> APIs & Services -> OAuth Consent Screen und bestätigen Sie Folgendes:
  • Der Veröffentlichungsstatus ist auf "In Produktion" gesetzt.
  • Der Benutzertyp wird als "Extern" bezeichnet.

• Zeigen Sie die Homepage Ihrer Anwendung mit der vollständigen URL an und betonen Sie den Produktionsstatus.
• Veranschaulichen Sie, wie ein Google-Kunde sein Konto verknüpfen kann, und betonen Sie dabei die Verwendung der offiziellen Google-Anmeldeschaltfläche.
• Markieren Sie während des Authentifizierungsablaufs, wenn der OAuth-Prozessbildschirm angezeigt wird, die URL und ziehen Sie sie, um die CLIENT-ID in der URL anzuzeigen.

• Stellen Sie nacheinander alle angeforderten Bereiche vor und passen Sie sie an Ihren speziellen Anwendungsfall an.
• Demonstrieren Sie die bidirektionale Funktionalität, indem Sie die Synchronisierung zwischen Ihrer Anwendung und Google Mail zeigen. Verwenden Sie separate Registerkarten, um zwischen Ihrer Anwendung und den einzelnen relevanten Bereichen von Google Mail hin- und herzuschalten. Senden Sie z. B. eine E-Mail über Ihre Anwendung und zeigen Sie, wie die Änderungen in der Liste "Gesendete Nachrichten" in Google Mail synchronisiert werden, und zeigen Sie umgekehrt den Empfang einer eingehenden E-Mail in Ihrer Anwendung.

Wenn Sie diese Richtlinien befolgen, wird Ihr Demo-Video den Authentifizierungsprozess und die funktionalen Möglichkeiten Ihrer Anwendung in Verbindung mit den Google-Diensten effektiv vermitteln.

Nachdem Sie Ihr Demovideo erstellt und sichergestellt haben, dass es alle genannten Kriterien erfüllt, teilen Sie uns bitte die URL des YouTube-Videos mit. Wir können Sie bei der Überprüfung unterstützen oder Sie können Ihre App direkt zur Überprüfung einreichen.

Bitte beachten Sie die folgenden Schritte:

• Fügen Sie das fertige Video Ihrem Google-Projekt als "nicht aufgelisteten" YouTube-Videolink hinzu.
• Senden Sie die URL des YouTube-Videos zur Überprüfung an Ihren Customer Success Manager.
• Nach der Überprüfung fahren Sie mit der Einreichung der App-Verifizierung fort.

Beachten Sie, dass die Dauer des Überprüfungsprozesses variieren kann. Nach der Einreichung kann es zwischen 2 und 8 Wochen dauern, je nach der Warteschlange von Google und der Anzahl der von Google als notwendig erachteten Nachbesserungsrunden. Bleiben Sie auf dem Laufenden und stimmen Sie sich während des gesamten Überprüfungsprozesses mit uns ab.

Wenn Ihre Anwendung eingeschränkte Geltungsbereiche verwendet, sind zusätzliche Schritte erforderlich. Hier ist ein kurzer Überblick darüber, was zu erwarten ist:

Google-Sicherheitsbewertung
Um die Sicherheit der Nutzerdaten zu gewährleisten, müssen Apps, die Zugriff auf Google-Nutzerdaten mit eingeschränktem Umfang beantragen, eine Sicherheitsbewertung durchlaufen. Diese Bewertung ist entscheidend für die Überprüfung, ob alle Apps, die auf Google-Nutzerdaten zugreifen, Daten sicher handhaben und Nutzerdaten auf Anfrage löschen können. Der detaillierte Bewertungsprozess wird auf der CASA-Website (Cloud Application Security Assessment) beschrieben.

Google stuft Ihre Anwendung entweder als Tier 2 oder Tier 3 ein.

Stufe 2 (selbst gescannt - laborgeprüft) >> Am häufigsten
Wahlmöglichkeit zwischen kostenlos ODER kostenpflichtig (Drittgutachter)
CASA Stufe 2 Prozess
Stufe 3 (Laborgescannt - Laborgeprüft)
Bezahlt - Muss von einem Drittgutachter ausgefüllt werden
Nach Erhalt Ihrer Einstufung stellt Google Anweisungen und Tools für die Durchführung der Bewertung zur Verfügung. Weitere Informationen finden Sie unter dem angegebenen Link für Informationen zur Google-Sicherheitsbewertung und in den FAQs zur Sicherheitsbewertung. Stellen Sie sicher, dass Sie diesen Prozess einhalten, um zu zeigen, dass Ihre App in der Lage ist, Nutzerdaten sicher zu behandeln, wenn sie eingeschränkte Bereiche nutzt.

Informationen zur Google-Sicherheitsbewertung

Jährliche Neubewertung der Sicherheit von Anwendungen mit eingeschränktem Geltungsbereich
Apps, die auf eingeschränkte Bereiche zugreifen, müssen sich einem jährlichen Überprüfungsprozess zur Einhaltung der Vorschriften unterziehen und alle 12 Monate eine Sicherheitsbewertung durchführen, um den Zugang zu verifizierten eingeschränkten Bereichen zu erhalten. Dieser Prozess gewährleistet die kontinuierliche Einhaltung von Sicherheitsstandards und den Schutz von Nutzerdaten.

Wenn Sie zu irgendeinem Zeitpunkt einen neuen, eingeschränkten Anwendungsbereich einführen, der noch nicht bewertet und genehmigt wurde, muss Ihre Anwendung zu diesem Zeitpunkt möglicherweise erneut bewertet werden.

Das Google-Prüfungsteam wird sich per E-Mail mit Ihnen in Verbindung setzen, wenn es an der Zeit ist, dass Ihre App erneut zertifiziert wird. Es ist wichtig, dass Sie die Informationen zu Ihrem Projektverantwortlichen und Ihrem Projekteditor in Ihrer Cloud-Konsole auf dem neuesten Stand halten. Dadurch wird sichergestellt, dass die richtigen Mitglieder Ihres Teams Benachrichtigungen über diese jährliche Durchsetzung erhalten, was eine rechtzeitige und reibungslose Einhaltung der Anforderungen für die Neubewertung ermöglicht. Bleiben Sie wachsam und reagieren Sie umgehend auf Mitteilungen von Google, um die Sicherheit und Konformität Ihrer App zu gewährleisten. Weitere Informationen finden Sie in den FAQ von Google.

Whitelisting-Option
Wenn Sie eine Alternative zu den üblichen Verifizierungs- und Sicherheitsüberprüfungsverfahren bevorzugen, haben Sie die Möglichkeit, Ihre Bewerbung auf eine Whitelist setzen zu lassen. Auf diese Weise können Sie die üblichen Verfahren umgehen, aber es ist wichtig zu beachten, dass diese Option nur anwendbar ist, wenn Ihre Anwendung ganz bestimmte Kriterien erfüllt. Obwohl die meisten Anwendungsfälle diese Kriterien nicht erfüllen, haben wir im Folgenden die Anforderungen aufgeführt, anhand derer Sie beurteilen können, ob eine Whitelist für Ihre Anwendung in Frage kommt.

Anforderungen:

Die Mehrheit der Kunden nutzt Google Workspace:
Die meisten Ihrer Kunden sollten Google Workspace (früher GSuite) Konten verwenden, d.h. E-Mail-Adressen mit dem Format @company.com haben.
Die Whitelist erfordert eine Aktion der Administratoren der Endnutzer, um den Zugriff zu erlauben. Sie müssen den Administratoren Ihrer Nutzer Ihre Google projet Client ID mitteilen. Sie müssen ihre Konsole öffnen: https://admin.google.com/ac/owl/list?tab=configuredApps und Ihnen client_id erlauben.
Eingeschränkte Nutzung des persönlichen Gmail-Kontos:
Weniger als 100 persönliche Gmail-Konten (@gmail.com-Adressen) sollten in der Lage sein, sich in diesem Fluss zu authentifizieren.
Für nicht überprüfte Projekte gilt eine Obergrenze von 100 Nutzern (auf Lebenszeit) pro Projekt. Wenn sie auf der Whitelist stehen, werden Google Workspace-Konten nicht auf dieses Limit angerechnet. Persönliche Google Mail-Konten werden jedoch immer auf dieses Limit angerechnet.
Kostenlose Testbenutzer und Whitelisting:
Benutzer der kostenlosen Testversion müssen ihre Workspace-E-Mail-Adresse verwenden und die Anwendung auf die Whitelist setzen.
Denken Sie daran, dass Whitelisting eine Behelfslösung ist und möglicherweise nicht für alle Anwendungsfälle geeignet ist. Prüfen Sie diese Anforderungen sorgfältig, um festzustellen, ob Ihre Anwendung die Kriterien für Whitelisting erfüllt. Wenn ja, unternehmen Sie die notwendigen Schritte, um diese Anforderungen zu erfüllen, und prüfen Sie diesen alternativen Ansatz.

Die Google Mail-API ist speziell für die Interaktion mit Google Mail-Konten konzipiert und lässt sich nicht direkt mit anderen E-Mail-Clients oder -Diensten integrieren. Entwickler können die API jedoch verwenden, um E-Mails mit Google Mail zu synchronisieren oder von dort zu migrieren und dann die Interaktion mit Nicht-Gmail-Clients über deren jeweilige APIs oder Protokolle wie IMAP oder SMTP abzuwickeln.

Die Gmail-API hält sich an die strengen Datenschutzrichtlinien von Google und die Einhaltung von Vorschriften wie der GDPR. Die Zustimmung der Nutzer ist obligatorisch, und Anwendungen müssen OAuth 2.0 für die Authentifizierung und Autorisierung verwenden, um sicherzustellen, dass die Nutzer ausdrücklich die Erlaubnis zum Zugriff auf ihre Google Mail-Konten erteilen. Der Zugriff der Anwendung ist auf das für die Funktionalität notwendige Maß beschränkt, und die Nutzer können den Zugriff jederzeit widerrufen.

Die Kosten für die Nutzung der Google Mail-API hängen von der Anzahl der über Ihre Anwendung verbundenen Benutzerkonten ab. Spezifische Preisinformationen finden Sie auf der Website Preisseite auf der Website von Unipile. Dort finden Sie Einzelheiten zu den verschiedenen Preisstufen, die sich nach der Anzahl der Konten richten und Ihnen helfen, die mit Ihren speziellen Integrationsanforderungen verbundenen Kosten zu verstehen.

Unipile bietet umfassende Dokumentation zur Google Mail-API, einschließlich eines Entwicklerhandbuchs, API-Referenzen und Tutorials. Diese Ressourcen sind hilfreich bei der Fehlerbehebung und bieten Ratschläge zu bewährten Verfahren für die API-Integration.