تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
قبل إنشاء إضافة "محرّر Google"، راجِع الحصص والقيود المفروضة على Apps Script لضمان توافق تصميم مشروعك مع هذه الإرشادات. يمكن أن يساعدك التعرّف على هذه الحدود في مرحلة مبكّرة من عملية التطوير في منع حدوث مشاكل محتملة لاحقًا. إنّ "برمجة تطبيقات Google" هي أداة مثالية لتطوير تطبيقات خفيفة الوزن إضافية لك أو لفريقك أو لمؤسستك. ومع ذلك، إذا كنت تتوقّع إنشاء إضافة على نطاق واسع تحتاج إلى التعامل مع العديد من المستخدمين أو تتطلّب وقت استجابة منخفضًا أو تتطلّب التحكّم الكامل في البنية الأساسية، ننصحك بتطوير إضافة Google Workspace في بيئة وقت تشغيل مختلفة.
اتّبِع الإجراء العام التالي عند إنشاء إضافة "محرِّر إعلانات Google":
أنشئ مشروعًا في Apps Script.
اكتب رمزًا لتحديد مظهر الإضافة وسلوكها باستخدام خدمة HTML المضمّنة في Apps Script.
اختبِر الإضافة.
انشر الإضافة.
إنشاء مشروع نصي
إضافة المحرِّر هي مشروع مستقل في "برمجة تطبيقات Google". يوفّر دليل النصوص البرمجية المستقلة تعليمات لإنشاء مشاريع جديدة. يمكنك أيضًا فتح نص برمجي جديد. في هذه الحالة، يتم وضع ملف المشروع (الذي يحمل الاسم Untitled project في البداية) في مجلد Drive الجذر.
التعاون
عند التعاون مع مستخدمين آخرين في تطوير إضافة، يكون حساب مستخدم واحد هو صاحب مشروع الإضافة. عند نشر إضافة، يعمل حساب مستخدم واحد بدور الناشر. يجب أن يكون لدى حساب النشر إذن وصول للتعديل في مشروع الإضافة البرمجي، ولكن ليس من الضروري أن يكون مالك المشروع.
من المهم جدًا تجنُّب المواقف التي تفقد فيها إمكانية الوصول إلى رمز أو إعدادات إحدى الإضافات لأنّ مالك المشروع قد غادر مؤسستك.
لتجنُّب فقدان إمكانية الوصول إلى رمز الإضافة، ننصحك باستخدام مساحات التخزين السحابي المشتركة عند التعاون في إنشاء إضافة. يضمن وضع ملف نص البرمجة الإضافي في مساحة تخزين سحابي مشتركة عدم توفّر حساب واحد يكون المالك الوحيد للمشروع.
بعد إنشاء مشروع نصي، يمكنك البدء في كتابة الرمز لتحديد مظهر الإضافة وسلوكها. يمكنك استخدام HtmlService في Apps Script لإنشاء واجهة مستخدم الإضافة، أي المربّعات الحوارية والأشرطة الجانبية، باستخدام HTML وCSS التقليديتين. يمكن لإضافات المحرِّر أيضًا تحديد عناصر قائمة مخصّصة.
أثناء كتابة الرموز البرمجية، يمكنك الرجوع إلى دليل تنسيق إضافات "محرّر Google" للاطّلاع على إرشادات حول كيفية تصميم تجربة المستخدم في الإضافة. تأكَّد أيضًا من فهم مختلف حالات دورة حياة التفويض التي يمكن أن تواجهها إضافتك وبرمجة الإضافة وفقًا لها.
اختبار الإضافة
يمكنك اختبار إضافات "محرّر Google" قبل نشرها للتأكّد من أنّها تعمل على النحو المتوقّع. يتطلّب الاختبار إنشاء إعداد اختبار واستخدام مستند اختبار أو جدول بيانات أو نموذج أو عرض تقديمي.
تاريخ التعديل الأخير: 2025-04-23 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-23 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eEditor add-ons are built using Apps Script, requiring a standalone Apps Script project and code for the add-on's functionality and user interface.\u003c/p\u003e\n"],["\u003cp\u003eThorough testing is crucial before publishing using a dedicated test configuration and sample documents, ensuring the add-on functions as intended.\u003c/p\u003e\n"],["\u003cp\u003eCollaboration involves shared ownership and access, recommending the use of shared drives and adding collaborators to the Cloud Platform project for sustained accessibility.\u003c/p\u003e\n"],["\u003cp\u003ePublishing makes the add-on accessible to others, either publicly or within a domain, involving a review process for public listings on the Google Workspace Marketplace.\u003c/p\u003e\n"],["\u003cp\u003eThe add-on's appearance and behavior are defined using Apps Script's HTML service, allowing for custom menus, dialogs, and sidebars constructed with HTML and CSS.\u003c/p\u003e\n"]]],["Begin by creating a standalone Apps Script project, which can be done via a new script or through specific instructions. Next, code the add-on's appearance and functionality using Apps Script's HTML service for the user interface. Before releasing, test the add-on with a test configuration and document. To make the add-on available to users, publish it on the Google Workspace Marketplace after ensuring the add-on complies with publication guidelines. Utilizing shared drives for code access is encouraged.\n"],null,["Before building your Editor add-on, review the\n[Apps Script quotas and limitations](/apps-script/guides/services/quotas) to\nensure your project design aligns with these guidelines. Familiarizing yourself\nwith these limits early in your development process can help prevent potential\nissues later on. Apps Script is ideal for lightweight\nadd-on development for yourself, your team, or your\norganization. However, if you anticipate building a large-scale\nadd-on that needs to handle many users, requires low\nlatency, or demands full control over your infrastructure, consider developing\na Google Workspace add-on on a\n[different runtime](/workspace/add-ons/guides/alternate-runtimes) environment.\n\nFollow this general procedure when building an Editor add-on:\n\n1. Create an Apps Script project.\n2. Write code to define the add-on's appearance and behavior, using the built-in Apps Script [HTML service](/apps-script/reference/html).\n3. Test the add-on.\n4. Publish the add-on.\n\nCreate a script project\n\nAn Editor add-on is a [standalone](/apps-script/guides/standalone) Apps Script\nproject. The standalone script guide provides\n[instructions to create new projects](/apps-script/guides/standalone#creating_a_standalone_script).\nYou can also just\n[open a new script](https://script.google.com/create).\nIf you do this, the project file (initially named `Untitled project`) is\nplaced in your root Drive folder.\n| **Note:** If you intend to publish your add-on, you must use a [standard Cloud Platform (GCP) project](/apps-script/guides/cloud-platform-projects#standard_cloud_platform_projects).\n\nCollaboration\n\nWhen you collaborate with others in developing an add-on, a single user account\nowns the add-on project. When you publish an add-on, a single user account acts\nas the publisher. The publishing account must have edit access to the add-on\nscript project, but it doesn't need to be project owner.\n\n**It's very important to avoid situations where you lose access to an add-on's\ncode or settings because the owner of the project left your organization.**\n\nTo prevent losing access to add-on code, we encourage you to use\n[shared drives](/apps-script/collaborating#collaborating_with_shared_drives)\nwhen you collaborate on an add-on. Placing your add-on script file in a shared\ndrive ensures that no single account is the sole owner of the project.\n\nIt is also recommended that you\n[add collaborators to the script project's Cloud Platform (GCP) project](/apps-script/guides/cloud-platform-projects#adding_additional_owners_to_a_standard_gcp_project).\nThis helps ensure someone on your team always can access the add-on's\nCloud settings.\n| **Warning:** If you don't add collaborators to your add-on project, it is vital that you transfer ownership of the script project prior to the owner's account being shutdown or removed. Otherwise you could lose access to the add-on code and settings entirely.\n\nCode the add-on\n\nOnce you have created a script project, you can begin writing\ncode to define the add-on appearance and behavior. You use the Apps Script\n[HtmlService](/apps-script/reference/html) to construct the add-on user\ninterface---[dialogs and sidebars](/workspace/add-ons/concepts/dialogs)---\nusing conventional HTML and CSS. Editor add-ons can define custom\n[menu items](/workspace/add-ons/concepts/menus) as well.\n\nAs you code, refer to the [Editor add-on style guide](/workspace/add-ons/guides/editor-style)\nfor guidelines on how to design your add-on user experience. Also, be sure\nyou understand and program for the different\n[authorization lifecycle states](/workspace/add-ons/concepts/editor-auth-lifecycle)\nyour add-on can encounter.\n\nTest the add-on\n\nYou can test Editor add-ons before they are published to ensure they behave\nas expected. Testing requires you to create a\n[test configuration](/workspace/add-ons/how-tos/testing-editor-addons#create_a_test_configuration)\nand use a testing document, spreadsheet, form, or presentation.\n\nSee [Test an Editor add-on](/workspace/add-ons/how-tos/testing-editor-addons)\nfor details.\n\nPublish the add-on\n\nPublishing your add-on makes it available to others, either publicly or just\nusers in your domain. Before you start the publishing process, be sure to\nreview the [publication overview](/workspace/add-ons/how-tos/editor-publish-overview).\n\nEditor add-ons are published to the [Google Workspace Marketplace](https://workspace.google.com/marketplace/). Publicly available add-ons\nmust complete [add-on review](/workspace/marketplace/about-app-review) before they are published.\n\nSee [Publishing an Editor add-on](/workspace/add-ons/how-tos/publishing-editor-addons)\nfor more details."]]
