قبل إنشاء إضافة "المحرّر"، راجِع حصص واستخدامات Apps Script للتأكّد من أنّ تصميم مشروعك يتوافق مع هذه الإرشادات. يمكن أن يساعدك التعرّف على هذه الحدود في مرحلة مبكرة من عملية التطوير في تجنُّب المشاكل المحتملة لاحقًا. تُعدّ "برمجة تطبيقات Google" مثالية لتطوير إضافات بسيطة لك أو لفريقك أو لمؤسستك. ومع ذلك، إذا كنت تتوقّع إنشاء إضافة واسعة النطاق تحتاج إلى التعامل مع العديد من المستخدمين، أو تتطلّب وقت استجابة منخفضًا، أو تحتاج إلى التحكّم الكامل في البنية الأساسية، ننصحك بتطوير إضافة Google Workspace في بيئة وقت تشغيل مختلف.
اتّبِع الإجراء العام التالي عند إنشاء إضافة "المحرّر":
- أنشئ مشروعًا في "برمجة تطبيقات Google".
- اكتب رمزًا برمجيًا لتحديد مظهر الإضافة وطريقة عملها باستخدام خدمة HTML المضمّنة في "برمجة تطبيقات Google".
- اختبِر الإضافة.
- انشر الإضافة.
إنشاء مشروع نص برمجي
إضافة المحرّر هي مشروع مستقل في "برمجة تطبيقات Google". يقدّم دليل النصوص البرمجية المستقلة
تعليمات لإنشاء مشاريع جديدة.
يمكنك أيضًا فتح نص برمجي جديد.
إذا أجريت ذلك، سيتم وضع ملف المشروع (الذي كان اسمه في البداية Untitled project) في مجلد Drive الجذر.
التعاون
عند التعاون مع مستخدمين آخرين في تطوير إضافة، يملك حساب مستخدم واحد مشروع الإضافة. عند نشر إضافة، يعمل حساب مستخدم واحد كناشر. يجب أن يكون لحساب النشر إذن تعديل مشروع البرنامج النصي للإضافة، ولكن ليس من الضروري أن يكون صاحب المشروع.
من المهم جدًا تجنُّب الحالات التي تفقد فيها إمكانية الوصول إلى رمز أو إعدادات إضافة لأنّ مالك المشروع غادر مؤسستك.
لتجنُّب فقدان إذن الوصول إلى رمز الإضافة، ننصحك باستخدام وحدات التخزين المشتركة عند التعاون في إضافة. يضمن وضع ملف نص برمجي للإضافة في مساحة تخزين سحابي مشتركة عدم امتلاك حساب واحد للمشروع.
ننصحك أيضًا بإضافة متعاونين إلى مشروع Cloud Platform (GCP) الخاص بمشروع النص البرمجي. يساعد ذلك في ضمان إمكانية وصول أحد أعضاء فريقك دائمًا إلى إعدادات السحابة الإلكترونية الخاصة بالإضافة.
كتابة رمز الإضافة
بعد إنشاء مشروع نص برمجي، يمكنك البدء في كتابة الرمز البرمجي لتحديد مظهر الإضافة وسلوكها. يمكنك استخدام خدمة HtmlService في Apps Script لإنشاء واجهة مستخدم الإضافة، أي مربّعات الحوار والأشرطة الجانبية، باستخدام لغتَي HTML وCSS التقليديتَين. يمكن أن تحدّد إضافات المحرّر أيضًا عناصر قائمة مخصّصة.
أثناء كتابة الرمز، راجِع دليل الأنماط الخاص بإضافة "المحرّر" للحصول على إرشادات حول كيفية تصميم تجربة المستخدم الخاصة بالإضافة. عليك أيضًا التأكّد من فهم حالات دورة حياة التفويض المختلفة التي يمكن أن تواجهها الإضافة والبرمجة وفقًا لها.
اختبار الإضافة
يمكنك اختبار إضافات "المحرّر" قبل نشرها للتأكّد من أنّها تعمل على النحو المتوقّع. يتطلّب الاختبار إنشاء إعداد اختبار واستخدام مستند أو جدول بيانات أو نموذج أو عرض تقديمي للاختبار.
لمزيد من التفاصيل، يُرجى الاطّلاع على اختبار إحدى "إضافات المحرِّر".
نشر الإضافة
يؤدي نشر الإضافة إلى إتاحتها للآخرين، إما بشكل علني أو فقط للمستخدمين في نطاقك. قبل بدء عملية النشر، احرص على مراجعة نظرة عامة على عملية النشر.
يتم نشر إضافات المحرّر في Google Workspace Marketplace. يجب أن تجتاز الإضافات المتاحة للجميع مراجعة الإضافات قبل نشرها.
لمزيد من التفاصيل، يُرجى الاطّلاع على نشر إضافة "أداة التعديل".