إنشاء إضافات Google Workspace

تعرَّف على كيفية تصميم إضافات Google Workspace وإنشائها ونشرها:

  1. حدِّد تطبيقات Google Workspace التي تريد إتاحة الإضافة فيها للمستخدمين.
  2. إعداد مشاريع الإضافة واختيار مالك ومتعاونين
  3. تصميم مظهر الإضافة وضبطه
  4. إنشاء الإضافة
  5. تحقَّق من نطاقات OAuth الخاصة بالإضافة.
  6. اختبِر الإضافة في تطبيق واحد أو أكثر من تطبيقات Google Workspace.
  7. انشر الإضافة.

إنشاء إضافة باستخدام "برمجة تطبيقات Google" أو HTTP للمقارنة بينهما، شاهِد الفيديو "برمجة تطبيقات مقابل نقاط نهاية HTTP: Which should you choose?‎". 🤔".

اختيار تطبيقات المضيف في Google Workspace

يمكنك ضبط إعدادات إضافات Google Workspace لتظهر في تطبيقات Google Workspace المضيفة التالية:

  • Gmail
  • تقويم Google
  • Google Chat
  • مستندات Google
  • Google Drive
  • Google Meet
  • جداول بيانات Google
  • العروض التقديمية من Google

لتطوير تطبيقات Google Workspace، يُرجى الاطّلاع على توسيع نطاق واجهة مستخدم Google Workspace.

إعداد مشاريع الإضافة واختيار مالك ومتعاونين

إذا أنشأت الإضافة في "برمجة تطبيقات Google"، ستنشئ مشروعًا في "برمجة تطبيقات Google" ومشروعًا في Google Cloud. إذا أنشأت الإضافة بلغة أخرى غير "برمجة تطبيقات Google"، عليك إنشاء مشروع Google Cloud فقط.

لإنشاء إضافة، يجب إعداد كل من مشروع نص برمجي ومشروع على السحابة الإلكترونية.

قبل البدء في تطوير الإضافات، اختَر حساب مستخدم واحدًا تملك المشاريع من خلاله، وحدِّد الحسابات الأخرى التي ستتعاون معها. ينشئ مالك المشاريع ملفات المشروع والإعدادات المرتبطة بها ويديرها، بينما يمكن للمتعاونين المساعدة في الترميز والاختبار.

مشاريع "برمجة تطبيقات Google"

قبل إنشاء الإضافة، راجِع حصص وقيود برمجة تطبيقات لمواءمة تصميم مشروعك مع هذه الإرشادات. تُعدّ برمجة تطبيقات الخيار الأفضل للتطوير البسيط للإضافات الشخصية أو الداخلية التي تضم قاعدة المستخدمين صغيرة. إذا كانت الإضافة تتطلّب توفير الدعم لعدد كبير من المستخدمين أو وقت استجابة منخفض أو تحكّمًا كاملاً في البنية الأساسية، ننصحك باستخدام وقت تشغيل مختلف.

أنشئ ملفات مشروع "برمجة تطبيقات Google" الخاصة بالإضافة في مساحة تخزين سحابي مشتركة لكي لا يمتلك حساب واحد الملكية الحصرية. يضمن وضع ملف البرنامج النصي للإضافة في مساحة تخزين سحابي مشتركة أن يتمكّن جميع المتعاونين من الوصول إلى مشروع البرنامج النصي.

عند نشر إضافة، يكون حساب مستخدم واحد هو الناشر. يجب أن يكون لحساب النشر إذن تعديل مشروع النص البرمجي، ولكن ليس بالضرورة أن يكون هو المالك.

لإنشاء مشروع في "برمجة التطبيقات"، راجِع مشاريع البرامج النصية.

مشاريع Google Cloud

أضِف متعاونين إلى مشروع على السحابة الإلكترونية الخاص بالإضافة. يضمن ذلك إمكانية وصول فريقك دائمًا إلى إعدادات Cloud الخاصة بالإضافة.

لإنشاء مشروع على Google Cloud، يُرجى الاطّلاع على إنشاء مشروع على Google Cloud.

تصميم مظهر الإضافة وطريقة عملها وضبطهما

حدِّد شكل الوظيفة الإضافية وسلوكها قبل إنشائها. حدِّد حالات الاستخدام التي تحلّها الإضافة. ابدأ بتصميم أساسي للبدء في العمل أولاً، ثم أضِف تحسينات.

راجِع دليل أسلوب إضافات Google Workspace للحصول على إرشادات حول كيفية تصميم تجربة المستخدم الخاصة بالإضافة.

ضبط ملف بيان الإضافة

تنفيذ التصميم في بيان الإضافة اضبط مظهر الإضافة وسلوكها في ملف البيان، بما في ذلك تطبيقات Google Workspace المضيفة التي توسّعها الإضافة.

لمزيد من التفاصيل، يُرجى الاطّلاع على بيانات Google Workspace الإضافية.

عند إضافة رموز وميزات، عدِّل ملف البيان حسب الحاجة لتحديد شكل وسلوك الإضافة المطلوبة.

ضبط مظهر تطبيق Google Chat وسلوكه

