عملية مراجعة التطبيقات ومتطلباتها في Google Workspace Marketplace

لنشر تطبيق بشكل علني على Google Workspace Marketplace، تراجع Google تطبيقك وبطاقة بياناته للتأكّد من أنّهما يستوفيان إرشادات Google بشأن التصميم والمحتوى والأسلوب.

بعد أن تراجع Google تطبيقك، ستتلقّى رسالة إلكترونية بشأن ما إذا كان يحتاج إلى المزيد من العمل أو ما إذا تمت الموافقة عليه.

  • إذا كان تطبيقك يتطلّب إجراء تعديلات إضافية: ستتلقّى مستند مراجعة يتضمّن معلومات محدّدة حول الجوانب التي تحتاج إلى تحسين. عليك حلّ المشاكل وإعادة إرسال تطبيقك للمراجعة.
  • في حال موافقة فريق المراجعة على تطبيقك: يتم نشره تلقائيًا وتتلقّى رسالة إلكترونية تتضمّن إشعارًا بذلك.

قبل إرسال تطبيقك للمراجعة، تأكَّد من أنّه جاهز للنشر. لمعرفة التفاصيل، يُرجى الاطّلاع على الاستعداد لعملية النشر.

مدة المراجعة

تستغرق مراجعة التطبيق عادةً عدة أيام. يعتمد الوقت المستغرَق على ما يلي:

  • عدد التطبيقات التي تم إرسالها مؤخرًا
  • مقدار العمل الإضافي الذي يحتاج إليه تطبيقك

الأسباب الشائعة لعدم اجتياز التطبيق للمراجعة

التحقّق من OAuth:

  • إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth بشكلٍ غير صحيح على سبيل المثال، تم ضبط نوع المستخدم على داخلي أو تم ضبط حالة النشر على اختبار.

  • لم يكمل التطبيق عملية التحقّق من OAuth.

المشاكل المتعلقة ببطاقة بيانات التطبيق:

  • الاستخدام غير الملائم لعلامات Google التجارية المسجّلة في اسم التطبيق أو شعاره أو أوصافه للحصول على إرشادات، يُرجى الانتقال إلى إرشادات العلامة التجارية في Google Workspace Marketplace.

  • الروابط لا تعمل أو تشير إلى معلومات غير صحيحة. على سبيل المثال، يؤدي رابط سياسة الخصوصية إلى صفحة دعم المطوّرين.

  • لقطات الشاشة والصور منخفضة الجودة أو لا تمثّل إمكانات التطبيق بدقة.

جاهزية التطبيق:

  • لا يزال التطبيق قيد الاختبار ولم يصبح متاحًا للجميع بعد.
  • يحتوي التطبيق على أخطاء أو لا يعمل بكامل وظائفه.

معايير المراجعة

قبل إرسال تطبيقك للمراجعة، تأكَّد من استيفائه لجميع المتطلبات والالتزام بسياسات برنامج Google Workspace Marketplace.

متطلبات جميع التطبيقات

يمكنك استخدام مربّعات الاختيار لتتبُّع المراجعة الأولية.

الفئة المعايير
اسم التطبيق
  • لا تتوفّر بطاقات بيانات أخرى للتطبيق تحمل الاسم نفسه.
  • لا يتضمّن الاسم رقم إصدار.
  • يتطابق الاسم مع الاسم الظاهر على شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
  • ألّا يكون الاسم غامضًا أو عامًا جدًا
  • ألّا يزيد طول الاسم عن 50 حرفًا
  • (يُنصح به) يستخدم الاسم حالة أحرف العنوان.
  • (يُنصح به) لا يتضمّن الاسم علامات ترقيم، خاصةً الأقواس.
  • (يُنصح به) يتطابق الاسم مع الاسم المعروض في تطبيقات Google Workspace. على سبيل المثال، في إضافات Google Workspace، يكون الاسم في ملف البيان مشابهًا للاسم المقدَّم في بطاقة بيانات التطبيق.
