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