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

Class PageProtection

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

به برگه‌های محافظت شده در نسخه قدیمی 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
var sheet = SpreadsheetApp.getActiveSheet();
var 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
var sheet = SpreadsheetApp.getActiveSheet();
var permissions = sheet.getSheetProtection();
var isProtected = permissions.isProtected();

بازگشت

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

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

setProtected(protection)

`removeUser(user)`

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

کاربری را از لیست کاربرانی که می توانند برگه را ویرایش کنند حذف می کند.

// Remove the "user@example.com" user to the list of users who can edit this sheet
var sheet = SpreadsheetApp.getActiveSheet();
var 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
var sheet = SpreadsheetApp.getActiveSheet();
var permissions = sheet.getSheetProtection();
permissions.setProtected(true);
sheet.setSheetProtection(permissions);

پارامترها

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

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

isProtected()