معلومات مطوِّر البرامج
  • يجب أن يمثّل اسم المطوّر وموقعه الإلكتروني المعلومات ذات الصلة بالمطوّر بدقة وأن يوجّه المستخدمين إليها.
  • بموجب قوانين حماية المستهلك، يجب إبلاغ المستهلكين المقيمين في المنطقة الاقتصادية الأوروبية بما إذا كان البائع في Google Workspace Marketplace تاجرًا أو غير تاجر:
    • التاجر: هو شخص يعمل لأغراض تتعلّق بتجارة أو نشاط تجاري أو حرفة أو مهنة، أو باسم تاجر أو بالنيابة عنه.
    • غير تاجر: غير التاجر (المستهلك) هو شخص يعمل لأغراض غير مهنية.

    في حال عدم تحديد حالة التاجر، سيظهر التصنيف "حالة التاجر غير مُحدَّدة" على صفحة بطاقة بيانات المتجر الخاصة بتطبيقك.
وصف التطبيق
  • أنّ جميع الروابط المقدَّمة تعمل وتنقل المستخدمين إلى المعلومات الصحيحة. على سبيل المثال، يشير رابط سياسة الخصوصية إلى صفحة تصف سياسة الخصوصية.
  • إذا كان التطبيق يتفاعل مع خدمة تابعة لجهة خارجية، يوضّح الوصف وظيفة الخدمة التابعة لجهة خارجية وكيفية تفاعل التطبيق معها، ويوفّر اختياريًا رابطًا يؤدي إلى الموقع الإلكتروني ذي الصلة.
  • الوصفان الموجز والتفصيلي مفهومان.
  • يجب ألا يتطابق الوصف المختصر مع الوصف التفصيلي.
  • (إجراء يُنصح به) معلومات التسعير كاملة ودقيقة.
  • (يُنصح به) يتم تحديد المجموعة الكاملة من السمات لكل لغة (الاسم والوصف الموجز والوصف التفصيلي) بشكل صحيح بدون حدوث أي تعارض في اللغة.
الوظائف
  • لا توجد أخطاء واضحة، وجميع الإجراءات، بما في ذلك الحالات الحدّية، تعمل بشكل كامل. تتم إدارة مدة التحميل باستخدام مؤشرات التحميل.
  • يوضّح التطبيق التفاعلات الواضحة مع واجهات Google API.
  • يوفّر التطبيق وظيفة جديدة أو موسّعة لا تعادل الوظائف المضمّنة في منتجات Google.
  • يجب ألا يكون التطبيق مخصّصًا لأغراض إعلانية أو لإرسال رسائل غير مرغوب فيها.
  • التطبيق يعمل بشكل كامل وليس مخصّصًا لأغراض الاختبار، أي أنّه ليس في مرحلة التطوير.
  • إذا كان التطبيق يتفاعل مع ميزات متاحة للمستخدمين أو المستخدمين الذين يدفعون مقابلها، سيتم توفير حساب تجريبي على نظام المطوّر لفريق المراجعة في Google.
تجربة المستخدم
  • لا يستخدم التطبيق، بما في ذلك اسمه، مواد عرض أو علامات تجارية مسجّلة أو محتوى يحمل علامة Google التجارية. اطّلِع على إرشادات وضع العلامة التجارية في Google Workspace Marketplace.
  • يجب الحصول على التفويض وتسجيل الدخول مرة واحدة فقط. يستخدم التطبيق ميزة الدخول المُوحَّد بنقرة واحدة أو ميزة الدخول المُوحَّد بدون نقرة.
  • بعد أن يمنح المشرف أذونات لنطاقات OAuth 2.0 للنطاق، لن يُطلب من المستخدمين الفرديين منح أذونات النطاق مرة أخرى.
  • لا يحتاج المستخدمون إلى إدخال بيانات الاعتماد بعد تسجيل الدخول إلى حساباتهم على Google. في الحد الأقصى، عليهم النقر على زر "تسجيل الدخول باستخدام حساب Google" للحصول على إذن الوصول.
  • تتوفّر عبارات متسقة وواضحة وسهلة الفهم لتصنيفات الأزرار وعناصر القوائم والعناوين وعناصر التطبيق الأخرى. على سبيل المثال، بدلاً من نعم أو لا، تشير التصنيفات إلى أسماء الإجراءات، مثل "حذف" و"إلغاء".
  • إذا كان تسجيل الدخول مطلوبًا، تعمل وظيفة تسجيل الخروج بشكلٍ سليم. يتم إبطال الرموز المميزة ويمكن بدء عملية تسجيل الدخول من البداية.
  • يتم عرض الملاحظات دائمًا، مثل رسائل التأكيد أو الخطأ، للإجراءات.
  • عدم توفّر روابط صور معطّلة أو صور غير واضحة
