يصف هذا القسم السلوكيات والقيود التي يجب أن تفهمها في تعديل المستندات باستخدام واجهة برمجة تطبيقات محرر مستندات Google.
وبشكل عام، لا يمكنك تنفيذ التعديلات التي تتسبب في بنية غير صالحة
والعناصر داخل الوثيقة. مراجعة كل منها
documents.batchUpdate
طلب طريقة للقيود والقواعد التي تنطبق على تلك القيود
الطلبات.
تلخّص الأقسام التالية القواعد الأساسية لهذه الطرق.
إدراج نص
- يؤدي إدراج حرف جديد إلى إنشاء
Paragraph
في ذلك الوقت الفهرس. يتم نسخ نمط الفقرة للفقرة الجديدة من الفقرة في فهرس الإدراج الحالي، بما في ذلك القوائم والرموز النقطية - يجب إدراج النص داخل حدود
Paragraph
حالية. بالنسبة على سبيل المثال، لا يمكن إدراج نص في فهرس بداية الجدول. يجب أن يكون النص تم إدراجها في الفقرة السابقة. - قد تعدّل واجهة برمجة التطبيقات الموقع الجغرافي ضمنيًا لمنع عمليات الإدراج في مجموعات الرسوم البيانية بيونيكود. وعند حدوث ذلك، يتم إدراج النص مباشرةً بعد المجموعة العنقودية للرسم البياني.
- يتم تحديد أنماط النص للنص المدرج تلقائيًا، بشكل عام من الحفاظ على نمط النص المجاور. عادةً ما يكون نمط النص يتطابق النص المدرج مع النص الموجود قبل فهرس الإدراج مباشرةً.
- بعض أحرف التحكم (
U+0000-U+0008, U+000C-U+001F
) والأحرف من إنّ مساحة الاستخدام الخاص للخطة متعددة اللغات بيونيكود (U+E000-U+F8FF
) هي التي تم إزالتها من النص المدرج. - لمزيد من المعلومات، يُرجى الاطّلاع على المقالة إدراج وحذف ونقل النص.
إدراج صور مضمَّنة
- يجب أن يكون حجم الصورة أقل من 50 ميغابايت، ولا يمكن أن يتجاوز 25 ميغابكسل، ويجب أن أن تكون بتنسيق PNG أو JPEG أو GIF
- يجب أن يكون معرّف الموارد المنتظم (URI) المقدّم متاحًا للجميع، ولا يزيد حجمه عن 2 كيلوبايت.
- يجب إدراج الصورة ضمن حدود
Paragraph
حالية. بالنسبة على سبيل المثال، لا يمكن إدراج نص في فهرس بداية الجدول. - ولا يمكن إدراج الصور داخل حاشية سفلية أو معادلة.
- لمزيد من المعلومات، يُرجى الاطّلاع على إدراج صور مضمَّنة.
تنسيق النص
- عندما تطبق التنسيق على مستوى الفقرة على نطاق، يكون التنسيق يتم تطبيقها على أي فقرة تتداخل معها جزئيًا أو كليًا النطاق.
- ويمكن توسيع النطاق ليشمل سطورًا جديدة مجاورة.
- إذا كان النطاق يحتوي بالكامل على فقرة تنتمي إلى قائمة، فإن قيمة يتم أيضًا تحديث الرمز النقطي بنمط النص المطابق.
- لمعرفة مزيد من المعلومات، يُرجى الاطّلاع على تنسيق النص.
إنشاء التعداد النقطي للفقرات
- تنشئ رموزًا نقطية لكل الفقرات التي تتداخل مع النطاق المحدّد.
- يتم تحديد مستوى التداخل لكل فقرة عن طريق عدد بادئة قبل كل فقرة.
- تتم إزالة علامات التبويب البادئة عند إنشاء الرموز النقطية، مما قد يؤدي إلى تغيير فهارس أجزاء من النص.
- إذا أضفت رموزًا نقطية للفقرات تتطابق مع رموز القائمة قبل إضافة الفقرة المستهدفة، يتم ضم الفقرة إلى القائمة.
- لمزيدٍ من المعلومات، يُرجى الاطّلاع على العمل باستخدام القوائم.
حذف النص
قد يؤدي حذف النص الذي يتخطى حدود الفقرة إلى إجراء تغييرات على وأنماط الفقرات والقوائم والكائنات الموضوعة والإشارات المرجعية كاثنين يتم دمج الفقرات.
لا يُسمح بعمليات الحذف التي تتسبب في بنية مستند غير صالحة. بعض الإشعارات تشمل أمثلة طلبات الحذف غير الصالحة ما يلي:
حذف وحدة رمز واحدة لزوج بديل.
حذف آخر حرف جديد في
Body
,Header
,Footer
,Footnote
,TableCell
، أوTableOfContents
.حذف بداية أو نهاية
Table
,TableOfContents
، أوEquation
بدون حذف العنصر بأكمله.حذف حرف السطر الجديد قبل
Table
أوTableOfContents
أوSectionBreak
دون حذف العنصر.حذف صفوف أو خلايا فردية من الجدول. حذف المحتوى في خلية جدول.
لمزيد من المعلومات، يُرجى الاطّلاع على القسم إدراج وحذف ونقل النص.