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) والأحرف من منطقة الاستخدام الخاص في المستوى الأساسي المتعدّد اللغات في Unicode (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)

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

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

قد تؤدي تغييرات معيّنة في نمط النص إلى تغييرات أخرى لمطابقة سلوك محرِّر "مستندات Google". انظر وثائق 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 "الخطأ 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 كيلوبايت. يتم حفظ عنوان URL نفسه مع الصورة، ويتم عرضه من خلال الحقل 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 كيلوبايت. يتم حفظ عنوان URL مع الصورة، ويتم عرضه من خلال الحقل ImageProperties.source_uri .

enum (ImageReplaceMethod)

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

string

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

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

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

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

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

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

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

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

object (DocumentStyle)

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

قد تؤدي بعض التغييرات في أسلوب المستند إلى حدوث تغييرات أخرى لمطابقة سلوك محرِّر "مستندات Google". انظر وثائق 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)

الأنماط التي سيتم ضبطها على القسم

قد تؤدي تغييرات معيّنة في نمط القسم إلى تغييرات أخرى لمطابقة سلوك محرِّر "مستندات Google". انظر وثائق 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 إلى إزالة تثبيت جميع الصفوف.