Эта страница переведена с помощью Cloud Translation API.

Class PageProtection

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

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

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

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

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

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

См. также

remove User(user)

`get Users()`

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

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

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

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

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

`is Protected()`

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

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

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

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

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

См. также

set Protected(protection)

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

См. также

add User(email)

`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` , чтобы отключить защиту листа.

См. также

is Protected()