Google Docs API-Bereiche auswählen

Dieses Dokument enthält spezifische Autorisierungs- und Authentifizierungsinformationen für die Google Docs API. Bevor Sie dieses Dokument lesen, sollten Sie die allgemeinen Authentifizierungs- und Autorisierungsinformationen für Google Workspace unter Informationen zu Authentifizierung und Autorisierunglesen.

OAuth 2.0 für die Autorisierung konfigurieren

Konfigurieren Sie den OAuth-Zustimmungsbildschirm, und wählen Sie Bereiche aus um festzulegen, welche Informationen Nutzern und App-Prüfern angezeigt werden, und registrieren Sie Ihre App, damit Sie sie später veröffentlichen können.

Docs API-Bereiche

Um die Zugriffsebene zu definieren, die Ihrer App gewährt wird, müssen Sie Autorisierungsbereiche identifizieren und deklarieren. Ein Autorisierungsbereich ist ein OAuth 2.0-URI-String, der den Namen der Google Workspace-App, die Art der Daten, auf die sie zugreift, und die Zugriffsebene enthält. Bereiche sind die Anfragen Ihrer App, mit Google Workspace-Daten zu arbeiten, einschließlich der Google-Kontodaten von Nutzern.

Wenn Ihre App installiert wird, werden Nutzer aufgefordert, die von der App verwendeten Bereiche zu bestätigen. Im Allgemeinen sollten Sie den engsten Bereich auswählen und keine Bereiche anfordern, die Ihre App nicht benötigt. Nutzer gewähren eher Zugriff auf eingeschränkte, klar beschriebene Bereiche.

Wenn möglich, empfehlen wir die Verwendung von nicht vertraulichen Bereichen, da dadurch der Zugriffsbereich pro Datei gewährt und der Zugriff auf bestimmte Funktionen eingeschränkt wird, die von einer App benötigt werden.

Die Docs API unterstützt die folgenden Bereiche:

Bereichscode Beschreibung Nutzung
https://www.googleapis.com/auth/documents Alle Google Docs-Dokumente ansehen, bearbeiten, erstellen und löschen Vertraulich
https://www.googleapis.com/auth/documents.readonly Alle Google Docs-Dokumente ansehen Vertraulich
https://www.googleapis.com/auth/drive.file Nur die spezifischen Google Drive-Dateien ansehen, bearbeiten, erstellen und löschen, die Sie mit dieser App verwenden Empfohlen
Nicht vertraulich
https://www.googleapis.com/auth/drive Alle Google Drive-Dateien ansehen, bearbeiten, erstellen und löschen Eingeschränkt
https://www.googleapis.com/auth/drive.readonly Alle Google Drive-Dateien ansehen und herunterladen Eingeschränkt

In der Spalte „Nutzung“ der Tabelle wird die Vertraulichkeit der einzelnen Bereiche gemäß den folgenden Definitionen angegeben:

  • Nicht vertraulich: Diese Bereiche bieten den kleinsten Umfang an Autorisierungs zugriff und erfordern nur eine grundlegende App-Überprüfung. Informationen zu dieser Anforderung finden Sie unter App zur Überprüfung einreichen.

  • Vertraulich: Diese Bereiche bieten Zugriff auf bestimmte Google-Nutzerdaten die vom Nutzer für Ihre App autorisiert wurden. Sie müssen eine zusätzliche App-Überprüfung durchlaufen. Informationen zu dieser Anforderung finden Sie unter Anforderungen für vertrauliche und eingeschränkte Bereiche.

  • Eingeschränkt: Diese Bereiche bieten umfassenden Zugriff auf Google-Nutzerdaten und erfordern einen Überprüfungsprozess für eingeschränkte Bereiche. Informationen zu dieser Anforderung finden Sie in der Nutzerdatenrichtlinie für Google API-Dienste und unter Zusätzliche Anforderungen für bestimmte API-Bereiche. Wenn Sie Daten aus eingeschränkten Bereichen auf Servern speichern oder übertragen, müssen Sie eine Sicherheitsüberprüfung durchlaufen.

Wenn Ihre App Zugriff auf andere Google APIs benötigt, können Sie diese Bereiche ebenfalls hinzufügen. Weitere Informationen zu Google API-Bereichen finden Sie unter Mit OAuth 2.0 auf Google APIs zugreifen.

Weitere Informationen zu bestimmten OAuth 2.0-Bereichen finden Sie unter OAuth 2.0-Bereiche für Google APIs.