Veraltet. Verwenden Sie für Tabellen, die in der neueren Version von Google Sheets erstellt wurden, stattdessen die leistungsstärkere Klasse Protection. Diese Klasse ist zwar veraltet, bleibt aber zur Kompatibilität mit der älteren Version von Google Tabellen verfügbar.
Auf geschützte Tabellenblätter in der älteren Version von Google Sheets zugreifen und sie bearbeiten.
Eingestellte Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
| void | Fügt einen Nutzer der Liste der Nutzer hinzu, die das Tabellenblatt bearbeiten können, wenn es geschützt ist. |
| String[] | Gibt eine Liste der E-Mail-Adressen der Nutzer zurück, die dieses Tabellenblatt bearbeiten können. |
| Boolean | Gibt an, ob der Blattschutz für das Tabellenblatt aktiviert ist. |
| void | Entfernt einen Nutzer aus der Liste der Nutzer, die das Tabellenblatt bearbeiten können. |
| void | Legt den Schutzstatus für das Tabellenblatt fest. |
Eingestellte Methoden
add
addVeraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Fügt einen Nutzer der Liste der Nutzer hinzu, die das Tabellenblatt bearbeiten können, wenn es geschützt ist.
// Add the "user@example.com" user to the list of users who can edit this sheet const sheet = SpreadsheetApp.getActiveSheet(); const permissions = sheet.getSheetProtection(); permissions.addUser('user@example.com'); permissions.setProtected(true); sheet.setSheetProtection(permissions);
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
email | String | Die E‑Mail-Adresse des Nutzers, der hinzugefügt werden soll. |
Weitere Informationen
get
getVeraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Gibt eine Liste der E-Mail-Adressen der Nutzer zurück, die dieses Tabellenblatt bearbeiten können.
Wenn der Blattschutz deaktiviert ist, ist der von diesem Aufruf zurückgegebene Wert bedeutungslos.
Rückflug
String[]: Ein Array mit E-Mail-Adressen von Nutzern, die dieses Tabellenblatt bearbeiten können.
is
isVeraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Gibt an, ob der Blattschutz für das Tabellenblatt aktiviert ist.
// Determine whether or not sheet protection is enabled const sheet = SpreadsheetApp.getActiveSheet(); const permissions = sheet.getSheetProtection(); const isProtected = permissions.isProtected();
Rückflug
Boolean: Gibt an, ob das Tabellenblatt geschützt ist.
Weitere Informationen
remove
removeVeraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Entfernt einen Nutzer aus der Liste der Nutzer, die das Tabellenblatt bearbeiten können.
// Remove the "user@example.com" user to the list of users who can edit this // sheet const sheet = SpreadsheetApp.getActiveSheet(); const permissions = sheet.getSheetProtection(); permissions.removeUser('user@example.com'); permissions.setProtected(true); sheet.setSheetProtection(permissions);
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
user | String | Die E‑Mail-Adresse des Nutzers, der entfernt werden soll. |
Weitere Informationen
set
setVeraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Legt den Schutzstatus für das Tabellenblatt fest.
// Enables sheet protection for this sheet const sheet = SpreadsheetApp.getActiveSheet(); const permissions = sheet.getSheetProtection(); permissions.setProtected(true); sheet.setSheetProtection(permissions);
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
protection | Boolean | true zum Aktivieren des Tabellenblattschutzes, false zum Deaktivieren des Tabellenblattschutzes. |