Google Sheets API-Bereiche auswählen

Dieses Dokument enthält Google Sheets API-spezifische Autorisierungs- und Authentifizierungsinformationen. Bevor Sie dieses Dokument lesen, sollten Sie sich die allgemeinen Informationen zur Authentifizierung und Autorisierung in Google Workspace unter Authentifizierung und Autorisierung ansehen.

Beachten Sie, dass Sheets API-Bereiche auf eine Tabellenkalkulationsdatei angewendet werden und nicht auf ein bestimmtes Tabellenblatt beschränkt werden können. Um die Änderung eines Blatts zu verhindern, verwenden Sie 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

OAuth-Zustimmungsbildschirm konfigurieren und Bereiche auswählen: Damit legen Sie fest, welche Informationen Nutzern und App-Prüfern angezeigt werden. Außerdem registrieren Sie Ihre App, damit Sie sie später veröffentlichen können.

Sheets API-Bereiche

Um den Zugriff zu definieren, der 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 möglichen Bereich auswählen und keine Bereiche anfordern, die Ihre App nicht benötigt. Nutzer gewähren eher Zugriff auf eingeschränkte, klar beschriebene Bereiche.

Wir empfehlen, wenn möglich nicht vertrauliche Bereiche zu verwenden, da sie einen Zugriffsbereich pro Datei ermöglichen und den Zugriff auf bestimmte Funktionen einschränken, die von einer App benötigt werden.

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 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 vertraulich
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 Alle Ihre Google Drive-Dateien ansehen und herunterladen Eingeschränkt

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

  • Nicht vertraulich: Diese Bereiche bieten den geringsten Umfang an 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 bieten Zugriff auf bestimmte Google-Nutzerdaten, die vom Nutzer für Ihre App autorisiert wurden. Sie erfordern eine zusätzliche App-Überprüfung. Weitere 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 einen Überprüfungsprozess für eingeschränkte Bereiche. Weitere Informationen zu dieser Anforderung finden Sie in der Nutzerdatenrichtlinie für Google API-Dienste und den zusätzlichen Anforderungen für bestimmte API-Bereiche. Wenn Sie Daten mit eingeschränkten Bereichen 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 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.