Wenn Ihre App die Berechtigung anfordert, über Google APIs auf die Daten von Google-Nutzern zuzugreifen, müssen Sie möglicherweise ein Überprüfungsverfahren durchlaufen, bevor Sie Ihre App zum ersten Mal öffentlich verfügbar machen.
Ob diese Anforderung für Ihre App gilt, hängt hauptsächlich von zwei Faktoren ab:
- Die Art der Nutzerdaten, auf die Sie zugreifen, z. B. öffentliche Profilinformationen, Kalendereinträge, Dateien in Drive, bestimmte Gesundheits- und Fitnessdaten usw.
- Die erforderliche Zugriffsebene, z. B. Lesezugriff, Lese- und Schreibzugriff usw.
Wenn Sie OAuth 2.0 verwenden, um von einem Google-Konto die Berechtigung für den Zugriff auf die Daten zu erhalten, verwenden Sie Strings, die als Bereiche bezeichnet werden, um den Typ der Daten anzugeben, auf die Sie im Namen des Nutzers zugreifen möchten. Wenn Ihre App Bereiche anfordert, die als vertraulich oder eingeschränkt eingestuft sind, müssen Sie wahrscheinlich das Überprüfungsverfahren durchlaufen, es sei denn, die Nutzung Ihrer App fällt unter eine Ausnahme.
Beispiele für sensible Bereiche sind das Lesen von in Google Kalender gespeicherten Terminen, das Speichern eines neuen Kontakts in Google Kontakte oder das Löschen eines YouTube-Videos. Weitere Informationen zu verfügbaren Bereichen und ihren Klassifizierungen finden Sie in der Referenzdokumentation der API-Endpunkte, die von Ihrer App aufgerufen werden, und in allen zugehörigen Autorisierungsleitfäden, die für die API veröffentlicht wurden.
Sie müssen Bereiche anfordern, die den geringsten Zugriff auf Nutzerdaten erfordern, der für die Bereitstellung dieser Funktion erforderlich ist. Beispiel: Eine App, die nur Daten liest, darf keinen Zugriff zum Lesen, Schreiben und Löschen von Inhalten anfordern, wenn für die API und die zugehörigen Endpunkte ein engerer Bereich verfügbar ist. Daten, die Sie von einer Google API erhalten, dürfen nur in Übereinstimmung mit den Richtlinien der API und so verwendet werden, wie Sie es Ihren Nutzern in den Aktionen Ihrer App und in Ihrer Datenschutzerklärung mitteilen.
Berücksichtigen Sie die Zeit, die für die Bestätigung erforderlich ist, in Ihrem Einführungsplan für Ihre App oder für neue Funktionen, die einen neuen Bereich erfordern. Die Überprüfung sensibler Bereiche kann bis zu 10 Tage dauern. Möglicherweise ist Ihre App für die Markenüberprüfung als Teil Ihrer Anfrage zur Überprüfung sensibler Bereiche berechtigt.
Sensible Bereiche
Sensible Bereiche müssen von Google überprüft werden, bevor ein Google-Konto Zugriff gewähren kann. Administratoren von Google Workspace-Organisationen können den Zugriff auf sensible Bereiche einschränken, um den Zugriff durch OAuth-Client-IDs zu verhindern, die von der Organisation nicht explizit als vertrauenswürdig gekennzeichnet wurden.
Informationen zur Verwendung von Bereichen
- Prüfen Sie die Bereiche, die Ihre App verwendet oder die Sie verwenden möchten. Wenn Sie herausfinden möchten, welche Bereiche Sie derzeit verwenden, prüfen Sie den Quellcode Ihrer App auf Bereiche, die mit Autorisierungsanfragen gesendet werden.
- Stellen Sie sicher, dass jeder angeforderte Bereich für die beabsichtigten Aktionen der App-Funktion erforderlich ist und die geringste Berechtigung verwendet wird, die für die Bereitstellung der Funktion erforderlich ist. Eine Google API hat in der Regel eine Referenzdokumentation auf der Google Developers-Seite des Produkts für ihre Endpunkte, die den Bereich enthält, der zum Aufrufen des Endpunkts oder bestimmter Attribute darin erforderlich ist. Weitere Informationen zu den erforderlichen Zugriffsbereichen für die API-Endpunkte, die Ihre Anwendung aufruft, finden Sie in der Referenzdokumentation zu diesen Endpunkten.
- Daten, die Sie von einer Google API erhalten, dürfen nur in Übereinstimmung mit den Richtlinien der API und so verwendet werden, wie Sie es Ihren Nutzern in den Aktionen Ihrer App und in Ihrer Datenschutzerklärung mitteilen.
- Weitere Informationen zu den einzelnen Bereichen, einschließlich des potenziellen sensiblen oder eingeschränkten Status, finden Sie in der API-Dokumentation.
- Geben Sie alle von Ihrer App verwendeten Bereiche auf der Seite „Datenzugriff“ in der Cloud Console an. Die von Ihnen angegebenen Bereiche werden in vertrauliche oder eingeschränkte Kategorien gruppiert, um zusätzliche Überprüfungen hervorzuheben, die erforderlich sind.
- Suchen Sie den besten Bereich, der den von Ihrer Integration verwendeten Daten entspricht, machen Sie sich mit seiner Verwendung vertraut, prüfen Sie noch einmal, ob in einer Testumgebung alles funktioniert, und bereiten Sie dann die Einreichung zur Überprüfung vor.
Vorbereitung auf die Überprüfung
Alle Apps, die über Google APIs Zugriff auf Daten anfordern, müssen die folgenden Schritte ausführen, um die Markenüberprüfung abzuschließen:
- Prüfen Sie, ob Ihre Anwendung unter einen der Anwendungsfälle im Abschnitt Ausnahmen von den Überprüfungsanforderungen fällt.
- Achten Sie darauf, dass Ihre App die Markenanforderungen der zugehörigen APIs oder Produkte erfüllt. Beispiele finden Sie in den Branding-Richtlinien für Google Log-in-Bereiche.
- Bestätigen Sie die Inhaberschaft der autorisierten Domains Ihres Projekts in der Google Search Console. Verwenden Sie ein Google-Konto, das mit Ihrem API Console-Projekt als Inhaber oder Bearbeiter verknüpft ist.
- Achten Sie darauf, dass alle Branding-Informationen auf dem OAuth-Zustimmungsbildschirm, z. B. der App-Name, die Support-E-Mail-Adresse, der Startseiten-URI und der URI der Datenschutzerklärung, die Identität der App korrekt wiedergeben.
Anforderungen an die Startseite der Anwendung
Ihre Startseite muss die folgenden Anforderungen erfüllen:
- Ihre Startseite muss öffentlich zugänglich sein und darf nicht nur für angemeldete Nutzer Ihrer Website zugänglich sein.
- Die Relevanz Ihrer Startseite für die zu überprüfende App muss klar erkennbar sein.
- Links zum Eintrag Ihrer App im Google Play Store oder auf der Facebook-Seite werden nicht als gültige Startseiten der Anwendung betrachtet.
Anforderungen an den Link zur Datenschutzerklärung der Anwendung
Die Datenschutzerklärung Ihrer App muss die folgenden Anforderungen erfüllen:
- Die Datenschutzerklärung muss für Nutzer sichtbar sein, auf derselben Domain wie die Startseite Ihrer Anwendung gehostet werden und auf dem OAuth-Zustimmungsbildschirm der Google API Console verlinkt sein. Die Startseite muss eine Beschreibung der Funktionen der App sowie Links zur Datenschutzerklärung und optional zu den Nutzungsbedingungen enthalten.
- In der Datenschutzerklärung muss offengelegt werden, wie Ihre Anwendung auf Daten von Google-Nutzern zugreift, diese verwendet, speichert oder weitergibt. Sie müssen die Verwendung von Google-Nutzerdaten auf die in Ihrer veröffentlichten Datenschutzerklärung offengelegten Praktiken beschränken.
App zur Markenüberprüfung einreichen
In einem Google Cloud Console-Projekt werden alle Ihre Cloud Console-Ressourcen organisiert. Ein Projekt umfasst mehrere verknüpfte Google-Konten, die berechtigt sind, Projektvorgänge auszuführen, mehrere aktivierte APIs sowie Abrechnungs-, Authentifizierungs- und Überwachungseinstellungen für diese APIs. Ein Projekt kann beispielsweise einen oder mehrere OAuth-Clients enthalten, APIs für die Verwendung durch diese Clients konfigurieren und einen OAuth-Zustimmungsbildschirm konfigurieren, der Nutzern angezeigt wird, bevor sie den Zugriff auf Ihre App autorisieren.
Wenn einer Ihrer OAuth-Clients nicht für die Produktion bereit ist, empfehlen wir, ihn aus dem Projekt zu löschen, für das die Überprüfung angefordert wird. Das können Sie auf der Seite „Kunden“ tun.
So reichen Sie die Informationen zur Überprüfung ein:
- Ihre App muss den Nutzungsbedingungen für Google APIs und der Richtlinie zu Nutzerdaten für Google API-Dienste entsprechen.
- Halten Sie die Inhaber- und Bearbeiterrollen der mit Ihrem Projekt verknüpften Konten sowie die E-Mail-Adresse für den Nutzersupport und die Kontaktdaten des Entwicklers auf dem OAuth-Zustimmungsbildschirm in der Cloud Console auf dem neuesten Stand. So werden die richtigen Mitglieder Ihres Teams über neue Anforderungen informiert.
- Rufen Sie in der Cloud Console die Seite „OAuth-Branding“ auf.
- Klicken Sie auf den Button Projektauswahl.
Wählen Sie im angezeigten Dialogfeld Auswählen aus Ihr Projekt aus. Wenn Sie Ihr Projekt nicht finden, aber die Projekt-ID kennen, können Sie in Ihrem Browser eine URL im folgenden Format erstellen:
https://console.developers.google.com/auth/branding?project=[PROJECT_ID]
Ersetzen Sie [PROJECT_ID] durch die Projekt-ID, die Sie verwenden möchten.
Geben Sie auf der Seite Branding die Branding-Informationen Ihrer App an, einschließlich App-Name, Logo, Kontaktdaten des Entwicklers und relevante Links. Alle Änderungen, die Sie vornehmen, werden als Branding-Entwurf gespeichert.
Klicken Sie auf den Button Branding bestätigen, um den Bewertungsprozess zu starten. Die automatisierte Überprüfung ist in der Regel innerhalb weniger Minuten abgeschlossen.
Prüfen Sie den Status, sobald die Bewertung abgeschlossen ist. Wenn der Vorgang erfolgreich durchgeführt wurde, ändert sich der Status in Bereit zur Veröffentlichung. Wenn die automatische Überprüfung fehlschlägt, können Sie die erkannten Probleme einsehen und entweder beheben oder eine manuelle Überprüfung beantragen.
Klicken Sie auf den Button Branding veröffentlichen, um das neue Branding zu aktivieren.
Wenn für Ihre App auch eine Überprüfung für vertrauliche oder eingeschränkte Bereiche erforderlich ist, rufen Sie das OAuth-Überprüfungscenter auf, um den Datenzugriffsstatus zu verfolgen und alle angeforderten zusätzlichen Informationen anzugeben, z. B. ein Demonstrationsvideo. Sie müssen einen veröffentlichten Branding-Status haben, bevor Sie eine Überprüfung für den Datenzugriff anfordern können.
Verwenden Sie die Schaltfläche Bereiche hinzufügen oder entfernen, um alle von Ihrer App angeforderten Bereiche zu deklarieren. Im Abschnitt Nicht vertrauliche Bereiche sind bereits einige Bereiche vorausgefüllt, die für Google Log-in erforderlich sind. Hinzugefügte Bereiche werden als nicht sensibel, sensibel oder eingeschränkt klassifiziert.
Stellen Sie bis zu drei Links zu relevanten Dokumentationen für ähnliche Funktionen in Ihrer App bereit.
Geben Sie in den folgenden Schritten alle weiteren Informationen zu Ihrer App an, die angefordert werden.
- Bereiten Sie eine detaillierte Begründung für jeden angeforderten sensiblen Bereich vor und erklären Sie, warum ein engerer Bereich nicht ausreicht. Beispiel: „Meine App verwendet
https://www.googleapis.com/auth/calendar, um die Google Kalender-Daten eines Nutzers auf dem Planungsbildschirm meiner App anzuzeigen. So können Nutzer ihre Termine über meine App verwalten und die Änderungen mit ihrem Google Kalender synchronisieren.“ - Bereiten Sie ein Video vor, in dem vollständig gezeigt wird, wie ein Nutzer den Zugriff auf die angeforderten Bereiche initiiert und gewährt. Außerdem muss im Detail zu sehen sein, wie die gewährten sensiblen und eingeschränkten Bereiche in der App verwendet werden. Laden Sie das Video in YouTube Studio hoch und legen Sie die Sichtbarkeit auf Nicht gelistet fest. Sie müssen im Feld für den YouTube-Link einen Link zum Demonstrationsvideo angeben.
- Zeigen Sie den OAuth-Zustimmungsprozess, den Nutzer durchlaufen, auf Englisch. Dazu gehören der Einwilligungsablauf und, wenn Sie Google Log-in verwenden, der Anmeldeablauf.
- Zeigen Sie, dass der App-Name auf dem OAuth-Zustimmungsbildschirm korrekt angezeigt wird.
- Zeigen Sie, dass die Browseradressleiste des OAuth-Zustimmungsbildschirms die OAuth-Client-ID Ihrer App korrekt enthält.
- Um zu zeigen, wie die Daten verwendet werden, demonstrieren Sie die Funktionalität, die durch jeden von Ihnen angeforderten sensiblen Bereich ermöglicht wird.
- Bereiten Sie eine detaillierte Begründung für jeden angeforderten sensiblen Bereich vor und erklären Sie, warum ein engerer Bereich nicht ausreicht. Beispiel: „Meine App verwendet
Nachdem Sie Ihr Branding veröffentlicht oder eine Anfrage für den Datenzugriff gesendet haben, meldet sich das Trust & Safety-Team von Google möglicherweise per E-Mail, um weitere Informationen anzufordern oder Sie über die nächsten Schritte zu informieren. Prüfen Sie Ihre E-Mail-Adressen im Abschnitt Kontaktdaten des Entwicklers und die Support-E-Mail-Adresse Ihres OAuth-Zustimmungsbildschirms auf Anfragen nach zusätzlichen Informationen. Sie können auch die Seiten „Branding“ oder „Überprüfungscenter“ Ihres Projekts aufrufen, um den aktuellen Überprüfungsstatus Ihres Projekts zu prüfen. Dort sehen Sie auch, ob der Überprüfungsprozess pausiert ist, während wir auf Ihre Antwort warten.
Ausnahmen von den Überprüfungsanforderungen
Wenn Ihre App in einem der in den folgenden Abschnitten beschriebenen Szenarien verwendet wird, müssen Sie sie nicht zur Überprüfung einreichen.
Private Nutzung
Ein Anwendungsfall ist, wenn Sie der einzige Nutzer Ihrer Anwendung sind oder wenn Ihre Anwendung nur von wenigen Nutzern verwendet wird, die Sie alle persönlich kennen. Sie und Ihre begrenzte Anzahl von Nutzern können den Bildschirm für nicht überprüfte Anwendungen durchlaufen und Ihren privaten Konten Zugriff auf Ihre Anwendung gewähren.
Projekte, die in Entwicklungs-, Test- oder Staging-Stufen verwendet werden
Um die Google OAuth 2.0-Richtlinien einzuhalten, empfehlen wir, für Test- und Produktionsumgebungen unterschiedliche Projekte zu verwenden. Wir empfehlen, Ihre App nur dann zur Überprüfung einzureichen, wenn Sie sie allen Nutzern mit einem Google-Konto zur Verfügung stellen möchten. Wenn sich Ihre App in der Entwicklungs-, Test- oder Staging-Phase befindet, ist daher keine Überprüfung erforderlich.
Wenn sich Ihre App in der Entwicklungs- oder Testphase befindet, können Sie den Veröffentlichungsstatus auf der Standardeinstellung Wird getestet belassen. Diese Einstellung bedeutet, dass sich Ihre Anwendung noch in der Entwicklung befindet und nur für Nutzer verfügbar ist, die Sie in die Liste der Testnutzer aufnehmen. Du musst die Liste der Google-Konten verwalten, die an der Entwicklung oder am Testen deiner App beteiligt sind.
Nur Daten, die dem Dienst gehören
Wenn Ihre App ein Dienstkonto verwendet, um nur auf ihre eigenen Daten zuzugreifen, und nicht auf Nutzerdaten (die mit einem Google-Konto verknüpft sind), müssen Sie sie nicht zur Überprüfung einreichen.
Informationen zu Dienstkonten finden Sie in der Google Cloud-Dokumentation unter Dienstkonten. Eine Anleitung zur Verwendung eines Dienstkontos finden Sie unter OAuth 2.0 für Server-zu-Server-Anwendungen verwenden.
Nur für den internen Gebrauch
Das bedeutet, dass die App nur von Personen in Ihrer Google Workspace- oder Cloud Identity-Organisation verwendet wird. Das Projekt muss der Organisation gehören und der OAuth-Zustimmungsbildschirm muss für den internen Nutzertyp konfiguriert sein. In diesem Fall muss Ihre Anwendung möglicherweise von einem Organisationsadministrator genehmigt werden. Weitere Informationen finden Sie unter Zusätzliche Überlegungen für Google Workspace.
- Weitere Informationen zu öffentlichen und internen Anwendungen.
- Informationen dazu, wie Sie Ihre Anwendung als intern kennzeichnen, finden Sie in der FAQ Wie kann ich meine Anwendung als „nur intern“ kennzeichnen?
Domainweite Installation
Wenn Ihre App nur für Nutzer einer Google Workspace- oder Cloud Identity-Organisation gedacht ist und immer die domainweite Installation verwendet wird, ist für Ihre App keine Markenbestätigung erforderlich. Wenn Ihre Anwendung jedoch eingeschränkte oder vertrauliche Bereiche verwendet, ist eine Anwendungsüberprüfung erforderlich. Bei einer domainweiten Installation kann ein Domainadministrator Drittanbieter- und internen Anwendungen Zugriff auf die Daten Ihrer Nutzer gewähren. Nur Administratoren der Organisation können die App auf eine Zulassungsliste für die Verwendung in ihren Domains setzen.
Informationen dazu, wie Sie Ihre App domainweit installieren, finden Sie in den FAQs unter Meine Anwendung hat Nutzer mit Arbeitskonten aus einer anderen Google Workspace-Domain.