الرسومات
  • يجب أن تكون الرموز بالحجم الصحيح ومربعة الشكل وبخلفيات شفافة. اطّلِع على أصول الرسومات.
  • يعرض الرمز اسم التطبيق أو وظائفه بشكل صحيح.
  • يجب أن يكون الرمز ملوّنًا (وليس بتدرّج الرمادي).
  • لا يستخدم الرمز علامات Google التجارية المسجّلة.
  • يجب أن تكون لقطات الشاشة والصور غير مموّهة أو يصعب قراءتها أو غير لائقة. أن تمثّل التطبيق بدقة
  • (يُنصح به) توضّح لقطات الشاشة بوضوح كيفية استخدام التطبيق والوظائف التي يقدّمها.
OAuth
  • اجتاز التطبيق عملية التحقّق من OAuth، ويستخدم أضيق نطاقات OAuth ممكنة، وتتكامل جميع النطاقات بشكل صحيح مع واجهات برمجة التطبيقات لخدمات Google.

متطلبات إضافية لعمليات دمج تطبيقات معيّنة

اختَر عمليات تكامل التطبيقات المُدرَجة في بطاقة بيانات تطبيقك للاطّلاع على معايير المراجعة ذات الصلة. يمكنك النقر على أسماء الأعمدة لترتيب المعايير، مثلاً حسب الفئة.

يمكنك استخدام مربّعات الاختيار لتتبُّع المراجعة الأولية.

دمج التطبيق الفئة المعايير
تطبيق Google Chat الاسم
  • تتوفّر أزرار التواصل مع التطبيق في الوصف.
  • يبدأ اسم التطبيق بالأحرف من A إلى Z (أحرف كبيرة) أو من 0 إلى 9. لا يمكن أن يبدأ برمز.
تطبيق Google Chat الوظائف
  • يحتوي تطبيق Chat على ميزات تفاعلية ويمكن إضافته إلى الرسائل المباشرة أو المساحات.
تطبيق Google Chat تجربة المستخدم
  • يرسل التطبيق رسالة ترحيب غير مطلوبة في كل مرة يبدأ فيها المستخدم رسالة مباشرة أو تتم إضافة التطبيق إلى مساحة. تختلف رسالة الترحيب عن الأمر "مساعدة". عرض المستندات
  • يتوافق التطبيق مع الأمر "مساعدة" ويساعد المستخدمين على البدء. عرض المستندات
  • يستجيب التطبيق دائمًا عند التحدث إليه في مساحة أو محادثة مباشرة في Chat.
  • تستخدم الرسائل القواعد الإملائية والنحوية وعلامات الترقيم والأحرف اللاتينية الكبيرة بشكل صحيح، ولا تتضمّن أي محتوى ضار أو مسيء أو غير لائق.
  • تستخدم الرسائل تنسيقًا واضحًا وموجزًا ومتسقًا للنص أو البطاقات وفقًا لمتطلبات Google.
  • إذا استغرق الرد أكثر من ثانيتَين، يرسل التطبيق رسالة تشرح سبب التأخير.
  • تتيح التطبيقات التي ترسل إشعارات للمستخدمين إيقاف الإشعارات.
  • يمكن للمستخدمين إضافة التطبيق إلى مساحة من خلال الإشارة إليه باستخدام @.
  • يمكن للمستخدمين إزالة التطبيق من مساحة باستخدام قائمة عرض الأعضاء.
  • يجب أن يوضّح التطبيق للمستخدم كل ما هو ضروري للتفاعل معه.
  • يتوافق تنسيق البطاقات الذي يستخدمه التطبيق مع متطلبات Google. عرض المستندات
  • يتوفّر التطبيق من خلال خيار العثور على التطبيقات في قائمة Chat.
  • لا تنتمي عناوين URL الخارجية التي يتفاعل معها التطبيق إلى بيئة تجريبية أو تطويرية.
  • يجب الإشارة باستخدام الرمز @إلى التطبيق في كل رسالة مُرسَلة إليه في المساحات. وهذه هي الطريقة الوحيدة التي يعرف بها التطبيق أنّه يجب الردّ.
  • إذا كان تطبيق Chat يعرض معاينات للروابط من نطاق تابع لجهة خارجية:
    • تقدّم معاينات الروابط معلومات إضافية ذات صلة برسالة المستخدم. على سبيل المثال، تؤدي معاينة رابط إلى صفقة مبيعات إلى إضافة معلومات مثل الحساب والمبلغ والمرحلة.
    • المطوّر تابع للنطاق الذي تمّت معاينته.

    لمعرفة المزيد عن معاينة الروابط، يمكنك الاطّلاع على المستندات.

  • (يُنصح به) للسماح لمشرفي Workspace بتثبيت تطبيقك نيابةً عن المستخدمين في مؤسستهم، يجب أن يكون تطبيقك قادرًا على تلقّي الرسائل المباشرة وإرسالها.
