تتيح لك Google Docs API إنشاء المستندات وتعديلها في "مستندات 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.