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

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

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

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

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

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

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

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

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

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

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

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

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

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

• تستخدم الإضافة الأدوات المناسبة للوظائف المطلوبة. على سبيل المثال، استخدِم مفتاح تبديل لاختيار قيمة منطقية.

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

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

إضافات Gmail

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

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

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

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

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

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

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

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

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

إضافات Drive

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

إضافات Gmail

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

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

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

إضافات Drive

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

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