Requests

الطلب

تعديل واحد لتطبيقه على مستند.

تمثيل JSON 
{

  // Union field request can be only one of the following:
  "replaceAllText": {
    object (ReplaceAllTextRequest)
  },
  "insertText": {
    object (InsertTextRequest)
  },
  "updateTextStyle": {
    object (UpdateTextStyleRequest)
  },
  "createParagraphBullets": {
    object (CreateParagraphBulletsRequest)
  },
  "deleteParagraphBullets": {
    object (DeleteParagraphBulletsRequest)
  },
  "createNamedRange": {
    object (CreateNamedRangeRequest)
  },
  "deleteNamedRange": {
    object (DeleteNamedRangeRequest)
  },
  "updateParagraphStyle": {
    object (UpdateParagraphStyleRequest)
  },
  "deleteContentRange": {
    object (DeleteContentRangeRequest)
  },
  "insertInlineImage": {
    object (InsertInlineImageRequest)
  },
  "insertTable": {
    object (InsertTableRequest)
  },
  "insertTableRow": {
    object (InsertTableRowRequest)
  },
  "insertTableColumn": {
    object (InsertTableColumnRequest)
  },
  "deleteTableRow": {
    object (DeleteTableRowRequest)
  },
  "deleteTableColumn": {
    object (DeleteTableColumnRequest)
  },
  "insertPageBreak": {
    object (InsertPageBreakRequest)
  },
  "deletePositionedObject": {
    object (DeletePositionedObjectRequest)
  },
  "updateTableColumnProperties": {
    object (UpdateTableColumnPropertiesRequest)
  },
  "updateTableCellStyle": {
    object (UpdateTableCellStyleRequest)
  },
  "updateTableRowStyle": {
    object (UpdateTableRowStyleRequest)
  },
  "replaceImage": {
    object (ReplaceImageRequest)
  },
  "updateDocumentStyle": {
    object (UpdateDocumentStyleRequest)
  },
  "mergeTableCells": {
    object (MergeTableCellsRequest)
  },
  "unmergeTableCells": {
    object (UnmergeTableCellsRequest)
  },
  "createHeader": {
    object (CreateHeaderRequest)
  },
  "createFooter": {
    object (CreateFooterRequest)
  },
  "createFootnote": {
    object (CreateFootnoteRequest)
  },
  "replaceNamedRangeContent": {
    object (ReplaceNamedRangeContentRequest)
  },
  "updateSectionStyle": {
    object (UpdateSectionStyleRequest)
  },
  "insertSectionBreak": {
    object (InsertSectionBreakRequest)
  },
  "deleteHeader": {
    object (DeleteHeaderRequest)
  },
  "deleteFooter": {
    object (DeleteFooterRequest)
  },
  "pinTableHeaderRows": {
    object (PinTableHeaderRowsRequest)
  }
  // End of list of possible types for union field request.
}
الحقول
حقل الاتحاد request. تمثّل هذه السمة الطلب المحدّد المطلوب تطبيقه. يجب توفّر حقل واحد بالضبط. يمكن أن تكون السمة request واحدة فقط من العناصر التالية:
replaceAllText

object (ReplaceAllTextRequest)

استبدال جميع مثيلات النص المحدد.

insertText

object (InsertTextRequest)

إدراج نص في الموقع المحدّد

updateTextStyle

object (UpdateTextStyleRequest)

يعدّل نمط النص في النطاق المحدد.

createParagraphBullets

object (CreateParagraphBulletsRequest)

تنشئ التعداد النقطي للفقرات.

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

حذف التعداد النقطي من الفقرات

createNamedRange

object (CreateNamedRangeRequest)

تنشئ نطاقًا مُعنوَنًا.

deleteNamedRange

object (DeleteNamedRangeRequest)

حذف نطاق مُعنوَن

updateParagraphStyle

object (UpdateParagraphStyleRequest)

تعديل نمط الفقرة في النطاق المحدد.

deleteContentRange

object (DeleteContentRangeRequest)

حذف المحتوى من المستند

insertInlineImage

object (InsertInlineImageRequest)

إدراج صورة مضمّنة في الموقع المحدّد

insertTable

object (InsertTableRequest)

إدراج جدول في الموقع المحدّد

insertTableRow

object (InsertTableRowRequest)

إدراج صف فارغ في جدول

insertTableColumn

object (InsertTableColumnRequest)

إدراج عمود فارغ في الجدول

deleteTableRow

object (DeleteTableRowRequest)

لحذف صف من الجدول.

deleteTableColumn

object (DeleteTableColumnRequest)

حذف عمود من الجدول

insertPageBreak

object (InsertPageBreakRequest)

إدراج فاصل صفحة في المكان المحدّد

deletePositionedObject

object (DeletePositionedObjectRequest)

حذف عنصر تم تحديد موضعه من المستند

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

تعدّل خصائص الأعمدة في الجدول.

updateTableCellStyle

object (UpdateTableCellStyleRequest)

تعديل نمط خلايا الجدول

updateTableRowStyle

object (UpdateTableRowStyleRequest)

يعدّل نمط الصف في الجدول.

replaceImage

object (ReplaceImageRequest)

تستبدل صورة في المستند.

updateDocumentStyle

object (UpdateDocumentStyleRequest)

يعدِّل نمط المستند.

mergeTableCells

object (MergeTableCellsRequest)

لدمج الخلايا في جدول

unmergeTableCells

object (UnmergeTableCellsRequest)

يتم إلغاء دمج الخلايا في الجدول.

createHeader

object (CreateHeaderRequest)

تنشئ عنوانًا.

createFootnote

object (CreateFootnoteRequest)

تنشئ حاشية سفلية.

replaceNamedRangeContent

object (ReplaceNamedRangeContentRequest)

لاستبدال المحتوى في نطاق مُعنوَن.

updateSectionStyle

object (UpdateSectionStyleRequest)

تعديل نمط القسم للنطاق المحدَّد.

insertSectionBreak

object (InsertSectionBreakRequest)

إدراج فاصل أقسام في الموقع المحدّد

deleteHeader

object (DeleteHeaderRequest)

حذف عنوان من المستند

pinTableHeaderRows

object (PinTableHeaderRowsRequest)

يعدِّل عدد صفوف العناوين المُثبَّتة في جدول.

استبدال كل النصوص

استبدال جميع مثيلات النص المطابق لمعايير بـ replace text.

تمثيل JSON 
{
  "replaceText": string,

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.
}
الحقول
replaceText

