Esta página foi traduzida pela API Cloud Translation.

Class PageProtection

Obsoleto. Para planilhas criadas na versão mais recente do Planilhas Google, use a versão Protection. Embora o uso dessa classe tenha sido descontinuado, ela continua disponível para compatibilidade com a versão mais antiga do Planilhas.

Acessar e modificar páginas protegidas na versão antiga do Planilhas Google.

Métodos obsoletos

Método	Tipo de retorno	Breve descrição
`addUser(email)`	`void`	Adiciona um usuário à lista de usuários que poderão editar a página (se ela estiver protegida).
`getUsers()`	`String[]`	Retorna uma lista com os endereços de e-mail dos usuários que podem editar esta página.
`isProtected()`	`Boolean`	Indica se a proteção da página está ativada na página.
`removeUser(user)`	`void`	Remove um usuário da lista de usuários que podem editar a página.
`setProtected(protection)`	`void`	Define o status de proteção da página.

Métodos obsoletos

`addUser(email)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Adiciona um usuário à lista de usuários que poderão editar a página (se ela estiver protegida).

// 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);

Parâmetros

Nome	Tipo	Descrição
`email`	`String`	O e-mail do usuário a ser adicionado.

Consulte também

removeUser(user)

`getUsers()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Retorna uma lista com os endereços de e-mail dos usuários que podem editar esta página.

Se a proteção da página estiver desativada, o valor retornado por essa chamada não fará sentido.

Retornar

String[]: uma matriz de endereços de e-mail de usuários que podem editar esta página

`isProtected()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Indica se a proteção da página está ativada na página.

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

Retornar

Boolean: se a proteção da página está ativada ou não na página

Consulte também

setProtected(protection)

`removeUser(user)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Remove um usuário da lista de usuários que podem editar a página.

// 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);

Parâmetros

Nome	Tipo	Descrição
`user`	`String`	O endereço de e-mail do usuário a ser removido.

Consulte também

addUser(email)

`setProtected(protection)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o status de proteção da página.

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

Parâmetros

Nome	Tipo	Descrição
`protection`	`Boolean`	`true` para ativar a proteção da página, `false` para desativar a página proteção de dados.

Consulte também

isProtected()