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

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

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

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

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

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

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

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

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

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

  يمكنك تجنُّب هذا الشرط من خلال إجراء تغييرات على التصميم. على سبيل المثال، تؤدي إضافة "جداول بيانات 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" بنقرة واحدة وخيار احتياطي لميزة "تسجيل الدخول باستخدام حساب 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 مناسبة للشعار في الوضع الداكن في manifest الإضافة.

إضافات Drive

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

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