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()