דף זה תורגם על ידי Cloud Translation API.

Class PageProtection

הוצא משימוש. בגיליונות אלקטרוניים שנוצרו בגרסה החדשה יותר של Google Sheets, צריך להשתמש במקום זאת בכיתה Protection בעלת העוצמה יותר. המחלקה הזו הוצאה משימוש, אבל היא עדיין זמינה לתאימות לגרסה הקודמת של Sheets.

גישה לגיליונות מוגנים ושינוי שלהם בגרסה הישנה יותר של Google Sheets.

שיטות שהוצאו משימוש

שיטה	סוג הערך שמוחזר	תיאור קצר
`addUser(email)`	`void`	מוסיף משתמש לרשימת המשתמשים שיכולים לערוך את הגיליון, אם הוא מוגן.
`getUsers()`	`String[]`	מחזירה רשימה של כתובות האימייל של המשתמשים שיכולים לערוך את הגיליון.
`isProtected()`	`Boolean`	הגנת גיליון מופעלת או לא מופעלת בגיליון.
`removeUser(user)`	`void`	מסיר משתמש מרשימת המשתמשים שיכולים לערוך את הגיליון.
`setProtected(protection)`	`void`	מגדיר את סטטוס ההגנה על הגיליון.

שיטות שהוצאו משימוש

`addUser(email)`

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

מוסיף משתמש לרשימת המשתמשים שיכולים לערוך את הגיליון, אם הוא מוגן.

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

פרמטרים

שם	תיאור	התיאור
`email`	`String`	כתובת האימייל של המשתמש שיש להוסיף.

כדאי לעיין גם בפרטים הבאים

removeUser(user)

`getUsers()`

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

מחזירה רשימה של כתובות האימייל של המשתמשים שיכולים לערוך את הגיליון.

אם הגנת הגיליון מושבתת, הערך שהוחזר על ידי הקריאה הזו הוא חסר משמעות.

החזרות

String[] – מערך של כתובות אימייל של משתמשים שיכולים לערוך את הגיליון הזה

`isProtected()`

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הגנת גיליון מופעלת או לא מופעלת בגיליון.

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

החזרות

Boolean – האם הגנת גיליון מופעלת בגיליון או לא

כדאי לעיין גם בפרטים הבאים

setProtected(protection)

`removeUser(user)`

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

מסיר משתמש מרשימת המשתמשים שיכולים לערוך את הגיליון.

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

פרמטרים

שם	תיאור	התיאור
`user`	`String`	כתובת האימייל של המשתמש שיש להסיר.

כדאי לעיין גם בפרטים הבאים

addUser(email)

`setProtected(protection)`

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

מגדיר את סטטוס ההגנה על הגיליון.

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

פרמטרים

שם	תיאור	התיאור
`protection`	`Boolean`	`true` כדי להפעיל הגנת גיליון, `false` כדי להשבית את הגנת הגיליון.

כדאי לעיין גם בפרטים הבאים

isProtected()