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