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

Accéder 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[]`	Renvoie 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 les 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
const sheet = SpreadsheetApp.getActiveSheet();
const 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 les nouveaux scripts.

Renvoie 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 aucune signification.

Renvois

String[] : tableau d'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 les nouveaux scripts.

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

// Determine whether or not sheet protection is enabled
const sheet = SpreadsheetApp.getActiveSheet();
const permissions = sheet.getSheetProtection();
const 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 les 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
const sheet = SpreadsheetApp.getActiveSheet();
const 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 les nouveaux scripts.

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

// Enables sheet protection for  this sheet
const sheet = SpreadsheetApp.getActiveSheet();
const 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.

Voir aussi

isProtected()