هل لديك 5 دقائق؟ يُرجى مساعدتنا في تحسين مستندات Google Workspace Marketplace من خلال المشاركة في استطلاع سريع على الإنترنت.

لمحة عن مراجعة التطبيقات

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

إذا أردت عرض تطبيقك للجميع، يجب أن تراجعه Google قبل نشره للتأكد من توافقه مع إرشادات التصميم والمحتوى والنمط المتبعة في Google.

بعد أن تراجع Google تطبيقك، ستتلقى رسالة إلكترونية تفيد بما إذا كان يحتاج إلى مزيد من العمل أو ما إذا تمت الموافقة عليه.

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

مدة المراجعة

تعتمد مدة مراجعة التطبيق على عدد التطبيقات التي تم إرسالها مؤخرًا وعدد التصحيحات التي يحتاجها تطبيقك. من الشائع أن يستغرق إكمال المراجعة عدة أيام.

الأسباب الشائعة لعدم جاهزية تطبيقك

التحقق من OAuth

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

بطاقة بيانات التطبيق

  • الاستخدام غير الملائم للعلامات التجارية لشركة Google في اسم التطبيق أو الشعار أو وصف التطبيق. للحصول على إرشادات، انتقِل إلى إرشادات وضع العلامة التجارية في Google Workspace Marketplace.
  • لا تعمل الروابط أو تشير إلى معلومات غير صحيحة. على سبيل المثال، يؤدي رابط لسياسة الخصوصية إلى صفحة دعم لمطوّري البرامج.
  • جودة لقطات الشاشة والصور منخفضة أو لا تمثل وظائف التطبيق بدقة.

جاهزية التطبيق

  • لا يزال التطبيق في مرحلة الاختبار وليس جاهزًا للاستخدام بشكل علني.
  • التطبيق به أخطاء أو لا يعمل بشكل كامل.

مجالات المراجعة

تستخدم Google الإرشادات التالية لمراجعة تطبيقك. وقبل إرسال تطبيقك للمراجعة، تأكّد من أنّ تطبيقك يتوافق مع جميع الإرشادات ويلتزم بما ورد في سياسات برنامج Google Workspace Marketplace.

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

    • تاجر: التاجر هو الشخص الذي يخدم أغراضًا متعلقة بتجارة أو نشاط تجاري أو حرفة أو مهنة، أو باسم تاجر أو بالنيابة عنه.
    • غير تاجر: غير التاجر (المستهلك) هو شخص يعمل لأغراض غير احترافية.

    وفي حال عدم تحديد خيار "حالة التاجر" غير محدّد، ستظهر في صفحة بطاقة بيانات المتجر الخاصة بتطبيقك.

الكل وصف التطبيق
  • تعمل جميع الروابط المتوفرة وتشير إلى المعلومات الصحيحة. على سبيل المثال، يشير رابط سياسة خصوصية إلى صفحة تصف سياسة الخصوصية.
  • إذا تفاعل التطبيق مع خدمة تابعة لجهة خارجية، يصف الوصف ما تفعله خدمة الجهة الخارجية وكيفية تفاعل التطبيق معها ويضع رابطًا اختياريًا إلى الموقع الإلكتروني ذي الصلة.
  • تكون الأوصاف القصيرة والمفصلة سهلة الفهم.
  • الأوصاف القصيرة والمفصلة ليست متطابقة.
  • (مُقترَح) معلومات التسعير كاملة ودقيقة.
  • (مُقترَح) تم تعريف المجموعة الكاملة من السمات لكل لغة (الاسم والوصف المختصر والوصف التفصيلي) بشكل صحيح بدون مطابقة اللغة.
