Class PageProtection

PageProtection

Obsoleto. Para planilhas criadas na versão mais recente do Google Planilhas, use a classe Protection, que é mais eficiente. Embora essa classe esteja descontinuada, ela continua disponível para compatibilidade com a versão mais antiga do app Planilhas.

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

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 esta planilha.
isProtected()	Boolean	Indica se a proteção de planilha está ativada ou não.
removeUser(user)	void	Remove um usuário da lista de pessoas que podem editar a planilha.
setProtected(protection)	void	Define o status de proteção da planilha.

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 "[e-mail]" user to the list of users who can edit this sheet
const sheet = SpreadsheetApp.getActiveSheet();
const permissions = sheet.getSheetProtection();
permissions.addUser('[e-mail]');
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 esta planilha.

Se a proteção da planilha 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 planilha.

---

isProtected()

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

Indica se a proteção de planilha 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 pessoas que podem editar a planilha.

// Remove the "[e-mail]" user to the list of users who can edit this
// sheet
const sheet = SpreadsheetApp.getActiveSheet();
const permissions = sheet.getSheetProtection();
permissions.removeUser('[e-mail]');
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 planilha.

// 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 da página e false para desativar.

Consulte também

• isProtected()