Class PageProtection

PageProtection

已弃用。对于在新版 Google 表格中创建的电子表格，请使用 Protection 类。虽然此类已弃用，但仍然可用 ，以便与旧版表格兼容。

访问和修改旧版 Google 表格中的受保护工作表。

已弃用的方法

方法	返回类型	简介
addUser(email)	void	将用户添加到可以编辑工作表的用户列表中（如果工作表受保护）。
getUsers()	String[]	返回可编辑此工作表的用户的电子邮件地址列表。
isProtected()	Boolean	指明工作表是否启用了工作表保护。
removeUser(user)	void	从可编辑工作表的用户列表中移除用户。
setProtected(protection)	void	设置工作表的保护状态。

已弃用的方法

addUser(email)

已弃用。此函数已弃用，不应在新脚本中使用。

将用户添加到可以编辑工作表的用户列表中（如果工作表受保护）。

// Add the "[e-mail]" user to the list of users who can edit this sheet
var sheet = SpreadsheetApp.getActiveSheet();
var permissions = sheet.getSheetProtection();
permissions.addUser('[e-mail]');
permissions.setProtected(true);
sheet.setSheetProtection(permissions);

参数

名称	类型	说明
email	String	要添加的用户的电子邮件地址。

另请参阅

• removeUser(user)

---

getUsers()

已弃用。此函数已弃用，不应在新脚本中使用。

返回可编辑此工作表的用户的电子邮件地址列表。

如果停用了工作表保护，则此调用返回的值将毫无意义。

返回

String[] - 可编辑此工作表的用户的电子邮件地址数组

---

isProtected()

已弃用。此函数已弃用，不应在新脚本中使用。

指明工作表是否启用了工作表保护。

// Determine whether or not sheet protection is enabled
var sheet = SpreadsheetApp.getActiveSheet();
var permissions = sheet.getSheetProtection();
var isProtected = permissions.isProtected();

返回

Boolean - 工作表是否启用了工作表保护

另请参阅

• setProtected(protection)

---

removeUser(user)

已弃用。此函数已弃用，不应在新脚本中使用。

从可编辑工作表的用户列表中移除用户。

// Remove the "[e-mail]" user to the list of users who can edit this sheet
var sheet = SpreadsheetApp.getActiveSheet();
var permissions = sheet.getSheetProtection();
permissions.removeUser('[e-mail]');
permissions.setProtected(true);
sheet.setSheetProtection(permissions);

参数

名称	类型	说明
user	String	要移除的用户的电子邮件地址。

另请参阅

• addUser(email)

---

setProtected(protection)

已弃用。此函数已弃用，不应在新脚本中使用。

设置工作表的保护状态。

// Enables sheet protection for  this sheet
var sheet = SpreadsheetApp.getActiveSheet();
var permissions = sheet.getSheetProtection();
permissions.setProtected(true);
sheet.setSheetProtection(permissions);

参数

名称	类型	说明
protection	Boolean	true 可启用工作表保护，false 可停用工作表 保护。

另请参阅

• isProtected()