Устарело. Для таблиц, созданных в новой версии Google Таблиц, используйте более мощный класс Protection . Несмотря на то, что этот класс устарел, он по-прежнему доступен для совместимости со старой версией Таблиц.
Доступ к защищенным листам и их изменение в старой версии Google Таблиц.
Устаревшие методы
| Метод | Тип возврата | Краткое описание |
|---|---|---|
| void | Добавляет пользователя в список пользователей, которые могут редактировать лист, если он защищен. |
| String[] | Возвращает список адресов электронной почты пользователей, которые могут редактировать этот лист. |
| Boolean | Указывает, включена ли защита листа. |
| void | Удаляет пользователя из списка пользователей, которые могут редактировать лист. |
| void | Устанавливает статус защиты листа. |
Устаревшие методы
add User(email)
add User(email)Устарело. Эта функция устарела и не должна использоваться в новых скриптах.
Добавляет пользователя в список пользователей, которые могут редактировать лист, если он защищен.
// Add the "user@example.com" user to the list of users who can edit this sheet const sheet = SpreadsheetApp.getActiveSheet(); const permissions = sheet.getSheetProtection(); permissions.addUser('user@example.com'); permissions.setProtected(true); sheet.setSheetProtection(permissions);
Параметры
| Имя | Тип | Описание |
|---|---|---|
email | String | Адрес электронной почты добавляемого пользователя. |
Смотрите также
get Users()
get Users()Устарело. Эта функция устарела и не должна использоваться в новых скриптах.
Возвращает список адресов электронной почты пользователей, которые могут редактировать этот лист.
Если защита листа отключена, значение, возвращаемое этим вызовом, бессмысленно.
Возвращаться
String[] — Массив адресов электронной почты пользователей, которые могут редактировать этот лист.
is Protected()
is Protected()Устарело. Эта функция устарела и не должна использоваться в новых скриптах.
Указывает, включена ли защита листа.
// Determine whether or not sheet protection is enabled const sheet = SpreadsheetApp.getActiveSheet(); const permissions = sheet.getSheetProtection(); const isProtected = permissions.isProtected();
Возвращаться
Boolean — включена ли защита листа.
Смотрите также
remove User(user)
remove User(user)Устарело. Эта функция устарела и не должна использоваться в новых скриптах.
Удаляет пользователя из списка пользователей, которые могут редактировать лист.
// Remove the "user@example.com" user to the list of users who can edit this // sheet const sheet = SpreadsheetApp.getActiveSheet(); const permissions = sheet.getSheetProtection(); permissions.removeUser('user@example.com'); permissions.setProtected(true); sheet.setSheetProtection(permissions);
Параметры
| Имя | Тип | Описание |
|---|---|---|
user | String | Адрес электронной почты пользователя, которого необходимо удалить. |
Смотрите также
set Protected(protection)
set Protected(protection)Устарело. Эта функция устарела и не должна использоваться в новых скриптах.
Устанавливает статус защиты листа.
// Enables sheet protection for this sheet const sheet = SpreadsheetApp.getActiveSheet(); const permissions = sheet.getSheetProtection(); permissions.setProtected(true); sheet.setSheetProtection(permissions);
Параметры
| Имя | Тип | Описание |
|---|---|---|
protection | Boolean | true — включить защиту листа, false — отключить защиту листа. |