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 la version plus puissante Protection à la place. Bien que cette classe soit obsolète, elle reste disponible pour assurer la compatibilité avec l'ancienne version de Sheets.

L'ancienne version de Google Sheets permet d'accéder aux feuilles protégées et de les modifier.

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 celle-ci 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 celle-ci 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 la feuille est désactivée, la valeur renvoyée par cet appel n'a aucun sens.

Renvois

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

Renvois

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 la feuille, `false` pour la désactiver de sécurité.

Voir aussi

isProtected()