توسيع نطاق عمل "مستندات Google" باستخدام الإضافات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
مستندات Google هي خدمة مستندات مستنِدة إلى السحابة الإلكترونية تتيح التعاون في الوقت الفعلي وتوفّر أدوات فعّالة لإنشاء المستندات وتعديلها ومشاركتها.
يمكنك توسيع نطاق "مستندات Google" باستخدام إضافات تساعدك في تحسين سير العمل المخصّص، وإنشاء اتصال بأنظمة تابعة لجهات خارجية، ودمج مستنداتك مع تطبيقات Google Workspace الأخرى (مثل "العروض التقديمية من Google").
يمكنك الاطّلاع على إضافات "مستندات Google" التي أنشأها مستخدمون آخرون في Google Workspace Marketplace.
الإجراءات التي يمكنك اتّخاذها
في ما يلي بعض الإجراءات التي يمكنك تنفيذها باستخدام إضافة توسّع نطاق وظائف "مستندات Google":
- يمكنك قراءة النص وتعديله وعرضه وتنسيقه في "مستندات Google" باستخدام خدمة المستندات المضمّنة في Apps Script. تتيح لك الخدمة أيضًا إنشاء وتعديل الجداول والصور والرسومات والمعادلات التي تظهر في "مستندات Google".
- يمكنك إنشاء قوائم مخصّصة وتحديد واجهات مربّعات حوار وأشرطة جانبية مخصّصة متعددة باستخدام HTML وCSS العاديين.
- يمكنك استخدام المشغّلات الخاصة بالإضافات لتشغيل دوال محدّدة عند حدوث أحداث تشغيل معيّنة.
يتم إنشاء إضافات "مستندات Google" باستخدام "برمجة تطبيقات Google". لمزيد من المعلومات حول كيفية الوصول إلى "مستندات Google" وإدارتها باستخدام Apps Script، يُرجى الاطّلاع على توسيع نطاق "مستندات Google".
بنية المستند
تتضمّن المستندات التي يتم إنشاؤها في "مستندات Google" بنى داخلية شبيهة بالشجرة
(مشابهة لـ HTML أو JSON) تحدّد مكان ظهور النصوص والصور والجداول
والعناصر الأخرى وكيفية ظهورها. تحدّد خدمة المستندات في Apps Script عدة فئات (مثل Paragraph أو Table) للمساعدة في إدارة أنواع العناصر المختلفة.
راجِع بنية المستند
للتعرّف على فئات العناصر هذه والقواعد التي تحكم ترتيبها.
العوامل التي تؤدي إلى الظهور
تتيح المشغّلات في Apps Script لمشروع نص برمجي تنفيذ دالة محدّدة عند استيفاء شروط معيّنة، مثل فتح مستند أو تثبيت إضافة.
اطّلِع على مشغّلات الإضافات لمزيد من المعلومات حول المشغّلات التي يمكن استخدامها مع إضافات "مستندات Google" والقيود التي تنطبق على استخدامها.
الخطوات الأولى
عندما تكون مستعدًا لإلقاء نظرة على بعض الرموز، يمكنك الاطّلاع على نماذج الإضافات، بما في ذلك الإضافة السريعة في "محرّر مستندات Google" التي تتضمّن "ترجمة Google".
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGoogle Docs is a cloud-based document solution enabling real-time collaboration and offering robust tools for composing, editing, and sharing documents.\u003c/p\u003e\n"],["\u003cp\u003eDocs add-ons, built using Apps Script, extend functionality by enabling workflow customization, integration with third-party systems, and connectivity with other Google Workspace applications.\u003c/p\u003e\n"],["\u003cp\u003eAdd-ons can manipulate document content, create custom interfaces, and automate tasks through triggers based on specific events.\u003c/p\u003e\n"],["\u003cp\u003eGoogle provides comprehensive documentation and resources, including code samples, to guide developers in building Docs add-ons.\u003c/p\u003e\n"]]],["Google Docs is a cloud-based document solution that can be extended with add-ons via Apps Script. These add-ons can read, edit, visualize, and format text, create custom menus and dialogs, and integrate with other Google Workspace applications. Add-ons utilize Apps Script triggers to run functions when specific events occur. The documents' tree-like structure is managed through the Apps Script Document service. Resources are available, including add-on samples and a quickstart guide, to help begin developing.\n"],null,["# Extending Google Docs with add-ons\n\n[Google Docs](https://workspace.google.com/products/docs/) is a cloud-based document\nsolution with real-time collaboration and powerful tools to compose, edit,\nand share documents.\n\nYou can extend Docs with add-ons that build customized workflow improvements,\nestablish connectivity to third-party systems, and integrate your documents\nwith other Google Workspace applications (like\nGoogle Slides).\n\nYou can see the Docs add-on others have built on the\n[Google Workspace Marketplace](https://workspace.google.com/marketplace/category/works-with-doc).\n\nWhat you can do\n---------------\n\nHere are a few things you can do with an add-on that extends Google Docs:\n\n- You can read, edit, visualize, and format text in Google Docs using the built-in Apps Script [Document service](/apps-script/reference/document). The service also lets you create and modify tables, images, drawings, and equations appearing in Google Docs.\n- You can create [custom menus](/workspace/add-ons/concepts/menus) and define multiple [custom dialogs and sidebars](/workspace/add-ons/concepts/dialogs) interfaces using standard HTML and CSS.\n- You can use add-on [triggers](#triggers) to run specified functions when certain triggering events occur.\n\nDocs add-ons are built using Apps Script. To learn more about how to access\nand manage Google Docs with Apps Script, see\n[Extending Google Docs](/apps-script/guides/docs).\n\nDocument structure\n------------------\n\nThe documents created in Google Docs have internal, tree-like structures\n(similar to HTML or JSON) that define where and how text, images, tables, and\nother elements appear. The Apps Script\n[Document service](/apps-script/reference/document) defines several\nclasses (such as [`Paragraph`](/apps-script/reference/document/paragraph)\nor [`Table`](/apps-script/reference/document/table)) to help manage the\ndifferent element types.\n\nSee [Structure of a document](/apps-script/guides/docs#structure_of_a_document)\nto learn about these element classes and the rules that govern their\narrangement.\n\nTriggers\n--------\n\nApps Script **triggers** let a script project execute a specified function\nwhen certain conditions are met, such as when a document is opened or when an\nadd-on is installed.\n\nSee [add-on triggers](/workspace/add-ons/concepts/editor-triggers) for more information\non what triggers can be used with Docs add-ons and what restrictions apply to\ntheir use.\n\nGetting started\n---------------\n\nWhen you're ready to take a look at some code, check out our\n[add-on samples](/workspace/add-ons/samples), including the\n[Docs add-on Quickstart](/workspace/add-ons/editors/docs/quickstart/translate)\nfeaturing Google Translate."]]
