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