نظرة عامة على Google Docs API

تتيح لك واجهة برمجة التطبيقات 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 الذي يتضمّن عناصر هيكلية أو عناصر محتوى تكون فهارس العناصر ضمن مقطع معيّن مرتبطة ببداية هذا المقطع.

اقتراح

تغييرات على مستند بدون تغيير النص الأصلي وإذا وافق المالك على اقتراحاتك، ستحل محل النص الأصلي.