منسوخ شده. برای صفحات گسترده ایجاد شده در نسخه جدیدتر Google Sheets، به جای آن از کلاس Protection که قدرتمندتر است استفاده کنید. اگرچه این کلاس منسوخ شده است، اما برای سازگاری با نسخه قدیمیتر Sheets همچنان در دسترس است.
دسترسی و تغییر برگههای محافظتشده در نسخه قدیمی Google Sheets.
متدهای منسوخ شده
| روش | نوع بازگشتی | شرح مختصر |
|---|---|---|
| void | اگر برگه محافظت شده باشد، یک کاربر را به لیست کاربرانی که میتوانند آن را ویرایش کنند، اضافه میکند. |
| String[] | لیستی از آدرسهای ایمیل کاربرانی که میتوانند این برگه را ویرایش کنند، برمیگرداند. |
| Boolean | نشان میدهد که آیا محافظت از برگه فعال است یا خیر. |
| void | کاربر را از لیست کاربرانی که میتوانند برگه را ویرایش کنند، حذف میکند. |
| void | وضعیت حفاظت برای برگه را تنظیم میکند. |
متدهای منسوخ شده
addUser(email)
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 | ایمیل کاربر برای اضافه کردن. |
همچنین ببینید
getUsers()
getUsers()منسوخ شده. این تابع منسوخ شده است و نباید در اسکریپتهای جدید استفاده شود.
لیستی از آدرسهای ایمیل کاربرانی که میتوانند این برگه را ویرایش کنند، برمیگرداند.
اگر محافظت از برگه غیرفعال باشد، مقدار برگردانده شده توسط این فراخوانی بیمعنی است.
بازگشت
String[] — آرایهای از آدرسهای ایمیل کاربرانی که میتوانند این برگه را ویرایش کنند.
isProtected()
isProtected()منسوخ شده. این تابع منسوخ شده است و نباید در اسکریپتهای جدید استفاده شود.
نشان میدهد که آیا محافظت از برگه فعال است یا خیر.
// Determine whether or not sheet protection is enabled const sheet = SpreadsheetApp.getActiveSheet(); const permissions = sheet.getSheetProtection(); const isProtected = permissions.isProtected();
بازگشت
Boolean - آیا محافظت از برگه فعال است یا خیر.
همچنین ببینید
removeUser(user)
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 | آدرس ایمیل کاربر برای حذف. |
همچنین ببینید
setProtected(protection)
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 وارد کنید. |