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