إذا كنت تصمّم إضافة توسّع نطاق Google Chat، استخدِم Google Chat API لإعداد مظهر وسلوك تطبيق Chat. للاطّلاع على الخطوات، راجِع استخدام Google Chat API.

إنشاء الإضافة

تنفيذ واجهة مستندة إلى البطاقات للإضافة استخدِم خدمة البطاقات أو إذا كنت تستخدم لغة رمز أخرى، أرجِع JSON منسَّقًا لتعرض الواجهة على شكل بطاقات.

نفِّذ أي دوال مشغّلة محدّدة في بيان الإضافة. إذا كانت الإضافة تتصل بخدمة تابعة لجهة خارجية باستخدام بروتوكول OAuth، عليك ضبط بروتوكول OAuth لهذه الخدمة.

بطاقات الإنشاء

حدِّد واجهة مستخدم إضافية من خلال إنشاء عناصر Card وإضافة عناصر واجهة مستخدم. يجب أن تعرض دوال التشغيل المحدّدة في البيان إما عنصر Card واحدًا أو مصفوفة من عناصر Card تمثّل "صفحات" مختلفة لواجهة الإضافة. يمكن للإضافة أيضًا إنشاء بطاقات جديدة وعرضها استجابةً لإجراءات المستخدم.

في برمجة تطبيقات، أنشئ بطاقات باستخدام الفئة CardBuilder. تتطلّب كل بطاقة CardHeader وسمة واحدة أو أكثر من CardSections. املأ كل قسم من البطاقة بالتطبيقات المصغّرة الفردية التي تشكّل الواجهة. عادةً ما تكون عناصر واجهة المستخدم التفاعلية مرتبطة بإجراءات لتحديد سلوك التفاعل الخاص بها.

بعد إضافة جميع الأقسام والتطبيقات المصغّرة إلى بطاقتك من خلال CardBuilder، استدعِ الدالة CardBuilder.build لإنشاء عنصر Card المقابل.

استخدِم خدمات برمجة تطبيقات المضمّنة، مثل CalendarApp، لاسترداد المعلومات وعرضها في بطاقات الإضافة. استخدام البيانات من الخدمات غير التابعة لـ Google

إذا كانت الإضافة بحاجة إلى الوصول إلى واجهات برمجة تطبيقات غير تابعة لـ Google وتتطلّب بروتوكول OAuth، عليك إعداد الخدمة والربط بها. راجِع دليل الربط بالخدمات غير التابعة لـ Google.

ترتيب البناء

عند إنشاء بطاقة، ابدأ من الأعلى. استخدِم ترتيب الإنشاء التالي:

  1. أنشئ التطبيق المصغّر.
  2. أضِف التطبيق المصغّر إلى قسم البطاقات.
  3. كرِّر هذه الخطوة إلى أن يحتوي قسم البطاقة على جميع التطبيقات المصغّرة.
  4. أضِف قسم البطاقة إلى البطاقة.

ويرجع ذلك إلى أنّه عند إضافة تطبيق مصغّر إلى بطاقة أو قسم بطاقة، تتم في الواقع إضافة نسخة من هذا التطبيق المصغّر. لن تظهر في البطاقة النهائية أي تغييرات تجريها على عنصر واجهة المستخدم بعد إضافته.

الإجراءات الشاملة

استخدِم الإجراءات الشاملة لتوفير وظائف لا تعتمد على السياق. الإجراءات العامة هي عناصر قائمة تتوفّر في واجهة مستخدم الإضافة بغض النظر عن البطاقة. تظهر جميع الإجراءات العامة المحدّدة في قائمة بطاقة الإضافة.

لمزيد من التفاصيل، يُرجى الاطّلاع على الإجراءات الشاملة.

التحقّق من نطاقات OAuth الخاصة بالإضافة

تحدِّد النطاقات الإجراءات التي يمكن أن تتّخذها الإضافة نيابةً عن المستخدم. يجب أن تتضمّن الإضافات النطاقات اللازمة لعملها فقط.

في مشاريع الإضافات، اضبط نطاقات الإضافة لضمان استخدام الإضافة أقل مجموعة من النطاقات الممكنة. حدِّد النطاقات في ملف البيان الخاص بالإضافة.

لمزيد من التفاصيل، يُرجى الاطّلاع على النطاقات.

اختبار الإضافة

يمكنك اختبار الإضافات غير المنشورة من خلال تثبيت الإضافة غير المنشورة أولاً. بعد تثبيت الإضافة ومنحها الإذن، استخدِمها في حسابك لاختبار مظهرها وسلوكها في التطبيقات المضيفة التي توسّعها. تأكَّد من أنّ الإضافة تعمل على النحو المتوقّع في سياقات وإجراءات المستخدمين.

لبدء اختبار الإضافة، راجِع الأدلة التالية:

نشر الإضافة

يؤدي نشر الإضافة إلى إتاحتها للمستخدمين الآخرين. قبل النشر، راجِع نظرة عامة على النشر. النشر عملية معقّدة تتطلّب بعض التحضير.

يتم نشر إضافات Google Workspace على Google Workspace Marketplace. تتطلّب الإضافات المتاحة للجميع إجراء مراجعة للتطبيق قبل نشرها.

لمزيد من التفاصيل، يُرجى الاطّلاع على نشر إضافة Google Workspace.