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

لنشر تطبيق علنًا على Google Workspace Marketplace، تراجع Google تطبيقك وبطاقة بياناته للتأكّد من أنّهما يستوفيان إرشادات Google المتعلقة بالتصميم والمحتوى والأسلوب.

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

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

قبل إرسال تطبيقك للمراجعة، تأكَّد من أنّه جاهز لل نشر. لمعرفة التفاصيل، يُرجى الاطّلاع على الاستعداد لبدء عملية النشر.

مدة المراجعة

تستغرق مراجعة التطبيق عادةً عدة أيام. ويعتمد الوقت المستغرَق على ما يلي:

  • عدد التطبيقات التي تم إرسالها مؤخرًا
  • مقدار العمل الإضافي الذي يحتاجه تطبيقك

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

إثبات ملكية حسابك على OAuth:

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

  • لم يُكمِل التطبيق عملية التحقّق من OAuth.

مشاكل بطاقة بيانات التطبيق:

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

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

  • لقطات الشاشة والصور منخفضة الجودة أو لا تمثّل بدقة ميزات التطبيق

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

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

معايير المراجعة

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

المتطلّبات لجميع التطبيقات

يمكنك استخدام مربّعات الاختيار لتتبُّع المراجعة الأولية.

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

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

متطلبات إضافية لعمليات دمج تطبيقات معيّنة

اختَر عمليات دمج التطبيقات المضمّنة في بطاقة بيانات تطبيقك للاطّلاع على معايير المراجعة ذات الصلة. يمكنك النقر على أسماء الأعمدة لترتيب المعايير، مثلاً، حسب الفئة.

يمكنك استخدام مربّعات الاختيار لتتبُّع المراجعة الأولية.

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

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

  • (إجراء مقترَح) للسماح لمشرفي Workspace بتثبيت تطبيقك نيابةً عن المستخدمين في مؤسستهم، يجب أن يكون تطبيقك قادرًا على تلقّي الرسائل المباشرة وإرسالها.
تطبيق Google Chat الرسومات
  • يتضمّن التطبيق صورة رمزية واضحة يسهُل التعرّف عليها.
تطبيق Google Drive الوظائف
  • لا يستخدم التطبيق إضافات متصفّح Chrome لتوفير الوظائف من خلال التلاعب برمز HTML في Drive مباشرةً.
  • إذا كان تطبيقك يستخدم نطاقات حسّاسة أو مفروض عليها قيود، يجب أن يخضع للتحقّق من OAuth. اطّلِع على كيف يمكنني إرسال طلب لإثبات الملكية؟
  • إذا كان تطبيقك يستخدم نطاقات محدودة، يجب أيضًا أن يخضع لتقييم للأمان. اطّلِع على سبب الحاجة إلى تقييم الأمان.
تطبيق Google Drive تجربة المستخدم
  • إذا كان التطبيق يخزِّن الملفات في Drive، يجب أن يسمح للمستخدمين باختيار مجلد أو أن ينشئ مجلدًا خاصًا بالتطبيق ويعيد استخدامه. يمكن تخزين بيانات الضبط في مجلد "بيانات التطبيق". لا يُلقي التطبيق الملفات في مجلد "ملفاتي" الخاص بالمستخدم.
  • لا يخزِّن التطبيق سوى الملفات في Drive المرتبطة بالوظائف الموثَّقة للتطبيق.
إضافة المحرِّر الوظائف
  • يتم تضمين الإجراءات المتوقّعة والمطلوبة في الإضافة، وتوفر جميع الأدوات اللازمة لإكمال سير العمل. على سبيل المثال:
    • إذا كانت الإضافة تطبّق التصميم على المستند بأكمله، تقدّم خيار تطبيق التصميم على نص محدّد فقط.
    • إذا كانت الإضافة تحمّل بيانات جدول البيانات إلى خلاصة خدمة ويب، سيكون لها رابط يؤدي إلى هذه الخلاصة لتسهيل التنقّل.
    • إذا كانت الإضافة تتطلّب من المستخدم امتلاك حساب، يجب أن تشمل روابط أو معلومات لإنشاء حساب بسهولة إذا لم يكن لدى المستخدم حساب.
  • تحتوي الإضافة على عناصر قائمة ضمن علامة التبويب الإضافات.
  • حتى إذا كانت الإضافة تتألف من دوال مخصّصة فقط، يجب أن تتضمّن مستندات مناسبة.
  • تستخدم الإضافة onInstall() و onOpen() بشكل صحيح لتعبئة قائمتها. تتم تعبئة عناصر القائمة عند تثبيت الإضافة لأول مرة وعند فتح ملف مختلف. راجِع تفويض إضافة ميزات المحرِّر.
  • تم إعداد أوضاع التفويض بشكل صحيح. يُرجى الاطّلاع على أوضاع التفويض.
  • يجب تنفيذ الإضافة في وقت تشغيل V8 في Apps Script. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على وقت تشغيل V8.
