Esta página foi traduzida pela API Cloud Translation.

Class PageProtection

Obsoleto. Para planilhas criadas na versão mais recente das Planilhas Google, use a classe Protection mais poderosa. Embora essa classe tenha sido descontinuada, ela ainda está disponível para compatibilidade com a versão mais antiga das Planilhas.

Acessar e modificar páginas protegidas na versão mais antiga das 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 planilha, se ela estiver protegida.
`getUsers()`	`String[]`	Retorna uma lista dos endereços de e-mail dos usuários que podem editar essa planilha.
`isProtected()`	`Boolean`	Indica se a proteção da página está ativada ou não.
`removeUser(user)`	`void`	Remove um usuário da lista de usuários que podem editar a planilha.
`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 podem editar a planilha, se ela estiver protegida.

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

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 dos endereços de e-mail dos usuários que podem editar essa planilha.

Se a proteção de planilha estiver desativada, o valor retornado por essa chamada não terá sentido.

Retornar

String[]: uma matriz de endereços de e-mail dos usuários que podem editar a planilha

`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 ou não.

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

Retornar

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

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

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

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
const sheet = SpreadsheetApp.getActiveSheet();
const permissions = sheet.getSheetProtection();
permissions.setProtected(true);
sheet.setSheetProtection(permissions);

Parâmetros

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

Consulte também

isProtected()