قواعد وسلوك التعديل الهيكلي

يوضّح هذا القسم السلوكيات والقيود التي يجب أن تفهمها عند تعديل المستندات باستخدام Google Docs API.

بشكل عام، لا يمكنك تنفيذ تعديلات تتسبب في حدوث بنية غير صالحة للعناصر داخل المستند. راجِع كل طريقة من طرق طلب documents.batchUpdate لمعرفة القيود والقواعد التي تنطبق على تلك الطلبات.

تلخِّص الأقسام التالية القواعد الرئيسية المتعلّقة بهذه الطرق.

إدراج نص

  • يؤدي إدراج حرف سطر جديد إلى إنشاء Paragraph ضمن ذلك الفهرس. يتم نسخ نمط الفقرة للفقرة الجديدة من الفقرة في فهرس الإدراج الحالي، بما في ذلك القوائم والرموز النقطية.
  • يجب إدراج النص ضمن حدود Paragraph حالي. على سبيل المثال، لا يمكن إدراج النص في فهرس بداية الجدول. يجب إدراج النص في الفقرة السابقة.
  • قد تعدِّل واجهة برمجة التطبيقات الموقع ضمنيًا لمنع الإدراج في مجموعات الرسوم البيانية بترميز Unicode. عندما يحدث هذا، يتم إدراج النص مباشرةً بعد مجموعة الرسومات البيانية.
  • ويتم تحديد أنماط النص للنص المدرج تلقائيًا، مع الحفاظ بشكل عام على نمط النص المجاور. عادةً ما يتطابق نمط النص للنص المدرج مع النص قبل فهرس الإدراج مباشرةً.
  • تتم إزالة بعض أحرف التحكّم (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 بدون حذف العنصر

    • حذف صفوف أو خلايا فردية من جدول. يُسمح بحذف المحتوى في خلية جدول.

  • لمزيد من المعلومات، يُرجى الاطّلاع على القسم إدراج نص وحذفه ونقله.