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

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

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

  لمزيد من المعلومات، يُرجى الاطّلاع على روابط المعاينة.

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

• يحتوي التطبيق على صورة رمزية واضحة وسهلة التعرّف عليها.

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

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

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

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

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

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

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

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

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

إضافات "تقويم 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"

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

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

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

إضافات Drive

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

إضافات Gmail

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

إضافات Meet

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

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

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

إضافات Meet

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

إضافات Drive

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

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