Requests

{

  // 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.
}

object (ReplaceAllTextRequest)

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

object (InsertTextRequest)

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

object (UpdateTextStyleRequest)

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

object (CreateParagraphBulletsRequest)

لإنشاء رموز نقطية للفقرات

object (DeleteParagraphBulletsRequest)

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

object (CreateNamedRangeRequest)

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

object (DeleteNamedRangeRequest)

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

object (UpdateParagraphStyleRequest)

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

object (DeleteContentRangeRequest)

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

object (InsertInlineImageRequest)

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

object (InsertTableRequest)

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

object (InsertTableRowRequest)

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

object (InsertTableColumnRequest)

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

object (DeleteTableRowRequest)

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

object (DeleteTableColumnRequest)

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

object (InsertPageBreakRequest)

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

object (DeletePositionedObjectRequest)

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

object (UpdateTableColumnPropertiesRequest)

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

object (UpdateTableCellStyleRequest)

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

object (UpdateTableRowStyleRequest)

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

object (ReplaceImageRequest)

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

object (UpdateDocumentStyleRequest)

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

object (MergeTableCellsRequest)

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

object (UnmergeTableCellsRequest)

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

object (CreateHeaderRequest)

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

object (CreateFooterRequest)

لإنشاء تذييل.

object (CreateFootnoteRequest)

لإنشاء حاشية سفلية.

object (ReplaceNamedRangeContentRequest)

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

object (UpdateSectionStyleRequest)

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

object (InsertSectionBreakRequest)

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

object (DeleteHeaderRequest)

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

object (DeleteFooterRequest)

لحذف تذييل من المستند.

object (PinTableHeaderRowsRequest)

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

