تمّت إزالة هذا العمود. بالنسبة إلى جداول البيانات التي تم إنشاؤها في الإصدار الأحدث من "جداول بيانات Google"، استخدِم الفئة Protection الأكثر فعالية بدلاً من ذلك. على الرغم من أنّه تم إيقاف هذه الفئة نهائيًا، إلا أنّها تظل متاحة للتوافق مع الإصدار القديم من "جداول بيانات Google".
الوصول إلى أوراق البيانات المحمية وتعديلها في الإصدار القديم من "جداول بيانات Google"
الطُرق المتوقّفة
| الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
|---|---|---|
| void | تضيف هذه الدالة مستخدمًا إلى قائمة المستخدمين الذين يمكنهم تعديل ورقة البيانات، إذا كانت محمية. |
| String[] | تعرض هذه الدالة قائمة بعناوين البريد الإلكتروني للمستخدمين الذين يمكنهم تعديل ورقة البيانات هذه. |
| Boolean | توضّح هذه السمة ما إذا كانت حماية ورقة البيانات مفعّلة أم لا. |
| void | تزيل هذه الطريقة مستخدمًا من قائمة المستخدمين الذين يمكنهم تعديل ورقة البيانات. |
| void | تضبط هذه السمة حالة الحماية للورقة. |
الطُرق المتوقّفة
add
addتمّت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تضيف هذه الدالة مستخدمًا إلى قائمة المستخدمين الذين يمكنهم تعديل ورقة البيانات، إذا كانت محمية.
// Add the "[email protected]" user to the list of users who can edit this sheet const sheet = SpreadsheetApp.getActiveSheet(); const permissions = sheet.getSheetProtection(); permissions.addUser('[email protected]'); permissions.setProtected(true); sheet.setSheetProtection(permissions);
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
email | String | البريد الإلكتروني للمستخدم الذي تريد إضافته |
انظر أيضًا
get
getتمّت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تعرض هذه الدالة قائمة بعناوين البريد الإلكتروني للمستخدمين الذين يمكنهم تعديل ورقة البيانات هذه.
إذا كانت ميزة حماية ورقة البيانات غير مفعّلة، ستكون القيمة التي تعرضها هذه الدالة بلا معنى.
الإرجاع
String[]: مصفوفة من عناوين البريد الإلكتروني للمستخدمين الذين يمكنهم تعديل ورقة البيانات هذه.
is
isتمّت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
توضّح هذه السمة ما إذا كانت حماية ورقة البيانات مفعّلة أم لا.
// Determine whether or not sheet protection is enabled const sheet = SpreadsheetApp.getActiveSheet(); const permissions = sheet.getSheetProtection(); const isProtected = permissions.isProtected();
الإرجاع
Boolean: ما إذا كانت حماية الورقة مفعّلة أم لا.
انظر أيضًا
remove
removeتمّت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تزيل هذه الطريقة مستخدمًا من قائمة المستخدمين الذين يمكنهم تعديل ورقة البيانات.
// Remove the "[email protected]" user to the list of users who can edit this // sheet const sheet = SpreadsheetApp.getActiveSheet(); const permissions = sheet.getSheetProtection(); permissions.removeUser('[email protected]'); permissions.setProtected(true); sheet.setSheetProtection(permissions);
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
user | String | عنوان البريد الإلكتروني للمستخدم الذي تريد إزالته |
انظر أيضًا
set
setتمّت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تضبط هذه السمة حالة الحماية للورقة.
// Enables sheet protection for this sheet const sheet = SpreadsheetApp.getActiveSheet(); const permissions = sheet.getSheetProtection(); permissions.setProtected(true); sheet.setSheetProtection(permissions);
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
protection | Boolean | true لتفعيل حماية الورقة، false لإيقاف حماية الورقة |