Class PageProtection

حماية الصفحة

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

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

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addUser(email)voidتُضيف مستخدمًا إلى قائمة المستخدمين الذين يمكنهم تعديل ورقة البيانات، إذا كانت محمية.
getUsers()String[]تعرِض هذه الدالة قائمة بعناوين البريد الإلكتروني للمستخدمين الذين يمكنهم تعديل هذه الورقة.
isProtected()Booleanيشير إلى ما إذا كانت حماية الورقة مفعّلة أم لا.
removeUser(user)voidتزيل مستخدمًا من قائمة المستخدمين الذين يمكنهم تعديل ورقة البيانات.
setProtected(protection)voidلضبط حالة الحماية للورقة

الطرق المتوقّفة

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

تُضيف مستخدمًا إلى قائمة المستخدمين الذين يمكنهم تعديل ورقة البيانات، إذا كانت محمية.

// 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);

المعلمات

الاسمالنوعالوصف
emailStringعنوان البريد الإلكتروني للمستخدم الذي تريد إضافته

انظر أيضًا


تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

تعرِض هذه الدالة قائمة بعناوين البريد الإلكتروني للمستخدمين الذين يمكنهم تعديل هذه الورقة.

إذا كانت حماية ورقة البيانات غير مفعّلة، تكون القيمة التي تعرضها هذه الدعوة بلا معنى.

الإرجاع

String[]: صفيف من عناوين البريد الإلكتروني للمستخدمين الذين يمكنهم تعديل هذه الورقة


تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

يشير إلى ما إذا كانت حماية الورقة مفعّلة أم لا.

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

الإرجاع

Boolean: ما إذا كانت حماية الورقة مفعّلة أم لا

انظر أيضًا


تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

تزيل مستخدمًا من قائمة المستخدمين الذين يمكنهم تعديل ورقة البيانات.

// 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);

المعلمات

الاسمالنوعالوصف
userStringعنوان البريد الإلكتروني للمستخدم المطلوب إزالته

انظر أيضًا


تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

لضبط حالة الحماية للورقة

// Enables sheet protection for  this sheet
const sheet = SpreadsheetApp.getActiveSheet();
const permissions = sheet.getSheetProtection();
permissions.setProtected(true);
sheet.setSheetProtection(permissions);

المعلمات

الاسمالنوعالوصف
protectionBooleantrue لتفعيل حماية الورقة، false لإيقاف حماية الورقة

انظر أيضًا