{
  "replaceText": string,
  "tabsCriteria": {
    object (TabsCriteria)
  },

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

string

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

object (TabsCriteria)

اختياريّ. المعايير المستخدمة لتحديد علامات التبويب التي يحدث فيها الاستبدال.

عند إسقاط العلامة، يتم تطبيق الاستبدال على جميع علامات التبويب.

في مستند يحتوي على علامة تبويب واحدة:

• يجب أن يتطابق مع رقم تعريف علامة التبويب المفردة، في حال توفّره.

• وعند إسقاطها، ينطبق الاستبدال على علامة التبويب المفردة.

في مستند يحتوي على علامات تبويب متعددة:

• وفي حال توفّره، ينطبق الاستبدال على علامات التبويب المحدّدة.

• وعند إسقاطها، ينطبق الاستبدال على جميع علامات التبويب.

object (SubstringMatchCriteria)

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

{
  "text": string,
  "matchCase": boolean
}

string

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

boolean

يشير إلى ما إذا كان يجب أن يراعي البحث حالة الأحرف:

• True : إنّ البحث حسّاس لحالة الأحرف.
• False : إنّ البحث غير حساس لحالة الأحرف.

{
  "tabIds": [
    string
  ]
}

string

قائمة بأرقام تعريف علامات التبويب التي يتم تنفيذ الطلب فيها

{
  "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.
}

string

النص المطلوب إدراجه.

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

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

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

object (Location)

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

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

object (EndOfSegmentLocation)

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

{
  "segmentId": string,
  "index": integer,
  "tabId": string
}

string

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

integer

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

ويكون الفهرس نسبةً إلى بداية الشريحة التي حددتها من خلال segmentId

string

علامة التبويب التي يظهر فيها الموقع الجغرافي وعند حذفه، يتم تطبيق الطلب على علامة التبويب الأولى.

في مستند يحتوي على علامة تبويب واحدة:

• يجب أن يتطابق مع رقم تعريف علامة التبويب المفردة، في حال توفّره.

• وإذا تم حذفها، ينطبق الطلب على علامة التبويب الفردية.

في مستند يحتوي على علامات تبويب متعددة:

• وفي حال توفّره، ينطبق الطلب على علامة التبويب المحدّدة.

• وفي حال حذفه، ينطبق الطلب على علامة التبويب الأولى في المستند.

{
  "segmentId": string,
  "tabId": string
}

string

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

string

علامة التبويب التي يظهر فيها الموقع الجغرافي وعند حذفه، يتم تطبيق الطلب على علامة التبويب الأولى.

في مستند يحتوي على علامة تبويب واحدة:

• يجب أن يتطابق مع رقم تعريف علامة التبويب المفردة، في حال توفّره.

• وإذا تم حذفها، ينطبق الطلب على علامة التبويب الفردية.

في مستند يحتوي على علامات تبويب متعددة:

• وفي حال توفّره، ينطبق الطلب على علامة التبويب المحدّدة.

• وفي حال حذفه، ينطبق الطلب على علامة التبويب الأولى في المستند.

{
  "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.
}

object (TextStyle)

الأنماط التي تريد تعيينها على النص.

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

قد تؤدي تغييرات معينة في نمط النص إلى حدوث تغييرات أخرى حتى يتماشى مع سلوك أداة تحرير المستندات. انظر وثائق TextStyle لمزيد من المعلومات.

string (FieldMask format)

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

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

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

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

object (Range)

نطاق النص المراد نمطه.

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

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

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

{
  "range": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}

object (Range)

النطاق الذي سيتم تطبيق الإعداد النقطي عليه مسبقًا.

enum (BulletGlyphPreset)

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

{
  "range": {
    object (Range)
  }
}

object (Range)

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

{
  "name": string,
  "range": {
    object (Range)
  }
}

string

اسم النطاق NamedRange. لا يُشترَط أن تكون الأسماء فريدة.

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

object (Range)

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

{
  "tabsCriteria": {
    object (TabsCriteria)
  },

  // 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.
}

object (TabsCriteria)

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

في مستند يحتوي على علامة تبويب واحدة:

• يجب أن يتطابق مع رقم تعريف علامة التبويب المفردة، في حال توفّره.

• في حال حذف النطاق، ينطبق حذف النطاق على علامة التبويب المفردة.

في مستند يحتوي على علامات تبويب متعددة:

• وفي حال توفّره، ينطبق حذف النطاق على علامات التبويب المحدَّدة.

• وفي حال عدم توفّره، ينطبق حذف النطاق على جميع علامات التبويب.

string

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

string

اسم النطاق(النطاقات) المراد حذفه. سيتم حذف جميع النطاقات المُعنونة التي تحمل الاسم المحدّد.

{
  "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.
}

object (ParagraphStyle)

الأنماط المراد تعيينها على الفقرات.

قد تتسبب تغييرات معينة في نمط الفقرة في حدوث تغييرات أخرى، وذلك لتطبيق سلوك أداة تحرير المستندات بشكل مطابق. انظر وثائق ParagraphStyle لمزيد من المعلومات.

string (FieldMask format)

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

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

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

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

object (Range)

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

{
  "range": {
    object (Range)
  }
}

object (Range)

نطاق المحتوى الذي تريد حذفه.

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

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

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

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

{
  "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.
}

string

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

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

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

object (Size)

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

object (Location)

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

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

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

object (EndOfSegmentLocation)

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

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

{
  "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.
}

integer

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

integer

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

object (Location)

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

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

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

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

object (EndOfSegmentLocation)

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

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

{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean
}

object (TableCellLocation)

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

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

boolean

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

• True : إدراج أسفل الخلية.
• False : إدراج أعلى الخلية

{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndex": integer,
  "columnIndex": integer
}

object (Location)

تمثّل هذه السمة مكان بدء الجدول في المستند.

integer

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

integer

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

{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean
}

object (TableCellLocation)

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

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

boolean

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

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

{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}

object (TableCellLocation)

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

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

{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}

object (TableCellLocation)

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

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

{

  // 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.
}

object (Location)

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

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

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

object (EndOfSegmentLocation)

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

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

{
  "objectId": string,
  "tabId": string
}

string

رقم تعريف العنصر المطلوب حذفه

string

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

في مستند يحتوي على علامة تبويب واحدة:

• يجب أن يتطابق مع رقم تعريف علامة التبويب المفردة، في حال توفّره.

• وإذا تم حذفها، ينطبق الطلب على علامة التبويب الفردية.

في مستند يحتوي على علامات تبويب متعددة:

• وفي حال توفّره، ينطبق الطلب على علامة التبويب المحدّدة.

• وفي حال حذفه، ينطبق الطلب على علامة التبويب الأولى في المستند.

{
  "tableStartLocation": {
    object (Location)
  },
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}

object (Location)

تمثّل هذه السمة مكان بدء الجدول في المستند.

integer

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

object (TableColumnProperties)

سمات العمود في الجدول المطلوب تعديلها.

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

string (FieldMask format)

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

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

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

{
  "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.
}

object (TableCellStyle)

النمط المطلوب تعيينه على خلايا الجدول.

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

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

• borderRight
• borderLeft
• borderBottom
• borderTop

string (FieldMask format)

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

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

على سبيل المثال، لتحديث لون خلفية خلية الجدول، قم بتعيين fields إلى "backgroundColor"

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

object (TableRange)

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

object (Location)

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

{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}

object (TableCellLocation)

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

integer

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

integer

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

{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndices": [
    integer
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "fields": string
}

object (Location)

تمثّل هذه السمة مكان بدء الجدول في المستند.

integer

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

object (TableRowStyle)

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

string (FieldMask format)

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

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

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

{
  "imageObjectId": string,
  "uri": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "tabId": string
}

string

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

string

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

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

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

enum (ImageReplaceMethod)

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

string

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

في مستند يحتوي على علامة تبويب واحدة:

• يجب أن يتطابق مع رقم تعريف علامة التبويب المفردة، في حال توفّره.

• وإذا تم حذفها، ينطبق الطلب على علامة التبويب الفردية.

في مستند يحتوي على علامات تبويب متعددة:

• وفي حال توفّره، ينطبق الطلب على علامة التبويب المحدّدة.

• وفي حال حذفه، ينطبق الطلب على علامة التبويب الأولى في المستند.

{
  "documentStyle": {
    object (DocumentStyle)
  },
  "fields": string,
  "tabId": string
}

object (DocumentStyle)

الأنماط التي سيتم تعيينها على المستند.

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

string (FieldMask format)

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

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

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

string

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

في مستند يحتوي على علامة تبويب واحدة:

• يجب أن يتطابق مع رقم تعريف علامة التبويب المفردة، في حال توفّره.

• وإذا تم حذفها، ينطبق الطلب على علامة التبويب الفردية.

في مستند يحتوي على علامات تبويب متعددة:

• وفي حال توفّره، ينطبق الطلب على علامة التبويب المحدّدة.

• وإذا لم يتم تقديمه، ينطبق الطلب على علامة التبويب الأولى في المستند.

{
  "tableRange": {
    object (TableRange)
  }
}

object (TableRange)

نطاق الجدول الذي يحدد خلايا الجدول المطلوب دمجها.

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

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

{
  "tableRange": {
    object (TableRange)
  }
}

object (TableRange)

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

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

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

{
  "type": enum (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}

enum (HeaderFooterType)

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

object (Location)

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

{
  "type": enum (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}

enum (HeaderFooterType)

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

object (Location)

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

{

  // 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.
}

object (Location)

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

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

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

object (EndOfSegmentLocation)

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

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

{
  "tabsCriteria": {
    object (TabsCriteria)
  },

  // 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.
}

object (TabsCriteria)

اختياريّ. المعايير المستخدمة لتحديد علامات التبويب التي يحدث فيها الاستبدال. عند إسقاط العلامة، يتم تطبيق الاستبدال على جميع علامات التبويب.

في مستند يحتوي على علامة تبويب واحدة:

• يجب أن يتطابق مع رقم تعريف علامة التبويب المفردة، في حال توفّره.

• وعند إسقاطها، ينطبق الاستبدال على علامة التبويب المفردة.

في مستند يحتوي على علامات تبويب متعددة:

• وفي حال توفّره، ينطبق الاستبدال على علامات التبويب المحدّدة.

• وعند إسقاطها، ينطبق الاستبدال على جميع علامات التبويب.

string

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

string

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

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

string

اسم NamedRanges الذي سيتم استبدال محتواه.

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

{
  "range": {
    object (Range)
  },
  "sectionStyle": {
    object (SectionStyle)
  },
  "fields": string
}

object (Range)

يتداخل النطاق مع الأقسام في النمط.

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

object (SectionStyle)

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

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

string (FieldMask format)

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

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

على سبيل المثال، لتحديث الهامش الأيسر، قم بتعيين fields إلى "marginLeft"

{
  "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.
}

enum (SectionType)

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

object (Location)

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

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

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

object (EndOfSegmentLocation)

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

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

{
  "headerId": string,
  "tabId": string
}

string

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

string

علامة التبويب التي تحتوي على العنوان المطلوب حذفه وعند حذفه، يتم تطبيق الطلب على علامة التبويب الأولى.

في مستند يحتوي على علامة تبويب واحدة:

• يجب أن يتطابق مع رقم تعريف علامة التبويب المفردة، في حال توفّره.

• وإذا تم حذفها، ينطبق الطلب على علامة التبويب الفردية.

في مستند يحتوي على علامات تبويب متعددة:

• وفي حال توفّره، ينطبق الطلب على علامة التبويب المحدّدة.

• وفي حال حذفه، ينطبق الطلب على علامة التبويب الأولى في المستند.

{
  "footerId": string,
  "tabId": string
}

string

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

string

علامة التبويب التي تحتوي على التذييل المطلوب حذفه. وعند حذفه، يتم تطبيق الطلب على علامة التبويب الأولى.

في مستند يحتوي على علامة تبويب واحدة:

• يجب أن يتطابق مع رقم تعريف علامة التبويب المفردة، في حال توفّره.

• وإذا تم حذفها، ينطبق الطلب على علامة التبويب الفردية.

في مستند يحتوي على علامات تبويب متعددة:

• وفي حال توفّره، ينطبق الطلب على علامة التبويب المحدّدة.

• وفي حال حذفه، ينطبق الطلب على علامة التبويب الأولى في المستند.

{
  "tableStartLocation": {
    object (Location)
  },
  "pinnedHeaderRowsCount": integer
}

object (Location)

تمثّل هذه السمة مكان بدء الجدول في المستند.

integer

عدد صفوف الجدول المطلوب تثبيتها، ويشير الرقم 0 إلى إزالة تثبيت جميع الصفوف.