تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class PageProtection

متوقف. بالنسبة إلى جداول البيانات التي يتم إنشاؤها في الإصدار الأحدث من "جداول بيانات Google"، استخدِم فئة Protection الأكثر فعالية بدلاً من ذلك. على الرغم من إيقاف هذه الفئة، ستظل متاحة للتوافق مع الإصدار القديم من "جداول بيانات Google".

الوصول إلى الأوراق المحمية وتعديلها في الإصدار الأقدم من "جداول بيانات Google".

الطرق التي تم إيقافها نهائيًا

الطريقة	نوع الإرجاع	وصف قصير
`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()