Überprüfung des eingeschränkten Bereichs

Für bestimmte Google APIs (diejenigen, die vertrauliche oder eingeschränkte Bereiche akzeptieren) gelten Anforderungen für Apps, die eine Berechtigung für den Zugriff auf Kundendaten anfordern. Diese zusätzlichen Anforderungen für eingeschränkte Bereiche erfordern, dass eine App nachweist, dass sie ein zulässiger Anwendungstyp ist, und sich zusätzlichen Überprüfungen unterzieht, einschließlich einer möglichen Sicherheitsprüfung.

Die Anwendbarkeit von eingeschränkten Bereichen innerhalb einer API hängt hauptsächlich vom Grad des Zugriffs ab, der erforderlich ist, um eine relevante Funktion in Ihrer App bereitzustellen: schreibgeschützt, lesegeschützt, Lese- und Schreibzugriff usw.

Wenn Sie OAuth 2.0 verwenden, um eine Berechtigung von einem Google-Konto für den Zugriff auf diese Daten zu erhalten, verwenden Sie Strings, die als Bereiche bezeichnet werden, um den Typ der Daten anzugeben, auf die Sie zugreifen möchten, und wie viel Zugriff Sie benötigen. Wenn Ihre App vertrauliche oder eingeschränkte Bereiche anfordert, müssen Sie die Überprüfung durchlaufen, es sei denn, die Verwendung Ihrer App fällt unter eine Ausnahme.

Es gibt weniger eingeschränkte Bereiche als vertrauliche Bereiche. Die FAQ zur OAuth API-Überprüfung enthält die aktuelle Liste der vertraulichen und eingeschränkten Bereiche. Diese Bereiche bieten umfassenden Zugriff auf Google-Nutzerdaten und erfordern, dass Sie eine Bereichsüberprüfung durchlaufen, bevor Sie die Bereiche von einem Google-Konto anfordern. Informationen zu dieser Anforderung finden Sie in der Nutzerdatenrichtlinie für Google API-Dienste und in den zusätzlichen Anforderungen für bestimmte API-Bereiche oder auf der produktspezifischen Google Developers-Seite. Wenn Sie Daten aus eingeschränkten Bereichen auf Servern speichern oder übertragen, müssen Sie eine Sicherheitsprüfung durchführen.

Eingeschränkte Bereiche

Wenn Ihre App eingeschränkte Bereiche anfordert und keine Ausnahme gilt, müssen Sie die zusätzlichen Anforderungen für bestimmte API-Bereiche der Nutzerdatenrichtlinie für Google API-Dienste oder die produktspezifischen Anforderungen auf der Google Developers-Seite des Produkts erfüllen. Dies erfordert eine umfassendere Überprüfung.

Bereichsverwendung

  • Prüfen Sie die Bereiche, die Ihre App verwendet oder verwenden soll. Um Ihre vorhandene Bereichsverwendung zu ermitteln, suchen Sie im Quellcode Ihrer App nach Bereichen, die mit Autorisierungsanfragen gesendet werden.
  • Stellen Sie sicher, dass jeder angeforderte Bereich für die beabsichtigten Aktionen der App-Funktion erforderlich ist und die geringsten Berechtigungen verwendet, die für die Bereitstellung der Funktion erforderlich sind. Eine Google API enthält in der Regel eine Referenzdokumentation auf der Google Developers-Seite des Produkts für die Endpunkte, einschließlich des Bereichs, der zum Aufrufen des Endpunkts oder bestimmter Eigenschaften darin erforderlich ist. Weitere Informationen zu den erforderlichen Zugriffsbereichen für die API-Endpunkte, die Ihre App aufruft, finden Sie in der Referenzdokumentation dieser Endpunkte. Wenn eine App beispielsweise nur Gmail APIs verwendet, um gelegentlich E‑Mails im Namen eines Nutzers zu senden, fordern Sie nicht den Bereich an, der vollständigen Zugriff auf die E‑Mail-Daten des Nutzers bietet.
  • 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.
  • In der API-Dokumentation finden Sie weitere Informationen zu den einzelnen Bereichen, einschließlich ihres potenziellen vertraulichen oder eingeschränkten Status.
  • 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 auf zusätzliche Überprüfungen hinzuweisen, die erforderlich sind.
  • Suchen Sie den besten Bereich, der den von Ihrer Integration verwendeten Daten entspricht, informieren Sie sich über die Verwendung, bestätigen Sie noch einmal, dass alles in einer Testumgebung funktioniert, und bereiten Sie dann die Einreichung zur Überprüfung vor.

