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

Class PageProtection

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

الوصول إلى أوراق البيانات المحمية وتعديلها في الإصدار القديم من "جداول بيانات 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()