الكل الوظائف
  • ما مِن أخطاء واضحة، وجميع الإجراءات، بما في ذلك الحالات القصوى، تعمل بشكل كامل. تتم إدارة أوقات التحميل باستخدام مؤشرات التحميل.
  • يعرض التطبيق تفاعلات واضحة مع Google APIs.
  • يوفّر التطبيق وظيفة جديدة أو موسّعة لا تعادل ما تتضمّنه منتجات Google.
  • لم يتم تصميم التطبيق لأغراض إعلانية أو غير مرغوب فيها.
  • يعمل التطبيق بكامل وظائفه وليس مخصّصًا لأغراض الاختبار، وهو ليس عملاً قيد التقدم.
  • إذا تفاعل التطبيق مع الميزات المتاحة للمستخدمين أو المستخدمين الذين يدفعون رسومًا، يتم توفير حساب تجريبي على نظام مطوّري البرامج لفريق المراجعة من Google.
الكل تجربة المستخدم
  • ولا يستخدم التطبيق، بما في ذلك اسمه، مواد العرض أو العلامات التجارية أو المحتوى المرتبط بعلامة Google التجارية. يمكنك الاطّلاع على إرشادات وضع العلامة التجارية في Google Workspace Marketplace.
  • يلزم التفويض وتسجيل الدخول مرة واحدة فقط. ويستخدم التطبيق خدمة الدخول المُوحَّد (SSO) بنقرة واحدة أو عادةً يعمل بدون الدخول الموحد.
  • بعد أن يمنح المشرف الأذونات لنطاقات Oauth 2.0 للنطاق، لا تتم مطالبة المستخدمين الفرديين بأذونات النطاق مرة أخرى.
  • لا يحتاج المستخدمون إلى إدخال بيانات الاعتماد بعد تسجيل الدخول إلى حساباتهم على Google. وما عليهم سوى النقر على زر "تسجيل الدخول باستخدام حساب Google" على الأكثر للوصول إليها.
  • هناك عبارات متسقة وواضحة ومفهومة لتسميات الأزرار وعناصر القائمة والعناوين وما إلى ذلك. على سبيل المثال، بدلاً من نعم، لا، تشير التصنيفات إلى أسماء إجراءات، مثل "حذف" و"إلغاء".
  • إذا كان تسجيل الدخول مطلوبًا، تعمل وظيفة تسجيل الخروج بشكل صحيح. يتم إبطال الرموز المميزة ويمكن أن يبدأ تسجيل الدخول من البداية.
  • يتم دائمًا عرض التعليقات، مثل رسائل التأكيد أو رسائل الخطأ، للإجراءات.
  • ليست هناك روابط صور معطلة أو صور غير واضحة.
الكل الرسومات
  • يكون حجم الرموز بشكل صحيح ومربّعة ولها خلفيات شفافة. راجِع أصول الرسومات.
  • يمثِّل الرمز اسم التطبيق أو وظيفته بشكل صحيح.
  • الرمز ملون (وليس تدرج رمادي).
  • ولا يستخدم الرمز علامات Google التجارية.
  • لقطات الشاشة والصور ليست معتمة أو يصعب قراءتها أو غير ملائمة. إنها تمثل التطبيق بدقة.
  • (مُقترَح) تعرض لقطات الشاشة بوضوح كيفية استخدام التطبيق ووظيفته.
الكل OAuth
  • اجتاز التطبيق التحقُّق من OAuth، ويستخدم أضيق نطاقات ممكن لبروتوكول OAuth، وتتكامل جميع النطاقات بشكل صحيح مع واجهات برمجة التطبيقات لخدمات Google.
تطبيق Google Chat الاسم
  • يتوفّر الزرّين المخصّصين للتواصل مع التطبيق من الوصف.
  • يبدأ اسم التطبيق بالحروف من A إلى Z (الأحرف الكبيرة) أو من 0 إلى 9. لا يمكن أن يبدأ الرمز برمز.