Berücksichtigen Sie die Zeit, die für die Überprüfung erforderlich ist, in Ihrem Einführungsplan für Ihre App oder für neue Funktionen, für die ein neuer Bereich erforderlich ist. Eine dieser zusätzlichen Anforderungen tritt ein, wenn die App über einen Server auf Google-Nutzerdaten zugreift oder die Möglichkeit dazu hat. In diesen Fällen muss das System jährlich von einem unabhängigen Drittanbieter geprüft werden, der von Google zugelassen ist. Aus diesem Grund kann die Überprüfung von eingeschränkten Bereichen mehrere Wochen dauern. Alle Apps müssen zuerst die Marken überprüfung durchlaufen. Das dauert in der Regel zwei bis drei Werktage, wenn sich die Branding-Informationen seit der letzten genehmigten Überprüfung des OAuth-Zustimmungsbildschirms geändert haben.

Zulässige Anwendungstypen

Bestimmte Anwendungstypen können auf eingeschränkte Bereiche für jedes Produkt zugreifen. Die Anwendungstypen finden Sie auf der produktspezifischen Google Developers Seite (z. B. die Gmail API-Richtlinie).

Sie sind dafür verantwortlich, Ihren Anwendungstyp zu kennen und zu bestimmen. Wenn Sie sich jedoch wirklich nicht sicher sind, können Sie bei der Einreichung der App zur Überprüfung keine Optionen für die Frage Welche Funktionen werden Sie verwenden? auswählen. Das Überprüfungsteam der Google API bestimmt dann den Anwendungstyp.

Sicherheitsprüfung

Jede App, die Zugriff auf eingeschränkte Daten von Google-Nutzern anfordert und auf Daten von oder über einen Drittanbieterserver zugreifen kann, muss eine Sicherheitsprüfung durch von Google beauftragte Sicherheitsprüfer durchlaufen. Diese Prüfung trägt dazu bei, die Daten von Google-Nutzern zu schützen, indem überprüft wird, ob alle Apps, die auf Google-Nutzerdaten zugreifen, in der Lage sind, Daten sicher zu verarbeiten und Nutzerdaten auf Anfrage eines Nutzers zu löschen.

Um unsere Sicherheitsprüfung zu standardisieren, verwenden wir die App Defense Alliance und das Cloud Application Security Assessment Framework (CASA).

Wie bereits erwähnt, müssen Apps mindestens alle 12 Monate nach dem Genehmigungsdatum des Bewertungsberichts Ihres Prüfers noch einmal auf Einhaltung überprüft und einer Sicherheitsprüfung unterzogen werden, um den Zugriff auf bestätigte eingeschränkte Bereiche beizubehalten. Wenn Ihre App einen neuen eingeschränkten Bereich hinzufügt, muss sie möglicherweise noch einmal überprüft werden, um den zusätzlichen Bereich abzudecken, wenn er nicht in einer früheren Sicherheitsprüfung enthalten war.

Das Google-Überprüfungsteam sendet Ihnen eine E‑Mail, wenn es Zeit für die Rezertifizierung Ihrer App ist. Damit die richtigen Mitglieder Ihres Teams über diese jährliche Durchsetzung informiert werden, verknüpfen Sie zusätzliche Google-Konten als Inhaber oder Bearbeiter mit Ihrem Cloud Console-Projekt. Außerdem sollten Sie die E‑Mail-Adressen für den Nutzersupport und die Kontaktdaten des Entwicklers auf der Seite „OAuth-Branding“ in der Google Cloud Console auf dem neuesten Stand halten.

Vorbereitung auf die Überprüfung

Alle Apps, die Google APIs verwenden, um Zugriff auf Daten anzufordern, müssen die folgenden Schritte ausführen, um die Markenüberprüfung abzuschließen:

  1. Prüfen Sie, ob Ihre App unter einen der Anwendungsfälle im Abschnitt Ausnahmen von den Überprüfungsanforderungen fällt.
  2. Achten Sie darauf, dass Ihre App den Branding-Anforderungen der zugehörigen APIs oder des zugehörigen Produkts entspricht. Beispiele finden Sie in den Branding-Richtlinien für Google Log-in-Bereiche.
  3. 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.
  4. Achten Sie darauf, dass alle Branding-Informationen auf dem OAuth-Zustimmungsbildschirm, z. B. der App-Name, die Support-E‑Mail-Adresse, der URI der Startseite und der URI der Datenschutzerklärung, die Identität der App korrekt darstellen.

