Cette page a été traduite par l'API Cloud Translation.

Class PageProtection

Obsolète. Pour les feuilles de calcul créées dans la nouvelle version de Google Sheets, utilisez plutôt la classe Protection la plus performante. Bien que cette classe soit obsolète, elle reste disponible pour la compatibilité avec l'ancienne version de Sheets.

Consulter et modifier des feuilles protégées dans l'ancienne version de Google Sheets.

Méthodes obsolètes

Méthode	Type renvoyé	Brève description
`addUser(email)`	`void`	Ajoute un utilisateur à la liste des utilisateurs autorisés à modifier la feuille, si elle est protégée.
`getUsers()`	`String[]`	Affiche la liste des adresses e-mail des utilisateurs autorisés à modifier cette feuille.
`isProtected()`	`Boolean`	Indique si la protection de la feuille est activée ou non.
`removeUser(user)`	`void`	Supprime un utilisateur de la liste des utilisateurs autorisés à modifier la feuille.
`setProtected(protection)`	`void`	Définit l'état de protection de la feuille.

Méthodes obsolètes

`addUser(email)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans de nouveaux scripts.

Ajoute un utilisateur à la liste des utilisateurs autorisés à modifier la feuille, si elle est protégée.

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

Paramètres

Nom	Type	Description
`email`	`String`	Adresse e-mail de l'utilisateur à ajouter.

Voir aussi

removeUser(user)

`getUsers()`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans de nouveaux scripts.

Affiche la liste des adresses e-mail des utilisateurs autorisés à modifier cette feuille.

Si la protection de feuille est désactivée, la valeur renvoyée par cet appel n'a aucun sens.

Aller-retour

String[] : tableau des adresses e-mail des utilisateurs autorisés à modifier cette feuille.

`isProtected()`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans de nouveaux scripts.

Indique si la protection de la feuille est activée ou non.

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

Aller-retour

Boolean : indique si la protection de la feuille est activée ou non.

Voir aussi

setProtected(protection)

`removeUser(user)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans de nouveaux scripts.

Supprime un utilisateur de la liste des utilisateurs autorisés à modifier la feuille.

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

Paramètres

Nom	Type	Description
`user`	`String`	Adresse e-mail de l'utilisateur à supprimer.

Voir aussi

addUser(email)

`setProtected(protection)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans de nouveaux scripts.

Définit l'état de protection de la feuille.

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

Paramètres

Nom	Type	Description
`protection`	`Boolean`	`true` pour activer la protection de feuille, `false` pour désactiver la protection de feuille.

Voir aussi

isProtected()