يتم ربط النص البرمجي بملف "جداول بيانات Google" أو "مستندات Google" أو "العروض التقديمية من Google" أو "نماذج Google" إذا تم إنشاؤه من ذلك المستند وليس كنص برمجي مستقل. يُطلق على الملف الذي يتم إرفاق نص برمجي مرتبط به اسم "الحاوية". تعمل النصوص البرمجية المرتبطة بشكل عام مثل النصوص البرمجية المستقلة باستثناء أنها لا تظهر في Google Drive، ولا يمكن فصلها عن الملف الذي ترتبط به، وتحصل على بعض الامتيازات الخاصة عبر الملف الأصلي.
تجدر الإشارة إلى أنّه يمكن أيضًا ربط النصوص البرمجية بـ "مواقع Google"، ولكن يتم نشر هذه النصوص البرمجية غالبًا على أنّها تطبيقات ويب. يمكن أن تصبح النصوص البرمجية المرتبطة بـ "جداول بيانات Google" أو "مستندات 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". إذا كنت قد طوّرت نصًا برمجيًا مستقل أو مرتبطًا وتريد مشاركته مع الجميع، تتيح لك لغة "برمجة تطبيقات Google" publish النص البرمجي كإضافة تتيح للمستخدمين الآخرين تثبيته من متجر الإضافات.
أسباب طلب المساعدة
يمكن أن تستخدم النصوص البرمجية المرتبطة مشغلات بسيطة
مثل دالة onOpen() الخاصة، التي تعمل تلقائيًا عندما يتم فتح الملف من قِبل مستخدم لديه الإذن بتعديل المحتوى. مثل جميع أنواع النصوص البرمجية، يمكنها أيضًا
استخدام المشغلات القابلة للتثبيت.
الدوال المخصّصة
الدالة المخصّصة هي دالة في نص برمجي مرتبط بـ "جداول بيانات Google" وتستدعيها مباشرةً من خلية باستخدام البنية =myFunctionName(). وبالتالي، تتشابه الدوال المخصّصة مع مئات الدوال المضمَّنة في "جداول بيانات Google"، مثل AVERAGE أو SUM، باستثناء أنّك تحدّد سلوك الدالة المخصّصة.
الوصول إلى النصوص البرمجية المرتبطة
يمكن فقط للمستخدمين الذين لديهم إذن بتعديل إحدى الحاويات تشغيل النص البرمجي المرتبط بها. ولا يمكن للمتعاونين الذين لديهم إمكانية الوصول للعرض فقط فتح أداة تعديل النص البرمجي، على الرغم من أنّه في حال إنشاء نسخة من ملف الحاوية، يصبحون مالكي النسخة ويمكنهم الاطّلاع على نسخة من النص البرمجي وتشغيلها.
للتعرّف على كيفية مشاركة ملف حاوية النص البرمجي، راجِع مشاركة الملفات من Google Drive.