דף זה תורגם על ידי 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
const sheet = SpreadsheetApp.getActiveSheet();
const 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
const sheet = SpreadsheetApp.getActiveSheet();
const permissions = sheet.getSheetProtection();
const isProtected = permissions.isProtected();

חזרה

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

ראה גם

setProtected(protection)

`removeUser(user)`

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

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

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

פרמטרים

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

ראה גם

addUser(email)

`setProtected(protection)`

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

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

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

פרמטרים

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

ראה גם

isProtected()