تطبيق Google Chat تجربة المستخدم
  • يرسل التطبيق رسالة ترحيب غير مطلوبة في كل مرة يبدأ فيها المستخدم رسالة مباشرة أو تتم إضافة التطبيق إلى مساحة عمل. تختلف رسالة الترحيب عن أمر "المساعدة". لمزيد من المعلومات حول كيفية إنشاء رسالة ترحيب جيدة، يمكنك الاطّلاع على إنشاء تطبيقات Chat التي تساعد المستخدمين وتُرضيهم.
  • يدعم التطبيق الأمر "مساعدة" ويساعد المستخدمين في بدء استخدام التطبيق. لمزيد من المعلومات حول كيفية إنشاء رسالة مساعدة جيدة، راجع إنشاء تطبيقات Chat التي تساعد المستخدمين وترضيهم.
  • يستجيب التطبيق دائمًا عند التحدث إليه في مساحة أو عبر الدردشة المباشرة.
  • تستخدم الرسائل الهجاء الصحيح والكتابة بالأحرف الكبيرة وعلامات الترقيم والقواعد النحوية. لا تحتوي الرسائل على مواد مسيئة أو مسيئة أو مسيئة.
  • تستخدم الرسائل تنسيقًا واضحًا وموجزًا وثابتًا للنص أو البطاقات وفقًا لمتطلبات Google.
  • إذا استغرقت الاستجابة أكثر من ثانيتين، سيرسل التطبيق رسالة توضّح التأخير.
  • تتيح التطبيقات التي ترسل إشعارات للمستخدمين إيقاف الإشعارات.
  • يمكن للمستخدمين إضافة التطبيق إلى مساحة عمل باستخدام @الإشارة.
  • يمكن للمستخدمين إزالة التطبيق من مساحة باستخدام قائمة عرض العضو.
  • ويشير التطبيق إلى المستخدم كل ما يلزم للتفاعل معه.
  • يتوافق تنسيق البطاقات الذي يستخدمه التطبيق مع متطلبات Google. راجِع إنشاء بطاقات تفاعلية.
  • يتوفر التطبيق من خلال خيار البحث عن تطبيقات في قائمة Chat.
  • عناوين URL الخارجية التي يتفاعل معها التطبيق لا تنتمي إلى بيئة مرحلية أو بيئة تطوير.
  • الرمز @الإشارة مطلوب في كل رسالة إلى التطبيق في المساحات. وهذه هي الطريقة الوحيدة التي يعرف بها التطبيق أنه يجب أن يستجيب.
  • (مُقترَح) للسماح لمشرفي Workspace بتثبيت تطبيقك بالنيابة عن المستخدمين في مؤسستهم، يجب أن يكون تطبيقك قادرًا على استلام الرسائل المباشرة وإرسالها.
تطبيق Google Chat الرسومات
  • يشتمل التطبيق على صورة رمزية يسهل التعرُّف عليها ويمكن التعرُّف عليها.
تطبيق Google Chat معاينات الروابط
  • تعرض معاينة الرابط معلومات تكميلية ذات صلة برسالة المستخدم. على سبيل المثال، تؤدي معاينة رابط إلى صفقة بيع إلى إضافة معلومات، مثل الحساب والمبلغ والمرحلة.
  • مطوّر البرامج تابع للنطاق الذي تمت معاينته.

للحصول على مزيد من المعلومات حول تهيئة معاينة الرابط، يمكنك الاطلاع على معاينة الروابط.

تطبيق Google Drive الوظائف
  • لا يستخدم التطبيق إضافات متصفّح Chrome لتوفير وظائف من خلال معالجة Drive HTML مباشرةً.
  • إذا كان تطبيقك يستخدم نطاقات حسّاسة أو محدودة، يجب أن يخضع للتحقق من OAuth. اطّلِع على كيف يمكنني إرسال طلب لإثبات الملكية.
  • إذا كان تطبيقك يستخدم نطاقات محظورة، يجب أن يخضع أيضًا لتقييم أمان. راجع ما أهمية التقييم الأمني.
