Class PageProtection

Защита страницы

Устарело. Для электронных таблиц, созданных в более новых версиях Google Sheets, используйте более мощный класс Protection . Хотя этот класс устарел, он остается доступным для обеспечения совместимости со старой версией Sheets.

Доступ к защищенным листам и их изменение в старых версиях Google Sheets.

Устаревшие методы

Метод	Тип возвращаемого значения	Краткое описание
add User(email)	void	Добавляет пользователя в список пользователей, которые могут редактировать таблицу, если она защищена.
get Users()	String[]	Возвращает список адресов электронной почты пользователей, которые могут редактировать этот лист.
is Protected()	Boolean	Указывает, включена ли защита листа или нет.
remove User(user)	void	Удаляет пользователя из списка пользователей, имеющих право редактировать таблицу.
set Protected(protection)	void	Устанавливает статус защиты для листа.

Устаревшие методы

addUser(email)

Устарело. Эта функция устарела и не должна использоваться в новых скриптах.

Добавляет пользователя в список пользователей, которые могут редактировать таблицу, если она защищена.

// Add the "[e-mail]" user to the list of users who can edit this sheet
const sheet = SpreadsheetApp.getActiveSheet();
const 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
const sheet = SpreadsheetApp.getActiveSheet();
const permissions = sheet.getSheetProtection();
const isProtected = permissions.isProtected();

Возвращаться

Boolean — Указывает, включена ли защита листа или нет.

См. также

• setProtected(protection)

---

removeUser(user)

Устарело. Эта функция устарела и не должна использоваться в новых скриптах.

Удаляет пользователя из списка пользователей, имеющих право редактировать таблицу.

// Remove the "[e-mail]" user to the list of users who can edit this
// sheet
const sheet = SpreadsheetApp.getActiveSheet();
const 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
const sheet = SpreadsheetApp.getActiveSheet();
const permissions = sheet.getSheetProtection();
permissions.setProtected(true);
sheet.setSheetProtection(permissions);

Параметры

Имя	Тип	Описание
protection	Boolean	true включает защиту листа, значение false отключает защиту листа.

См. также

• isProtected()