Class PageProtection

محافظت از صفحه

منسوخ شده است. برای صفحات گسترده ایجاد شده در نسخه جدیدتر Google Sheets، به جای آن از کلاس Protection قدرتمندتر استفاده کنید. اگرچه این کلاس منسوخ شده است، اما برای سازگاری با نسخه قدیمی کاربرگ‌نگار همچنان در دسترس است.

به برگه‌های محافظت شده در نسخه قدیمی Google Sheets دسترسی داشته باشید و آنها را اصلاح کنید.

روش نوع برگشت شرح مختصر
add User(email) void کاربر را به لیست کاربرانی اضافه می کند که می توانند برگه را ویرایش کنند، در صورتی که محافظت شده باشد.
get Users() String[] فهرستی از آدرس‌های ایمیل کاربرانی را که می‌توانند این برگه را ویرایش کنند، برمی‌گرداند.
is Protected() Boolean نشان می دهد که آیا صفحه محافظ صفحه فعال است یا خیر.
remove User(user) void کاربری را از لیست کاربرانی که می توانند برگه را ویرایش کنند حذف می کند.
set Protected(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);

پارامترها

نام تایپ کنید توضیحات
email String ایمیل کاربر برای افزودن.

همچنین ببینید

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

فهرستی از آدرس‌های ایمیل کاربرانی را که می‌توانند این برگه را ویرایش کنند، برمی‌گرداند.

اگر محافظت برگه غیرفعال باشد، مقدار بازگردانده شده توسط این تماس بی معنی است.

بازگشت

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

پارامترها

نام تایپ کنید توضیحات
user String آدرس ایمیل کاربر برای حذف.

همچنین ببینید

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

وضعیت حفاظتی ورق را تنظیم می کند.

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

پارامترها

نام تایپ کنید توضیحات
protection Boolean true برای فعال کردن محافظ صفحه، false برای غیرفعال کردن محافظت صفحه.

همچنین ببینید