تطبيق Google Chat الرسومات
  • يحتوي التطبيق على أفاتار واضح يسهُل التعرّف عليه.
تطبيق Google Drive الوظائف
  • لا يستخدم التطبيق إضافات متصفّح Chrome لتوفير وظائف من خلال تعديل رمز HTML في Drive مباشرةً.
  • إذا كان تطبيقك يستخدم نطاقات حساسة أو مقيَّدة، يجب أن يخضع لعملية التحقّق من OAuth. اطّلِع على إرسال تطبيقك لإجراء عملية التحقّق.
  • إذا كان تطبيقك يستخدم نطاقات محدودة، يجب أن يخضع أيضًا لتقييم أمان. اطّلِع على تقييم الأمان.
تطبيق Google Drive تجربة المستخدم
  • إذا كان التطبيق يخزّن الملفات في Drive، سيسمح للمستخدمين باختيار مجلد أو إنشاء مجلد خاص بالتطبيق وإعادة استخدامه. يمكن تخزين بيانات الإعدادات في مجلد "بيانات التطبيق". لا يضيف التطبيق الملفات إلى مجلد "ملفاتي" الخاص بالمستخدم.
  • يخزِّن التطبيق الملفات في Drive المرتبط بالوظائف الموضّحة في المستندات الخاصة بالتطبيق فقط.
إضافة "المحرّر" الوظائف
  • يتم تضمين الإجراءات المتوقّعة والمطلوبة في الإضافة، كما توفّر جميع الأدوات اللازمة لإكمال سير العمل. على سبيل المثال:
    • إذا كان التطبيق الإضافي يطبّق التصميم على المستند بأكمله، سيتيح لك خيار تطبيق التصميم على النص المحدّد فقط.
    • إذا كان التطبيق الإضافي يحمّل بيانات جدول بيانات إلى خلاصة خدمة ويب، سيتضمّن رابطًا إلى تلك الخلاصة لتسهيل التنقّل.
    • إذا كانت الإضافة تتطلّب أن يكون لدى المستخدم حساب، فإنّها توفّر روابط أو معلومات لإنشاء حساب بسهولة إذا لم يكن لدى المستخدم حساب من قبل.
  • تحتوي الإضافة على عناصر قائمة ضمن علامة التبويب الإضافات.
  • حتى إذا كانت الإضافة تتضمّن وظائف مخصّصة فقط، ستتضمّن أيضًا وثائق مناسبة.
  • تستخدم الإضافة onInstall() وonOpen() بشكل صحيح لتعبئة القائمة. تتم تعبئة عناصر القائمة عند تثبيت الإضافة لأول مرة وعند فتح ملف مختلف. اطّلِع على تفاصيل حول منح الإذن لإضافة "المحرّر".
  • تم ضبط أوضاع المصادقة في بشكل صحيح. يمكنك الاطّلاع على أوضاع التفويض.
  • يجب تنفيذ الإضافة في وقت تشغيل V8 في Apps Script. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على وقت تشغيل V8.
