تتيح لك واجهة برمجة تطبيقات "مستندات 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الذي يحتوي على عناصر هيكلية أو عناصر محتوى تكون فهارس العناصر ضمن مقطع معيّن مرتبطة ببداية هذا المقطع.- اقتراح
تغييرات على مستند بدون تغيير النص الأصلي وإذا وافق المالك على اقتراحاتك، ستحل محل النص الأصلي.
مواضيع ذات صلة
للتعرّف على كيفية التطوير باستخدام واجهات برمجة التطبيقات في Google Workspace، بما في ذلك التعامل مع المصادقة والتفويض، يُرجى الرجوع إلى التطوير على Google Workspace.
للحصول على نظرة عامة مفاهيمية حول المستند، راجِع المستند.
لمعرفة كيفية ضبط تطبيق يستخدم واجهة برمجة التطبيقات Docs API وتشغيله، جرِّب البدء السريع باستخدام JavaScript.