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

تتيح لك Google Docs API إنشاء المستندات وتعديلها في "مستندات Google".

يمكن أن تتكامل التطبيقات مع واجهة برمجة التطبيقات Docs لإنشاء مستندات من كل من البيانات المقدّمة من المستخدم والنظام. تتيح لك واجهة برمجة التطبيقات لـ Docs تساعدك على تنفيذ ما يلي:

  • أتمتة العمليات
  • إنشاء الوثائق بشكل مجمّع
  • تنسيق المستندات
  • إنشاء فواتير أو عقود
  • استرداد سمات معيّنة للكائنات

في ما يلي قائمة بالمصطلحات الشائعة المستخدمة في واجهة برمجة تطبيقات "مستندات 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:

  • للحصول على نظرة عامة مفهومة لأحد المستندات، راجع مستند:

  • للتعرّف على كيفية ضبط تطبيق واجهة برمجة التطبيقات لتطبيق "مستندات Google" وتشغيله، يمكنك تجربة التشغيل السريع لـ JavaScript: