Class PageProtection

PageProtection

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

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

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

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

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

addUser(email)

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

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

// Add the "[e-mail]" user to the list of users who can edit this sheet
const sheet = SpreadsheetApp.getActiveSheet();
const permissions = sheet.getSheetProtection();
permissions.addUser('[e-mail]');
permissions.setProtected(true);
sheet.setSheetProtection(permissions);

المَعلمات

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

انظر أيضًا

• removeUser(user)

---

getUsers()

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

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

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

الإرجاع

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

---

isProtected()

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

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

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

الإرجاع

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

انظر أيضًا

• setProtected(protection)

---

removeUser(user)

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

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

// Remove the "[e-mail]" user to the list of users who can edit this
// sheet
const sheet = SpreadsheetApp.getActiveSheet();
const permissions = sheet.getSheetProtection();
permissions.removeUser('[e-mail]');
permissions.setProtected(true);
sheet.setSheetProtection(permissions);

المَعلمات

الاسم	النوع	الوصف
user	String	عنوان البريد الإلكتروني للمستخدم الذي تريد إزالته

انظر أيضًا

• addUser(email)

---

setProtected(protection)

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

تضبط هذه السمة حالة الحماية للورقة.

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

المَعلمات

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

انظر أيضًا

• isProtected()