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