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