يقتصر النص البرمجي على ملف في "جداول بيانات Google" أو "مستندات Google" أو "العروض التقديمية من Google" أو "نماذج Google" إذا تم إنشاؤه من هذا المستند بدلاً من نص برمجي مستقل. يُطلق على الملف الذي يتم إرفاق نص برمجي مرتبط به "الحاوية". تعمل النصوص البرمجية المقيّدة بشكل عام مثل النصوص البرمجية المستقلة ما لم تظهر في Google Drive، ولا يمكن فصلها عن الملف الذي تم ربطها به، كما تحصل على بعض الامتيازات الخاصة على الملف الرئيسي.
ويمكن أيضًا ربط النصوص البرمجية بـ "مواقع Google"، ولكن يتم نشر هذه النصوص البرمجية في أغلب الأحيان كتطبيقات ويب. وقد تصبح النصوص البرمجية المرتبطة بـ "جداول بيانات Google" أو "مستندات Google" أو "العروض التقديمية من Google" أو "نماذج Google" تطبيقات ويب أيضًا، ولكن هذا الأمر غير شائع.
إنشاء نص برمجي مرتبط
"مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google"
لإنشاء نص برمجي مرتبط في "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google"، افتح مستندًا في "مستندات Google" أو جدول بيانات في "جداول بيانات Google" أو عرضًا تقديميًا في "العروض التقديمية من Google" وانقر على الإضافات > برمجة التطبيقات. لإعادة فتح النص البرمجي في المستقبل، نفِّذ الإجراء نفسه أو افتح النص البرمجي من لوحة بيانات برمجة التطبيقات.
نماذج Google
لإنشاء نص برمجي مرتبط في "نماذج Google"، افتح نموذجًا وانقر على رمز المزيد > محرِّر النص البرمجي. لإعادة فتح النص البرمجي في المستقبل، نفِّذ الإجراء نفسه أو افتح النص البرمجي من لوحة بيانات برمجة التطبيقات.
الطرق الخاصة
يمكن أن تطلب النصوص البرمجية المقيّدة بضع طرق لا يمكن لها استخدام نصوص برمجية مستقلة:
getActiveSpreadsheet()
وgetActiveDocument()
getActivePresentation()
وgetActiveForm()
السماح بالنصوص البرمجية المرتبطة بالرجوع إلى الملف الرئيسي بدون الرجوع إلى معرِّف الملف.- تتيح
getUi
للنصوص البرمجية المُلزَمة الوصول إلى واجهة المستخدم للملف الرئيسي لإضافة القوائم ومربّعات الحوار والأشرطة الجانبية المخصصة. - في "جداول بيانات Google"
getActiveSheet()
getActiveRange()
وgetActiveCell()
اسمح للنص البرمجي بتحديد ورقة البيانات الحالية للمستخدم أو نطاق الخلايا المحدد أو الخلية الفردية المحددة.setActiveSheet(sheet)
وsetActiveRange(range)
اسمح للنص البرمجي بتغيير هذه الاختيارات. - في "مستندات Google"،
getCursor()
وgetSelection()
اسمح للنص البرمجي بتحديد موضع مؤشر المستخدم أو النص المحدد.setCursor(position)
وsetSelection(range)
اسمح للنص البرمجي بتغيير هذه المواقع الجغرافية.
لمزيد من المعلومات، يمكنك الاطّلاع على دليل توسيع "جداول بيانات Google" أو دليل توسيع نطاق "مستندات Google".
القوائم ومربّعات الحوار والأشرطة الجانبية المخصّصة
يمكن للنصوص البرمجية المقيّدة تخصيص "جداول بيانات Google" و"مستندات Google" و"نماذج Google" من خلال إضافة القوائم المخصّصة ومربّعات الحوار أو الأشرطة الجانبية. ومع ذلك، تذكّر أن النص البرمجي يمكن أن يتفاعل فقط مع واجهة المستخدم للنسخة الحالية من ملف مفتوح. وهذا يعني أن النص البرمجي المرتبط بمستند واحد لا يمكن أن يؤثر في واجهة المستخدم لمستند آخر.
الشبكات الإضافية
يتم تشغيل الإضافات داخل Gmail و"جداول بيانات Google" و"مستندات Google" و"العروض التقديمية من Google" و"نماذج Google". إذا كنت قد طوّرت نصًا برمجيًا محدودًا أو مستقلًا وأردت مشاركته مع العالم، تتيح لك "برمجة التطبيقات" نشر النص البرمجي كإضافة حتى يتمكّن المستخدمون الآخرون من تثبيته من متجر الإضافات.
أسباب طلب المساعدة
يمكن للنصوص البرمجية المقيّدة استخدام مشغّلات بسيطة
مثل دالة onOpen()
الخاصة التي يتم تشغيلها تلقائيًا عند فتح
ملف لدى مستخدم لديه الإذن بتعديل المحتوى. وكما هو الحال مع جميع أنواع النصوص البرمجية، يمكن لهذه التطبيقات أيضًا استخدام مشغِّلات قابلة للتثبيت.
دوال مخصصة
الدالة المخصصة هي دالة في نص برمجي مرتبط بـ "جداول بيانات Google" تطلبها مباشرةً من خلية باستخدام البنية =myFunctionName()
. وبالتالي، تشبه الدوال المخصّصة المئات من الدوال المضمّنة في "جداول بيانات Google" مثل AVERAGE
أو SUM
، باستثناء أنّك تحدّد سلوك الدالة المخصّصة.
الوصول إلى النصوص البرمجية المرتبطة
يمكن فقط للمستخدمين الذين لديهم إذن لتعديل حاوية تنفيذ النص البرمجي المرتبط بها. لا يمكن للمتعاونين الذين لديهم حق العرض فقط فتح محرِّر النص البرمجي، ولكن في حال إنشاء نسخة من ملف الحاوية، يصبحون مالكي النص ويمكنهم الاطّلاع على نسخة من النص البرمجي وتشغيلها.
لمعرفة كيفية مشاركة ملف حاوية النص البرمجي، يُرجى الرجوع إلى مشاركة الملفات من Google Drive.