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

• تتوفّر أزرار التواصل مع التطبيق في الوصف.
• يبدأ اسم التطبيق بالأحرف من A إلى Z (أحرف كبيرة) أو من 0 إلى 9. لا يمكن أن يبدأ برمز.

• يحتوي تطبيق Chat على ميزات تفاعلية ويمكن إضافته إلى الرسائل المباشرة أو المساحات.

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

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

• (يُنصح به) للسماح لمشرفي Workspace بتثبيت تطبيقك نيابةً عن المستخدمين في مؤسستهم، يجب أن يكون تطبيقك قادرًا على تلقّي الرسائل المباشرة وإرسالها.

• يحتوي التطبيق على أفاتار واضح يسهُل التعرّف عليه.

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

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

• يتم تضمين الإجراءات المتوقّعة والمطلوبة في الإضافة، كما توفّر جميع الأدوات اللازمة لإكمال سير العمل. على سبيل المثال:
  • إذا كان التطبيق الإضافي يطبّق التصميم على المستند بأكمله، سيتيح لك خيار تطبيق التصميم على النص المحدّد فقط.
  • إذا كان التطبيق الإضافي يحمّل بيانات جدول بيانات إلى خلاصة خدمة ويب، سيتضمّن رابطًا إلى تلك الخلاصة لتسهيل التنقّل.
  • إذا كانت الإضافة تتطلّب أن يكون لدى المستخدم حساب، فإنّها توفّر روابط أو معلومات لإنشاء حساب بسهولة إذا لم يكن لدى المستخدم حساب من قبل.
• تحتوي الإضافة على عناصر قائمة ضمن علامة التبويب الإضافات.
• حتى إذا كانت الإضافة تتضمّن وظائف مخصّصة فقط، ستتضمّن أيضًا وثائق مناسبة.
• تستخدم الإضافة onInstall() وonOpen() بشكل صحيح لتعبئة القائمة. تتم تعبئة عناصر القائمة عند تثبيت الإضافة لأول مرة وعند فتح ملف مختلف. اطّلِع على تفاصيل حول منح الإذن لإضافة "المحرّر".
• تم ضبط أوضاع المصادقة في بشكل صحيح. يمكنك الاطّلاع على أوضاع التفويض.
• يجب تنفيذ الإضافة في وقت تشغيل V8 في Apps Script. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على وقت تشغيل V8.

• تقدّم الإضافة كل المعلومات اللازمة لفهم المنتج بشكل أساسي ومعرفة كيفية استخدامه.
• لا يستخدم رمز الإضافة المكتبات بشكل مفرط، لأنّ ذلك قد يؤدي إلى انخفاض أداء الإضافة.
• يجب تجنُّب الأخطاء قدر الإمكان وإدارتها بشكل صحيح في حال حدوثها:
  • يتم عرض رسائل الخطأ في نافذة حوار، وليس في تنبيه JavaScript أو على الشريط الأحمر التلقائي. وتوضّح هذه الرسائل المشكلة وتصف الإجراءات التي يجب أن يتّخذها المستخدم لحلّها بلغة بسيطة.
  • عند الإمكان، إذا كان المستخدم يرتكب خطأ، سيظهر له زر يحلّ المشكلة.
  • لمزيد من المعلومات، اطّلِع على دليل أنماط الإضافات.
• تفتح الروابط المؤدية إلى صفحات خارجية في نوافذ جديدة وهي صحيحة.
• الإضافة سهلة الاستخدام ومصمَّمة بشكل جيد. وهذا يعني:
  • ويكون من الواضح دائمًا ما يجب فعله وكيفية تنفيذه.
  • يجب أن تكون الإضافة سهلة الاستخدام والفهم. تجنَّب المصطلحات الفنية واللغة الاصطلاحية.
  • تكون إجراءات العمل واضحة وميسّرة قدر الإمكان.
  • يتم توفير أعلى مستوى ممكن من الأمان للمستخدم ومحتواه.
• تتّبع الإضافة دليل أسلوب واجهة المستخدم لإضافات المحرّر وتستخدم حزمة CSS لإضافات المحرّر.
• تستخدِم الإضافة إجراءً أساسيًا واحدًا باللون الأزرق لكل شاشة عرض.
• تعرض الإضافة مربّع حوار واحدًا في كل مرة. لا تتداخل مع أي عناصر أخرى أو تتضمّن مربّعات حوار متعدّدة مفتوحة في الوقت نفسه.
• تتلاءم واجهة المستخدم الخاصة بالإضافة بشكلٍ جيد مع المساحات المخصّصة:
  • عدم اقتطاع النص والتصنيفات بعلامة "..."
  • لا يحتاج المستخدم إلى التمرير عموديًا كثيرًا.
  • لا يتجاوز عرض المحتوى 300 بكسل كي لا يظهر شريط تمرير أفقي.
• يتطلّب هذا التطبيق الإضافي تأكيدًا أو يعرض تحذيرات لجميع الإجراءات الحسّاسة. على سبيل المثال، إذا كان سيتم استبدال كل المحتوى في جدول بيانات باستخدام الإضافة، سيتم تحذير المستخدم وسيؤكّد الإجراء قبل تنفيذه.

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

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

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

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

• تستخدم الإضافة عنصر واجهة المستخدم الصحيح (مثل التطبيقات المصغّرة أو واجهة المستخدم المضمّنة في إطار iframe في إضافات Meet) للوظيفة المطلوبة. على سبيل المثال، استخدِم مفتاح التبديل a لاختيار قيمة منطقية.

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

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

إضافات Gmail

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

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

إضافات Meet

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

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

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

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

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

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

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

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

إضافات Drive

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

إضافات Gmail

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

إضافات Meet

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

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

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

إضافات Meet

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

إضافات Drive

• (يُنصح به) إذا كنت تريد تلقّي بيانات وصفية محدودة، يتضمّن الملحق النطاق drive.addons.metadata.readonly.

• يشير عنوان URL الخاص بأداة التنقّل الشاملة إلى تطبيق ويب. ولا تُعدّ صفحة ويب بسيطة بدون وظائف تطبيق ويب.