Google Sheets API-Bereiche auswählen

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

Beachten Sie, dass Bereiche der Sheets API auf eine Tabellendatei angewendet werden und nicht auf ein bestimmtes Tabellenblatt beschränkt werden können. Wenn Sie verhindern möchten, dass ein Tabellenblatt geändert wird, verwenden Sie ein ProtectedRange , um eine Zelle oder einen Zellbereich zu definieren, die nicht bearbeitet werden können. Ein Beispiel finden Sie unter Benannte und geschützte Bereiche.

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

Bereiche der Sheets API

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 Zugriffsbereiche.

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 Sheets API unterstützt die folgenden Bereiche:

Bereichscode Beschreibung Nutzung
https://www.googleapis.com/auth/spreadsheets Alle Google Sheets-Tabellen ansehen, bearbeiten, erstellen und löschen Sensibel
https://www.googleapis.com/auth/spreadsheets.readonly Alle Google Sheets-Tabellen ansehen Sensibel
https://www.googleapis.com/auth/drive.file Nur die Google Drive-Dateien ansehen, bearbeiten, erstellen und löschen, die Sie mit dieser App verwenden Empfohlen
Nicht sensibel
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“ in der Tabelle wird die Vertraulichkeit der einzelnen Bereiche gemäß den folgenden Definitionen angegeben:

  • Nicht sensibel: 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.

  • Sensibel: 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 sensible und eingeschränkte Bereiche.

  • Eingeschränkt: Diese Bereiche bieten umfassenden Zugriff auf Google-Nutzerdaten und erfordern, dass Sie einen Überprüfungsprozess für eingeschränkte Bereiche durchlaufen. 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 mit 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.