تطبيق Google Drive تجربة المستخدم
  • إذا كان التطبيق يخزّن الملفات في Drive، فإنه يسمح للمستخدمين باختيار مجلد أو إنشاء مجلد خاص بالتطبيق وإعادة استخدامه. يمكن تخزين بيانات التهيئة في مجلد بيانات التطبيق. لا يتجاهل التطبيق الملفات في مجلد "ملفاتي" لدى المستخدم.
  • لا يخزِّن التطبيق سوى الملفات في Drive المتصلة بالوظائف الموثقة في التطبيق.
إضافة المحرِّر الوظائف
  • تم تضمين الإجراءات المتوقعة والمطلوبة في الإضافة، وتوفّر جميع الأدوات اللازمة لإكمال سير العمل. مثلاً:
    • إذا كانت الإضافة تضيف نمطًا إلى المستند بأكمله، ستوفّر خيارًا لتطبيق النمط على النص المحدد فقط.
    • إذا كانت الإضافة تحمّل بيانات جدول البيانات إلى خلاصة خدمة ويب، يكون لها رابط يؤدي إلى هذه الخلاصة لسهولة التنقّل.
    • إذا كانت الإضافة تتطلّب أن يكون لدى المستخدم حساب، فإنها توفّر روابط أو معلومات لإنشاء حساب بسهولة إذا لم يكن لديه حساب.
  • تتضمن الإضافة عناصر في القائمة ضمن علامة التبويب الإضافات.
  • وحتى إذا كانت الإضافة هي وظائف مخصّصة فقط، ستظل تتضمّن مستندات مناسبة.
  • تستخدم الإضافة onInstall() وonOpen() بشكلٍ صحيح لتعبئة قائمتها. تتم تعبئة عناصر القائمة عند تثبيت الإضافة لأول مرة وعند فتح ملف مختلف. راجِع تفويض إضافة المحرِّر.
  • تم إعداد أوضاع التفويض بشكل صحيح. راجِع أوضاع التفويض.
إضافة المحرِّر تجربة المستخدم
  • توفّر الإضافة جميع المعلومات اللازمة لفهم المنتج بشكل أساسي وكيفية استخدامه.
  • لا يستخدم رمز الإضافة المكتبات بشكلٍ زائد، لأن المكتبات يمكن أن تؤدي إلى فقدان الإضافة.
  • يتم تجنُّب الأخطاء إذا كان ذلك ممكنًا وتتم إدارتها بشكل صحيح، إن لم يكن كذلك:
    • يتم عرض رسائل الخطأ في نافذة حوار، وليس في تنبيه JavaScript أو على الشريط الأحمر التلقائي. فهي تُبلغ بالمشكلة وتصف ما يجب على المستخدم فعله لإصلاحها بلغة بسيطة.
    • وعندما يكون ذلك ممكنًا، إذا ارتكب المستخدم إجراءً غير صحيح، يتم عرض زر يعمل على حل المشكلة.
    • ولمزيد من المعلومات، يمكنك الاطّلاع على دليل أسلوب الإضافات.
  • يتم فتح الروابط المؤدية إلى صفحات خارجية في نوافذ جديدة وتكون صحيحة.
  • الإضافة سهلة ومصممة بشكل جيد. ويعني ذلك ما يلي:
    • من الواضح دائمًا ما عليك فعله وكيفية تنفيذه.
    • يمكن الوصول إلى الإضافة ويسهل فهمها. يتم تجنب المصطلحات والمصطلحات الفنية.
    • تتميز سير العمل بالوضوح والسهولة بقدر الإمكان.
    • الحفاظ على أمان المستخدم ومحتواه قدر الإمكان.
  • تتّبع الإضافة دليل نمط واجهة المستخدم لإضافات المحرِّرات وتستخدم حزمة CSS لإضافات المحرِّرين.
  • تستخدم الإضافة إجراءً أساسيًا واحدًا باللون الأزرق فقط لكل شاشة.
  • تعرض الإضافة مربع حوار واحدًا في كل مرة. ولا يتداخل مع مربّعات حوار متعددة أو يتم فتحها في وقت واحد.
  • تتلاءم واجهة مستخدم الإضافة مع المساحات المخصّصة بدقة:
    • لا يتم اقتطاع النص والتصنيفات باستخدام "..."
    • ليس على المستخدم إجراء الكثير من التمرير العمودي.
    • لا يتجاوز عرض المحتوى 300 بكسل ولا يحتوي على شريط تمرير أفقي.
  • تتطلب الإضافة تأكيدًا أو تعرض تحذيرات لجميع الإجراءات الحساسة. على سبيل المثال، إذا كانت الإضافة على وشك استبدال كل المحتوى في جدول بيانات، يتم تحذير المستخدم ويؤكد الإجراء قبل حدوثه.
    • يمكن أن تؤدي تغييرات التصميم إلى إلغاء الحاجة إلى مثل هذه المشكلات. على سبيل المثال، تؤدي إضافة "جداول بيانات Google" التي تستورد البيانات إلى خطر استبدال المحتوى الحالي. يمكن إزالة المخاطر بالكامل عن طريق إنشاء ورقة بيانات للبيانات كإجراء تلقائي.
  • لا يمكن للمستخدمين تشغيل الإجراءات عدّة مرات أثناء تحميل الإجراء. على سبيل المثال، يتم إيقاف الأزرار أو إخفاؤها أثناء تحميل إجراء.
