تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك تحسين تجربة المستخدمين الإجمالية من خلال اتّباع هذه الأدلة المتعلّقة بتصميم التطبيقات الملحقة.
أفضل الممارسات العامة
ننصحك باتّباع أفضل الممارسات التالية لجميع
الإضافات التي تُطوّرها.
تحديد ملكية الإضافة قبل البدء
يتم تحديد الإضافات من خلال مشاريع Apps Script التي
يجب أن يملكها حساب معيّن أو يتم وضعها في مساحة تخزين
سحابي مشتركة. قبل كتابة رمز برمجي لإضافة، حدِّد الحساب الذي يجب أن يملك المشروع،
والحساب الذي يمثّل الناشر. حدِّد أيضًا الحسابات التي ستؤدي دور المتعاونين، وتأكَّد من أنّ هذه الحسابات يمكنها الوصول إلى مشروع النصوص البرمجية
ومشروع Google Cloud المرتبط به.
توسيع نطاق Google Workspace، وليس تكراره
تهدف الإضافات إلى توفير إمكانات جديدة لتطبيقات Google Workspace التي توسّع نطاقها، أو إلى التشغيل الآلي للمهام المعقّدة.
من غير المرجّح أن تجتاز مراجعة الإضافات للنشر الإضافات التي تكرّر الوظيفة المتوفرة في
التطبيق أو التي لا تُجري تحسينات كبيرة على سير العمل.
إبقاء النطاقات ضيّقة
عند تحديد نطاقاتك
بوضوح، اختَر دائمًا
مجموعة النطاقات الأقل تساهلاً. على سبيل المثال، لا تجعل تكمِّل طلب إذن الوصول الكامل إلى "تقويم" المستخدم باستخدام النطاق https://www.googleapis.com/auth/calendar
إذا كانت تحتاج فقط إلى إذن الوصول للقراءة. للحصول على إذن بالقراءة فقط، استخدِم نطاق
https://www.googleapis.com/auth/calendar.readonly.
تجنُّب الاعتماد بشكل كبير على المكتبات
يمكن أن يؤدي استخدام مكتبات Apps Script
إلى تشغيل الإضافة بشكلٍ
أبطأ
من السرعة التي يمكن أن تحقّقها إذا كان كل رمز Apps Script مضمّنًا في
مشروع نص برمجي واحد. على الرغم من أنّ مكتبات Apps Script تعمل في
الإضافات، قد تواجه انخفاضًا في الأداء في حال استخدام
هذه المكتبات. تجنَّب تضمين مكتبات غير ضرورية في مشروعك، وفكِّر في طرق
لتقليل اعتماد الإضافة عليها.
لا ينطبق وقت الاستجابة الموضّح أعلاه إلا على مشاريع "برمجة التطبيقات" التي يتم استخدامها كمكتبات من جهة الخادم. يمكنك استخدام مكتبات JavaScript
التابعة للجانب العميل، مثل jQuery، بحرية بدون مواجهة هذا الاستجابة البطيئة.
أفضل الممارسات المتعلقة بإضافات المحرّر
لا تنطبق أفضل الممارسات التالية إلا على
إضافة "المحرِّر".
يجب وضع رمز HTML للواجهة وJavaScript من جهة العميل في ملفات النصوص البرمجية الخاصة بهما.
يمكنك إنشاء ملفات نصوص برمجية متعددة في مشروع "برمجة تطبيقات Google".
من الأسهل إدارة إضافة معقدة إذا وضعت ملفَي HTML وJavaScript اللذين يحدّدان الشريحتَين الجانبيتَين للإضافة
ومربّعات الحوار في ملفات نصوص برمجية مخصّصة لهما.
تاريخ التعديل الأخير: 2025-04-09 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-04-09 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Enhance user experience by adhering to add-on design guidelines that focus on ownership, functionality, and security."],["Design add-ons to extend Google Workspace capabilities, rather than duplicating existing features, to ensure successful publication."],["Prioritize security by minimizing the scope of access your add-on requires, requesting only necessary permissions."],["Optimize performance by limiting reliance on external libraries and, if applicable to Editor add-ons, strategically organizing code within dedicated script files."],["For Editor add-ons, thorough testing across various authorization modes is crucial to ensure functionality and user experience."]]],["Before coding, determine the add-on's ownership, publisher, and collaborators, ensuring all have access to the project. Prioritize extending, not replicating, Google Workspace functionality and use the narrowest scopes possible when defining permissions. Avoid over-reliance on Apps Script libraries due to potential performance issues. Organize complex add-ons by placing HTML and JavaScript in dedicated script files. Thoroughly test the add-on in various authorization modes and file configurations.\n"]]