عملية مراجعة التطبيقات ومتطلباتها في 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"، قد يتم توفير خيارات تسجيل دخول أخرى.
  • يجب أن تتضمّن الإضافة تصميمًا سريع الاستجابة يمكنه تعديل المحتوى ليناسب أحجامًا مختلفة.
  • يجب أن تكون مسارات المستخدمين في الإضافة فعّالة حتى إذا تم إيقاف ملفات تعريف الارتباط التابعة لجهات خارجية.
  • يجب ألا يتضمّن الإطار 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 الخاص بأداة التنقّل الشاملة إلى تطبيق ويب، ولا تُعدّ صفحة الويب البسيطة التي لا تتضمّن وظائف تطبيق ويب.