Bevor Sie eine Anwendung starten, die Nutzeranmeldedaten für die Data Manager API von externen Nutzern anfordert, muss Ihr Google Cloud-Projekt die Google OAuth-App-Überprüfung durchlaufen.
In diesem Leitfaden werden die empfohlenen Übergänge bei der Konfiguration der Zielgruppe während der Entwicklung und die Schritte zur Überprüfung der Google OAuth-App beschrieben.
Phasen der Zielgruppenansprache für Apps
Konfigurieren Sie je nach Entwicklungsphase die Seite „Zielgruppe“ in der Google Cloud Console mit unterschiedlichen Einstellungen für Nutzertyp und Veröffentlichungsstatus. Folgen Sie diesen Phasen, um einen reibungslosen Übergang von den ersten Tests zur Produktionseinführung zu ermöglichen.
Phase 1: Erste Entwicklung (Testen)
Zu Beginn der Entwicklung und beim Testen grundlegender API-Anfragen:
Veröffentlichungsstatus: Auf Test festgelegt.
Nutzertyp:
Wenn Ihr Google Cloud-Projekt zu einer Google Workspace-Organisation gehört und nur Nutzer in Ihrer Organisation die App verwenden, wählen Sie Intern aus.
Wählen Sie andernfalls Extern aus.
Testnutzer: Wenn Sie den Nutzertyp auf Extern festlegen, klicken Sie auf Nutzer hinzufügen, um die Google-Konten, die Sie zum Generieren von Anmeldedaten verwenden, manuell hinzuzufügen. Nur die aufgeführten Google-Konten können die App autorisieren. Außerdem gelten Testlimits und Regeln für den Ablauf von Tokens.
Während des Tests ist keine Überprüfung erforderlich. Wenn Sie Extern verwenden, sehen Testnutzer einen Warnbildschirm, auf dem sie bestätigen müssen, dass sie Testzugriff auf eine nicht überprüfte App haben, bevor sie zum Zustimmungsbildschirm weitergeleitet werden.
Phase 2: Kurz vor der Einführung (Einreichung zur Überprüfung)
Wenn die Integration abgeschlossen ist, die Benutzeroberfläche erstellt wurde und du die Einführung innerhalb des nächsten Monats planst:
Aktualisieren Sie die Einstellungen auf der Seite „Zielgruppe“:
Veröffentlichungsstatus: Wechseln Sie zu In Produktion.
Nutzertyp: Legen Sie Extern fest, wenn Ihre App für Kunden außerhalb Ihrer Organisation bestimmt ist, z. B. Werbetreibende.
Reichen Sie Ihre App zur Überprüfung ein. Die Überprüfung der Google OAuth-App kann mehrere Wochen dauern. Reichen Sie sie daher so früh wie möglich ein, sobald Ihre Benutzeroberfläche bereit ist.
Anforderungen an die App-Überprüfung
Wenn Sie Ihre App im Überprüfungscenter zur Überprüfung einreichen möchten, konfigurieren Sie die Einstellungen für die Google Auth Platform und bereiten Sie die erforderlichen Überprüfungsmaterialien vor.
Branding und Datenschutzerklärung
Prüfen Sie auf der Seite „Branding“ in der Google Cloud Console die folgenden Details, bevor Sie sie einreichen:
Startseite der Anwendung: Ihre Startseite muss öffentlich zugänglich sein und einen sichtbaren Link zur Datenschutzerklärung Ihrer Anwendung enthalten.
Link zur Datenschutzerklärung: Die auf der Seite „Branding“ konfigurierte URL zur Datenschutzerklärung muss mit der URL zur Datenschutzerklärung übereinstimmen, die auf der Startseite Ihrer Anwendung verlinkt ist.
Überprüfungsbereiche
Fordern Sie auf der Seite Datenzugriff nur die Bereiche an, die Ihre Anwendung benötigt. Die Data Manager API verwendet sensible Bereiche:
https://www.googleapis.com/auth/datamanager(primärer Bereich)https://www.googleapis.com/auth/datamanager.partnerlink(für Partnerlinks)
Geben Sie bei der Einreichung zur Überprüfung eine detaillierte schriftliche Erklärung dazu ab, warum Ihre Anwendung Zugriff auf die angeforderten Bereiche benötigt.
Kontaktdaten
Das Google OAuth-Überprüfungsteam sendet alle Mitteilungen an die Projektinhaber und Projektbearbeiter, die in Ihrem Google Cloud-Projekt konfiguriert sind. Halten Sie diese Kontaktdaten in der Google Cloud Console auf dem neuesten Stand, damit Sie keine Informationsanfragen verpassen.
Wenn das Überprüfungsteam Folgefragen sendet oder Aktualisierungen anfordert (z. B. Änderungen an Ihrem Demonstrationsvideo oder den Einstellungen des Zustimmungsbildschirms), wird die Überprüfung pausiert, bis Sie antworten. Wenn Ihre Einreichung seit mehr als ein paar Wochen aussteht, ohne dass Sie eine Aktualisierung erhalten haben, prüfen Sie die E-Mail-Posteingänge (einschließlich Spam- und Junk-Ordner) aller Project Owner und Projektbearbeiter.
Demonstrationsvideo
Geben Sie einen Link zu einem öffentlich zugänglichen Demonstrationsvideo an, z. B. ein nicht gelistetes YouTube-Video oder einen öffentlichen Google Drive-Link, in dem gezeigt wird, wie Ihre Anwendung die angeforderten Bereiche verwendet.
Achten Sie darauf, dass das Video alle Anforderungen an Videos zur Demonstration von App-Funktionen erfüllt, einschließlich der folgenden Data Manager API-Prüfungen:
Vollständige User Journey und OAuth-Zustimmung: Zeigen Sie die vollständige User Journey in Ihrer Anwendung, beginnend mit der Anmeldung oder Autorisierung durch den Nutzer bis zum Abschluss des OAuth-Zustimmungsablaufs.
Übereinstimmende App-Identität: Der Name, das Logo und das Branding der Anwendung im Video müssen mit der Konfiguration auf der Branding-Seite in der Google Cloud Console übereinstimmen.
Vollständiger OAuth-Zustimmungsbildschirm auf Englisch: Zeigen Sie den gesamten OAuth-Zustimmungsbildschirm mit der Sprachauswahl in der linken unteren Ecke auf Englisch an. Achten Sie darauf, dass auf dem Bildschirm genau die Data Manager API-Bereiche angezeigt werden, die Ihre App anfordert.
Verwendung der Bereiche in der Benutzeroberfläche Ihrer App: Zeigen Sie die App-Funktionen, die die angeforderten Bereiche verwenden (z. B. das Erstellen eines Partnerlinks, das Erstellen einer Zielgruppenliste oder das Konfigurieren der Datenaufnahme in der Benutzeroberfläche Ihrer Anwendung).
Phase 3: Bereit zur Einführung (bestätigt)
Sobald das Google OAuth-Überprüfungsteam Sie darüber informiert hat, dass Ihr Antrag auf App-Überprüfung genehmigt wurde, sind keine weiteren Maßnahmen erforderlich. Ihre App ist jetzt überprüft und externe Nutzer können sie autorisieren, ohne dass der Warnbildschirm für nicht überprüfte Apps angezeigt wird.