Устарело. Для электронных таблиц, созданных в более новой версии Google Таблиц, вместо этого используйте более мощный класс Protection
. Хотя этот класс устарел, он по-прежнему доступен для совместимости со старой версией Таблиц.
Доступ и изменение защищенных листов в старой версии Google Sheets.
Устаревшие методы
Метод | Тип возврата | Краткое описание |
---|---|---|
| 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 , чтобы отключить защиту листа. |