این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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 User(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`	ایمیل کاربر برای افزودن.

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

remove User(user)

`get Users()`

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

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

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

بازگشت

String[] - آرایه ای از آدرس های ایمیل کاربرانی که می توانند این برگه را ویرایش کنند

`is Protected()`

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

نشان می دهد که آیا صفحه محافظ صفحه فعال است یا خیر.

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

بازگشت

Boolean - آیا صفحه محافظ صفحه فعال است یا خیر

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

set Protected(protection)

`remove User(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`	آدرس ایمیل کاربر برای حذف.

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

add User(email)

`set Protected(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` برای غیرفعال کردن محافظت صفحه.

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

is Protected()