إضافة "المحرّر" تجربة المستخدم
  • تقدّم الإضافة كل المعلومات اللازمة لفهم المنتج بشكل أساسي ومعرفة كيفية استخدامه.
  • لا يستخدم رمز الإضافة المكتبات بشكل مفرط، لأنّ ذلك قد يؤدي إلى انخفاض أداء الإضافة.
  • يجب تجنُّب الأخطاء قدر الإمكان وإدارتها بشكل صحيح في حال حدوثها:
    • يتم عرض رسائل الخطأ في نافذة حوار، وليس في تنبيه JavaScript أو على الشريط الأحمر التلقائي. وتوضّح هذه الرسائل المشكلة وتصف الإجراءات التي يجب أن يتّخذها المستخدم لحلّها بلغة بسيطة.
    • عند الإمكان، إذا كان المستخدم يرتكب خطأ، سيظهر له زر يحلّ المشكلة.
    • لمزيد من المعلومات، اطّلِع على دليل أنماط الإضافات.
  • تفتح الروابط المؤدية إلى صفحات خارجية في نوافذ جديدة وهي صحيحة.
  • الإضافة سهلة الاستخدام ومصمَّمة بشكل جيد. وهذا يعني:
    • ويكون من الواضح دائمًا ما يجب فعله وكيفية تنفيذه.
    • يجب أن تكون الإضافة سهلة الاستخدام والفهم. تجنَّب المصطلحات الفنية واللغة الاصطلاحية.
    • تكون إجراءات العمل واضحة وميسّرة قدر الإمكان.
    • يتم توفير أعلى مستوى ممكن من الأمان للمستخدم ومحتواه.
  • تتّبع الإضافة دليل أسلوب واجهة المستخدم لإضافات المحرّر وتستخدم حزمة CSS لإضافات المحرّر.
  • تستخدِم الإضافة إجراءً أساسيًا واحدًا باللون الأزرق لكل شاشة عرض.
  • تعرض الإضافة مربّع حوار واحدًا في كل مرة. لا تتداخل مع أي عناصر أخرى أو تتضمّن مربّعات حوار متعدّدة مفتوحة في الوقت نفسه.
  • تتلاءم واجهة المستخدم الخاصة بالإضافة بشكلٍ جيد مع المساحات المخصّصة:
    • عدم اقتطاع النص والتصنيفات بعلامة "..."
    • لا يحتاج المستخدم إلى التمرير عموديًا كثيرًا.
    • لا يتجاوز عرض المحتوى 300 بكسل كي لا يظهر شريط تمرير أفقي.
  • يتطلّب هذا التطبيق الإضافي تأكيدًا أو يعرض تحذيرات لجميع الإجراءات الحسّاسة. على سبيل المثال، إذا كان سيتم استبدال كل المحتوى في جدول بيانات باستخدام الإضافة، سيتم تحذير المستخدم وسيؤكّد الإجراء قبل تنفيذه.

    يمكنك تجنُّب هذا الشرط من خلال إجراء تغييرات في التصميم. على سبيل المثال، يمكن أن تؤدي إضافة في "جداول بيانات Google" تستورد البيانات إلى خطر الكتابة فوق المحتوى الحالي. يمكنك إزالة المخاطرة عن طريق إنشاء ورقة بيانات للبيانات كإجراء تلقائي.

  • لا يمكن للمستخدمين بدء إجراءات متعدّدة أثناء تحميل إجراء معيّن. على سبيل المثال، يتم إيقاف الأزرار أو إخفاؤها أثناء تحميل إجراء معيّن.
إضافة Google Workspace الاسم

إضافات "تقويم Google"

  • إذا كانت الإضافة تستخدم calendar.name أو common.name، يجب أن يكون الاسم في ملف البيان مطابقًا للاسم المقدَّم في بطاقة بيانات التطبيق.
  • إذا كان التطبيق الإضافي يستخدم calendar.conferenceSolution، لن يتضمّن اسم حلّ المؤتمرات عبارة "تقويم Google".
  • (يُنصح به) إذا كان التطبيق الإضافي يستخدم calendar.conferenceSolution، يجب ألا يتجاوز اسم حلّ المؤتمرات 30 حرفًا.
