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