این صفحه به‌وسیله ‏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()