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

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

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

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

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

مدة المراجعة

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • (إجراء مقترَح) للسماح لمشرفي Workspace بتثبيت تطبيقك نيابةً عن المستخدمين في مؤسستهم، يجب أن يكون تطبيقك قادرًا على تلقّي الرسائل المباشرة وإرسالها.
تطبيق Google Chat الرسومات
  • يحتوي التطبيق على صورة رمزية واضحة وسهلة التعرّف عليها.
تطبيق Google Drive الوظائف
  • لا يستخدم التطبيق إضافات متصفّح Chrome لتوفير الوظائف من خلال معالجة Drive HTML مباشرةً.
  • إذا كان تطبيقك يستخدم نطاقات حسّاسة أو مفروض عليها قيود، يجب أن يخضع للتحقّق من 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 تفاصيل عن متطلبات الترخيص والاشتراك التي قد تكون مطلوبة لاستخدام الإضافة. إذا كانت الإضافة تتضمّن فئة مدفوعة، يجب أن توفّر بيانات Marketplace رابطًا إلى صفحة ويب تقدّم مزيدًا من المعلومات عن الأسعار أو كيفية التواصل مع مندوب مبيعات.
  • إذا لم يكن المستخدم مسجّلاً الدخول، يجب أن تعرض الإضافة رسالة المطالبة بتسجيل الدخول بنقرة واحدة الواردة في عرض Google One بنقرة واحدة والإجراء الاحتياطي "تسجيل الدخول باستخدام حساب Google" الذي تم العثور عليه في المصادقة. بالإضافة إلى آلية "تسجيل الدخول باستخدام حساب Google"، قد يتم تقديم خيارات تسجيل دخول أخرى.
  • يجب أن تكون الإضافة ذات تصميم سريع الاستجابة يمكنه تعديل المحتوى مع الأحجام المختلفة.
  • يجب أن تكون مسارات المستخدِمين في الإضافة صالحة حتى في حال إيقاف ملفات تعريف الارتباط التابعة لجهات خارجية.
  • يجب ألا تتضمّن الإضافة ميزة التمرير الأفقي داخل إطار iframe.
  • إذا أرادت الإضافة استخدام المرحلة الرئيسية، يجب تصميم الإضافة لتجارب اللاعبين المتعددين والسماح بتلاعب عدة مشاركين في الوقت نفسه بالمحتوى. بالنسبة إلى تجارب اللاعبين الفرديين، على المطوّر استخدام اللوحة الجانبية.
  • (يُنصَح به) يجب أن تعرض الإضافة هوية المستخدم الذي سجَّل الدخول.
  • (إجراء يُنصح به) خيار الترجمة: يجب أن تستند اللغة إلى الإعدادات المفضّلة المحلية التي يضبطها المتصفّح عند توفّرها.
  • (إجراء مقترَح) يجب اختيار المحتوى من خلال واجهة تصفّح تعرض المحتوى الذي تم الوصول إليه مؤخرًا.
  • (إجراء مقترَح) إذا لم تعُد اللوحة الجانبية مطلوبة، يجب أن تُغلق الإضافة اللوحة الجانبية بعد الانتقال إلى المرحلة الرئيسية.
إضافة Google Workspace الرسومات

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

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

إضافات Meet

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

إضافات Drive

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