إضافة Google Workspace الوظائف
  • تستخدم الإضافة عنصر واجهة المستخدم الصحيح (مثل التطبيقات المصغّرة أو واجهة المستخدم المضمّنة في إطار iframe في إضافات Meet) للوظيفة المطلوبة. على سبيل المثال، استخدِم مفتاح التبديل a لاختيار قيمة منطقية.

إضافات "تقويم Google"

  • إتاحة التقاويم الثانوية والتفويض، أو إدارتها بشكل سليم في حال عدم إتاحتها على سبيل المثال، لن يتعذّر إنشاء اجتماع فيديو إذا اختار المستخدم تقويمًا مختلفًا لديه إذن تعديل فيه عند إنشاء حدث.
  • تعمل الأحداث المتكرّرة بشكل صحيح.
  • إذا كان التطبيق الإضافي يستخدم calendar.conferenceSolution، يجب توفير حل واحد على الأقل لعقد المؤتمرات.
  • إذا كان التطبيق الإضافي يوفّر حلولاً لعقد المؤتمرات، يتم استخدام حقول بيانات المؤتمرات المناسبة. على سبيل المثال، تستخدم روابط مؤتمرات الفيديو وأرقام الهواتف وروابط SIP ورموز الدخول والسمات الأخرى المتوافقة حقول البيانات المنظَّمة، ولا يتم توفيرها في حقل الملاحظات.
  • إذا كان التطبيق الإضافي يوفّر حلولاً لعقد المؤتمرات، سيعدّل تفاصيل المؤتمر فقط، وليس أي حقول أخرى في الحدث.
  • إذا كانت الإضافة توفّر حلولاً لمكالمات الفيديو، يستغرق إنشاء مكالمة الفيديو أقل من 5 ثوانٍ.

إضافات Gmail

إذا كانت الإضافة تستخدم UrlFetchApp أو OpenLinkUrl:

  • عنوان URL صالح.
  • يستخدم عنوان URL بروتوكول HTTPS وليس HTTP.
  • يتم تحديد النطاق الكامل.
  • المسار ليس فارغًا. على سبيل المثال، https://altostrat/ مقبول، لكن https://altostrat غير مقبول.
  • لا يمكن استخدام أحرف البدل في UrlFetchApp.

إضافات Meet

  • يجب أن يكون تسجيل الدخول إلى الإضافة ورحلات المستخدمين فيها فعّالاً حتى في حال إيقاف ملفات تعريف الارتباط التابعة لجهات خارجية.
  • يجب أن توفّر الإضافة وظائف ذات صلة بتشغيل اجتماع أو المشاركة فيه.
  • يجب ألا تتسبّب الإضافة في مغادرة المستخدمين للاجتماع، مثل إعادة تحميل المتصفّح.
  • في حال استخدام تجربة متعددة اللاعبين، يجب أن تسمح الإضافة لجميع المشاركين بالتعاون في المحتوى حتى إذا لم يتم ضبط الأذونات مسبقًا. يجب أن يكون تعديل الأذونات متاحًا أثناء جلسة الإضافة التعاونية.
  • يجب أن يتعامل التطبيق الإضافي مع إلغاء عملية بدء النشاط وأن يسمح للمستخدم بإعادة بدء النشاط من التطبيق.
  • يجب أن توفّر الإضافة لوحة جانبية لتسجيل الدخول وإعداد تجربة النشاط.
  • يجب ألا توفّر الإضافة وظيفة لدعوة برنامج آلي أو تعتمد على وجود برنامج آلي في الاجتماع