إضافة المحرِّر تجربة المستخدم
  • توفّر الإضافة كل المعلومات اللازمة للتعرّف على المنتج وكيفية استخدامه بشكل أساسي.
  • لا يستخدم رمز الإضافة المكتبات بشكل مفرط لأنّه يمكن أن تؤدي المكتبات إلى خفض أداء الإضافة.
  • يتم تجنُّب الأخطاء إن أمكن ويتم إدارتها بشكل صحيح، وفي حال عدم حدوث ذلك:
    • يتم عرض رسائل الخطأ في نافذة حوار، وليس في تحذير JavaScript أو على الشريط الأحمر التلقائي. وتوضّح المشكلة وتصف ما يجب على المستخدم فعله لحلّها بلغة بسيطة.
    • إذا كان المستخدم يخطئ في إجراء معيّن، يتم عرض زر يساعده في حلّ المشكلة متى أمكن ذلك.
    • لمزيد من المعلومات، يمكنك الاطّلاع على دليل أنماط الإضافات.
  • الروابط المؤدية إلى صفحات خارجية تفتح في نوافذ جديدة وهي صحيحة.
  • الإضافة سهلة الاستخدام ومصمّمة بشكل جيد. وهذا يعني ما يلي:
    • يكون من الواضح دائمًا ما يجب فعله وكيفية تنفيذه.
    • يجب أن تكون الإضافة سهلة الاستخدام وسهلة الفهم. يتم تجنُّب المصطلحات الفنية والمصطلحات غير المألوفة.
    • تكون سير العمل واضحة ومبسّطة قدر الإمكان.
    • أمان المستخدم ومحتوى حسابه بأكبر قدر ممكن
  • تلتزم الإضافة بدليل أنماط واجهة المستخدم الخاص بإضافات المحرّر وتستخدم حزمة CSS الخاصة بإضافات المحرّر.
  • لا تستخدِم الإضافة سوى إجراء أساسي أزرق واحد لكلّ شاشة.
  • تعرض الإضافة مربّع حوار واحدًا في المرة الواحدة. لا يتداخل مع المحتوى ولا يتضمّن عدة مربّعات حوار مفتوحة في الوقت نفسه.
  • يجب أن تتناسب واجهة مستخدم الإضافة بشكلٍ أنيق مع المساحات المخصّصة لها:
    • لا يتم اقتطاع النص والتصنيفات باستخدام "..."
    • لا يحتاج المستخدم إلى التمرير كثيرًا عموديًا.
    • لا يتجاوز عرض المحتوى 300 بكسل لكي لا يحتوي على شريط التمرير الأفقي.
  • تتطلّب الإضافة تأكيدًا أو تعرِض تحذيرات لجميع الإجراءات الحسّاسة. على سبيل المثال، إذا كانت الإضافة على وشك تغطية كل المحتوى في جدول بيانات، يتم تحذير المستخدم ويؤكّد الإجراء قبل حدوثه.

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

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

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

  • إذا كانت الإضافة تستخدم calendar.name أو common.name، يكون الاسم الوارد في البيان مطابقًا للاسم الوارد في بطاقة بيانات التطبيق.
  • إذا كانت الإضافة تستخدم calendar.conferenceSolution، لن يحتوي اسم حلّ المؤتمرات على "تقويم Google".
  • (إجراء مقترَح) إذا كانت الإضافة تستخدم calendar.conferenceSolution، يجب ألا يتجاوز اسم حلّ المؤتمرات 30 حرفًا.
إضافة Google Workspace الوظائف
  • تستخدم الإضافة التطبيقات المصغّرة الصحيحة (أو واجهة المستخدم المضمّنة في إطار iframe في إضافات Meet) للحصول على الوظيفة المطلوبة. على سبيل المثال، استخدِم مفتاح تبديل لاختيار قيمة منطقية.

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

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

الإضافات في Gmail

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

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

إضافات Meet

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

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

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

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

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

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

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

إضافات Drive

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

الإضافات في Gmail

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

إضافات Meet

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

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

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

إضافات Meet

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

إضافات Drive

  • (إجراء مقترَح) إذا كنت تريد تلقّي بيانات وصفية محدودة، تتضمّن الإضافة النطاق drive.addons.metadata.readonly.
تطبيق الويب الوظائف
  • يشير عنوان URL الخاص بالتنقّل العام إلى تطبيق ويب. ولا يُعدّ تطبيق ويب عاديًا صفحة ويب بسيطة بدون وظائف.