Google Docs API-Bereiche auswählen

Dieses Dokument enthält die Google Docs API-spezifische Autorisierung und Authentifizierungsinformationen. Bevor Sie dieses Dokument lesen, sollten Sie die die allgemeinen Informationen zur Authentifizierung und Autorisierung von Google Workspace unter Informationen zur Authentifizierung und Autorisierung

OAuth 2.0 für die Autorisierung konfigurieren

OAuth-Zustimmungsbildschirm konfigurieren und Bereiche auswählen definieren, welche Informationen Nutzern und App-Prüfern angezeigt werden, und registrieren um sie später veröffentlichen zu können.

Docs API-Bereiche

Um die Zugriffsebene für Ihre App festzulegen, müssen Sie Autorisierungsbereiche deklarieren Ein Autorisierungsbereich ist ein OAuth 2.0-URI-String die den Namen der Google Workspace-App enthält, auf welche Art von Daten die App zugreift die Zugriffsebene. Bereiche sind die Anfragen Ihrer Anwendung zur Verwendung von Google Workspace-Daten, einschließlich des Nutzers Google-Kontodaten.

Wenn Ihre App installiert ist, wird ein Nutzer aufgefordert, die verwendeten Bereiche zu validieren durch die App. Im Allgemeinen sollten Sie den am engsten fokussierten Umfang und vermeiden Sie, Bereiche anzufordern, die Ihre App nicht benötigt. Nutzer mehr Zugriff auf eingeschränkte, klar beschriebene Bereiche zu gewähren.

Wir empfehlen, nach Möglichkeit nicht vertrauliche Bereiche zu verwenden, da die Berechtigungen pro Datei gewährt werden. den Zugriffsbereich und schränkt den Zugriff auf bestimmte Funktionen ein, die von einer App benötigt werden.

Die Docs API unterstützt folgende Bereiche:

Bereichscode Beschreibung Nutzung
https://www.googleapis.com/auth/documents Alle Ihre Google Docs-Dokumente abrufen, bearbeiten, erstellen und löschen. Sensibel
https://www.googleapis.com/auth/documents.readonly Alle Ihre Google Docs-Dokumente ansehen Sensibel
https://www.googleapis.com/auth/drive.file Nur bestimmte Google Drive-Dateien abrufen, bearbeiten, erstellen oder löschen, die Sie die Sie in dieser App verwenden können. Empfohlen
Kein sensibles Thema
https://www.googleapis.com/auth/drive Alle Ihre Google Drive-Dateien aufrufen, bearbeiten, erstellen und löschen. Eingeschränkt
https://www.googleapis.com/auth/drive.readonly Sie können alle Ihre Google Drive-Dateien aufrufen und herunterladen. Eingeschränkt

Die Spalte „Nutzung“ in der Tabelle gibt die Vertraulichkeit jedes Bereichs an, zu den folgenden Definitionen:

  • Nicht vertraulich: Diese Bereiche bieten den kleinsten Autorisierungsbereich. und erfordert nur eine einfache App-Überprüfung. Weitere Informationen unter App einreichen für .

  • Vertraulich: Diese Bereiche ermöglichen den Zugriff auf bestimmte Google-Nutzerdaten. der vom Nutzer für Ihre App autorisiert wurde. Sie müssen die zusätzliche App-Bestätigung. Informationen zu dieser Anforderung finden Sie unter Vertraulicher und eingeschränkter Bereich Anforderungen.

  • Eingeschränkt: Diese Umfänge ermöglichen einen umfassenden Zugriff auf Google-Nutzerdaten und müssen Sie einen Überprüfungsprozess für einen eingeschränkten Bereich durchlaufen. Für Informationen zu dieser Anforderung finden Sie unter Nutzerdaten für Google API-Dienste. Richtlinie und zusätzliche Anforderungen für bestimmte API Bereiche. Wenn Sie eingeschränkte Bereichsdaten auf Servern speichern (oder übertragen), müssen Sie eine Sicherheitsprüfung durchlaufen.

Wenn Ihre Anwendung Zugriff auf andere Google APIs benötigt, können Sie diese Bereiche hinzufügen. . Weitere Informationen zu den Google API-Bereichen finden Sie unter OAuth 2.0 für Folgendes verwenden: Auf Google APIs zugreifen

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