عند إنشاء إضافة جديدة على Google Workspace، اتّبِع الخطوات التالية بشكل عام:
- إعداد مشاريع الإضافات واختيار مالك والمتعاونين معهم.
- تصميم مظهر الإضافة وسلوكها
- اضبط بيان مشروع الإضافة أو مورد النشر.
- اكتب التعليمة البرمجية لتحديد مظهر الإضافة السلوك.
- تحقَّق من نطاقات OAuth الخاصة بإضافتك.
- اختبار الإضافة ضمن التطبيقات المضيفة يتمدد.
- انشر الإضافة.
إعداد مشاريع الإضافة واختيار مالك ومتعاونين
إذا أنشأت الإضافة في "برمجة تطبيقات Google" في إنشاء كل من مشروع "برمجة تطبيقات Google" ومشروع على Google Cloud. إذا أنشأت الإضافة بلغة غير برمجة التطبيقات، ما عليك سوى إنشاء مشروع على Google Cloud.
قبل البدء في تطوير الإضافة، اختَر حساب مستخدم لامتلاك المشاريع وتحديد الحسابات الأخرى والمتعاونين. ينشئ مالك المشاريع ملفات المشاريع ويدير الإعدادات المرتبطة بها، بينما يمكن للمتعاونين المساعدة في الترميز والاختبار.
مشاريع "برمجة تطبيقات Google"
يمكنك إنشاء ملفات مشروع "برمجة تطبيقات Google" لإضافة Chrome في مساحة تخزين سحابي مشترَكة حتى لا يمتلك أي حساب واحد الملكية الكاملة. يضمن وضع ملف رمزبرمجي إضافي في مساحة تخزين سحابي مشتركة إمكانية وصول متعاونين متعدّدين إلى مشروع الرمز البرمجي.
عند نشر إضافة، يعمل حساب مستخدم واحد بدور الناشر. يجب أن يكون لدى حساب النشر إذن وصول للتعديل في مشروع السيناريو، ولكن ليس بالضرورة أن يكون المالك.
لإنشاء مشروع "برمجة تطبيقات Google"، يُرجى الاطّلاع على مشاريع النص البرمجي.
مشاريع Google Cloud
ننصحك بإضافة متعاونين إلى مشروع الإضافة في Cloud. يساعد ذلك في ضمان إمكانية وصول أحد أفراد فريقك في أي وقت إلى إعدادات "سحابة Google" في الإضافة.
لإنشاء مشروع على Google Cloud، يُرجى الاطّلاع على مقالة إنشاء مشروع على Google Cloud.
تصميم مظهر الإضافة وسلوكها
اختيار الشكل الذي تريد أن تظهر به الإضافة وطريقة عرضها ينبغي أن يتصرف قبل البدء في إنشائه. ضع في اعتبارك حالات الاستخدام التي يجب أن تحاول الوظيفة الإضافية تقديم حلول لها. ابدأ بتصميم بسيط للبدء أولاً، ثم أضِف المزيد من التحسينات.
راجِع دليل تصميم إضافات Google Workspace. للحصول على إرشادات حول كيفية تصميم إضافتك المستخدم.
ضبط بيان مشروع الإضافة
في مشاريع Apps Script، بيان المشروع هوملف JSON خاص. يحدد مجموعة متنوعة من التفاصيل حول المشروع، مثل مكتبته والتبعيات لديك. بالنسبة إلى إضافات Google Workspace، يوفّر البيان أيضًا الإعدادات الأساسية: المعلومات التي يحتاجها التطبيق المضيف لعرض الإضافة بشكل صحيح.
اطّلِع على بيانات البيان لمعرفة تفاصيل عن كيفية ضبط بيان الإضافة في Apps Script.
أثناء إضافة الرموز البرمجية والميزات إلى الإضافة، عدِّل البيان حسب الحاجة لإنشاء المظهر والسلوك المطلوبَين للإضافة.
ترميز الإضافة
يجب تنفيذ واجهة مستندة إلى البطاقة لتطبيق الإضافة. استخدِم خدمة البطاقات في Apps Script أو إذا كنت تكتب بلغة رموز أخرى، أعِد ملف JSON بتنسيق صحيح لكي تعرِض الواجهة البطاقات.
يجب أيضًا تنفيذ أي وظائف مشغِّلة محدّدة في بيان الإضافة. إذا كان ترتبط الإضافة بخدمة تابعة لجهة خارجية غير تابعة لشركة Google باستخدام بروتوكول OAuth، يجب ضبط بروتوكول OAuth من أجل ذلك. خدمة أيضًا.
بطاقات الإنشاء
يمكنك تحديد واجهة مستخدم للإضافة من خلال إنشاء عناصر
Card وملؤها بعناصر
أداة مصغّرة. يجب أن تعرِض دوال التفعيل المحدّدة في
ملف البيان إما كائنًا واحدًا
Card أو صفيفًا من كائنات
Card تمثّل
"صفحات" مختلفة من واجهة الإضافة. إنّ
الإضافة أيضًا إنشاء بطاقات جديدة وعرضها في
الاستجابة لإجراءات المستخدم.
في "برمجة تطبيقات Google"، يمكنك إنشاء بطاقات باستخدام
صف واحد (CardBuilder). على كل
تتطلّب البطاقة CardHeader.
وواحد أو أكثر
CardSections عليك
ملء كل قسم من أقسام البطاقة بالأدوات الفردية التي تشكل
مع واجهة المستخدم الإضافية. يتم عادةً ربط تطبيقات قياس التفاعل
المصغرة بـ الإجراءات لتحديد سلوك التفاعل.
بعد إضافة جميع الأقسام والتطبيقات المصغّرة إلى بطاقتك من خلال
CardBuilder، عليك الاتصال
CardBuilder.build()
لإنشاء كائن Card المقابل.
يمكنك استخدام خدمات Apps Script
المضمّنة الأخرى، مثل
CalendarApp لاسترداد
المعلومات لعرضها في البطاقات الإضافية التي تنشئها.
يمكنك استخدام البيانات التي تم استرجاعها من الخدمات غير التابعة لشركة Google.
إذا كانت الإضافة تحتاج إلى الوصول إلى واجهات برمجة تطبيقات غير تابعة لـ Google طلب بروتوكول OAuth، يجب عليك إعداد تلك الخدمة والاتصال بها، راجع دليل الربط بخدمات غير تابعة لشركة Google لمزيد من التفاصيل.
أمر الإنشاء
عند إنشاء بطاقة، يجب البدء من أعلى الصفحة. أي، يجب عليك استخدام هذا طلب البناء:
- إنشاء التطبيق المصغّر.
- أضِف التطبيق المصغّر إلى قسم البطاقة.
- كرِّر هذه الخطوة إلى أن يتضمّن قسم البطاقة جميع التطبيقات المصغّرة.
- أضِف قسم البطاقة إلى البطاقة.
هذا الإجراء مطلوب لأنه عند إضافة أداة إلى قسم البطاقة أو البطاقة، يضيفون في الواقع نسخة من هذا التطبيق المصغّر. أي تغييرات تجريها على التطبيق المصغّر بعد إضافته لا يظهر في البطاقة النهائية
الإجراءات العامة
يمكنك استخدام الإجراءات العامة لتوفير وظائف لا تعتمد على السياق. الإجراءات العامة هي عناصر قائمة متوفرة في واجهة مستخدم الإضافة بغض النظر عن البطاقة المعروضة. تظهر جميع الإجراءات العالمية المحدّدة دائمًا في قائمة بطاقة الإضافة.
اطّلِع على الإجراءات العامة لمزيد من المعلومات. التفاصيل.
التحقّق من نطاقات OAuth الإضافية
تحدد النطاقات الإجراءات التي السماح للإضافات بتوليها نيابةً عن المستخدم. إنها من أفضل الممارسات أن يكون للإضافات نطاقات للإجراءات التي وأن يعملوا جيدًا وليس أكثر من ذلك.
في مشاريع الإضافات، عيِّن حزمة إضافية والنطاقات لضمان استخدام الإضافة مجموعة النطاقات الأقل منحًا للأذونات ممكن. يمكنك تحديد النطاقات التي تستخدمها الإضافة الإضافة .
راجع النطاقات لمزيد من التفاصيل.
اختبار الإضافة
يمكنك اختبار الإضافات غير المنشورة من خلال تثبيت أولاً تم إلغاء نشره . بعد تثبيت الإضافة واعتمادها، يمكنك استخدامها في حسابك واختبار مظهره وسلوكه في التطبيقات المضيفة يمدّد. يجب عليك التحقق من أن الإضافة تعمل متوقع للسياقات وإجراءات المستخدم.
اطّلِع على اختبار إضافات Google Workspace للحصول على مزيد من التفاصيل.
نشر الإضافة
يؤدي نشر الإضافة إلى توفيرها للمستخدمين الآخرين إما بشكل علني أو المستخدمين في نطاقك فقط. قبل بدء النشر احرص على مراجعة نظرة عامة حول جهة النشر. يُعد النشر عملية معقدة تتطلب الإعداد والوقت لإنجازها.
يتم نشر إضافات Google Workspace في Google Workspace Marketplace. يجب أن تخضع المراجعات للإضافة المتاحة للجميع قبل نشرها.
الاطّلاع على نشر إضافة Google Workspace لـ المزيد من التفاصيل.