דף זה תורגם על ידי 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()