Class PageProtection
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
SeiteSchutz
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 |
addUser(email) | void | Fügt einen Nutzer der Liste der Nutzer hinzu, die das Tabellenblatt bearbeiten können, wenn es geschützt ist. |
getUsers() | String[] | Gibt eine Liste der E-Mail-Adressen der Nutzer zurück, die dieses Tabellenblatt bearbeiten können. |
isProtected() | Boolean | Gibt an, ob der Blattschutz für das Tabellenblatt aktiviert ist. |
removeUser(user) | void | Entfernt einen Nutzer aus der Liste der Nutzer, die das Tabellenblatt bearbeiten können. |
setProtected(protection) | void | Legt den Schutzstatus für das Tabellenblatt fest. |
Eingestellte Methoden
addUser(email)
Veraltet. 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
getUsers()
Veraltet. 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.
isProtected()
Veraltet. 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
removeUser(user)
Veraltet. 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
setProtected(protection)
Veraltet. 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. |
Weitere Informationen
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-13 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-13 (UTC)."],[[["\u003cp\u003eThe \u003ccode\u003ePageProtection\u003c/code\u003e class is deprecated and should not be used in new scripts for spreadsheets created in the newer version of Google Sheets.\u003c/p\u003e\n"],["\u003cp\u003eUse the \u003ccode\u003eProtection\u003c/code\u003e class instead for newer Google Sheets for more powerful sheet protection features.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ePageProtection\u003c/code\u003e provides methods to manage access and modifications to protected sheets in the older version of Google Sheets.\u003c/p\u003e\n"],["\u003cp\u003eDespite being deprecated, \u003ccode\u003ePageProtection\u003c/code\u003e remains available for compatibility with older Google Sheets.\u003c/p\u003e\n"],["\u003cp\u003eKey methods include adding/removing users with edit access, checking protection status, and setting protection status.\u003c/p\u003e\n"]]],[],null,["# Class PageProtection\n\nPageProtection\n\n\n**Deprecated.** For spreadsheets created in the newer version of Google Sheets, use the more powerful\n[Protection](/apps-script/reference/spreadsheet/protection) class instead. Although this class is deprecated, it remains available\nfor compatibility with the older version of Sheets.\n\nAccess and modify protected sheets in the older version of Google Sheets. \n\n### Deprecated methods\n\n| Method | Return type | Brief description |\n|----------------------------------------------------|-------------|------------------------------------------------------------------------------|\n| [addUser(email)](#addUser(String)) | `void` | Adds a user to the list of users who can edit the sheet, if it is protected. |\n| [getUsers()](#getUsers()) | `String[]` | Returns a list of the email addresses of the users who can edit this sheet. |\n| [isProtected()](#isProtected()) | `Boolean` | Indicates whether the sheet has sheet protection enabled or not. |\n| [removeUser(user)](#removeUser(String)) | `void` | Removes a user from the list of users who can edit the sheet. |\n| [setProtected(protection)](#setProtected(Boolean)) | `void` | Sets the protection status for the sheet. |\n\nDeprecated methods\n------------------\n\n### `add``User(email)`\n\n\n**Deprecated.** This function is deprecated and should not be used in new scripts.\n\nAdds a user to the list of users who can edit the sheet, if it is protected.\n\n```javascript\n// Add the \"user@example.com\" user to the list of users who can edit this sheet\nconst sheet = SpreadsheetApp.getActiveSheet();\nconst permissions = sheet.getSheetProtection();\npermissions.addUser('user@example.com');\npermissions.setProtected(true);\nsheet.setSheetProtection(permissions);\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|---------|----------|-------------------------------|\n| `email` | `String` | The email of the user to add. |\n\n#### See also\n\n- [removeUser(user)](#removeUser(String))\n\n*** ** * ** ***\n\n### `get``Users()`\n\n\n**Deprecated.** This function is deprecated and should not be used in new scripts.\n\nReturns a list of the email addresses of the users who can edit this sheet.\n\nIf sheet protection is disabled, the value returned by this call is meaningless.\n\n#### Return\n\n\n`String[]` --- An array of email addresses of users who can edit this sheet.\n\n*** ** * ** ***\n\n### `is``Protected()`\n\n\n**Deprecated.** This function is deprecated and should not be used in new scripts.\n\nIndicates whether the sheet has sheet protection enabled or not.\n\n```javascript\n// Determine whether or not sheet protection is enabled\nconst sheet = SpreadsheetApp.getActiveSheet();\nconst permissions = sheet.getSheetProtection();\nconst isProtected = permissions.isProtected();\n```\n\n#### Return\n\n\n`Boolean` --- Whether the sheet has sheet protection enabled or not.\n\n#### See also\n\n- [setProtected(protection)](#setProtected(Boolean))\n\n*** ** * ** ***\n\n### `remove``User(user)`\n\n\n**Deprecated.** This function is deprecated and should not be used in new scripts.\n\nRemoves a user from the list of users who can edit the sheet.\n\n```javascript\n// Remove the \"user@example.com\" user to the list of users who can edit this\n// sheet\nconst sheet = SpreadsheetApp.getActiveSheet();\nconst permissions = sheet.getSheetProtection();\npermissions.removeUser('user@example.com');\npermissions.setProtected(true);\nsheet.setSheetProtection(permissions);\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|--------|----------|------------------------------------------|\n| `user` | `String` | The email address of the user to remove. |\n\n#### See also\n\n- [addUser(email)](#addUser(String))\n\n*** ** * ** ***\n\n### `set``Protected(protection)`\n\n\n**Deprecated.** This function is deprecated and should not be used in new scripts.\n\nSets the protection status for the sheet.\n\n```javascript\n// Enables sheet protection for this sheet\nconst sheet = SpreadsheetApp.getActiveSheet();\nconst permissions = sheet.getSheetProtection();\npermissions.setProtected(true);\nsheet.setSheetProtection(permissions);\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|--------------|-----------|-------------------------------------------------------------------------|\n| `protection` | `Boolean` | `true` to enable sheet protection, `false` to disable sheet protection. |\n\n#### See also\n\n- [isProtected()](#isProtected())"]]
