Class PageProtection

הגנה על דפים

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

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

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

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

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

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

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

פרמטרים

שםסוגתיאור
emailStringכתובת האימייל של המשתמש שרוצים להוסיף.

ראה גם

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

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

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

חזרה

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

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

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

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

חזרה

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

ראה גם

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

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

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

פרמטרים

שםסוגתיאור
userStringכתובת האימייל של המשתמש שרוצים להסיר.

ראה גם

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

הגדרת סטטוס ההגנה של הגיליון. 

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

פרמטרים

שםסוגתיאור
protectionBooleantrue כדי להפעיל את ההגנה על הגיליון, false כדי להשבית את ההגנה על הגיליון.

ראה גם