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

Class PageProtection

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

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

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

Метод	Тип возврата	Краткое описание
`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()