إضافة Google Workspace الاسم (إضافات "تقويم Google")
  • إذا كانت الإضافة تستخدم calendar.name أو common.name، سيكون الاسم الوارد في البيان مطابقًا للاسم الوارد في بطاقة بيانات التطبيق.
  • إذا كانت الإضافة تستخدم calendar.conferenceSolution، لن يحتوي اسم حل مكالمة الفيديو على "تقويم Google".
  • (إجراء مقترَح) إذا كانت الإضافة تستخدم calendar.conferenceSolution، يجب ألا يتجاوز اسم حل المكالمة 30 حرفًا.
إضافة Google Workspace الوظائف
  • تستخدم الإضافة الأدوات الصحيحة للوظيفة المطلوبة. على سبيل المثال، استخدِم مفتاح تحكّم لاختيار قيمة منطقية.
  • (إضافات "تقويم Google")
    • يمكن استخدام التقاويم الثانوية والتفويض، أو إذا لم يكنا متاحين، تتم إدارتهما بشكل آمن. على سبيل المثال، يتعذّر إنشاء المكالمة الجماعية إذا اختار المستخدم تقويمًا مختلفًا يمكنه الوصول إليه عند إنشاء حدث.
    • تعمل الأحداث المتكررة بشكل صحيح.
    • إذا كانت الإضافة تستخدم calendar.conferenceSolution، يتم تقديم حل واحد على الأقل للمؤتمر.
    • إذا كانت الإضافة توفّر حلول مكالمات الفيديو، سيتم استخدام حقول بيانات المؤتمر المناسبة. على سبيل المثال، تستخدم روابط اجتماعات الفيديو وأرقام الهواتف وروابط SIP ورموز الدخول وغيرها من السمات المتوافقة حقول البيانات المنظَّمة ولا يتم توفيرها في حقل الملاحظات.
    • إذا كانت الإضافة توفّر حلول مكالمات الفيديو، لن تعدِّل سوى تفاصيل مكالمة الفيديو وليست أي حقول أحداث أخرى.
    • إذا كانت الإضافة توفّر حلول مكالمات الفيديو، يستغرق إنشاء المكالمة أقل من 5 ثوانٍ.
    (إضافات Gmail)
    • إذا كانت الإضافة تستخدم UrlFetchApp أو OpenLinkUrl:
      • عنوان URL صالح.
      • يستخدم عنوان URL بروتوكول HTTPS وليس HTTP.
      • تم تحديد النطاق بالكامل.
      • المسار ليس فارغًا. على سبيل المثال، https://altostrat/ مقبول، ولكن https://altostrat غير متوافق.
      • لا يمكن استخدام أحرف البدل في UrlFetchApp.
