PageProtection
已淘汰。如果是透過新版 Google 試算表建立的試算表,請改用功能更強大的 Protection
類別。雖然這個類別已淘汰,但仍可與舊版試算表相容。
在舊版 Google 試算表中存取及修改受保護的工作表。
已淘汰的方法
方法 | 傳回類型 | 簡短說明 |
---|---|---|
| void | 將使用者新增至可以編輯工作表的使用者清單 (如果試算表受到保護)。 |
| String[] | 傳回可以編輯這張工作表的使用者電子郵件地址清單。 |
| Boolean | 指出工作表是否已啟用工作表保護功能。 |
| void | 將使用者從可以編輯試算表的使用者清單中移除。 |
| void | 設定工作表的保護狀態。 |
已淘汰的方法
addUser(email)
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 | 要新增的使用者的電子郵件地址。 |
另請參閱
getUsers()
getUsers()
已淘汰。此函式已淘汰,不應在新的指令碼中使用。
傳回有權編輯這份工作表的使用者電子郵件地址清單。
如果已停用工作表保護功能,這個呼叫傳回的值沒有意義。
回攻員
String[]
:可編輯這份工作表的使用者電子郵件地址陣列
isProtected()
isProtected()
已淘汰。此函式已淘汰,不應在新的指令碼中使用。
指出工作表是否已啟用工作表保護功能。
// Determine whether or not sheet protection is enabled var sheet = SpreadsheetApp.getActiveSheet(); var permissions = sheet.getSheetProtection(); var isProtected = permissions.isProtected();
回攻員
Boolean
:表示工作表是否已啟用工作表保護功能
另請參閱
removeUser(user)
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 | 要移除的使用者電子郵件地址。 |
另請參閱
setProtected(protection)
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 用於停用工作表保護功能。 |