Esta página foi traduzida pela API Cloud Translation.

Class PageProtection

Obsoleto. Para arquivos criados na versão mais recente do Planilhas Google, use a classe Protection mais eficiente. Embora esta classe tenha sido descontinuada, ela continua disponível para compatibilidade com a versão mais antiga do Planilhas.

Acesse e modifique 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 podem editar a página, caso ela esteja protegida.
`getUsers()`	`String[]`	Retorna uma lista de endereços de e-mail dos usuários que podem editar esta página.
`isProtected()`	`Boolean`	Indica se a proteção de páginas está ativada ou não.
`removeUser(user)`	`void`	Remove um usuário da lista de usuários que podem editar a página.
`setProtected(protection)`	`void`	Define o status da 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 podem editar a página, caso ela esteja 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.

Veja também

removeUser(user)

`getUsers()`

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

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

Se a proteção de página estiver desativada, o valor retornado por essa chamada não terá significado.

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 de páginas está ativada ou não.

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

Retornar

Boolean: indica se a página está com a proteção de páginas ativada ou não.

Veja 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.

Veja também

addUser(email)

`setProtected(protection)`

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

Define o status da 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 contra páginas, `false` para desativá-la.

Veja também

isProtected()