نظرة عامة على Google Docs API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك واجهة برمجة تطبيقات "مستندات Google" إنشاء المستندات وتعديلها في "مستندات Google".
يمكن للتطبيقات الدمج مع Docs API لإنشاء مستندات مصقولة من البيانات التي يقدّمها المستخدم والنظام. تتيح لك واجهة Docs API إجراء ما يلي:
- التشغيل الآلي للعمليات
- إنشاء مستندات بشكل مجمّع
- تنسيق المستندات
- إنشاء فواتير أو عقود
- استرداد سمات محدّدة للكائنات
في ما يلي قائمة بالمصطلحات الشائعة المستخدَمة في Docs API:
- رقم تعريف المستند
المعرّف الفريد للمستند. وهي سلسلة معيّنة تحتوي على أحرف وأرقام وبعض الرموز الخاصة التي تشير إلى مستند، ويمكن استخراجها من عنوان URL الخاص بالمستند. تكون معرّفات المستندات ثابتة، حتى إذا تغيّر اسم المستند. لمزيد من المعلومات حول كيفية العثور على رقم التعريف، يُرجى الاطّلاع على مقالة رقم تعريف المستند.
https://docs.google.com/document/d/DOCUMENT_ID/edit
- العنصر
البنية التي يتكوّن منها المستند تشمل عناصر المستوى الأعلى في المستند Body وDocumentStyle وList.
- مستند Google Workspace
ملف ينشئه أحد تطبيقات Google Workspace، مثل "مستندات Google"
تنسيق نوع MIME في "مستندات Google" هو
application/vnd.google-apps.document. للاطّلاع على قائمة بأنواع MIME، يُرجى الرجوع إلى
أنواع MIME المتوافقة في Google Workspace وGoogle Drive.
- الفهرس
تتضمّن معظم العناصر ضمن نص المحتوى السمتَين startIndex وendIndex. تشير هذه القيم إلى إزاحة بداية عنصر ونهايته،
بالنسبة إلى بداية المقطع الحاوي.
- صورة مضمّنة
صورة تظهر في سياق النص داخل مستند وهي ليست
مرفقًا.
- النطاق المُعنوَن
نطاق متجاور من النص NamedRange هو مجموعة من النطاقات التي لها namedRangeId نفسه. تسمح النطاقات المسماة للمطوّرين بربط أجزاء من مستند بتصنيف عشوائي يحدّده المستخدم، ما يتيح قراءة محتواه أو تعديله برمجيًا في وقت لاحق. يمكن أن يحتوي المستند على نطاقات مُسمّاة متعددة تحمل الاسم نفسه، ولكن لكل نطاق مُسمّى رقم تعريف فريد.
- القسم
العنصر Body أو Header أو Footer أو Footnote الذي يحتوي على عناصر هيكلية أو عناصر محتوى تكون فهارس العناصر ضمن مقطع معيّن مرتبطة ببداية هذا المقطع.
- اقتراح
تغييرات على مستند بدون تغيير النص الأصلي وإذا وافق المالك على اقتراحاتك، ستحل محل النص الأصلي.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Google Docs API overview\n\nThe Google Docs API lets you create and modify documents in Google Docs.\n\nApplications can integrate with the Docs API to create polished\ndocuments from both user and system-provided data. The Docs API lets\nyou:\n\n- Automate processes\n- Create documentation in bulk\n- Format documents\n- Generate invoices or contracts\n- Retrieve specific attributes of objects\n\nThe following is a list of common terms used in the Docs API:\n\n*Document ID*\n\n: The unique identifier for a document. It's a particular string containing\n letters, numbers, and some special characters that reference a document and\n it can be derived from the document's URL. Document IDs are stable, even if\n the document name changes. For more information on how to find the ID, see\n [Document ID](/workspace/docs/api/concepts/document#document-id).\n\n https://docs.google.com/document/d/\u003cvar translate=\"no\"\u003eDOCUMENT_ID\u003c/var\u003e/edit\n\n*Element*\n\n: The structure that makes up a document. Top-level elements of a document\n include the [`Body`](/workspace/docs/api/reference/rest/v1/documents#body),\n [`DocumentStyle`](/workspace/docs/api/reference/rest/v1/documents#documentstyle), and\n [`List`](/workspace/docs/api/reference/rest/v1/documents#list).\n\n*Google Workspace document*\n\n: A file that a Google Workspace application, like Google Docs, creates.\n The MIME type format for Docs is\n `application/vnd.google-apps.document`. For a list of MIME types, see [Google Workspace and Google Drive supported MIME types](/drive/api/guides/mime-types).\n\n*Index*\n\n: Most *elements* within the content body have the `startIndex` and `endIndex`\n properties. These indicate the offset of an element's beginning and end,\n relative to the beginning of its enclosing *segment*.\n\n*Inline image*\n\n: An image that appears in the flow of text within a document. It's not an\n attachment.\n\n*Named range*\n\n: A contiguous range of text. A\n [`NamedRange`](/workspace/docs/api/reference/rest/v1/documents#namedrange) is a\n collection of ranges with the same `namedRangeId`. Named ranges allow\n developers to associate parts of a document with an arbitrary user-defined\n label so their contents can be programmatically read or edited later. A\n document can contain multiple named ranges with the same name, but every\n named range has a unique ID.\n\n*Segment*\n\n: The `Body`, [`Header`](/workspace/docs/api/reference/rest/v1/documents#header),\n [`Footer`](/workspace/docs/api/reference/rest/v1/documents#footer), or\n [`Footnote`](/workspace/docs/api/reference/rest/v1/documents#footnote) containing\n structural or content *elements* . The *indexes* of the elements within a\n segment are relative to the beginning of that segment.\n\n*Suggestion*\n\n: Changes to a document without changing the original text. If the owner\n approves your suggestions, they replace the original text.\n\nRelated topics\n--------------\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer to [Develop on\n Google Workspace](/workspace/guides/get-started).\n\n- To get a conceptual overview of a document, see\n [Document](/workspace/docs/api/concepts/document).\n\n- To learn how to configure and run a Docs API app, try the\n [JavaScript quickstart](/workspace/docs/api/quickstart/js)."]]
