تمت إزالة هذا العمود. بالنسبة إلى جداول البيانات التي يتم إنشاؤها في الإصدار الأحدث من "جداول بيانات Google"، استخدِم فئة Protection
الأكثر فعالية بدلاً من ذلك. على الرغم من أنّه تم إيقاف هذه الفئة نهائيًا، فإنها لا تزال متاحة
للتوافق مع الإصدار القديم من "جداول بيانات Google".
الوصول إلى أوراق البيانات المحمية وتعديلها في الإصدار السابق من "جداول بيانات Google"
الطرق المتوقّفة نهائيًا
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
| void | لإضافة مستخدم إلى قائمة المستخدمين الذين يمكنهم تعديل الورقة، إذا كانت محمية. |
| String[] | تعرض قائمة بعناوين البريد الإلكتروني للمستخدمين الذين يمكنهم تعديل ورقة البيانات هذه. |
| Boolean | يشير هذا الحقل إلى ما إذا كانت ميزة حماية الورقة مُفعَّلة أم لا. |
| void | إزالة مستخدم من قائمة المستخدمين الذين يمكنهم تعديل ورقة البيانات. |
| void | لضبط حالة الحماية لورقة البيانات. |
الطرق المتوقّفة نهائيًا
addUser(email)
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
email | String | عنوان البريد الإلكتروني للمستخدم المطلوب إضافته. |
يمكن أيضًا مراجعة
getUsers()
getUsers()
تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.
تعرض قائمة بعناوين البريد الإلكتروني للمستخدمين الذين يمكنهم تعديل ورقة البيانات هذه.
في حال إيقاف حماية الأوراق، لن تكون القيمة التي يعرضها هذا الاستدعاء ذات معنى.
استرجاع الكرة
String[]
— مصفوفة من عناوين البريد الإلكتروني للمستخدمين الذين يمكنهم تعديل ورقة البيانات هذه
isProtected()
isProtected()
تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.
يشير هذا الحقل إلى ما إذا كانت ميزة حماية الورقة مُفعَّلة أم لا.
// Determine whether or not sheet protection is enabled var sheet = SpreadsheetApp.getActiveSheet(); var permissions = sheet.getSheetProtection(); var isProtected = permissions.isProtected();
استرجاع الكرة
Boolean
— سواء تم تفعيل حماية الورقة أم لا
يمكن أيضًا مراجعة
removeUser(user)
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
user | String | عنوان البريد الإلكتروني للمستخدم المطلوب إزالته. |
يمكن أيضًا مراجعة
setProtected(protection)
setProtected(protection)
تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.
لضبط حالة الحماية لورقة البيانات.
// Enables sheet protection for this sheet var sheet = SpreadsheetApp.getActiveSheet(); var permissions = sheet.getSheetProtection(); permissions.setProtected(true); sheet.setSheetProtection(permissions);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
protection | Boolean | true لتفعيل حماية الورقة، وfalse لإيقاف حماية الورقة. |