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)

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

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

يجب أن يكون معرّف الموارد المتسلسل المقدَّم متاحًا للجميع وألا يزيد طوله عن 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)

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

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

إذا كان النطاق غير مستطيل (يمكن أن يحدث ذلك في بعض الحالات التي يغطي فيها النطاق خلايا تم دمجها من قبل أو عندما يكون الجدول غير مستطيل)، يتم عرض خطأ 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

عدد صفوف الجدول المطلوب تثبيتها، حيث يشير الصفر إلى أنّه تم إلغاء تثبيت جميع الصفوف.