string

النص الذي سيحل محل النص المطابق

حقل الاتحاد criteria. المعايير المستخدمة لمطابقة النص المطلوب استبداله. يمكن أن تكون السمة criteria واحدة فقط من العناصر التالية:
containsText

object (SubstringMatchCriteria)

يعثر على النص في المستند الذي يطابق هذه السلسلة الفرعية.

سلسلة فرعية للمعايير

معيار يتطابق مع سلسلة نصية محدّدة في المستند.

تمثيل JSON 
{
  "text": string,
  "matchCase": boolean
}
الحقول
text

string

النص المطلوب البحث عنه في المستند.

matchCase

boolean

تحدّد هذه السياسة ما إذا كان البحث يجب أن يحترم حالة الأحرف التالية:

  • True : عملية البحث حساسة لحالة الأحرف.
  • False : عملية البحث غير حساسة لحالة الأحرف.

طلب نص

إدراج نص في الموقع المحدّد

تمثيل JSON 
{
  "text": string,

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
الحقول
text

string

النص الذي سيتم إدراجه.

وسيؤدي إدراج حرف جديد ضمنيًا إلى إنشاء Paragraph جديد في ذلك الفهرس. سيتم نسخ نمط الفقرة الجديدة من الفقرة في فهرس الإدراج الحالي، بما في ذلك القوائم والقوائم النقطية.

سيتم تحديد أنماط النص للنص الذي يتم إدراجه تلقائيًا، مع الحفاظ على نمط النص المجاور بشكل عام. في معظم الحالات، يتطابق نمط النص للنص الذي تم إدراجه مع النص الذي يظهر قبل فهرس الإدراج مباشرةً.

ستتم إزالة بعض أحرف التحكم (U+0000-U+0008 وU+000C-U+001F) والأحرف من منطقة الاستخدام الخاص لأساسيات الخطة المتعددة اللغات على يونيكود (U+E000-U+F8FF).

حقل الاتحاد insertion_location. الموقع الذي سيتم إدراج النص فيه. يمكن أن تكون السمة insertion_location واحدة فقط من العناصر التالية:
location

object (Location)

إدراج النص في فهرس محدد في المستند.

يجب إدراج النص داخل حدود Paragraph الحالية. على سبيل المثال، لا يمكن إدراج نص في فهرس بدء الجدول (أي بين الجدول والفقرة السابقة له). يجب إدراج النص في الفقرة السابقة.

endOfSegmentLocation

object (EndOfSegmentLocation)

إدراج نص في نهاية الرأس أو التذييل أو الحاشية السفلية أو نص المستند

الموقع الجغرافي

موقع معيّن في المستند.

تمثيل JSON 
{
  "segmentId": string,
  "index": integer
}
الحقول
segmentId

string

رقم تعريف العنوان أو التذييل أو الحاشية السفلية التي كان الموقع الجغرافي فيها يشير رقم تعريف الشريحة الفارغ إلى نص المستند.

index

integer

الفهرس المستند إلى الصفر، بوحدات رموز UTF-16.

يرتبط المؤشر ببداية الشريحة التي تحدّدها segmentId.

نهاية الشريحة

الموقع الجغرافي في نهاية نص العنوان أو العنوان أو التذييل أو الحاشية السفلية يقع الموقع مباشرةً قبل السطر الأخير الأخير في شريحة المستند.

تمثيل JSON 
{
  "segmentId": string
}
الحقول
segmentId

string

رقم تعريف العنوان أو التذييل أو الحاشية السفلية التي كان الموقع الجغرافي فيها يشير رقم تعريف الشريحة الفارغ إلى نص المستند.

تعديل نمط النص

عدِّل نمط النص.

تمثيل JSON 
{
  "textStyle": {
    object (TextStyle)
  },
  "fields": string,

  // Union field insertion_location can be only one of the following:
  "range": {
    object (Range)
  }
  // End of list of possible types for union field insertion_location.
}
الحقول
textStyle

object (TextStyle)

الأنماط المطلوب ضبطها على النص.

إذا كانت قيمة نمط معيّن تتطابق مع قيمة النمط الرئيسي، سيتم ضبط هذا النمط على اكتساب.

قد تتسبب تغييرات معينة في نمط النص في إجراء تغييرات أخرى من أجل انعكاس سلوك أداة تحرير المستندات. يمكنك الاطّلاع على مستندات TextStyle للحصول على مزيد من المعلومات.

fields

string (FieldMask format)

الحقول التي يجب تعديلها.

يجب تحديد حقل واحد على الأقل. إنّ الجذر textStyle هو ضمني ويجب عدم تحديده. يمكن استخدام "*" واحدة كاختصار لإدراج كل حقل.

على سبيل المثال، لتعديل نمط النص بالخط الغامق، اضبط fields على "bold".

لإعادة ضبط السمة على قيمتها التلقائية، يجب تضمين اسم الحقل في قناع الحقل مع ترك الحقل نفسه بدون ضبط.

حقل الاتحاد insertion_location. نوع النطاق المستخدَم في تعديل نمط النص. يمكن أن تكون السمة insertion_location واحدة فقط من العناصر التالية:
range

object (Range)

نطاق النص للأسلوب.

يمكن توسيع النطاق ليشمل أسطر جديدة.

إذا كان النطاق يحتوي بالكامل على فقرة تنتمي إلى قائمة، يتم أيضًا تعديل النقطة في الفقرة بنمط النمط المطابق.

لا يمكن إدراج النطاقات داخل نوع UpdateTextStyleRequest نسبي.

إنشاء طلب ParagraphBullets

يتم إنشاء رموز نقطية لجميع الفقرات التي تتداخل مع النطاق المحدّد.

يتم تحديد مستوى التداخل لكل فقرة من خلال حساب علامات التبويب الرئيسية أمام كل فقرة. لتجنب المسافة الزائدة بين النقطة النقطية والفقرة المقابلة، تتم إزالة علامات التبويب الرئيسية هذه عن طريق هذا الطلب. وقد يؤدي هذا إلى تغيير فهارس أجزاء النص.

إذا كانت الفقرة التي تسبق تعديل الفقرات مباشرةً في قائمة تتضمّن إعدادًا مسبقًا مطابقًا، تتم إضافة الفقرات التي يتم تعديلها إلى تلك القائمة السابقة.

تمثيل JSON 
{
  "range": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}
الحقول
range

object (Range)

النطاق المراد تطبيق الإعداد المسبق لعنصر القائمة النقطية عليه.

bulletPreset

enum (BulletGlyphPreset)

أنواع الرموز الرسومية النقطية التي سيتم استخدامها.

BulletGlyphPreset

الأنماط المُعدَّة مسبقًا للنصوص البرمجية للقوائم.

تستخدم هذه الأنماط هذه الأنواع من التعداد النقطي:

  • ARROW : سهم، يتوافق مع نقطة رمز يونيكود U+2794
  • ARROW3D : سهم بتظليل ثلاثي الأبعاد، يقابل نقطة رمز يونيكود U+27a2
  • CHECKBOX : مربّع مجوف يقابل نقطة الرمز يونيكود U+274f
  • CIRCLE : دائرة مفرغة، مقابل نقطة رمز يونيكود U+25cb
  • DIAMOND : ماسة ثابتة، مقابل نقطة رمز يونيكود U+25c6
  • DIAMONDX : الشكل الماسي الذي يتضمّن علامة x، مطابقًا لنقطة الرمز يونيكود U+2756
  • HOLLOWDIAMOND : ماسة مفرغة، مقابل نقطة رمز يونيكود U+25c7
  • DISC : دائرة متصلة تقابل نقطة رمز يونيكود U+25cf
  • SQUARE : مربّع متصل يطابق نقطة الرمز يونيكود U+25a0
  • STAR : نجمة، تتطابق مع نقطة رمز يونيكود U+2605
  • ALPHA : حرف صغير، مثل "a" أو "b" أو "c".
  • UPPERALPHA : حرف كبير، مثل "A" أو "B" أو "C".
  • DECIMAL : رقم، مثل "1" أو "2" أو "3".
  • ZERODECIMAL : رقم يتم فيه احتساب الرقم المكوّن من رقم واحد مسبوقًا بصفر، مثل "01" أو "02" أو "03". إنّ الأرقام التي تحتوي على أكثر من رقم لا تكون مسبوقة بصفر.
  • ROMAN : رقم روماني صغير، مثل 'i' أو 'ii' أو 'iii'.
  • UPPERROMAN : رقم روماني كبير، مثل "I" أو "II" أو "III".
  • LEFTTRIANGLE : مثلث يشير إلى اليسار ويقابل نقطة رمز يونيكود U+25c4
عمليات التعداد
BULLET_GLYPH_PRESET_UNSPECIFIED ولم يتم تحديد الإعداد المُعدَّل للرسومات النقطية.
BULLET_DISC_CIRCLE_SQUARE قائمة نقطية تتضمّن حرفَي DISC وCIRCLE وSQUARE لأوّل 3 مستويات دمج في القائمة
BULLET_DIAMONDX_ARROW3D_SQUARE قائمة نقطية تتضمّن حرفَي DIAMONDX وARROW3D وSQUARE لأوّل 3 مستويات دمج في القائمة
BULLET_CHECKBOX قائمة نقطية تتضمّن رموزًا نصية نقطية CHECKBOX لجميع مستويات دمج القوائم
BULLET_ARROW_DIAMOND_DISC قائمة نقطية تتضمّن حرفَي ARROW وDIAMOND وDISC لأوّل 3 مستويات دمج في القائمة
BULLET_STAR_CIRCLE_SQUARE قائمة نقطية تتضمّن حرفَي STAR وCIRCLE وSQUARE لأوّل 3 مستويات دمج في القائمة
BULLET_ARROW3D_CIRCLE_SQUARE قائمة نقطية تتضمّن حرفَي ARROW3D وCIRCLE وSQUARE لأوّل 3 مستويات دمج في القائمة
BULLET_LEFTTRIANGLE_DIAMOND_DISC قائمة نقطية تتضمّن حرفَي LEFTTRIANGLE وDIAMOND وDISC لأوّل 3 مستويات دمج في القائمة
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE قائمة نقطية تتضمّن حرفَي DIAMONDX وHOLLOWDIAMOND وSQUARE لأوّل 3 مستويات دمج في القائمة
BULLET_DIAMOND_CIRCLE_SQUARE قائمة نقطية تتضمّن حرفَي DIAMOND وCIRCLE وSQUARE لأوّل 3 مستويات دمج في القائمة
NUMBERED_DECIMAL_ALPHA_ROMAN قائمة مرقّمة تتضمّن DECIMAL و ALPHA وROMAN رموز رسومية رقمية لأول 3 مستويات لدمج القائمة، متبوعةً بنقاط.
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS قائمة مرقّمة تتضمّن DECIMAL و ALPHA وROMAN حروف رسومية رقمية لأول 3 مستويات لإدراجها متبوعة بأقواس.
NUMBERED_DECIMAL_NESTED قائمة مرقّمة تتضمّن حروفًا أبجدية رقمية مكوّنة من DECIMAL مع الفصل بينها بنقاط، حيث يستخدم كل مستوى دمج الرمز الرسومي لمستوى التداخل السابق كبادئة. على سبيل المثال: "1." "1.1". '2.', "2.2".
NUMBERED_UPPERALPHA_ALPHA_ROMAN قائمة مرقّمة تتضمّن UPPERALPHA و ALPHA وROMAN رموز رسومية رقمية لأول 3 مستويات لدمج القائمة، متبوعةً بنقاط.
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL قائمة مرقّمة تتضمّن UPPERROMAN و UPPERALPHA وDECIMAL رموز رسومية رقمية لأول 3 مستويات لدمج القائمة، متبوعةً بنقاط.
NUMBERED_ZERODECIMAL_ALPHA_ROMAN قائمة مرقّمة تتضمّن ZERODECIMAL و ALPHA وROMAN رموز رسومية رقمية لأول 3 مستويات لدمج القائمة، متبوعةً بنقاط.

حذف حذفPARgraphBulletsRequest

حذف التعداد النقطي من جميع الفقرات التي تتداخل مع النطاق المحدد.

سيتم الاحتفاظ بمستوى التداخل لكل فقرة بشكل مرئي عن طريق إضافة مسافة بادئة إلى بداية الفقرة المقابلة.

تمثيل JSON 
{
  "range": {
    object (Range)
  }
}
الحقول
range

object (Range)

النطاق المراد حذف الرموز النقطية منه.

CreateNamedRangeRequest (إنشاء طلب)

تنشئ السمة NamedRange للإشارة إلى النطاق المحدّد.

تمثيل JSON 
{
  "name": string,
  "range": {
    object (Range)
  }
}
الحقول
name

string

اسم NameNameRange. ليس بالضرورة أن تكون الأسماء فريدة.

يجب أن تحتوي الأسماء على حرف واحد على الأقل ولا يزيد عن 256 حرفًا، ويتم قياسها بوحدات رموز UTF-16.

range

object (Range)

النطاق المراد تطبيق الاسم عليه.

حذفNameNameRangeRequest

حذف NamedRange

تمثيل JSON 
{

  // Union field named_range_reference can be only one of the following:
  "namedRangeId": string,
  "name": string
  // End of list of possible types for union field named_range_reference.
}
الحقول
حقل الاتحاد named_range_reference. القيمة التي تحدد النطاق أو النطاقات المطلوب حذفها. ويجب ضبط معرّف واحد بالضبط. يمكن أن تكون السمة named_range_reference واحدة فقط من العناصر التالية:
namedRangeId

string

رقم تعريف النطاق المُعنوَن المراد حذفه

name

string

اسم النطاقات التي سيتم حذفها سيتم حذف جميع النطاقات المُعنونة بالاسم نفسه.

تعديل ParagraphStyleRequest

تعديل تصميم جميع الفقرات التي تتداخل مع النطاق المحدد.

تمثيل JSON 
{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "fields": string,

  // Union field insertion_location can be only one of the following:
  "range": {
    object (Range)
  }
  // End of list of possible types for union field insertion_location.
}
الحقول
paragraphStyle

object (ParagraphStyle)

الأنماط المطلوب ضبطها على الفقرات.

قد تتسبب تغييرات معينة في نمط الفقرة في إجراء تغييرات أخرى من أجل انعكاس سلوك أداة تحرير المستندات. يمكنك الاطّلاع على مستندات ParagraphStyle للحصول على مزيد من المعلومات.

fields

string (FieldMask format)

الحقول التي يجب تعديلها.

يجب تحديد حقل واحد على الأقل. إنّ الجذر paragraphStyle هو ضمني ويجب عدم تحديده. يمكن استخدام "*" واحدة كاختصار لإدراج كل حقل.

على سبيل المثال، لتعديل سمة محاذاة نمط الفقرة، اضبط fields على "alignment".

لإعادة ضبط السمة على قيمتها التلقائية، يجب تضمين اسم الحقل في قناع الحقل مع ترك الحقل نفسه بدون ضبط.

حقل الاتحاد insertion_location. نوع النطاق المستخدَم حيث سيتم تعديل نمط الفقرة. يمكن أن تكون السمة insertion_location واحدة فقط من العناصر التالية:
range

object (Range)

النطاق الذي يتداخل مع الفقرة.

طلب حذف المحتوى

حذف المحتوى من المستند

تمثيل JSON 
{
  "range": {
    object (Range)
  }
}
الحقول
range

object (Range)

نطاق المحتوى المطلوب حذفه

قد يؤدي حذف النص الذي يتجاوز حدود الفقرة إلى إجراء تغييرات على أنماط الفقرة والقوائم والكائنات الموضوعة والإشارات المرجعية أثناء دمج الفقرتين.

يمكن أن تؤدي محاولة حذف نطاقات معيَّنة إلى بنية مستند غير صالحة، وفي هذه الحالة سيتم عرض الخطأ "400" غير صحيح في الطلب.

إليك بعض الأمثلة عن طلبات الحذف غير الصالحة:

  • حذف وحدة رمز واحدة لزوج بديل
  • حذف الحرف الأخير الأخير من Body أو Header أو Footer أو Footnote أو TableCell أو TableOfContents
  • حذف بداية أو نهاية السمة Table أو السمة TableOfContents أو Equation بدون حذف العنصر بأكمله
  • حذف الحرف الجديد قبل Table أو TableOfContents أو SectionBreak بدون حذف العنصر
  • حذف صفوف أو خلايا فردية في الجدول يُسمح بحذف المحتوى داخل خلية في الجدول.

طلب إدراج صورة مضمّنة

يتم إدراج InlineObject التي تحتوي على صورة في الموقع الجغرافي المحدّد.

تمثيل JSON 
{
  "uri": string,
  "objectSize": {
    object (Size)
  },

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
الحقول
uri

string

معرّف الموارد المنتظم (URI) للصورة.

يتم استرجاع الصورة مرة واحدة عند إدراجها ويتم تخزين نسخة لعرضها داخل المستند. يجب أن يكون حجم الصور أقل من 50 ميغابايت، وألا تتجاوز 25 ميغابكسل، ويجب أن تكون بأحد تنسيقات PNG أو JPEG أو GIF.

يجب أن يكون الوصول إلى معرّف الموارد المنتظم (URI) المتاح للجميع متاحًا للجميع وأن يبلغ طوله 2 كيلوبايت كحد أقصى. يتم حفظ معرّف الموارد المنتظم (URI) نفسه مع الصورة، ويتم عرضه عبر الحقل ImageProperties.content_uri.

objectSize

object (Size)

الحجم الذي يجب أن تظهر به الصورة في المستند. هذه السمة اختيارية، ويتم تحديد الحجم النهائي للصورة في المستند من خلال القواعد التالية: * إذا لم يتم تحديد العرض أو الارتفاع، سيتم حساب الحجم التلقائي للصورة استنادًا إلى درجة دقتها. * في حال تحديد سمة واحدة، يتم احتساب السمة الأخرى للحفاظ على نسبة العرض إلى الارتفاع للصورة. * في حال تحديد كل من العرض والارتفاع، سيتم تعديل حجم الصورة لتلائم الأبعاد المتوفرة مع الحفاظ على نسبة العرض إلى الارتفاع.

حقل الاتحاد insertion_location. الموقع الذي سيتم إدراج الصورة فيه يمكن أن تكون السمة insertion_location واحدة فقط من العناصر التالية:
location

object (Location)

يتم إدراج الصورة في فهرس محدّد في المستند.

يجب إدراج الصورة داخل حدود Paragraph الحالية. على سبيل المثال، لا يمكن إدراجه في فهرس بدء الجدول (أي بين الجدول والفقرة السابقة).

لا يمكن إدراج الصور المضمّنة داخل حاشية سفلية أو معادلة.

endOfSegmentLocation

object (EndOfSegmentLocation)

إدراج نص في نهاية الرأس أو التذييل أو نص المستند.

لا يمكن إدراج الصور المضمّنة داخل الحاشية السفلية.

طلب الجدول

إدراج جدول في الموقع المحدّد

سيتم إدراج حرف سطر جديد قبل الجدول الذي تم إدخاله.

تمثيل JSON 
{
  "rows": integer,
  "columns": integer,

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
الحقول
rows

integer

عدد الصفوف في الجدول.

columns

integer

عدد الأعمدة في الجدول.

حقل الاتحاد insertion_location. الموقع الذي سيتم إدراج الجدول فيه. يمكن أن تكون السمة insertion_location واحدة فقط من العناصر التالية:
location

object (Location)

إدراج الجدول في فهرس نموذج معيّن.

سيتم إدراج حرف سطر جديد قبل الجدول الذي تم إدراجه، وبالتالي سيكون فهرس بدء الجدول في فهرس الموقع المحدّد + 1.

يجب إدراج الجدول داخل حدود Paragraph الحالية. على سبيل المثال، لا يمكن إدراجه في فهرس بدء الجدول (أي بين جدول حالي وفقرته السابقة).

لا يمكن إدراج الجداول داخل حاشية سفلية أو معادلة.

endOfSegmentLocation

object (EndOfSegmentLocation)

إدراج الجدول في نهاية الرأس أو التذييل أو نص المستند المحدد. سيتم إدراج حرف سطر جديد قبل الجدول الذي تم إدخاله.

لا يمكن إدراج الجداول داخل حاشية سفلية.

طلب جدولة الجدول

إدراج صف فارغ في جدول

تمثيل JSON 
{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean
}
الحقول
tableCellLocation

object (TableCellLocation)

موقع الخلايا في الجدول المرجعي الذي سيتم إدراج الصفوف منه

سيتم إدراج صف جديد أعلى (أو أدناه) الصف الذي تحتوي عليه الخلية المرجعية. إذا كانت الخلية المرجعية هي خلية مدمجة، سيتم إدراج صف جديد أعلى (أو أدناه) الخلية التي تم دمجها.

insertBelow

boolean

ما إذا كان سيتم إدراج صف جديد أسفل موقع الخلية المرجعية.

  • True : أدرِجها تحت الخلية.
  • False : إدراج أعلى الخلية.

TableCellularLocation

موقع خلية واحدة داخل جدول.

تمثيل JSON 
{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndex": integer,
  "columnIndex": integer
}
الحقول
tableStartLocation

object (Location)

مكان بدء الجدول في المستند.

rowIndex

integer

فهرس الصف المستند إلى الصفر. على سبيل المثال، يحتوي الصف الثاني في الجدول على فهرس للصف 1.

columnIndex

integer

فهرس العمود المستند إلى الصفر. على سبيل المثال، يحتوي العمود الثاني في الجدول على فهرس للعمود 1.

طلب عمود الجدول

إدراج عمود فارغ في الجدول

تمثيل JSON 
{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean
}
الحقول
tableCellLocation

object (TableCellLocation)

موقع الخلايا في الجدول المرجعي الذي سيتم إدراج الأعمدة منه

سيتم إدراج عمود جديد على يسار (أو يمين) العمود الذي تتوفّر فيه الخلية المرجعية. إذا كانت الخلية المرجعية هي خلية مدمَجة، سيتم إدراج عمود جديد على يسار الخلية (أو على يمينها).

insertRight

boolean

ما إذا كان سيتم إدراج عمود جديد على يسار موقع الخلية المرجعية.

  • True : إدراج إلى اليسار
  • False : إدراج إلى اليمين.

حذفطلب الجدول

لحذف صف من الجدول.

تمثيل JSON 
{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}
الحقول
tableCellLocation

object (TableCellLocation)

موقع الخلية في الجدول المرجعي الذي سيتم حذف الصف منه

سيتم حذف الصف الذي تمتد فيه هذه الخلية. إذا كانت هذه الخلية مدمجة وتمتد إلى عدة صفوف، سيتم حذف جميع الصفوف التي تمتد إليها الخلايا. إذا لم تتبقَ أي صفوف في الجدول بعد هذا الحذف، سيتم حذف الجدول بأكمله.

طلب حذف جدول الجدول

حذف عمود من الجدول

تمثيل JSON 
{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}
الحقول
tableCellLocation

object (TableCellLocation)

موقع الخلية في الجدول المرجعي الذي سيتم حذف العمود منه

سيتم حذف العمود الذي تمتده هذه الخلية. إذا كانت هذه الخلية مدمجة وتمتد إلى أعمدة متعددة، سيتم حذف جميع الأعمدة التي تمتد إليها الخلايا. إذا لم تتبق أي أعمدة في الجدول بعد هذا الحذف، سيتم حذف الجدول بأكمله.

طلب صفحة Break

إدراج فاصل صفحة متبوعًا بسطر جديد في الموقع المحدّد.

تمثيل JSON 
{

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
الحقول
حقل الاتحاد insertion_location. سيتم إدراج فاصل الصفحات. يمكن أن تكون السمة insertion_location واحدة فقط من العناصر التالية:
location

object (Location)

إدراج فاصل صفحة في فهرس معين في المستند.

يجب إدراج فاصل الصفحة داخل حدود Paragraph الحالية. على سبيل المثال، لا يمكن إدراجه في فهرس بدء الجدول (أي بين الجدول والفقرة السابقة).

لا يمكن إدراج فواصل صفحات داخل جدول أو معادلة أو حاشية سفلية أو رأس أو تذييل. بما أنّه لا يمكن إدراج فواصل الصفحات إلا داخل النص، يجب أن يكون الحقل segment ID فارغًا.

endOfSegmentLocation

object (EndOfSegmentLocation)

إدراج فاصل صفحة في نهاية نص المستند

لا يمكن إدراج فواصل صفحات داخل حاشية سفلية أو رأس أو تذييل. بما أنّه لا يمكن إدراج فواصل الصفحات إلا داخل النص، يجب أن يكون الحقل segment ID فارغًا.

DeletePositionedObjectRequest

يؤدي هذا الإجراء إلى حذف PositionedObject من المستند.

تمثيل JSON 
{
  "objectId": string
}
الحقول
objectId

string

رقم تعريف العنصر الذي سيتم حذفه

طلب تعديل جدول الأعمدة

يتم تعديل TableColumnProperties من الأعمدة في الجدول.

تمثيل JSON 
{
  "tableStartLocation": {
    object (Location)
  },
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}
الحقول
tableStartLocation

object (Location)

مكان بدء الجدول في المستند.

columnIndices[]

integer

قائمة فهارس الأعمدة المستندة إلى الصفر والتي يجب تحديث موقعها. في حال عدم تحديد أي فهارس، سيتم تعديل جميع الأعمدة.

tableColumnProperties

object (TableColumnProperties)

خصائص عمود الجدول المطلوب تعديلها.

إذا كانت قيمة tableColumnProperties#width أقل من 5 نقاط (5/72 بوصة)، سيتم عرض خطأ طلب غير صحيح 400.

fields

string (FieldMask format)

الحقول التي يجب تعديلها.

يجب تحديد حقل واحد على الأقل. إنّ الجذر tableColumnProperties هو ضمني ويجب عدم تحديده. يمكن استخدام "*" واحدة كاختصار لإدراج كل حقل.

على سبيل المثال، لتعديل عرض العمود، اضبط fields على "width".

تعديلجدول الجدول الخلوي

يعدِّل نمط نطاق من خلايا الجدول.

تمثيل JSON 
{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "fields": string,

  // Union field cells can be only one of the following:
  "tableRange": {
    object (TableRange)
  },
  "tableStartLocation": {
    object (Location)
  }
  // End of list of possible types for union field cells.
}
الحقول
tableCellStyle

object (TableCellStyle)

النمط المطلوب إعداده في خلايا الجدول.

عند تعديل الحدود، إذا شاركت خلية حدودًا مع خلية مجاورة، سيتم تعديل خاصية الحدود المقابلة للخلية المجاورة أيضًا. لا يتم تعديل الحدود المدمجة وغير المرئية.

بما أنّ تعديل الحدود المشترَكة بواسطة خلايا مجاورة في الطلب نفسه قد يؤدي إلى تعارضات بشأن حدود الحدود، يتم تطبيق تعديلات الحدود بالترتيب التالي:

  • borderRight
  • borderLeft
  • borderBottom
  • borderTop
fields

string (FieldMask format)

الحقول التي يجب تعديلها.

يجب تحديد حقل واحد على الأقل. إنّ الجذر tableCellStyle هو ضمني ويجب عدم تحديده. يمكن استخدام "*" واحدة كاختصار لإدراج كل حقل.

على سبيل المثال، لتعديل لون خلفية الخلية في الجدول، اضبط fields على "backgroundColor".

لإعادة ضبط السمة على قيمتها التلقائية، يجب تضمين اسم الحقل في قناع الحقل مع ترك الحقل نفسه بدون ضبط.

حقل الاتحاد cells. الخلايا التي سيتم تعديلها. يمكن أن تكون السمة cells واحدة فقط من العناصر التالية:
tableRange

object (TableRange)

نطاق الجدول الذي يمثّل المجموعة الفرعية من الجدول التي يتم تطبيق التعديلات عليها.

tableStartLocation

object (Location)

مكان بدء الجدول في المستند. عند التحديد، يتم تطبيق التحديثات على جميع الخلايا في الجدول.

نطاق الجدول

يمثّل نطاق الجدول مرجعًا إلى مجموعة فرعية من الجدول.

من المهم ملاحظة أن الخلايا المحددة بنطاق النطاق لا تمثل بالضرورة مستطيلاً. على سبيل المثال، لنفترض أن لدينا جدولاً بحجم 3 × 3 حيث يتم دمج كل خلايا الصف الأخير معًا. يبدو الجدول كما يلي: 

 [   ][   ][   ]
 [   ][   ][   ]
 [             ]

نطاق الجدول الذي يحتوي على موقع خلية في الجدول = (tableStartLocation، الصف = 0، العمود = 0)، نطاق الصف = 3 والنطاق البالغ العمود = 2 يحدِّد الخلايا التالية: 

 [ x ][ x ][   ]
 [ x ][ x ][   ]
 [ x    x    x ]
تمثيل JSON 
{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}
الحقول
tableCellLocation

object (TableCellLocation)

موقع الخلية الذي يبدأ فيه نطاق الجدول.

rowSpan

integer

نطاق الصف لنطاق الجدول.

columnSpan

integer

نطاق العمود لنطاق الجدول.

تحديث TableTableStyleStyle

يتم تعديل TableRowStyle من الصفوف في الجدول.

تمثيل JSON 
{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndices": [
    integer
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "fields": string
}
الحقول
tableStartLocation

object (Location)

مكان بدء الجدول في المستند.

rowIndices[]

integer

قائمة فهارس الصفوف المستندة إلى الصفر والتي يجب تعديل نمطها. في حال عدم تحديد أي فهارس، سيتم تعديل جميع الصفوف.

tableRowStyle

object (TableRowStyle)

الأنماط التي سيتم ضبطها على الصفوف

fields

string (FieldMask format)

الحقول التي يجب تعديلها.

يجب تحديد حقل واحد على الأقل. إنّ الجذر tableRowStyle هو ضمني ويجب عدم تحديده. يمكن استخدام "*" واحدة كاختصار لإدراج كل حقل.

على سبيل المثال، لتعديل الحد الأدنى لارتفاع الصف، اضبط fields على "minRowHeight".

استبدال صورة

تستبدل صورة حالية بصورة جديدة.

يؤدي استبدال صورة إلى إزالة جزء image effects من الصورة الحالية لإظهار السلوك نفسه في "أدوات تحرير المستندات".

تمثيل JSON 
{
  "imageObjectId": string,
  "uri": string,
  "imageReplaceMethod": enum (ImageReplaceMethod)
}
الحقول
imageObjectId

string

رقم تعريف الصورة الحالية التي سيتم استبدالها يمكن استرداد المعرّف من ردّ على طلب الحصول على الإذن.

uri

string

معرّف الموارد المنتظم (URI) للصورة الجديدة.

يتم استرجاع الصورة مرة واحدة عند إدراجها ويتم تخزين نسخة لعرضها داخل المستند. يجب أن تكون الصور أقل من 50 ميغابايت، وألا تتجاوز 25 ميغابكسل، ويجب أن تكون بتنسيق PNG أو JPEG أو GIF.

لا يمكن أن يتجاوز طول معرّف الموارد المنتظم (URI) المقدّر 2 كيلوبايت. يتم حفظ معرّف الموارد المنتظم (URI) مع الصورة، ويتم عرضه من خلال الحقل ImageProperties.source_uri.

imageReplaceMethod

enum (ImageReplaceMethod)

طريقة الاستبدال.

طريقة استبدال الصورة

طريقة استبدال الصورة.

عمليات التعداد
IMAGE_REPLACE_METHOD_UNSPECIFIED طريقة استبدال الصور غير محدّدة يجب عدم استخدام هذه القيمة.
CENTER_CROP تحجيم الصورة وتوسيطها لملء حدود الصورة الأصلية. يمكن اقتصاص الصورة لملء حدود الصورة الأصلية. سيكون حجم الصورة المعروض هو نفسه حجم الصورة الأصلية.

تعديل نمط المستند

يتم تعديل DocumentStyle.

تمثيل JSON 
{
  "documentStyle": {
    object (DocumentStyle)
  },
  "fields": string
}
الحقول
documentStyle

object (DocumentStyle)

الأنماط المطلوب ضبطها على المستند.

قد تؤدي تغييرات معينة في نمط المستند إلى تغييرات أخرى من أجل انعكاس سلوك أداة تحرير المستندات. يمكنك الاطّلاع على مستندات DocumentStyle للحصول على مزيد من المعلومات.

fields

string (FieldMask format)

الحقول التي يجب تعديلها.

يجب تحديد حقل واحد على الأقل. إنّ الجذر documentStyle هو ضمني ويجب عدم تحديده. يمكن استخدام "*" واحدة كاختصار لإدراج كل حقل.

على سبيل المثال، لتعديل الخلفية، يجب ضبط fields على "background".

طلب دمج خلايا الجدول

يدمج الخلايا في Table.

تمثيل JSON 
{
  "tableRange": {
    object (TableRange)
  }
}
الحقول
tableRange

object (TableRange)

نطاق الجدول الذي يحدد الخلايا التي سيتم دمجها في الجدول.

سيتم ربط أي نص في الخلايا التي يتم دمجها وتخزينها في خلية "الرأس" للنطاق. هذه هي الخلية العلوية اليسرى من النطاق عندما يكون اتجاه المحتوى من اليسار إلى اليمين والخلية العلوية اليمنى من النطاق.

إذا كان النطاق غير مستطيل (وقد يحدث في بعض الحالات إذا كان النطاق يغطي الخلايا التي تم دمجها من قبل أو إذا كان الجدول غير مستطيل)، سيتم عرض الخطأ "400" غير صحيح في الطلب.

إلغاء دمج خلايا الجدول

يتم إلغاء دمج الخلايا في Table.

تمثيل JSON 
{
  "tableRange": {
    object (TableRange)
  }
}
الحقول
tableRange

object (TableRange)

نطاق الجدول الذي يحدد خلايا الجدول التي سيتم إلغاء دمجها.

سيتم إلغاء دمج كل الخلايا التي تم دمجها في هذا النطاق، ولن تتأثر الخلايا التي لم يتم إلغاء دمجها من قبل. إذا لم يحتوي النطاق على خلايا مدمَجة، لن تنفيذ أي إجراء.

إذا كان هناك نص في أي من الخلايا المدمجة، سيظل النص في خلية "الرأس" للكتلة الناتجة من الخلايا غير المدمجة. تكون خلية "head" هي الخلية العليا اليسرى عندما يكون اتجاه المحتوى من اليسار إلى اليمين والعكس أعلى.

طلب العنوان

تنشئ السمة Header. يتم تطبيق الرأس الجديد على SectionStyle في موقع SectionBreak إذا تم تحديده، أو يتم تطبيقه على DocumentStyle.

إذا كان هناك عنوان من النوع المحدّد، سيظهر خطأ طلب غير صحيح 400.

تمثيل JSON 
{
  "type": enum (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}
الحقول
type

enum (HeaderFooterType)

نوع العنوان المطلوب إنشاؤه.

sectionBreakLocation

object (Location)

تمثّل هذه السمة موقع SectionBreak الذي يبدأ بالقسم الذي يجب أن ينتمي إليه هذا العنوان. إذا تم ترك السياسة "sectionBreakLocation" بدون ضبط أو إذا كانت تشير إلى فاصل القسم الأول في نص المستند، ينطبق العنوان على DocumentStyle.

HeaderHeaderType

أنواع الرؤوس والتذييلات التي يمكن إنشاؤها.

عمليات التعداد
DEFAULT الرأس/التذييل التلقائي

إنشاء طلب تذييل

تنشئ السمة Footer. يتم تطبيق التذييل الجديد على SectionStyle في موقع SectionBreak إذا تم تحديده، أو يتم تطبيقه على DocumentStyle.

إذا كان تذييل من النوع المحدد موجودًا من قبل، سيتم عرض خطأ 400 غير صحيح في الطلب.

تمثيل JSON 
{
  "type": enum (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}
الحقول
type

enum (HeaderFooterType)

نوع التذييل المراد إنشاؤه.

sectionBreakLocation

object (Location)

موقع SectionBreak مباشرةً قبل القسم الذي يتضمن SectionStyle هذا التذييل. إذا تم ترك هذه الرسالة بدون ضبط أو إذا كانت تشير إلى فاصل القسم الأول في المستند، ينطبق التذييل على نمط المستند.

طلب إنشاء طلب

يتم إنشاء شريحة Footnote وإدراج FootnoteReference جديدة فيها في الموقع الجغرافي المحدّد.

ستتضمّن الشريحة الجديدة Footnote مسافة متبوعة بحرف سطر جديد.

تمثيل JSON 
{

  // Union field footnote_reference_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field footnote_reference_location.
}
الحقول
حقل الاتحاد footnote_reference_location. الموقع المراد إدراج إشارة الحاشية السفلية عليه يمكن أن تكون السمة footnote_reference_location واحدة فقط من العناصر التالية:
location

object (Location)

إدراج مرجع الحاشية السفلية في فهرس معيّن في المستند.

يجب إدراج مرجع الحاشية السفلية داخل حدود Paragraph الحالية. على سبيل المثال، لا يمكن إدراجه في فهرس بدء الجدول (أي بين الجدول والفقرة السابقة).

لا يمكن إدراج مراجع الحواشي السفلية داخل معادلة أو عنوان أو تذييل أو حاشية سفلية. بما أنّه يمكن إدراج مراجع الحاشية السفلية في النص فقط، يجب أن يكون الحقل segment ID فارغًا.

endOfSegmentLocation

object (EndOfSegmentLocation)

إدراج مرجع الحاشية السفلية في نهاية نص المستند

لا يمكن إدراج مراجع الحاشية السفلية في رأس أو تذييل أو حاشية سفلية. بما أنّه يمكن إدراج مراجع الحاشية السفلية في النص فقط، يجب أن يكون الحقل segment ID فارغًا.

الاستبدالNameDRangeContentRequest

تستبدل محتوى NamedRange المحدّد أو NamedRanges بالمحتوى البديل المحدد.

يُرجى العِلم بأنّ الفرد NamedRange قد يتألّف من عدة ranges منفصلة. وفي هذه الحالة، سيتم استبدال المحتوى في النطاق الأول فقط. سيتم حذف النطاقات الأخرى ومحتواها.

في الحالات التي يؤدي فيها استبدال أي نطاقات أو حذفها إلى بنية مستند غير صالحة، يتم عرض خطأ 400 غير صحيح في الطلب.

تمثيل JSON 
{

  // Union field replacement_content can be only one of the following:
  "text": string
  // End of list of possible types for union field replacement_content.

  // Union field named_range_reference can be only one of the following:
  "namedRangeId": string,
  "namedRangeName": string
  // End of list of possible types for union field named_range_reference.
}
الحقول
حقل الاتحاد replacement_content. المحتوى المراد استبدال المحتوى الحالي بالنطاق المُسمّى به يمكن أن تكون السمة replacement_content واحدة فقط من العناصر التالية:
text

string

استبدال محتوى النطاقات المُسمّاة المحددة بالنص المحدد.

حقل الاتحاد named_range_reference. مرجع للنطاقات التي سيتم استبدال المحتوى الخاص بها يمكن أن تكون السمة named_range_reference واحدة فقط من العناصر التالية:
namedRangeId

string

رقم تعريف النطاق المُعنوَن الذي سيتم استبدال المحتوى الخاص به

إذا لم يكن هناك نطاق مُعنوَن يحمل المعرّف المحدّد، سيظهر خطأ طلب غير صحيح 400.

namedRangeName

string

اسم NamedRanges الذي سيتم استبدال المحتوى الخاص به

إذا كان هناك عدّة named ranges بالاسم نفسه، سيتم استبدال محتوى كلٍّ منها. إذا لم تكن هناك نطاقات مُعنوَنة تحمل الاسم المُحدَّد، سيكون الطلب اختياريًا.

طلب تعديل القسم

يتم تعديل SectionStyle.

تمثيل JSON 
{
  "range": {
    object (Range)
  },
  "sectionStyle": {
    object (SectionStyle)
  },
  "fields": string
}
الحقول
range

object (Range)

النطاق المتداخل مع النمط.

بما أنّه لا يمكن إدراج فواصل الأقسام إلا داخل النص، يجب أن يكون الحقل segment ID فارغًا.

sectionStyle

object (SectionStyle)

الأنماط التي يتم ضبطها في القسم.

قد تتسبب تغييرات معينة في نمط القسم في إجراء تغييرات أخرى من أجل انعكاس سلوك أداة تحرير المستندات. يمكنك الاطّلاع على مستندات SectionStyle للحصول على مزيد من المعلومات.

fields

string (FieldMask format)

الحقول التي يجب تعديلها.

يجب تحديد حقل واحد على الأقل. إنّ الجذر sectionStyle مضمَّن ويجب عدم تحديده. يمكن استخدام "*" واحدة كاختصار لإدراج كل حقل.

على سبيل المثال، لتعديل الهامش الأيسر، اضبط fields على "marginLeft".

طلب إضافة القسم Break

إدراج فاصل أقسام في الموقع المحدّد

سيتم إدراج حرف جديد قبل فاصل الأقسام.

تمثيل JSON 
{
  "sectionType": enum (SectionType),

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
الحقول
sectionType

enum (SectionType)

نوع القسم المطلوب إدراجه.

حقل الاتحاد insertion_location. الموقع الذي سيتم إدراج الفاصل به. يمكن أن تكون السمة insertion_location واحدة فقط من العناصر التالية:
location

object (Location)

إدراج سطر جديد وفاصل أقسام في فهرس محدد في المستند.

يجب إدراج فاصل أقسام داخل حدود Paragraph الحالية. على سبيل المثال، لا يمكن إدراجه في فهرس بدء الجدول (أي بين الجدول والفقرة السابقة).

لا يمكن إدراج فواصل أقسام داخل جدول أو معادلة أو حاشية سفلية أو رأس أو تذييل. بما أنّه يمكن إدراج فواصل الأقسام داخل النص فقط، يجب أن يكون الحقل segment ID فارغًا.

endOfSegmentLocation

object (EndOfSegmentLocation)

إدراج سطر جديد وفاصل أقسام في نهاية نص المستند

لا يمكن إدراج فواصل أقسام داخل حاشية سفلية أو رأس أو تذييل. بما أنّه لا يمكن إدراج فواصل الأقسام إلا داخل النص، يجب أن يكون الحقل segment ID فارغًا.

طلب حذف العنوان

يؤدي هذا الإجراء إلى حذف Header من المستند.

تمثيل JSON 
{
  "headerId": string
}
الحقول
headerId

string

رقم تعريف العنوان المطلوب حذفه إذا تم تحديد هذا العنوان في DocumentStyle، ستتم إزالة الإشارة إلى هذا العنوان، ما يؤدي إلى عدم ظهور عنوان من هذا النوع للقسم الأول من المستند. إذا تم تحديد هذا العنوان على SectionStyle، ستتم إزالة الإشارة إلى هذا العنوان، ويستمر ظهور العنوان من هذا النوع من القسم السابق.

حذف تذييل الطلب

يؤدي هذا الإجراء إلى حذف Footer من المستند.

تمثيل JSON 
{
  "footerId": string
}
الحقول
footerId

string

رقم تعريف تذييل الصفحة المطلوب حذفه. إذا تم تحديد هذا التذييل في DocumentStyle، ستتم إزالة الإشارة إلى هذا التذييل، ما يؤدي إلى عدم توفّر أي تذييل من هذا النوع للقسم الأول من المستند. إذا تم تحديد هذا التذييل على SectionStyle، ستتم إزالة الإشارة إلى هذا التذييل ويواصل تذييل هذا النوع الآن من القسم السابق.

طلب.

يعدِّل عدد صفوف العناوين في الجدول المثبَّت في جدول.

تمثيل JSON 
{
  "tableStartLocation": {
    object (Location)
  },
  "pinnedHeaderRowsCount": integer
}
الحقول
tableStartLocation

object (Location)

مكان بدء الجدول في المستند.

pinnedHeaderRowsCount

integer

عدد صفوف الجدول التي سيتم تثبيتها، حيث يشير 0 إلى إلغاء تثبيت جميع الصفوف.