إذا سبق لك إنشاء إضافة ونشرها لتوسيع نطاق Gmail أو "تقويم Google"، يمكنك ترقيتها إلى إضافة Google Workspace. توضِّح التعليمات الواردة في هذه الصفحة كيفية إضافة وظائف Google Workspace إلى إضافات Gmail أو "تقويم Google" الحالية، ثم نشر الإضافة التي تمت ترقيتها حتى يمكن اكتشافها وتثبيتها.
يمكنك نقل الوظيفة الجديدة إلى تكمِّلتك الأصلية للحفاظ على بياناتك في Google Workspace Marketplace وعمليات التثبيت والمستخدمين. تتيح لك الترقية أيضًا الاستفادة من ميزات إضافية جديدة في Google Workspace، مثل الصفحات الرئيسية.
الخطوة 1: إنشاء نسخة من مشروع Apps Script الخاص بالإضافة
تستخدِم الإضافة التي تمت ترقيتها مشروع Google Cloud نفسه المستخدَم في الإضافة المنشورة، ولكن من المهم إنشاء نسخة من مشروع Apps Script الأساسي واستخدامها لكي لا يتأثّر المستخدمون الحاليون أثناء اختبار الإصدار الذي تمت ترقيته. تؤدي ترقية نسخة من مشروع النصوص البرمجية الأصلية أيضًا إلى مساعدتك في الوصول إلى الرمز الأصلي في أي وقت، ويمكنك إعادة نشره لاحقًا إذا لزم الأمر.
- افتح مشروع Apps Script الحالي المرتبط بإضافات Gmail أو إضافات مكالمات الفيديو في "تقويم Google".
- على يمين الصفحة، انقر على نظرة عامة .
- على يسار الصفحة، انقر على رمز إنشاء نسخة .
- على يمين الصفحة، انقر على إعدادات المشروع > تغيير المشروع.
- انقر على رقم مشروع Google Cloud Platform.
- أدخِل رقم المشروع نفسه المرتبط بمشروع الإضافة المنشور الحالي في Apps Script.
- انقر على ضبط المشروع.
الخطوة 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 (في مشروع Apps Script الجديد) باستخدام إصدار الرمز الذي تريد نشره. لا تحاول النشر باستخدام عملية بدء النشر.
إذا أضفت نطاقات جديدة أثناء ترقية الإضافة، عليك طلب إثبات الهوية باستخدام 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"؟
يمكن نقل معظم إضافات "محرّر Google" إلى إضافات Google Workspace. ومع ذلك، لا يمكن ترقيتها إلى إضافات Google Workspace بسهولة مثل إضافات Gmail و "تقويم Google".
إذا كنت تريد نقل إضافة "محرّر Google" إلى إضافة Google Workspace، عليك إعادة كتابة واجهة مستخدم الإضافة من HTML إلى واجهة استنادًا إلى "بطاقة بيانات Google"، وتعديل معالجة JavaScript لتكون خدمة "بطاقة بيانات Google".
قد لا تتوفّر بعض الخدمات في إضافة "المحرِّر" الحالية في خدمة "بطاقات Google". على سبيل المثال، إذا كانت إضافة "أداة التعديل" تتضمّن أداة اختيار ملفات، لن يكون هناك بديل متاح من "خدمة البطاقات" لإضافات 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؟
راجِع مقالة إدراج عمليات دمج التطبيقات معًا.