Class PageProtection
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
SayfaKoruma
Kullanımdan kaldırıldı. Google E-Tablolar'ın yeni sürümünde oluşturulan e-tablolar için daha güçlü olan Protection sınıfını kullanın. Bu sınıfın desteği sonlandırılmış olsa da Sheets'in eski sürümüyle uyumluluk için kullanılmaya devam edebilir.
Google E-Tablolar'ın eski sürümünde korumalı sayfalara erişme ve bunları değiştirme
Kullanımdan kaldırılan yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
addUser(email) | void | E-tablo korunuyorsa kullanıcıyı, tabloyu düzenleyebilecek kullanıcılar listesine ekler. |
getUsers() | String[] | Bu sayfayı düzenleyebilen kullanıcıların e-posta adreslerinin listesini döndürür. |
isProtected() | Boolean | Sayfada sayfa korumasının etkin olup olmadığını gösterir. |
removeUser(user) | void | Kullanıcıyı, sayfayı düzenleyebilecek kullanıcılar listesinden kaldırır. |
setProtected(protection) | void | Sayfanın koruma durumunu ayarlar. |
Kullanımdan kaldırılan yöntemler
addUser(email)
Kullanımdan kaldırıldı. Bu işlev kullanımdan kaldırıldı ve yeni komut dosyalarında kullanılmamalıdır.
E-tablo korunuyorsa kullanıcıyı, tabloyu düzenleyebilecek kullanıcılar listesine ekler.
// 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);
Parametreler
| Ad | Tür | Açıklama |
email | String | Eklenecek kullanıcının e-posta adresi. |
Aşağıdaki kaynakları da incelemenizi öneririz:
getUsers()
Kullanımdan kaldırıldı. Bu işlev kullanımdan kaldırıldı ve yeni komut dosyalarında kullanılmamalıdır.
Bu sayfayı düzenleyebilen kullanıcıların e-posta adreslerinin listesini döndürür.
Sayfa koruması devre dışı bırakılırsa bu çağrı tarafından döndürülen değer anlamsız olur.
Return
String[]: Bu sayfayı düzenleyebilecek kullanıcıların e-posta adreslerinden oluşan bir dizi.
isProtected()
Kullanımdan kaldırıldı. Bu işlev kullanımdan kaldırıldı ve yeni komut dosyalarında kullanılmamalıdır.
Sayfada sayfa korumasının etkin olup olmadığını gösterir.
// Determine whether or not sheet protection is enabled
const sheet = SpreadsheetApp.getActiveSheet();
const permissions = sheet.getSheetProtection();
const isProtected = permissions.isProtected();
Return
Boolean: Sayfada sayfa korumasının etkin olup olmadığı.
Aşağıdaki kaynakları da incelemenizi öneririz:
removeUser(user)
Kullanımdan kaldırıldı. Bu işlev kullanımdan kaldırıldı ve yeni komut dosyalarında kullanılmamalıdır.
Kullanıcıyı, sayfayı düzenleyebilecek kullanıcılar listesinden kaldırır.
// 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);
Parametreler
| Ad | Tür | Açıklama |
user | String | Kaldırılacak kullanıcının e-posta adresi. |
Aşağıdaki kaynakları da incelemenizi öneririz:
setProtected(protection)
Kullanımdan kaldırıldı. Bu işlev kullanımdan kaldırıldı ve yeni komut dosyalarında kullanılmamalıdır.
Sayfanın koruma durumunu ayarlar.
// Enables sheet protection for this sheet
const sheet = SpreadsheetApp.getActiveSheet();
const permissions = sheet.getSheetProtection();
permissions.setProtected(true);
sheet.setSheetProtection(permissions);
Parametreler
| Ad | Tür | Açıklama |
protection | Boolean | Sayfa korumasını etkinleştirmek için true, devre dışı bırakmak için false simgesini tıklayın. |
Aşağıdaki kaynakları da incelemenizi öneririz:
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-13 UTC.
[null,null,["Son güncelleme tarihi: 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())"]]