إضافة Google Workspace تجربة المستخدم
  • تحتوي الإضافة على صفحة رئيسية. إذا كانت "إضافة Google Workspace" هي إضافة في Gmail تم تحويلها، يتم تطبيق صفحة رئيسية تلقائية.
  • تعمل بطاقة الإضافة بشكلٍ صحيح. على سبيل المثال، لا تتوفر بطاقات مكررة، إذ تعمل أزرار الرجوع والتحديث والتحديث وفقًا لذلك.
  • بعد أن يفوّض المستخدم الإضافة، يتم عرض بطاقة صفحة رئيسية مخصّصة للترحيب بالمستخدم من خلال زر لتسجيل الدخول (إذا لزم الأمر) وشعار ووصف إضافي للميزة.
    • إذا تم تشغيل زر تسجيل الدخول، يعرض هذا الزر صفحة تسجيل دخول مخصصة من مورِّد الجهة الخارجية والتي تشير بوضوح إلى أن هناك خدمة خارجية تعمل خارج Google Workspace.
  • تتلاءم واجهة مستخدم الإضافة مع المساحات المخصّصة بدقة:
    • لا يتم اقتطاع النص والتصنيفات باستخدام "..."
    • ليس على المستخدم إجراء الكثير من التمرير العمودي.
    • لا يتجاوز عرض المحتوى 300 بكسل ولا يحتوي على شريط تمرير أفقي.
  • لا يستخدم رمز الإضافة المكتبات بشكلٍ زائد، لأن المكتبات يمكن أن تؤدي إلى فقدان الإضافة.
(إضافات "تقويم Google")
  • إذا كانت الإضافة توفّر حلولاً لمكالمات الفيديو، تكون مكالمات الفيديو التي تم إنشاؤها صالحة ويتم عرضها بشكل صحيح على موقع إلكتروني تابع لجهة خارجية.
(إضافات Drive)
  • إذا كان التطبيق يخزّن الملفات في Drive، فإنه يسمح للمستخدمين باختيار مجلد أو إنشاء مجلد خاص بالتطبيق وإعادة استخدامه. يمكن تخزين بيانات التهيئة في مجلد بيانات التطبيق. لا يتجاهل التطبيق الملفات في مجلد "ملفاتي" لدى المستخدم.
  • تخزّن الإضافة الملفات فقط في Drive المرتبطة بالوظائف الموثقة في الإضافة.
(إضافات Gmail)
  • ولا تشير الإضافة إلى إضافات متصفّح Chrome أو تحتوي على رابط يؤدي إليها بدون مبرّر.
  • تحتوي قائمة الإجراءات الإضافية على إجراءات عامة تعمل بشكل صحيح. على سبيل المثال، الخروج، حول، دعم، وما إلى ذلك.
إضافة Google Workspace الرسومات (إضافات "تقويم Google")
  • شعار حل مكالمة الفيديو هو عنوان URL عام. يُرجى الاطّلاع على توفير شعارات حلول المؤتمرات.
  • إذا كانت الإضافة تستخدم calendar.conferenceSolution، يتّبع شعار حل مكالمة الفيديو متطلبات calendar.logoUrl. راجِع مورد بيان التقويم.
  • إذا كانت الإضافة تستخدم calendar.logoUrl أو common.logoUrl، سيكون الشعار مطابقًا للرمز الوارد في بطاقة بيانات التطبيق.
  • إذا كانت الإضافة تستخدم calendar.logoUrl أو common.logoUrl، سيبدأ عنوان URL للشعار على النحو التالي: https://lh3.googleusercontent.com/
إضافة Google Workspace OAuth (إضافات Drive)
  • (إجراء يُنصَح به) إذا كنت تريد تلقّي بيانات وصفية محدودة، تتضمن الإضافة نطاق drive.addons.metadata.readonly.
تطبيق الويب الوظائف
  • يشير عنوان URL العام للتنقل إلى تطبيق ويب. لا تعتبر صفحة الويب البسيطة التي لا تتضمن وظائف أحد تطبيقات الويب.