Se usó la API de Cloud Translation para traducir esta página.

Class PageProtection

de la página

Obsoleto. En el caso de las hojas de cálculo creadas en la versión más reciente de Hojas de cálculo de Google, usa la clase Protection más potente. Aunque esta clase dejó de estar disponible, sigue disponible para brindar compatibilidad con la versión anterior de Hojas de cálculo.

Acceder a hojas protegidas y modificarlas en la versión anterior de Hojas de cálculo de Google

Métodos obsoletos

Método	Tipo de datos que se muestra	Descripción breve
`addUser(email)`	`void`	Agrega un usuario a la lista de usuarios que pueden editar la hoja, si está protegida.
`getUsers()`	`String[]`	Muestra una lista de las direcciones de correo electrónico de los usuarios que pueden editar esta hoja.
`isProtected()`	`Boolean`	Indica si la hoja tiene habilitada o no la protección de hoja.
`removeUser(user)`	`void`	Quita a un usuario de la lista de usuarios que pueden editar la hoja.
`setProtected(protection)`	`void`	Establece el estado de protección de la hoja.

Métodos obsoletos

`addUser(email)`

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Agrega un usuario a la lista de usuarios que pueden editar la hoja, si está 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

Nombre	Tipo	Descripción
`email`	`String`	El correo electrónico del usuario que quieres agregar.

Consulta también

removeUser(user)

`getUsers()`

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Muestra una lista de las direcciones de correo electrónico de los usuarios que pueden editar esta hoja.

Si la protección de la hoja está inhabilitada, el valor que muestra esta llamada no tiene sentido.

Volver

String[]: Es un array de direcciones de correo electrónico de los usuarios que pueden editar esta hoja.

`isProtected()`

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Indica si la hoja tiene habilitada o no la protección de hoja.

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

Volver

Boolean: Indica si la hoja tiene habilitada o no la protección de hoja.

Consulta también

setProtected(protection)

`removeUser(user)`

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Quita a un usuario de la lista de usuarios que pueden editar la hoja.

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

Nombre	Tipo	Descripción
`user`	`String`	Es la dirección de correo electrónico del usuario que quieres quitar.

Consulta también

addUser(email)

`setProtected(protection)`

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece el estado de protección de la hoja.

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

Parámetros

Nombre	Tipo	Descripción
`protection`	`Boolean`	`true` para habilitar la protección de la hoja, `false` para inhabilitarla.

Consulta también

isProtected()