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