أنواع الإضافات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تقدّم هذه الصفحة نظرة عامة على نوعَي الإضافات التي يمكنك إنشاؤها، وهما إضافات Google Workspace وإضافات المحرّر. تختلف أنواع الإضافات هذه في التطبيقات التي توسّعها وطريقة إنشائها والقيود المفروضة عليها.
إضافات Google Workspace
إضافات Google Workspace هي أحدث جيل من الإضافات، وتوفّر العديد من الإمكانات، بما في ذلك:
إنشاء إضافة واحدة فقط للعديد من تطبيقات Google Workspace: بدلاً من إنشاء إضافات منفصلة لكل تطبيق من تطبيقات Google Workspace، يمكنك إنشاء إضافة واحدة من إضافات Google Workspace وإدارتها، وتكون هذه الإضافة متوافقة مع جميع تطبيقات Google Workspace.
يمكن لإضافة Google Workspace توسيع نطاق التطبيقات المضيفة التالية:
- Gmail
- تقويم Google
- Google Chat (معاينة للمطوّرين)
- مستندات Google
- Google Drive
- Google Meet
- جداول بيانات Google
- العروض التقديمية من Google
زيادة الوعي بعلامتك التجارية: تظهر رموز الإضافات تلقائيًا في اللوحة الجانبية اليمنى لتطبيقات المضيفة للإضافة.
إنشاء تجارب على الصفحة الرئيسية: يمكنك إنشاء صفحات رئيسية فردية لكل تطبيق من تطبيقات Google Workspace توسّع نطاقه الإضافة، أو استخدام الصفحة الرئيسية نفسها لعدة تطبيقات.
مراعاة سياق المستخدم في الإضافة: يمكنك تصميم إضافة Google Workspace لعرض واجهات خاصة بالتطبيق المضيف للإضافة. على سبيل المثال، يمكن أن تعرض الإضافة معلومات من رسالة إلكترونية أو حدث في التقويم، أو تقترح إجراءً استنادًا إلى صفحة تطبيق Google Workspace الحالية.
استخدام واجهات موحّدة: يمكنك إنشاء واجهات مستخدم من عناصر الأدوات المضمّنة التي توفّرها خدمة Card في "برمجة التطبيقات". ولا تحتاج إلى أي خبرة في HTML أو CSS لتحديد هذه الواجهات.
توسيع نطاق استخدام إضافات Gmail على أجهزة الكمبيوتر والأجهزة الجوّالة: إذا كانت إحدى إضافات Google Workspace توسّع نطاق استخدام Gmail، يمكنك استخدامها في كل من إصدارَي Gmail على الكمبيوتر والأجهزة الجوّالة. إذا أنشأت إضافة Google Workspace توسّع نطاق Gmail، لن تحتاج إلى تصميم إصدار منفصل من الإضافة للأجهزة الجوّالة. ويتم استخدام الواجهة نفسها في كل مكان.
استخدام وقت التشغيل المفضّل: يمكنك تطوير إضافات Google Workspace باستخدام البنية الأساسية للاستضافة وسلسلة أدوات التطوير ونظام التحكّم في المصدر ولغة البرمجة ومكتبات الرموز التي تفضّلها.
إضافات المحرّر
توسّع إضافات أدوات التحرير إحدى تطبيقات Google Editor، مثل "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google" أو "نماذج Google". يمكن أن يتضمّن كل نوع من أنواع إضافات "محرّر Google" (مثل إضافات "جداول بيانات Google") مجموعة خاصة من الإمكانات والقيود والاعتبارات الخاصة بكل نوع. عند إنشاء إضافات في "محرّر Google"، من المهم فهم هذه التفاصيل الخاصة بـ "محرّر Google". لمزيد من التفاصيل حول الإضافات الخاصة ببعض المحرّرات، يُرجى الاطّلاع على الأقسام التالية:
يمكن أن تعمل إضافات المحرّر على إنجاز مهام المحرّر الشائعة بشكل آلي، مثل إنشاء الملفات وتعديلها وتنسيقها ونقل البيانات بين التطبيقات.
يمكن تخصيص واجهات إضافات المحرّر بشكل كبير لتناسب المهام التي يتم تنفيذها.
تُعدّ إضافات المحرّرين مثالية لأتمتة المهام ضمن "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google" أو "نماذج Google" للاستخدام الفردي أو الداخلي. بالنسبة إلى الإضافات التي تتطلّب إمكانات واسعة النطاق للتعامل مع العديد من المستخدمين، أو تتطلّب وقت استجابة منخفضًا، أو تتطلّب تحكّمًا كاملاً في البنية الأساسية، ننصحك بإنشاء إضافات Google Workspace في بيئة وقت تشغيل مختلفة للتحكّم بشكل أفضل في البنية الأساسية وعمليات النشر والإصدار.
تختلف طريقة عمل إضافات المحرّر عن إضافات Google Workspace في ما يلي:
- يمكن لإضافات المحرّر إنشاء واجهات تتألف من عناصر القائمة ومربّعات الحوار والأشرطة الجانبية. يتم تحديد مربّعات الحوار والأشرطة الجانبية للإضافات باستخدام HTML وCSS العاديين.
- تخضع إضافات المحرّرين لقواعد ترخيص خاصة لأنّها تنشئ ملفات أو تعدّلها أو تتفاعل معها بطريقة أخرى ضمن Google Drive. من المهم فهم تفويض إضافة المحرّر أثناء تطوير إضافة المحرّر.
- تتضمّن الملفات التي يتم إنشاؤها وتعديلها في كل محرّر بنى محدّدة. على سبيل المثال، تتألف العروض التقديمية في "العروض التقديمية من Google" من صفحات يمكن أن تكون شرائح أو شرائح رئيسية أو تنسيقات. يجب فهم بنى الملفات هذه لأنّ الإضافات تتفاعل معها غالبًا عند قراءة الملفات أو تعديلها.
- لا تعمل الوظائف الإضافية في "المحرّر" إلا في برامج الكمبيوتر المكتبي، وليس على أجهزة Android أو iOS.
- يجب تنفيذ إضافات المحرّر في Apps Script.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGoogle Workspace add-ons offer a unified solution, extending functionalities across multiple Google Workspace applications like Gmail, Calendar, and Docs with a single add-on.\u003c/p\u003e\n"],["\u003cp\u003eEditor add-ons focus on enhancing specific Google Editors (Docs, Sheets, Slides, Forms) with custom interfaces and automation capabilities but are limited to desktop use.\u003c/p\u003e\n"],["\u003cp\u003eWhile Workspace add-ons utilize standardized interfaces and work seamlessly across platforms, Editor add-ons require HTML/CSS knowledge and adhere to specific authorization rules.\u003c/p\u003e\n"],["\u003cp\u003eBoth add-on types provide distinct advantages; Workspace add-ons enhance cross-application workflows, while Editor add-ons offer deep, editor-specific customization and task automation.\u003c/p\u003e\n"]]],["There are two add-on types: Google Workspace and Editor add-ons. Google Workspace add-ons offer a single build for multiple apps (Gmail, Calendar, Chat, Docs, Drive, Sheets, Slides), and they feature standardized interfaces, mobile and desktop compatibility, and customizable homepages. Editor add-ons extend Docs, Sheets, Slides, and Forms, allowing for highly customizable interfaces using HTML and CSS, but require specific authorization and only function on desktop. They are built to automate common editor tasks.\n"],null,["This page provides a general overview of the two types of add-ons\nyou can build:\n*Google Workspace add-ons* and *Editor add-ons*. These\nadd-on types differ in what applications they extend,\nhow they are created, and what restrictions they have.\n\nGoogle Workspace add-ons\n\n*Google Workspace add-ons* are the latest generation of add-ons, and\nprovide many capabilities, including:\n\n- **Build just one add-on for multiple\n Google Workspace apps**: Instead of creating separate\n add-ons for\n each Google Workspace application, you can build and manage a single\n Google Workspace add-on that works across Google Workspace.\n A Google Workspace add-on can extend the following host applications:\n\n - Gmail\n - Google Calendar\n - Google Chat (Developer Preview)\n - Google Docs\n - Google Drive\n - Google Meet\n - Google Sheets\n - Google Slides\n- **Increase your brand awareness**: Add-ons icons are by\n default visible in the right-side panel of the\n add-on's host apps.\n\n- **Build homepage experiences** : You can create individual [homepages](/workspace/add-ons/concepts/homepages)\n for each Google Workspace app your add-on\n extends, or use the same homepage for multiple apps.\n\n- **Reflect the user's context in your add-on**: You\n can design your Google Workspace add-on to show interfaces specific to the\n add-on's host app. For example, your\n add-on can display info from an email or calendar\n event, or suggest an action based on the current Google Workspace app\n page.\n\n- **Use standardized interfaces** : Construct user interfaces from built-in\n widget elements provided by the Apps Script\n [`Card`](/apps-script/reference/card-service/card) service. You don't need\n any expertise with HTML or CSS to define these interfaces.\n\n- **Extend desktop and mobile clients for Gmail**: If a\n Google Workspace add-on extends Gmail, you can use it in both the\n desktop and mobile versions of Gmail. If you build a\n Google Workspace add-on that extends Gmail, you don't need to\n design a separate mobile version of the add-on. The\n same interface is used everywhere.\n\n- **Use your preferred runtime.** You can develop Google Workspace add-ons with your\n preferred hosting infrastructure, development tool chain, source control\n system, coding language, and code libraries.\n\nEditor add-ons\n\n*Editor add-ons* extend one of the Google Editor applications,\nsuch as Docs, Sheets, Slides, or\nForms. Each Editor add-on type (for\nexample, Sheets add-ons) can have its own set of\ntype-specific capabilities, restrictions, and special considerations. When\nbuilding Editor add-ons, it's important to understand these\nEditor-specific details. For more details on add-ons for specific\nEditors, see the corresponding sections:\n\n- [Google Docs](/workspace/add-ons/editors/docs)\n- [Google Forms](/workspace/add-ons/editors/forms)\n- [Google Sheets](/workspace/add-ons/editors/sheets)\n- [Google Slides](/workspace/add-ons/editors/slides)\n\nEditor add-ons can automate common editor tasks such as file\ncreation, editing, formatting, and moving data between applications.\nEditor add-on interfaces are highly-customizable for\nthe tasks at hand.\n\nEditor add-ons are ideal for automating tasks within Google\nDocs, Sheets, Slides, or\nForms for individual or internal use. For add-ons\nrequiring large-scale capabilities that need to handle many users, require low\nlatency, or demands full control over your infrastructure, consider building a\nGoogle Workspace add-ons on a [different runtime](/workspace/add-ons/guides/alternate-runtimes)\nenvironment for better control over infrastructure, deployment and release\nprocesses.\n\nEditor add-ons behave differently from Google Workspace add-ons in the\nfollowing ways:\n\n- Editor add-ons can create interfaces consisting of menu items, dialogs, and sidebars. Add-ons dialogs and sidebars are defined using standard [HTML and\n CSS](/workspace/add-ons/concepts/html-interfaces).\n- Editor add-ons have special authorization rules because they create, modify, or otherwise interact with files within Google Drive. It is important to understand the [Editor add-on\n authorization](/workspace/add-ons/concepts/editor-auth-lifecycle) while developing an Editor add-on.\n- Files created and updated in each editor have specific structures. For example, Google Slides presentations are composed of pages which can be slides, masters, or layouts. You should understand these file structures, as add-ons often interact with them when reading or editing files.\n- Editor add-ons only function in desktop clients, not Android or iOS.\n- Editor add-ons must be implemented in Apps Script."]]
