تمت ترجمة هذه الصفحة بواسطة 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
const sheet = SpreadsheetApp.getActiveSheet();
const 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
const sheet = SpreadsheetApp.getActiveSheet();
const permissions = sheet.getSheetProtection();
const isProtected = permissions.isProtected();

الإرجاع

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

انظر أيضًا

setProtected(protection)

`removeUser(user)`

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

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

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

المعلمات

الاسم	النوع	الوصف
`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()