Anforderungen an die Startseite der Anwendung

Ihre Startseite muss die folgenden Anforderungen erfüllen:

  • Sie muss öffentlich zugänglich sein und nicht nur für angemeldete Nutzer Ihrer Website.
  • Die Relevanz Ihrer Startseite für die zu überprüfende App muss klar sein.
  • Links zum Eintrag Ihrer App im Google Play Store oder auf der Facebook-Seite sind keine gültigen Startseiten der Anwendung.

Anforderungen an den Link zur Datenschutzerklärung der Anwendung

Die Datenschutzerklärung Ihrer App muss die folgenden Anforderungen erfüllen:

  • Sie muss für Nutzer sichtbar sein, in 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 zu optionalen Nutzungsbedingungen enthalten.
  • In der Datenschutzerklärung muss offengelegt werden, wie Ihre Anwendung auf Google-Nutzerdaten zugreift, diese verwendet, speichert oder weitergibt. The privacy policy must comply with the Google API Services User Data Policy and the Limited Use requirements for restricted scopes. Sie müssen die Verwendung von Google-Nutzer daten auf die in Ihrer veröffentlichten Datenschutzerklärung offengelegten Praktiken beschränken.
  • * Review example cases of privacy policies that don't meet the Limited Use requirements.

App zur Markenüberprüfung einreichen

In einem Google Cloud Console-Projekt werden alle Ihre Cloud Console-Ressourcen organisiert. Ein Projekt besteht aus einer Reihe verknüpfter Google-Konten, die die Berechtigung haben, Projektvorgänge auszuführen, einer Reihe aktivierter 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 „Clients“ tun.

So reichen Sie die App zur Überprüfung ein:

  1. Achten Sie darauf, dass Ihre App den Nutzungsbedingungen für Google APIs und der Richtlinie zu Nutzerdaten für Google API-Dienste entspricht.
  2. Halten Sie die Inhaber- und Bearbeiterrollen der verknüpften Konten Ihres Projekts sowie die E‑Mail-Adresse für den Nutzersupport und die Kontaktdaten des Entwicklers Ihres OAuth-Zustimmungsbildschirms in der Cloud Console auf dem neuesten Stand. So werden die richtigen Mitglieder Ihres Teams über neue Anforderungen informiert.
  3. Rufen Sie die Seite „OAuth-Branding“ in der Cloud Console auf.
  4. Klicken Sie auf die Schaltfläche Projektauswahl.
  5. 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 eine URL in Ihrem Browser 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.
  6. 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.
  7. Klicken Sie auf die Schaltfläche Branding überprüfen , um die Überprüfung zu starten. Die automatisierte Überprüfung ist in der Regel innerhalb weniger Minuten abgeschlossen.
  8. Prüfen Sie nach Abschluss der Überprüfung den Status. Bei Erfolg ändert sich der Status zu Bereit zur Veröffentlichung. Wenn die automatisierte Überprüfung fehlschlägt, können Sie die erkannten Probleme sehen und sie entweder beheben oder eine manuelle Überprüfung beantragen.
  9. Klicken Sie auf die Schaltfläche Branding veröffentlichen , um das neue Branding zu aktivieren.
  10. 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 Status des Datenzugriffs zu verfolgen und alle angeforderten zusätzlichen Informationen anzugeben, z. B. ein Demovideo. Sie müssen einen veröffentlichten Branding-Status haben, bevor Sie eine Überprüfung für den Datenzugriff beantragen können.
  11. Verwenden Sie die Schaltfläche Bereiche hinzufügen oder entfernen , um alle von Ihrer App angeforderten Bereiche zu deklarieren. Im Abschnitt Nicht vertrauliche Bereiche ist eine erste Reihe von Bereichen vorab ausgefüllt, die für das Google Log-in erforderlich sind. Hinzugefügte Bereiche werden als nicht vertraulich klassifiziert, sensitive, or restricted .
  12. Geben Sie bis zu drei Links zu relevanter Dokumentation für zugehörige Funktionen in Ihrer App an.
  13. Geben Sie in den folgenden Schritten alle zusätzlichen Informationen an, die zu Ihrer App angefordert werden. 1. Ensure your app complies with the Additional requirements for specific API scopes, which includes undergoing an annual security assessment if your app accesses restricted scope Google users' data from or through a third-party server. 2. Ensure your app is one of the allowed types specified in the Limited Use section of the Additional requirements for specific API scopes page. 3. If your app is a task automation platform, your demonstration video must showcase how multiple API workflows are created and automated, and in which directions user data flows. 4. Prepare a video that fully demonstrates how a user initiates and grants access to the requested scopes and shows, in detail, the usage of the granted sensitive and restricted scopes in the app. Upload the video to YouTube Studio and set Visibility as Unlisted. You need to provide a link to the demonstration video in the YouTube link field. 1. Show the OAuth grant process that users will experience, in English. This includes the consent flow and, if you use Google Sign-In, the sign-in flow. 2. Show that the OAuth consent screen correctly displays the App Name. 3. Show that the browser address bar of the OAuth consent screen correctly includes your app's OAuth client ID. 4. To show how the data will be used, demonstrate the functionality that's enabled by each sensitive and restricted scope that you request. 5. If you use multiple clients, and therefore have multiple OAuth client IDs, show how the data is accessed on each OAuth client. 5. Select your permitted application type from the "What features will you use?" list. 6. Describe how you will use the restricted scopes in your app and why more limited scopes aren't sufficient.

