Google Sheets API-Bereiche auswählen

Dieses Dokument enthält API-spezifische Autorisierungs- und Authentifizierungsinformationen für die Google Tabellen API. Lesen Sie sich vor diesem Dokument die allgemeinen Informationen zur Authentifizierung und Autorisierung in Google Workspace unter Weitere Informationen zur Authentifizierung und Autorisierung durch.

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-Rezensenten angezeigt werden. Registrieren Sie dann Ihre App, damit Sie sie später veröffentlichen können.

Sheets API-Bereiche

Um die Zugriffsebene für Ihre App zu definieren, müssen Sie Autorisierungsbereiche angeben. Ein Autorisierungsbereich ist ein OAuth 2.0-URI-String, der den Namen der Google Workspace-App, die Art der Daten, auf die zugegriffen wird, und die Zugriffsebene enthält. Bereiche sind die Anfragen Ihrer App zur Verarbeitung von Google Workspace-Daten, einschließlich der Google-Kontodaten der Nutzer.

Wenn Ihre App installiert wird, wird ein Nutzer aufgefordert, die von der App verwendeten Bereiche zu bestätigen. Im Allgemeinen sollten Sie den möglichst eng gefassten Bereich auswählen und Bereiche vermeiden, die für Ihre App nicht erforderlich sind. Nutzer gewähren eher Zugriff auf eingeschränkte, klar beschriebene Bereiche.

Wir empfehlen, nach Möglichkeit nicht vertrauliche Bereiche zu verwenden, da dadurch der Zugriff pro Datei gewährt und auf bestimmte Funktionen beschränkt wird, die für eine App erforderlich sind.

Die Sheets API unterstützt die folgenden Bereiche:

Umfangscode Beschreibung Nutzung
https://www.googleapis.com/auth/spreadsheets Alle Ihre Google Tabellen-Tabellen aufrufen, bearbeiten, erstellen oder löschen Sensibel
https://www.googleapis.com/auth/spreadsheets.readonly Alle Ihre Google Tabellen-Tabellen aufrufen Sensibel
https://www.googleapis.com/auth/drive.file Nur die Google Drive-Dateien, die Sie mit dieser App verwenden, abrufen, bearbeiten, erstellen und löschen. Empfohlen
Nicht sensibel
https://www.googleapis.com/auth/drive Sie können 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

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

  • Nicht vertraulich: Diese Bereiche bieten den geringsten Autorisierungszugriff und erfordern nur eine grundlegende App-Überprüfung. Weitere Informationen zu dieser Anforderung finden Sie unter App zur Überprüfung einreichen.

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

  • Eingeschränkt: Diese Bereiche gewähren umfassenden Zugriff auf Nutzerdaten von Google. Sie müssen eine Überprüfung für eingeschränkte Bereiche durchlaufen. Weitere 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. Wenn Sie Daten mit eingeschränktem Umfang auf Servern speichern (oder übertragen), müssen Sie eine Sicherheitsprüfung durchlaufen.

Wenn Ihre App Zugriff auf andere Google APIs benötigt, können Sie auch diese Bereiche hinzufügen. Weitere Informationen zu Google API-Bereichen finden Sie im Hilfeartikel 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.