本頁面由 Cloud Translation API 翻譯而成。

Class PageProtection

已淘汰。如果是透過新版 Google 試算表建立的試算表，請使用更強大的功能請改為使用 Protection 類別。雖然這個類別已淘汰，仍可繼續使用以便與舊版試算表相容

您可透過舊版 Google 試算表存取及修改受保護的工作表。

已淘汰的方法

方法	傳回類型	簡短說明
`addUser(email)`	`void`	將受保護工作表的使用者新增至可編輯工作表的使用者清單。
`getUsers()`	`String[]`	傳回有權編輯這份工作表的使用者電子郵件地址清單。
`isProtected()`	`Boolean`	指出工作表是否已啟用工作表保護功能。
`removeUser(user)`	`void`	從可編輯試算表的使用者清單中移除使用者。
`setProtected(protection)`	`void`	設定工作表的保護狀態。

已淘汰的方法

`addUser(email)`

已淘汰。這個函式已淘汰，不應用於新的指令碼。

將受保護工作表的使用者新增至可編輯工作表的使用者清單。

// Add the "user@example.com" user to the list of users who can edit this sheet
var sheet = SpreadsheetApp.getActiveSheet();
var permissions = sheet.getSheetProtection();
permissions.addUser('user@example.com');
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 "user@example.com" user to the list of users who can edit this sheet
var sheet = SpreadsheetApp.getActiveSheet();
var permissions = sheet.getSheetProtection();
permissions.removeUser('user@example.com');
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()