Nachdem Sie Ihr Branding veröffentlicht oder eine Anfrage für den Datenzugriff eingereicht haben, meldet sich das Trust & Safety-Team von Google möglicherweise per E‑Mail mit zusätzlichen Informationen oder Schritten, die Sie ausführen müssen. 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 bestätigen, einschließlich der Frage, ob die Überprüfung 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 App sind oder wenn Ihre App 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 Apps durchlaufen und Ihren privaten Konten Zugriff auf Ihre App gewähren.

Projekte, die in den Stufen „Entwicklung“, „Test“ oder „Staging“ verwendet werden

Um die Google OAuth 2.0-Richtlinien einzuhalten, empfehlen wir, verschiedene Projekte für Test- und Produktionsumgebungen zu verwenden. Wir empfehlen, Ihre App nur zur Überprüfung einzureichen, wenn Sie sie für alle Nutzer mit einem Google-Konto verfügbar machen möchten. Wenn sich Ihre App also in der Entwicklungs-, Test- oder Staging-Phase befindet, ist keine Überprüfung erforderlich.

Wenn sich Ihre App in der Entwicklungs- oder Testphase befindet, können Sie den Veröffentlichungsstatus auf die Standardeinstellung Test belassen. Diese Einstellung bedeutet, dass sich Ihre App noch in der Entwicklung befindet und nur für Nutzer verfügbar ist, die Sie der Liste der Testnutzer hinzufügen. Sie müssen die Liste der Google-Konten verwalten, die an der Entwicklung oder dem Test Ihrer App beteiligt sind.

Warnmeldung, dass Google eine App, die getestet wird, nicht überprüft hat.
Abbildung 1. Warnbildschirm für Tester

Nur dienstbezogene Daten

Wenn Ihre App ein Dienstkonto verwendet, um nur auf eigene 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 zur internen Verwendung

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 Nutzertyp Intern konfiguriert sein. In diesem Fall muss Ihre App möglicherweise von einem Organisationsadministrator genehmigt werden. Weitere Informationen finden Sie unter Zusätzliche Überlegungen für Google Workspace.

Domainweite Installation

Wenn Ihre App nur auf Nutzer einer Google Workspace- oder Cloud Identity-Organisation ausgerichtet ist und immer domainweit installiert wird, ist keine Markenüberprüfung erforderlich. Wenn Ihre App jedoch eingeschränkte oder vertrauliche Bereiche verwendet, ist eine App-Überprüfung erforderlich. Bei einer domainweiten Installation kann ein Domainadministrator Drittanbieter- und internen Apps Zugriff auf die Daten Ihrer Nutzer gewähren. Nur Organisationsadministratoren können die App einer Zulassungsliste für die Verwendung in ihren Domains hinzufügen.

Informationen dazu, wie Sie Ihre App domainweit installieren, finden Sie in den FAQ unter Meine Anwendung hat Nutzer mit Unternehmenskonten aus einer anderen Google Workspace-Domain.