إضافة Google Workspace تجربة المستخدم
  • تحتوي الإضافة على صفحة رئيسية. إذا كانت إضافة Google Workspace هي إضافة Gmail تم تحويلها، سيتم تطبيق صفحة رئيسية تلقائية.
  • يعمل عنصر واجهة المستخدم (مثل بطاقة إضافة أو واجهة مستخدم مضمّنة في إطار iframe في إضافات Meet) بشكل سليم. على سبيل المثال، لا تتضمّن القائمة عناصر مكرّرة، وتعمل أزرار الرجوع وإعادة التحميل والتعديل بشكل سليم.
  • بعد أن يمنح المستخدم الإذن للإضافة، تعرض الإضافة معلومات (مثل بطاقة مخصّصة على الصفحة الرئيسية أو صفحة ويب في إضافات Meet) للترحيب بالمستخدم مع زر لتسجيل الدخول (إذا لزم الأمر) وشعار ووصف موجز للإضافة.
    • في حال تم تفعيل زر تسجيل الدخول، سيتم عرض صفحة تسجيل دخول مخصّصة من المورّد الخارجي توضّح بشكل واضح أنّ هناك خدمة خارجية تعمل خارج Google Workspace.
  • تتلاءم واجهة المستخدم الخاصة بالإضافة بشكلٍ جيد مع المساحات المخصّصة:
    • لا يتم اقتطاع النص والتصنيفات باستخدام "..."
    • لا يحتاج المستخدم إلى التمرير عموديًا كثيرًا.
    • لا يتجاوز عرض المحتوى 300 بكسل كي لا يظهر شريط تمرير أفقي.
  • لا يستخدم رمز الإضافة المكتبات بشكل مفرط، لأنّ المكتبات قد تؤدي إلى انخفاض أداء الإضافة.

إضافات "تقويم Google"

  • إذا كانت الإضافة توفّر حلولاً لعقد المؤتمرات، ستكون المؤتمرات التي تم إنشاؤها صالحة وسيتم عرضها بشكل صحيح على الموقع الإلكتروني الخاص بالمؤتمرات التابع لجهة خارجية.

إضافات "مستندات Google"

إذا كانت الإضافة تعرِض معاينات للروابط من نطاق تابع لجهة خارجية (شرائح ذكية):

  • تقدّم معاينات الروابط معلومات تكميلية ذات صلة للمستخدم. على سبيل المثال، تؤدي معاينة رابط إلى صفقة مبيعات إلى إضافة معلومات مثل الحساب والمبلغ والمرحلة.
  • يكون المطوِّر تابعًا للنطاق الذي تمت معاينته (نمط عنوان URL المحدّد الذي يؤدي إلى إنشاء الشريحة الذكية).

لمزيد من المعلومات، يُرجى الاطّلاع على معاينة الروابط باستخدام الشرائح الذكية.

إضافات Drive

  • إذا كان التطبيق يخزّن الملفات في Drive، سيسمح للمستخدمين باختيار مجلد أو إنشاء مجلد خاص بالتطبيق وإعادة استخدامه. يمكن تخزين بيانات الإعدادات في مجلد "بيانات التطبيق". لا يضيف التطبيق الملفات إلى مجلد "ملفاتي" الخاص بالمستخدم.
  • لا يخزّن التطبيق الإضافي سوى الملفات في Drive المرتبطة بوظائفه الموضّحة في المستندات.

إضافات Gmail

  • لا تشير الإضافة إلى إضافات متصفّح Chrome أو تتضمّن رابطًا إليها بدون مبرّر.
  • تحتوي قائمة "المزيد من الإجراءات" على إجراءات عامة تعمل بشكلٍ سليم. على سبيل المثال، تسجيل الخروج، لمحة، الدعم، وما إلى ذلك

