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

Class PageProtection

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

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

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

Метод	Тип возврата	Краткое описание
`addUser(email)`	`void`	Добавляет пользователя в список пользователей, которые могут редактировать лист, если он защищен.
`getUsers()`	`String[]`	Возвращает список адресов электронной почты пользователей, которые могут редактировать этот лист.
`isProtected()`	`Boolean`	Указывает, включена ли на листе защита листа.
`removeUser(user)`	`void`	Удаляет пользователя из списка пользователей, которые могут редактировать лист.
`setProtected(protection)`	`void`	Устанавливает статус защиты листа.

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

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

См. также

removeUser(user)

`getUsers()`

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

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

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

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

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

`isProtected()`

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

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

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

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

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

См. также

setProtected(protection)

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

См. также

addUser(email)

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

См. также

isProtected()