Class PageProtection

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

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

Доступ к защищенным таблицам и их изменение в старой версии Google Таблиц.

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

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

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

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

// 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 Адрес электронной почты пользователя, которого необходимо добавить.

См. также

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

Возвращает список адресов электронной почты пользователей, которые могут редактировать этот лист.

Если защита листа отключена, значение, возвращаемое этим вызовом, не имеет смысла.

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

String[] — массив адресов электронной почты пользователей, которые могут редактировать этот лист.

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

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

// Determine whether or not sheet protection is enabled
const sheet = SpreadsheetApp.getActiveSheet();
const permissions = sheet.getSheetProtection();
const isProtected = permissions.isProtected();

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

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

См. также

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

Удаляет пользователя из списка пользователей, которые могут редактировать лист.

// 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 Адрес электронной почты пользователя, которого требуется удалить.

См. также

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

Устанавливает статус защиты листа.

// Enables sheet protection for  this sheet
const sheet = SpreadsheetApp.getActiveSheet();
const permissions = sheet.getSheetProtection();
permissions.setProtected(true);
sheet.setSheetProtection(permissions);

Параметры

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

См. также