إذا سبق لك إنشاء إضافة ونشرها لتوسيع نطاق Gmail أو "تقويم Google"، يمكنك ترقيتها إلى إضافة Google Workspace. توضّح التعليمات الواردة في هذه الصفحة كيفية إضافة وظائف Google Workspace إلى إضافات Gmail أو "تقويم Google" الحالية، ثم نشر الإضافة التي تمت ترقيتها ليتمكّن المستخدمون من العثور عليها وتثبيتها.
يمكنك نقل الوظيفة الجديدة إلى الإضافة الأصلية للاحتفاظ ببطاقة بياناتك على Google Workspace Marketplace وعمليات التثبيت والمستخدمين. تتيح لك الترقية أيضًا الاستفادة من ميزات إضافات Google Workspace الجديدة، مثل الصفحات الرئيسية.
الخطوة 1: إنشاء نسخة من مشروع Apps Script الخاص بالإضافة
يستخدم الإصدار المحسّن من الإضافة مشروع Google Cloud نفسه الذي تستخدمه الإضافة المنشورة، ولكن من المهم إنشاء نسخة من مشروع Apps Script الأساسي واستخدامها حتى لا يتأثّر المستخدمون الحاليون أثناء اختبار الإصدار المحسّن. يعني ترقية نسخة من مشروع النص البرمجي الأصلي أيضًا أنّه يمكنك دائمًا الوصول إلى الرمز الأصلي، وإعادة نشره لاحقًا إذا لزم الأمر.
- افتح مشروع Apps Script الخاص بإضافة Gmail أو إضافة مؤتمرات التقويم الحالية.
- على يمين الصفحة، انقر على نظرة عامة .
- على يسار الصفحة، انقر على "إنشاء نسخة" .
- في يمين الصفحة، انقر على إعدادات المشروع > تغيير المشروع.
- انقر على رقم مشروع GCP.
- أدخِل رقم المشروع نفسه المرتبط بمشروع إضافة "برمجة تطبيقات Google" الحالي المنشور.
- انقر على تحديد المشروع.
الخطوة 2: دمج إضافة Google Workspace
يجب تصميم وتنفيذ أي ميزات لإضافة Google Workspace تريد إضافتها إلى الإضافة.
- خطِّط للمحتوى الذي سيتم عرضه في بطاقات الصفحة الرئيسية للإضافة وما إذا كان سيظهر في Gmail أو "تقويم Google" أو Drive أو أي مجموعة من المضيفين الثلاثة. إذا أردت أن تكون لديك صفحة رئيسية في أكثر من مضيف واحد، عليك تحديد ما إذا كان بإمكانك استخدام الصفحة الرئيسية نفسها أو إذا كنت تريد بطاقات مخصّصة للصفحة الرئيسية لكل مضيف.
- في مشروع "برمجة تطبيقات Google" المنسوخ الخاص بالإضافة، أنشئ بطاقات صفحتك الرئيسية باستخدام دوال
homepageTrigger. احرص على تضمين أي وظائف أو منطق داعمَين مطلوبَين للتحكّم في واجهات صفحتك الرئيسية الجديدة. ننصحك بإضافة بطاقات سياقية يتم تشغيلها استجابةً لإجراء يتخذه المستخدم، مثل فتح سلسلة رسائل Gmail أو حدث في "تقويم Google".
عدِّل أي عملية وصول إلى عناصر الحدث في الإضافة (في دوال معاودة الاتصال الخاصة بالأداة أو في دوال المشغّل السياقي) لاستخدام بنية عنصر الحدث المعدَّلة. لا يزال البناء الجديد يتضمّن حقول عنصر الحدث نفسها التي تستخدمها إضافات المؤتمرات في Gmail و"تقويم Google"، ولكن تم إيقاف الحقول الأصلية نهائيًا وستتم إزالتها في النهاية.
الخطوة 3: تعديل ملف بيان الإضافة
لقد تغيّرت طريقة تخزين معلومات الإعدادات في بنية ملف البيان لإضافات Google Workspace بشكل كبير عن البنية التي تستخدمها إضافات Gmail وإضافات مؤتمرات "تقويم Google". عند ترقية الإضافة، عليك تعديل حقول البيان في مشروع Apps Script الخاص بالإضافة وفقًا للجداول أدناه. عليك تعديل جميع المواقع الفرعية ذات الصلة إلى الموقع الجديد addOns.
احرص أيضًا على تعديل الحقل oauthScopes في ملف البيان حسب الحاجة ليعكس الأذونات التي تتطلّبها الإضافة المعدَّلة.
لمزيد من المعلومات عن بيانات Google Workspace الإضافية، يُرجى الاطّلاع على بيانات.
إضافات Gmail
| حقل البيان الأصلي | يجب اتخاذ إجراء |
|---|---|
gmail.composeTrigger |
انتقِل إلى addOns.gmail.composeTrigger. |
gmail.contextualTriggers[] |
انقل القائمة إلى addOns.gmail.contextualTriggers[]. |
gmail.logoUrl |
انتقِل إلى addOns.common.logoUrl. |
gmail.name |
انتقِل إلى addOns.common.name. |
gmail.openLinkUrlPrefixes[] |
انقل القائمة إلى addOns.common.openLinkUrlPrefixes[].
|
gmail.primaryColor |
انتقِل إلى addOns.common.layoutProperties.primaryColor. |
gmail.secondaryColor |
انتقِل إلى addOns.common.layoutProperties.secondaryColor.
|
gmail.universalActions[] |
انقل القائمة إلى addOns.common.universalActions[]. |
gmail.universalActions[].text |
انقل كل حقل gmail.universalActions[].text إلى حقل addOns.common.universalActions[].label مطابق. |
gmail.useLocalFromApp |
انتقِل إلى addOns.common.useLocaleFromApp. |
إضافات مكالمات الفيديو في "تقويم Google"
| حقل البيان الأصلي | يجب اتخاذ إجراء |
|---|---|
calendar.createSettingsUrlFunction |
انتقِل إلى addOns.calendar.createSettingsUrlFunction. |
calendar.conferenceSolution[] |
انتقِل إلى addOns.calendar.conferenceSolution[]. |
calendar.logoUrl |
انتقِل إلى addOns.common.logoUrl. |
calendar.name |
انتقِل إلى addOns.common.name. |
الخطوة 4: اختبار الإضافة التي تمت ترقيتها
لاختبار الإضافة التي تمت ترقيتها قبل نشرها، راجِع مقالة اختبار إضافات Google Workspace.
الخطوة 5: طلب مراجعات للإضافة التي تمت ترقيتها
يجب الموافقة على جميع إضافات Google Workspace، سواء كانت إضافة تمت ترقيتها أو تم إنشاؤها من البداية، قبل إدراجها في Google Workspace Marketplace.
اتّبِع الخطوات التالية لإرسال الإضافة للمراجعة:
تأكَّد من أنّ الإضافة تستوفي جميع متطلبات نشر الإضافات.
أنشئ عملية نشر تتضمّن إصدارًا من إضافة Google Workspace (في مشروع "برمجة التطبيقات" الجديد) باستخدام إصدار الرمز الذي تريد نشره. لا تحاول النشر باستخدام عملية نشر رئيسية.
إذا أضفت نطاقات جديدة أثناء ترقية الإضافة، عليك طلب إثبات ملكية OAuth. على سبيل المثال، إذا كانت إضافة Gmail تستخدم نطاقات جديدة في Drive أو "تقويم Google" في إصدار إضافة Google Workspace، عليك إرسال هذه النطاقات الجديدة لإثبات ملكيتها. غالبًا ما تستغرق عملية إثبات الهوية بضعة أيام، لذا ننصحك ببدء العملية في أقرب وقت ممكن. تأكَّد من إثبات ملكية الإضافة قبل الانتقال إلى الخطوة 6.
الخطوة 6: إتاحة الإضافة التي تمت ترقيتها
افتح حزمة تطوير البرامج (SDK) في Google Workspace Marketplace.
على يمين الصفحة، انقر على الإعداد. تحتوي هذه اللوحة على نموذج يمكنك من خلاله تقديم معلومات عن الإضافة.
عدِّل الوصف المختصر والوصف التفصيلي ولقطات الشاشة الخاصة ببطاقة بياناتك لتعكس الوظيفة الجديدة لإضافة Google Workspace.
ضمن الإضافات، انقر على الزر الترقية إلى إضافة Google Workspace. في مربّع النص الذي يظهر، أدخِل معرّف النشر الجديد الذي أنشأته لإضافة Google Workspace في الخطوة السابقة. إذا كان رقم تعريف النشر صالحًا، ستظهر قائمة بالمضيفين المتوافقين.
إذا أضفت نطاقات جديدة إلى إضافة Google Workspace، تأكَّد من إضافتها إلى قسم نطاقات OAuth 2.0 في صفحة الإعداد. يجب أن تتطابق النطاقات المدرَجة في هذا القسم تمامًا مع النطاقات المدرَجة في ملف البيان الخاص بالإضافة.
تأكَّد من أنّ المعلومات التي أدخلتها في النموذج صحيحة. بعد ذلك، انقر على حفظ التغييرات.
إذا كانت لديك أسئلة أو واجهت مشكلة أثناء عملية ترقية إضافة Google Workspace هذه، يُرجى التواصل معنا.
الأسئلة الشائعة
في ما يلي الأسئلة الشائعة حول ترقيات الحِزم الإضافية:
هل يمكنني ترقية "إضافة المحرّر"؟
يمكن نقل معظم إضافات "المحرّر" إلى إضافات Google Workspace. ومع ذلك، لا يمكن ترقيتها إلى إضافات Google Workspace بسهولة مثل إضافات Gmail و"تقويم Google".
إذا أردت نقل إضافة "المحرّر" إلى إضافة Google Workspace، عليك إعادة كتابة واجهة مستخدم الإضافة من HTML إلى واجهة مستخدم مستندة إلى البطاقات، وتعديل معالجة JavaScript إلى خدمة البطاقات.
قد لا تتوفّر بعض الخدمات في إضافة "خدمة البطاقات" التي كانت متوفّرة في إضافة "محرّر" الحالية. على سبيل المثال، إذا كانت إضافة Editor تتضمّن أداة اختيار ملفات، لن تتوفّر أداة مكافئة من Card Service لإضافات Google Workspace.
هل يمكنني إنشاء إضافة منفصلة على Google Workspace والاحتفاظ بالإضافة الحالية؟
يمكنك إنشاء إضافات أخرى في Google Workspace بأسماء علامات تجارية مختلفة، ولكن لا نسمح بإنشاء إضافات منفصلة لاجتماعات الفيديو في Gmail أو "تقويم Google" تحت اسم العلامة التجارية نفسه الذي تستخدمه في إضافة Google Workspace. إذا كانت لديك أسئلة أو أردت طلب استثناء، يُرجى التواصل معنا.
هل سيحتاج المستخدمون إلى إعادة منح الإذن للإضافة بعد ترقيتها؟
طالما أنّ إضافتك على Google Workspace تستخدم مشروع Cloud Platform (GCP) الأساسي نفسه، مع معرّف عميل OAuth مرتبط، لن يحتاج المستخدمون إلى إعادة منح الأذونات التي سبق لهم منحها لإضافتك الأصلية. ومع ذلك، إذا أضفت نطاقات جديدة أثناء عملية الترقية، يجب أن يمنح المستخدمون الإذن لهذه النطاقات الجديدة في المرة الأولى التي يستخدمون فيها إصدار Google Workspace من الإضافة.
هل يمكنني ترقية إضافة Chrome إلى إضافة Google Workspace ونقل المستخدمين؟
لا، لا يمكنك نقل المستخدمين وعمليات التثبيت ومراجعات بيانات المتجر الخاصة بإضافة Chrome. عليك إنشاء إضافة جديدة في Google Workspace وتوجيه مستخدمي إضافة Chrome إلى Google Workspace Marketplace.
هل يمكنني تجميع إضافات متعددة مع إضافة Google Workspace؟
يُرجى الاطّلاع على مقالة إدراج عمليات دمج التطبيقات معًا.