إضافات Meet

  • إذا كانت الإضافة تتطلّب ترخيصًا أو اشتراكًا: يجب عرض رسالة سهلة الاستخدام للمستخدم عندما لا يكون لديه ترخيص.
  • إذا تعذّر على المستخدم استخدام الإضافة بسبب مشكلة في الترخيص، يجب أن توضّح رسالة الخطأ سبب عدم إمكانية استخدام الإضافة وأن تقترح على المستخدم إجراءً لمعالجة المشكلة.
  • يجب أن تتضمّن بطاقة بيانات الإضافة في Google Workspace Marketplace تفاصيل حول متطلبات الترخيص والاشتراك التي قد تكون مطلوبة لاستخدام الإضافة. إذا كان للملحق مستوى مدفوع، يجب أن يوفّر بطاقة بيانات Marketplace رابطًا إلى صفحة ويب تقدّم مزيدًا من المعلومات حول الأسعار أو كيفية التواصل مع مندوب مبيعات.
  • عندما لا يكون المستخدم مسجّلاً الدخول، يجب أن تعرض الإضافة إشعار تسجيل الدخول بنقرة واحدة الذي يمكن العثور عليه في عرض ميزة "تسجيل الدخول بنقرة واحدة من Google"، بالإضافة إلى خيار احتياطي "تسجيل الدخول باستخدام حساب Google" الذي يمكن العثور عليه في المصادقة. بالإضافة إلى آلية "تسجيل الدخول باستخدام حساب Google"، قد يتم توفير خيارات تسجيل دخول أخرى.
  • يجب أن تتضمّن الإضافة تصميمًا سريع الاستجابة يمكنه تكييف المحتوى مع أحجام مختلفة.
  • يجب أن تكون رحلات المستخدمين في الإضافة فعّالة حتى إذا تم إيقاف ملفات تعريف الارتباط التابعة لجهات خارجية.
  • يجب ألا يتضمّن الإطار iframe تمريرًا أفقيًا.
  • إذا أراد أحد الإضافات استخدام المسرح الرئيسي، يجب أن تكون الإضافة مصمَّمة لتوفير تجارب متعددة اللاعبين وأن تسمح لعدة مشاركين بالتفاعل مع المحتوى في الوقت نفسه. بالنسبة إلى تجارب اللاعب الفردي، على المطوّر استخدام اللوحة الجانبية.
  • (إجراء يُنصح به) يجب أن توضّح الإضافة هوية المستخدم الذي سجّل الدخول.
  • (يُنصح به) اختيار اللغة: يجب أن تستند اللغة إلى الإعدادات المفضّلة المحلية التي يضبطها المتصفّح عند توفّرها.
  • (يُفضّل) يجب أن يتم اختيار المحتوى من خلال واجهة تصفّح المحتوى التي تعرض المحتوى الذي تم الوصول إليه مؤخرًا.
  • (يُنصح به) إذا لم تعُد هناك حاجة إلى اللوحة الجانبية، يجب أن تغلق الإضافة اللوحة الجانبية بعد تشغيلها في المساحة الرئيسية.
إضافة Google Workspace الرسومات

إضافات "تقويم Google"

  • شعار حلّ مؤتمرات الفيديو هو عنوان URL متاح للجميع. اطّلِع على توفير شعارات حلول مكالمات الفيديو.
  • إذا كان التطبيق الإضافي يستخدم calendar.conferenceSolution، يجب أن يتوافق شعار حلّ مؤتمرات الفيديو مع متطلبات calendar.logoUrl. يُرجى الاطّلاع على مورد بيان التقويم.
  • إذا كانت الإضافة تستخدم calendar.logoUrl أو common.logoUrl، سيكون الشعار مطابقًا للرمز المقدَّم في بطاقة بيانات المتجر الخاصة بالتطبيق.
  • إذا كانت الإضافة تستخدم calendar.logoUrl أو common.logoUrl، يبدأ عنوان URL الخاص بالشعار على النحو التالي: https://lh3.googleusercontent.com/

إضافات Meet

  • يجب أن يكون شعار العلامة التجارية للإضافة بحجم وتصميم يتيحان التعرّف عليه في اللوحة الجانبية في Meet.
  • يجب تحديد عناوين URL مناسبة لشعار الوضع الداكن في بيان الإضافة
إضافة Google Workspace OAuth

إضافات Drive

  • (يُنصح به) إذا كنت تريد تلقّي بيانات وصفية محدودة، يتضمّن الملحق النطاق drive.addons.metadata.readonly.
تطبيق الويب الوظائف
  • يشير عنوان URL الخاص بأداة التنقّل الشاملة إلى تطبيق ويب. ولا تُعدّ صفحة ويب بسيطة بدون وظائف تطبيق ويب.