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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

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

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

إضافات Drive

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

الإضافات في Gmail

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

إضافات Meet

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