Class PageProtection

Seitenschutz

Veraltet. Verwenden Sie für Tabellen, die in der neueren Version von Google Tabellen erstellt wurden, stattdessen die leistungsstärkere Protection-Klasse. Diese Klasse ist zwar veraltet, bleibt aber zur Abwärtskompatibilität mit der älteren Version von Google Tabellen verfügbar.

Auf geschützte Tabellenblätter in der älteren Version von Google Tabellen zugreifen und sie ändern.

MethodeRückgabetypKurzbeschreibung
addUser(email)voidFügen Sie einen Nutzer der Liste der Nutzer hinzu, die das Tabellenblatt bearbeiten können, falls es geschützt ist.
getUsers()String[]Eine Liste der E-Mail-Adressen der Nutzer, die dieses Tabellenblatt bearbeiten können.
isProtected()BooleanGibt an, ob der Tabellenschutz für das Tabellenblatt aktiviert ist.
removeUser(user)voidEin Nutzer wird aus der Liste der Nutzer entfernt, die das Tabellenblatt bearbeiten können.
setProtected(protection)voidLegt den Schutzstatus für das Tabellenblatt fest.

Eingestellte Methoden

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Fügen Sie einen Nutzer der Liste der Nutzer hinzu, die das Tabellenblatt bearbeiten können, falls 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

NameTypBeschreibung
emailStringDie E-Mail-Adresse des Nutzers, den Sie hinzufügen möchten.

Weitere Informationen


Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Eine Liste der E-Mail-Adressen der Nutzer, die dieses Tabellenblatt bearbeiten können.

Wenn der Tabellenschutz deaktiviert ist, ist der durch diesen Aufruf zurückgegebene Wert bedeutungslos.

Rückflug

String[]: ein Array von E-Mail-Adressen von Nutzern, die dieses Tabellenblatt bearbeiten können


Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Gibt an, ob der Tabellenschutz 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 der Tabellenblattschutz für das Tabellenblatt aktiviert ist.

Weitere Informationen


Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Ein Nutzer wird aus der Liste der Nutzer entfernt, 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

NameTypBeschreibung
userStringDie E-Mail-Adresse des Nutzers, der entfernt werden soll.

Weitere Informationen


Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht 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

NameTypBeschreibung
protectionBooleantrue, um den Tabellenblattschutz zu aktivieren, false, um ihn zu deaktivieren.

Weitere Informationen