REST Resource: documents

{
  "documentId": string,
  "title": string,
  "tabs": [
    {
      object (Tab)
    }
  ],
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}

string

النتائج فقط. رقم تعريف المستند.

string

عنوان المستند.

object (Tab)

علامات التبويب التي تشكّل جزءًا من مستند

يمكن أن تحتوي علامات التبويب على علامات تبويب فرعية، وهي علامة تبويب مضمّنة في علامة تبويب أخرى. يتم تمثيل علامات التبويب الفرعية بحقل Tab.childTabs.

string

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

معرّف النسخة السابقة ليس رقمًا تسلسليًا ولكنه سلسلة مبهمة. قد يتغيّر تنسيق معرّف المراجعة بمرور الوقت. لا يمكن ضمان صلاحية معرّف المراجعة الذي تم إرجاعه إلا لمدة 24 ساعة بعد إرجاعه، ولا يمكن مشاركته مع جميع المستخدمين. إذا لم يتغيّر رقم تعريف المراجعة بين المكالمات، يعني ذلك أنّه لم يتم تغيير المستند. وفي المقابل، يعني تغيير المعرّف (للمستند والمستخدم نفسه) عادةً أنّه تم تعديل المستند. ومع ذلك، يمكن أن يرجع سبب تغيير رقم التعريف أيضًا إلى عوامل داخلية، مثل تغييرات تنسيق رقم التعريف.

enum (SuggestionsViewMode)

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

ملاحظة: عند تعديل مستند، يجب أن تستند التغييرات إلى مستند يتضمّن SUGGESTIONS_INLINE.

object (Body)

النتائج فقط. النص الرئيسي للمستند.

حقل قديم: بدلاً من ذلك، يمكنك استخدام Document.tabs.documentTab.body التي تعرض المحتوى الفعلي للمستند من جميع علامات التبويب عند ضبط مَعلمة includeTabsContent على true. في حال اختيار false أو تركها بدون ضبط، سيحتوي هذا الحقل على معلومات حول علامة التبويب الأولى في المستند.

map (key: string, value: object (Header))

النتائج فقط. العناوين في المستند، مرتبطة بمعرّف العنوان.

الحقل القديم: استخدِم بدلاً من ذلك Document.tabs.documentTab.headers الذي يعرض محتوى المستند الفعلي من جميع علامات التبويب عند ضبط المَعلمة includeTabsContent على true. إذا كانت القيمة false أو لم يتم ضبطها، يحتوي هذا الحقل على معلومات عن علامة التبويب الأولى في المستند.

map (key: string, value: object (Footer))

النتائج فقط. تتضمن هذه السمة التذييلات في المستند، مع ترتيبها حسب معرّف التذييل.

حقل قديم: بدلاً من ذلك، يمكنك استخدام Document.tabs.documentTab.footers التي تعرض المحتوى الفعلي للمستند من جميع علامات التبويب عند ضبط مَعلمة includeTabsContent على true. إذا كان false أو غير محدّد، يحتوي هذا الحقل على معلومات عن علامة التبويب الأولى في المستند.

map (key: string, value: object (Footnote))

النتائج فقط. الحواشي السفلية في المستند، مرتبطة برقم تعريف الحاشية السفلية.

الحقل القديم: استخدِم بدلاً من ذلك Document.tabs.documentTab.footnotes الذي يعرض محتوى المستند الفعلي من جميع علامات التبويب عند ضبط المَعلمة includeTabsContent على true. في حال اختيار false أو تركها بدون ضبط، سيحتوي هذا الحقل على معلومات حول علامة التبويب الأولى في المستند.

object (DocumentStyle)

النتائج فقط. نمط المستند.

حقل قديم: بدلاً من ذلك، يمكنك استخدام Document.tabs.documentTab.documentStyle التي تعرض المحتوى الفعلي للمستند من جميع علامات التبويب عند ضبط مَعلمة includeTabsContent على true. إذا كان false أو غير محدّد، يحتوي هذا الحقل على معلومات عن علامة التبويب الأولى في المستند.

map (key: string, value: object (SuggestedDocumentStyle))

النتائج فقط. التغييرات المقترَحة على نمط المستند، مرتَّبة حسب معرّف الاقتراح

حقل قديم: بدلاً من ذلك، يمكنك استخدام Document.tabs.documentTab.suggestedDocumentStyleChanges التي تعرض المحتوى الفعلي للمستند من جميع علامات التبويب عند ضبط مَعلمة includeTabsContent على true. في حال اختيار false أو تركها بدون ضبط، سيحتوي هذا الحقل على معلومات حول علامة التبويب الأولى في المستند.

object (NamedStyles)

النتائج فقط. الأنماط المُسَمّاة للمستند

الحقل القديم: استخدِم بدلاً من ذلك Document.tabs.documentTab.namedStyles الذي يعرض محتوى المستند الفعلي من جميع علامات التبويب عند ضبط المَعلمة includeTabsContent على true. إذا كان false أو غير محدّد، يحتوي هذا الحقل على معلومات عن علامة التبويب الأولى في المستند.

map (key: string, value: object (SuggestedNamedStyles))

النتائج فقط. التغييرات المقترَحة على الأنماط المُسمّاة للمستند، مع ترتيبها حسب معرّف الاقتراح

الحقل القديم: استخدِم بدلاً من ذلك Document.tabs.documentTab.suggestedNamedStylesChanges الذي يعرض محتوى المستند الفعلي من جميع علامات التبويب عند ضبط المَعلمة includeTabsContent على true. في حال اختيار false أو تركها بدون ضبط، سيحتوي هذا الحقل على معلومات حول علامة التبويب الأولى في المستند.

map (key: string, value: object (List))

النتائج فقط. القوائم الموجودة في المستند، مرتبطة برقم تعريف القائمة.

الحقل القديم: استخدِم بدلاً من ذلك Document.tabs.documentTab.lists الذي يعرض محتوى المستند الفعلي من جميع علامات التبويب عند ضبط المَعلمة includeTabsContent على true. في حال اختيار false أو تركها بدون ضبط، سيحتوي هذا الحقل على معلومات حول علامة التبويب الأولى في المستند.

map (key: string, value: object (NamedRanges))

النتائج فقط. النطاقات المُعنونة في المستند، مفصولة حسب الاسم.

حقل قديم: بدلاً من ذلك، يمكنك استخدام Document.tabs.documentTab.namedRanges التي تعرض المحتوى الفعلي للمستند من جميع علامات التبويب عند ضبط مَعلمة includeTabsContent على true. في حال اختيار false أو تركها بدون ضبط، سيحتوي هذا الحقل على معلومات حول علامة التبويب الأولى في المستند.

map (key: string, value: object (InlineObject))

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

الحقل القديم: استخدِم بدلاً من ذلك Document.tabs.documentTab.inlineObjects الذي يعرض محتوى المستند الفعلي من جميع علامات التبويب عند ضبط المَعلمة includeTabsContent على true. إذا كان false أو غير محدّد، يحتوي هذا الحقل على معلومات عن علامة التبويب الأولى في المستند.

map (key: string, value: object (PositionedObject))

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

حقل قديم: بدلاً من ذلك، يمكنك استخدام Document.tabs.documentTab.positionedObjects التي تعرض المحتوى الفعلي للمستند من جميع علامات التبويب عند ضبط مَعلمة includeTabsContent على true. إذا كان false أو غير محدّد، يحتوي هذا الحقل على معلومات عن علامة التبويب الأولى في المستند.

{
  "tabProperties": {
    object (TabProperties)
  },
  "childTabs": [
    {
      object (Tab)
    }
  ],

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

object (TabProperties)

خصائص علامة التبويب، مثل رقم التعريف والعنوان.

object (Tab)

علامات التبويب الفرعية المُدمجة في علامة التبويب هذه

object (DocumentTab)

علامة تبويب تتضمّن محتوى المستند، مثل النصوص والصور

{
  "tabId": string,
  "title": string,
  "parentTabId": string,
  "index": integer,
  "nestingLevel": integer
}

string

النتائج فقط. رقم تعريف علامة التبويب. لا يمكن تغيير هذا الحقل.

string

اسم علامة التبويب الذي يظهر للمستخدم

string

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

integer

الفهرس القائم على علامة صفرية لعلامة التبويب داخل العنصر الرئيسي.

integer

النتائج فقط. عمق علامة التبويب في المستند تبدأ علامات التبويب على مستوى الجذر من 0.

{
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}

object (Body)

النص الرئيسي لعلامة التبويب الخاصة بالمستند.

map (key: string, value: object (Header))

العناوين في علامة تبويب المستند، مفعَّلة حسب رقم تعريف العنوان

map (key: string, value: object (Footer))

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

map (key: string, value: object (Footnote))

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

object (DocumentStyle)

نمط علامة التبويب للمستند

map (key: string, value: object (SuggestedDocumentStyle))

التغييرات المقترَحة على نمط علامة تبويب المستند، استنادًا إلى رقم تعريف الاقتراح

object (NamedStyles)

الأنماط المُعنونة في علامة تبويب المستند.

map (key: string, value: object (SuggestedNamedStyles))

التغييرات المقترَحة على الأنماط المُعنونة لعلامة تبويب المستند، استنادًا إلى رقم تعريف الاقتراح

map (key: string, value: object (List))

القوائم الموجودة في علامة تبويب المستند، مرتَّبة حسب رقم تعريف القائمة.

map (key: string, value: object (NamedRanges))

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

map (key: string, value: object (InlineObject))

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

map (key: string, value: object (PositionedObject))

الكائنات التي تمّ وضعها في علامة تبويب المستند، مع ترتيبها حسب معرّف الكائن

{
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

object (StructuralElement)

محتوى النص

وتبدأ فهارس محتوى الجسم بصفر.

{
  "startIndex": integer,
  "endIndex": integer,

  // Union field content can be only one of the following:
  "paragraph": {
    object (Paragraph)
  },
  "sectionBreak": {
    object (SectionBreak)
  },
  "table": {
    object (Table)
  },
  "tableOfContents": {
    object (TableOfContents)
  }
  // End of list of possible types for union field content.
}

integer

مؤشر البداية المستند إلى الصفر لهذا العنصر الهيكلي، بوحدات ترميز UTF-16

integer

يشير إلى فهرس النهاية صفر الخاص بهذا العنصر الهيكلي، بشكل حصري، في وحدات ترميز UTF-16.

object (Paragraph)

نوع فقرة من العنصر الهيكلي.

object (SectionBreak)

نوع فاصل الأقسام للعنصر الهيكلي.

object (Table)

يشير ذلك المصطلح إلى نوع جدول من العناصر الهيكلية.

object (TableOfContents)

نوع جدول المحتويات للعنصر الهيكلي.

{
  "elements": [
    {
      object (ParagraphElement)
    }
  ],
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "suggestedParagraphStyleChanges": {
    string: {
      object (SuggestedParagraphStyle)
    },
    ...
  },
  "bullet": {
    object (Bullet)
  },
  "suggestedBulletChanges": {
    string: {
      object (SuggestedBullet)
    },
    ...
  },
  "positionedObjectIds": [
    string
  ],
  "suggestedPositionedObjectIds": {
    string: {
      object (ObjectReferences)
    },
    ...
  }
}

object (ParagraphElement)

محتوى الفقرة، مقسّمًا إلى أجزائه المكونة

object (ParagraphStyle)

نمط هذه الفقرة.

map (key: string, value: object (SuggestedParagraphStyle))

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

object (Bullet)

علامة نقطية لهذه الفقرة إذا لم يكن متوفّرًا، يعني ذلك أنّ الفقرة لا تنتمي إلى قائمة.

map (key: string, value: object (SuggestedBullet))

التغييرات المقترحة على التعداد النقطي لهذه الفقرة

string

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

map (key: string, value: object (ObjectReferences))

أرقام تعريف العناصر التي تمّ وضعها والمقترَحة لإرفاقها بهذه الفقرة، مرتّبة حسب معرّف الاقتراح

{
  "startIndex": integer,
  "endIndex": integer,

  // Union field content can be only one of the following:
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  },
  "pageBreak": {
    object (PageBreak)
  },
  "columnBreak": {
    object (ColumnBreak)
  },
  "footnoteReference": {
    object (FootnoteReference)
  },
  "horizontalRule": {
    object (HorizontalRule)
  },
  "equation": {
    object (Equation)
  },
  "inlineObjectElement": {
    object (InlineObjectElement)
  },
  "person": {
    object (Person)
  },
  "richLink": {
    object (RichLink)
  }
  // End of list of possible types for union field content.
}

integer

فهرس البدء المستنِد إلى صفر لعنصر الفقرة هذا، بوحدات رمز UTF-16.

integer

فهرس النهاية الصفرية لعنصر الفقرة هذا، بشكل حصري، بوحدات رمز UTF-16.

object (TextRun)

عنصر فقرة نصي

object (AutoText)

عنصر فقرة نص تلقائي

object (PageBreak)

عنصر فقرة في فاصل صفحة

object (ColumnBreak)

عنصر فاصل عمودي لفقرة

object (FootnoteReference)

عنصر فقرة مرجع حاشية سفلية

object (HorizontalRule)

عنصر فقرة خط أفقي

object (Equation)

عنصر فقرة معادلة

object (InlineObjectElement)

عنصر مضمّن من فقرة كائن.

object (Person)

عنصر فقرة يرتبط بشخص أو عنوان بريد إلكتروني.

object (RichLink)

عنصر فقرة يرتبط بمرجع في Google (مثل ملف في Google Drive أو فيديو على YouTube أو حدث في "تقويم Google")

{
  "content": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

نصّ هذه العملية

يتم استبدال أي عناصر غير نصية في عملية التشغيل بحرف يونيكود U+E907.

string

أرقام تعريف الإدراج المقترَحة قد يحتوي TextRun على أرقام تعريف إدراج متعددة إذا كان تغييرًا مقترحًا مدمجًا. إذا كانت فارغة، فهذا لا يعني إدراجًا مقترحًا.

string

أرقام تعريف الحذف المقترَحة وإذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذا المحتوى.

object (TextStyle)

نمط النص لعملية التشغيل هذه.

map (key: string, value: object (SuggestedTextStyle))

يتغير نمط النص المقترَح إلى هذه العملية، استنادًا إلى رقم تعريف الاقتراح.

{
  "bold": boolean,
  "italic": boolean,
  "underline": boolean,
  "strikethrough": boolean,
  "smallCaps": boolean,
  "backgroundColor": {
    object (OptionalColor)
  },
  "foregroundColor": {
    object (OptionalColor)
  },
  "fontSize": {
    object (Dimension)
  },
  "weightedFontFamily": {
    object (WeightedFontFamily)
  },
  "baselineOffset": enum (BaselineOffset),
  "link": {
    object (Link)
  }
}

boolean

ما إذا كان النص يتم عرضه بالخط الغامق أم لا

boolean

ما إذا كان النص مائلاً أم لا

boolean

ما إذا كان النص مُسطَّرًا أم لا

boolean

ما إذا كان النص مشطوبًا أم لا

boolean

ما إذا كان النص مكتوبًا بأحرف صغيرة كبيرة

object (OptionalColor)

لون خلفية النص إذا تم ضبطه، يكون اللون إما نموذج RGB أو شفافًا، وذلك استنادًا إلى الحقل color.

object (OptionalColor)

لون المقدّمة للنص وفي حال ضبط اللون، يكون اللون إما اللون الأحمر والأخضر والأزرق أو شفافًا، بناءً على الحقل color.

object (Dimension)

حجم خط النص

object (WeightedFontFamily)

مجموعة الخطوط وحجم النص المعروض

إذا حدّد طلب التعديل قيمًا لكل من weightedFontFamily وbold، يتم تطبيق weightedFontFamily أولاً، ثم bold.

إذا لم يتم ضبط weightedFontFamily#weight، سيتم ضبطه تلقائيًا على 400.

إذا تم ضبط weightedFontFamily، يجب أيضًا ضبط weightedFontFamily#fontFamily على قيمة غير فارغة. بخلاف ذلك، يتم عرض خطأ 400 "الخطأ 400: طلب غير صالح".

enum (BaselineOffset)

الإزاحة العمودية للنص عن موضعه المعتاد

يتم تلقائيًا عرض النص الذي يحتوي على إزاحة خط أساسية SUPERSCRIPT أو SUBSCRIPT بحجم خط أصغر، محسوبًا استنادًا إلى الحقل fontSize. لا تؤثر التغييرات الواردة في هذا الحقل على fontSize.

object (Link)

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

يؤدي تغيير الرابط في طلب التعديل إلى إجراء بعض التغييرات الأخرى على نمط نص النطاق:

• عند ضبط رابط، سيتم تعديل لون المقدّمة للنص إلى لون الرابط التلقائي وسيتم وضع خط تحت النص. في حال تعديل هذه الحقول في الطلب نفسه، سيتم استخدام هذه القيم بدلاً من الإعدادات التلقائية للرابط.
• سيؤدي ضبط رابط على نطاق نص يتداخل مع رابط حالي إلى تعديل الرابط الحالي أيضًا ليشير إلى عنوان URL الجديد.
• لا يمكن ضبط الروابط على أحرف الأسطر الجديدة. ونتيجةً لذلك، سيؤدي ضبط رابط على نطاق نصي يتخطى حدود الفقرة، مثل "ABC\n123"، إلى فصل أحرف السطر الجديد إلى نصوص تشغيل خاصة بها. سيتم تطبيق الرابط بشكل منفصل على عمليات التشغيل قبل السطر الجديد وبعده.
• وستؤدي إزالة رابط إلى تعديل نمط النص للنطاق لمطابقة نمط النص السابق (أو أنماط النص التلقائية إذا كان النص السابق رابطًا آخر) ما لم يتم ضبط أنماط مختلفة في الطلب نفسه.

{
  "color": {
    object (Color)
  }
}

object (Color)

في حال ضبط هذا الخيار، سيتم استخدامه كلون غير شفاف. وفي حال عدم ضبطها، يشير ذلك إلى لون شفاف.

{
  "rgbColor": {
    object (RgbColor)
  }
}

object (RgbColor)

قيمة اللون بتنسيق RGB

{
  "red": number,
  "green": number,
  "blue": number
}

number

العنصر الأحمر للون، من 0.0 إلى 1.0.

number

العنصر الأخضر للون، من 0.0 إلى 1.0.

number

المكوّن الأزرق للّون، من 0.0 إلى 1.0

{
  "magnitude": number,
  "unit": enum (Unit)
}

number

مقدار المجال

enum (Unit)

يشير ذلك المصطلح إلى وحدات المقدار.

{
  "fontFamily": string,
  "weight": integer
}

string

مجموعة خطوط النص

يمكن أن تكون مجموعة الخطوط أي خط من قائمة "الخط" في "مستندات Google" أو من Google Fonts. إذا لم يتم التعرّف على اسم الخط، سيتم عرض النص باللغة Arial.

integer

سمك الخط يمكن أن يحتوي هذا الحقل على أي قيمة تكون من مضاعفات 100 بين 100 و900، بشكل شامل. يتوافق هذا النطاق مع القيم الرقمية الموضحة في مواصفات CSS 2.1، القسم 15.6، مع عدم السماح بالقيم غير الرقمية.

القيمة التلقائية هي 400 ("عادية").

يشكل عرض الخط مكونًا واحدًا فقط من سُمك الخط المعروض. يحدّد كلّ من weight وقيمة bold التي تمّ حلّها لأسلوب النص الوزن المعروض، بعد مراعاة الخصائص المشترَكة:

• إذا كان النص بخط غامق وكان الوزن أقل من 400، يكون الوزن المعروض 400.
• إذا كان النص بخط غامق وكان الوزن أكبر من أو يساوي 400 ولكنّه أقل من 700، يكون الوزن المعروض 700.
• إذا كان الوزن أكبر من أو يساوي 700، يكون الوزن المعروض مساويًا للوزن.
• إذا لم يكن النص غامقًا، سيكون الوزن المعروض مساويًا للوزن.

{

  // Union field destination can be only one of the following:
  "url": string,
  "tabId": string,
  "bookmark": {
    object (BookmarkLink)
  },
  "heading": {
    object (HeadingLink)
  },
  "bookmarkId": string,
  "headingId": string
  // End of list of possible types for union field destination.
}

string

عنوان URL خارجي

string

معرّف علامة تبويب في هذا المستند

object (BookmarkLink)

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

في المستندات التي تحتوي على علامة تبويب واحدة، تستمر الروابط المؤدية إلى الإشارات المرجعية داخل علامة التبويب المفرد في عرض Link.bookmarkId عند ضبط مَعلمة includeTabsContent على false أو تركها بدون ضبط. وبخلاف ذلك، يتم عرض هذا الحقل.

object (HeadingLink)

عنوان في هذا المستند

في المستندات التي تحتوي على علامة تبويب واحدة، تستمر الروابط المؤدية إلى العناوين ضمن علامة التبويب المفرد في عرض Link.headingId عند ضبط مَعلمة includeTabsContent على false أو تركها بدون ضبط. وبخلاف ذلك، يتم عرض هذا الحقل.

string

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

حقل قديم: بدلاً من ذلك، اضبط includeTabsContent على true واستخدِم Link.bookmark لعمليات القراءة والكتابة. لا يتم عرض هذا الحقل إلا عند ضبط includeTabsContent على false في المستندات التي تحتوي على علامة تبويب واحدة وترتبط بإشارة مرجعية داخل علامة التبويب المفردة. بخلاف ذلك، يتم عرض Link.bookmark.

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

string

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

الحقل القديم: بدلاً من ذلك، اضبط includeTabsContent على true واستخدِم Link.heading لعمليات القراءة والكتابة. لا يتم عرض هذا الحقل إلا عند ضبط includeTabsContent على false في المستندات التي تحتوي على علامة تبويب واحدة وترتبط بعنوان ضمن علامة التبويب المفردة. بخلاف ذلك، يتم عرض Link.heading.

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

{
  "id": string,
  "tabId": string
}

string

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

string

معرّف علامة التبويب التي تحتوي على الإشارة المرجعية هذه.

{
  "id": string,
  "tabId": string
}

string

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

string

تمثّل هذه السمة رقم تعريف علامة التبويب التي تحتوي على هذا العنوان.

{
  "textStyle": {
    object (TextStyle)
  },
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}

object (TextStyle)

TextStyle لا يتضمن سوى التغييرات التي تم إجراؤها في هذا الاقتراح. ويمكن استخدام ذلك مع textStyleSuggestionState للاطّلاع على الحقول التي تم تغييرها وقيمها الجديدة.

object (TextStyleSuggestionState)

قناع يشير إلى الحقول التي تم تغييرها في قاعدة TextStyle هذه في هذا الاقتراح

{
  "boldSuggested": boolean,
  "italicSuggested": boolean,
  "underlineSuggested": boolean,
  "strikethroughSuggested": boolean,
  "smallCapsSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "foregroundColorSuggested": boolean,
  "fontSizeSuggested": boolean,
  "weightedFontFamilySuggested": boolean,
  "baselineOffsetSuggested": boolean,
  "linkSuggested": boolean
}

boolean

يشير إلى ما إذا كان هناك تغيير مقترَح على bold.

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في italic.

boolean

يشير إلى ما إذا كان هناك تغيير مقترَح على underline.

boolean

يشير إلى ما إذا كان هناك تغيير مقترَح على strikethrough.

boolean

يشير إلى ما إذا كان هناك تغيير مقترَح على smallCaps.

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في backgroundColor.

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في foregroundColor.

boolean

يشير إلى ما إذا كان هناك تغيير مقترَح على fontSize.

boolean

يشير إلى ما إذا كان هناك تغيير مقترَح على weightedFontFamily.

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في baselineOffset.

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في link.

{
  "type": enum (Type),
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

enum (Type)

نوع هذا النص التلقائي

string

معرّفات الإدراج المقترَحة قد يحتوي AutoText على أرقام تعريف إدراج متعددة إذا كان تغييرًا مقترحًا مدمجًا. إذا كانت فارغة، هذا يعني أنّها ليست إدراجًا مقترَحًا.

string

أرقام تعريف الحذف المقترَحة إذا كان الحقل فارغًا، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذا المحتوى.

object (TextStyle)

نمط النص لهذا النص التلقائي.

map (key: string, value: object (SuggestedTextStyle))

يتغير نمط النص المقترَح إلى هذا النص التلقائي، استنادًا إلى رقم تعريف الاقتراح.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

أرقام تعريف الإدراج المقترَحة قد يحتوي PageBreak على أرقام تعريف إدراج متعددة إذا كان تغييرًا مقترحًا مدمجًا. إذا كانت فارغة، فهذا لا يعني إدراجًا مقترحًا.

string

أرقام تعريف الحذف المقترَحة وإذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذا المحتوى.

object (TextStyle)

نمط النص الخاص بفاصل الصفحة هذا.

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

map (key: string, value: object (SuggestedTextStyle))

يتغير نمط النص المقترح إلى فاصل الصفحات هذا، استنادًا إلى رقم تعريف الاقتراح.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

معرّفات الإدراج المقترَحة قد يتضمّن العنصر ColumnBreak أرقام تعريف إدراج متعددة إذا كان تغييرًا مقترَحا متداخلًا. إذا كانت فارغة، فهذا لا يعني إدراجًا مقترحًا.

string

أرقام تعريف الحذف المقترَحة إذا كان الحقل فارغًا، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذا المحتوى.

object (TextStyle)

نمط النص الخاص بفاصل الأعمدة هذا.

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

map (key: string, value: object (SuggestedTextStyle))

يتغيّر نمط النص المقترَح إلى عنصر ColumnBreak هذا، والذي يتمّ تحديده باستخدام معرّف الاقتراح.

{
  "footnoteId": string,
  "footnoteNumber": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

رقم تعريف footnote الذي يتضمّن محتوى مرجع الحاشية السفلية هذا.

string

الرقم المعروض لهذه الحاشية السفلية.

string

معرّفات الإدراج المقترَحة قد يتضمّن العنصر FootnoteReference أرقام تعريف إدراج متعددة إذا كان تغييرًا مقترَحا متداخلًا. إذا كانت فارغة، فهذا لا يعني إدراجًا مقترحًا.

string

أرقام تعريف الحذف المقترَحة إذا كان الحقل فارغًا، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذا المحتوى.

object (TextStyle)

نمط النص الخاص بـ FootnoteReference هذا.

map (key: string, value: object (SuggestedTextStyle))

يتغيّر نمط النص المقترَح إلى FootnoteReference هذا، ويتمّ ترتيبه حسب معرّف الاقتراح.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

معرّفات الإدراج المقترَحة قد يحتوي HorizontalRule على أرقام تعريف إدراج متعددة إذا كان تغييرًا مقترحًا مدمجًا. إذا كانت فارغة، فهذا لا يعني إدراجًا مقترحًا.

string

أرقام تعريف الحذف المقترَحة وإذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذا المحتوى.

object (TextStyle)

نمط النص الخاص بعنصر HorizontalRule هذا.

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

map (key: string, value: object (SuggestedTextStyle))

يتغيّر نمط النص المقترَح إلى هذا العنصر HorizontalRule، والذي يتمّ تحديده باستخدام معرّف الاقتراح.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}

string

معرّفات الإدراج المقترَحة قد يتضمّن Equation أرقام تعريف إدراج متعددة إذا كان تغييرًا مقترَحا متداخلًا. إذا كانت فارغة، هذا يعني أنّها ليست إدراجًا مقترَحًا.

string

أرقام تعريف الحذف المقترَحة إذا كان الحقل فارغًا، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذا المحتوى.

{
  "inlineObjectId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

رقم تعريف InlineObject الذي يحتوي عليه هذا العنصر.

string

أرقام تعريف الإدراج المقترَحة قد يحتوي InlineObjectElement على أرقام تعريف إدراج متعددة إذا كان تغييرًا مقترَحا متداخلًا. إذا كانت فارغة، فهذا لا يعني إدراجًا مقترحًا.

string

أرقام تعريف الحذف المقترَحة إذا كان الحقل فارغًا، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذا المحتوى.

object (TextStyle)

نمط النص لهذا العنصر InlineObjectElement.

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

map (key: string, value: object (SuggestedTextStyle))

يتغيّر نمط النص المقترَح إلى عنصر InlineObject هذا، والذي يتمّ ترتيبه حسب معرّف الاقتراح.

{
  "personId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "personProperties": {
    object (PersonProperties)
  }
}

string

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

string

أرقام تعريف الاقتراحات التي تُدرج رابط هذا المستخدم في المستند قد يتضمّن العنصر Person أرقام تعريف إدراج متعددة إذا كان تغييرًا مقترَحًا متداخلًا (اقتراح ضمن اقتراح تقدّمه مستخدم مختلف، على سبيل المثال). إذا كان الحقل فارغًا، يعني ذلك أنّ رابط هذا المستخدم ليس إدراجًا مقترَحًا.

string

أرقام التعريف للاقتراحات التي تزيل رابط هذا الشخص من المستند. يمكن أن يتضمّن Person أرقام تعريف متعددة للحذف، إذا اقترح عدة مستخدمين حذفه مثلاً. إذا كان الحقل فارغًا، لن يتم اقتراح حذف رابط هذا المستخدم.

object (TextStyle)

نمط النص لسمة Person هذه.

map (key: string, value: object (SuggestedTextStyle))

يتغيّر نمط النص المقترَح إلى هذا النمط Person، استنادًا إلى معرّف الاقتراح.

object (PersonProperties)

النتائج فقط. سمات هذا Person هذا الحقل متوفّر دائمًا.

{
  "name": string,
  "email": string
}

string

النتائج فقط. اسم المستخدم إذا كان معروضًا في نص الرابط بدلاً من عنوان بريده الإلكتروني

string

النتائج فقط. عنوان البريد الإلكتروني المرتبط بـ Person هذا. هذا الحقل متوفّر دائمًا.

{
  "richLinkId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "richLinkProperties": {
    object (RichLinkProperties)
  }
}

string

النتائج فقط. رقم تعريف هذا الرابط.

string

أرقام تعريف للاقتراحات التي تُدرِج هذا الرابط في المستند يمكن أن يحتوي RichLink على أرقام تعريف إدراج متعددة إذا كان تغييرًا مقترحًا مدمجًا (على سبيل المثال، اقتراح ضمن اقتراح قدّمه مستخدم آخر). إذا كان هذا الحقل فارغًا، لن يكون رابط المستخدم هذا إدراجًا مقترحًا.

string

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

object (TextStyle)

نمط النص لهذا RichLink.

map (key: string, value: object (SuggestedTextStyle))

يتغيّر نمط النص المقترَح إلى هذا RichLink، استنادًا إلى معرّف الاقتراح.

object (RichLinkProperties)

النتائج فقط. تمثّل هذه السمة خصائص RichLink. هذا الحقل موجود دائمًا.

{
  "title": string,
  "uri": string,
  "mimeType": string
}

string

النتائج فقط. عنوان RichLink كما يظهر في الرابط يتطابق هذا العنوان مع عنوان المورد المرتبط عند إدراج الرابط أو آخر تعديل له. هذا الحقل موجود دائمًا.

string

النتائج فقط. تمثّل هذه السمة معرّف الموارد المنتظم (URI) الخاص بـ RichLink. هذه الميزة موجودة دائمًا.

string

النتائج فقط. نوع MIME للRichLink، إذا كان هناك نوع (على سبيل المثال، عندما يكون ملفًا في Drive)

{
  "headingId": string,
  "namedStyleType": enum (NamedStyleType),
  "alignment": enum (Alignment),
  "lineSpacing": number,
  "direction": enum (ContentDirection),
  "spacingMode": enum (SpacingMode),
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "borderBetween": {
    object (ParagraphBorder)
  },
  "borderTop": {
    object (ParagraphBorder)
  },
  "borderBottom": {
    object (ParagraphBorder)
  },
  "borderLeft": {
    object (ParagraphBorder)
  },
  "borderRight": {
    object (ParagraphBorder)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "tabStops": [
    {
      object (TabStop)
    }
  ],
  "keepLinesTogether": boolean,
  "keepWithNext": boolean,
  "avoidWidowAndOrphan": boolean,
  "shading": {
    object (Shading)
  },
  "pageBreakBefore": boolean
}

string

رقم تعريف عنوان الفقرة إذا كانت فارغة، هذا يعني أنّ هذه الفقرة ليست عنوانًا.

هذا الحقل للقراءة فقط.

enum (NamedStyleType)

نوع النمط المُعنوَن للفقرة.

نظرًا لأن تحديث نوع النمط المُعنون يؤثر على الخصائص الأخرى ضمن نمط الفقرة، يتم تطبيق نوع النمط المعنوَن قبل تحديث الخصائص الأخرى.

enum (Alignment)

محاذاة النص لهذه الفقرة.

number

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

enum (ContentDirection)

اتجاه نص هذه الفقرة. في حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على LEFT_TO_RIGHT لأنّ اتجاه الفقرة غير مكتسب.

enum (SpacingMode)

وضع التباعد للفقرة

object (Dimension)

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

object (Dimension)

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

object (ParagraphBorder)

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

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

لا يمكن تعديل حدود الفقرة جزئيًا. عند تغيير حدود فقرة، يجب تحديد الحدود الجديدة بالكامل.

object (ParagraphBorder)

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

يتم عرض الحد العلوي عندما تحتوي الفقرة أعلاه على خصائص مختلفة للحدود والمسافة البادئة.

لا يمكن تعديل حدود الفقرة جزئيًا. عند تغيير حدود فقرة، يجب تحديد الحدود الجديدة بالكامل.

object (ParagraphBorder)

الحدّ في أسفل هذه الفقرة في حال عدم ضبط القيمة، يتم اكتسابها من العنصر الرئيسي.

يتم عرض الحدّ السفلي عندما تحتوي الفقرة أدناه على سمات حدود ومَعلمات مسافة بادئة مختلفة.

لا يمكن تعديل حدود الفقرات جزئيًا. عند تغيير حد فقرة، يجب تحديد الحد الجديد بأكمله.

object (ParagraphBorder)

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

لا يمكن تعديل حدود الفقرة جزئيًا. عند تغيير حدود فقرة، يجب تحديد الحدود الجديدة بالكامل.

object (ParagraphBorder)

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

لا يمكن تعديل حدود الفقرات جزئيًا. عند تغيير حد فقرة، يجب تحديد الحد الجديد بأكمله.

object (Dimension)

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

object (Dimension)

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

object (Dimension)

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

object (TabStop)

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

هذا الموقع للقراءة فقط.

boolean

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

boolean

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

boolean

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

object (Shading)

تظليل الفقرة. في حال عدم ضبط القيمة، يتم اكتسابها من العنصر الرئيسي.

boolean

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

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

{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "padding": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}

object (OptionalColor)

لون الحدود

object (Dimension)

عرض الحدود.

object (Dimension)

المساحة الفارغة حول الحدود

enum (DashStyle)

نمط الشرطة للحدود.

{
  "offset": {
    object (Dimension)
  },
  "alignment": enum (TabStopAlignment)
}

object (Dimension)

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

enum (TabStopAlignment)

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

{
  "backgroundColor": {
    object (OptionalColor)
  }
}

object (OptionalColor)

لون خلفية تمويه هذه الفقرة.

{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}

object (ParagraphStyle)

ParagraphStyle يتضمّن التغييرات التي تم إجراؤها في هذا الاقتراح فقط يمكن استخدام هذا الخيار مع paragraphStyleSuggestionState لمعرفة الحقول التي تم تغييرها وقيمها الجديدة.

object (ParagraphStyleSuggestionState)

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

{
  "headingIdSuggested": boolean,
  "namedStyleTypeSuggested": boolean,
  "alignmentSuggested": boolean,
  "lineSpacingSuggested": boolean,
  "directionSuggested": boolean,
  "spacingModeSuggested": boolean,
  "spaceAboveSuggested": boolean,
  "spaceBelowSuggested": boolean,
  "borderBetweenSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "indentFirstLineSuggested": boolean,
  "indentStartSuggested": boolean,
  "indentEndSuggested": boolean,
  "keepLinesTogetherSuggested": boolean,
  "keepWithNextSuggested": boolean,
  "avoidWidowAndOrphanSuggested": boolean,
  "shadingSuggestionState": {
    object (ShadingSuggestionState)
  },
  "pageBreakBeforeSuggested": boolean
}

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في headingId.

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في namedStyleType.

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في alignment.

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في lineSpacing.

boolean

يشير إلى ما إذا كان هناك تغيير مقترَح على direction.

boolean

يشير إلى ما إذا كان هناك تغيير مقترَح على spacingMode.

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في spaceAbove.

boolean

يشير إلى ما إذا كان هناك تغيير مقترَح على spaceBelow.

boolean

يشير إلى ما إذا كان هناك تغيير مقترَح على borderBetween.

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في borderTop.

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في borderBottom.

boolean

يشير إلى ما إذا كان هناك تغيير مقترَح على borderLeft.

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في borderRight.

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في indentFirstLine.

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في indentStart.

boolean

يشير إلى ما إذا كان هناك تغيير مقترَح على indentEnd.

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في keepLinesTogether.

boolean

يشير إلى ما إذا كان هناك تغيير مقترَح على keepWithNext.

boolean

يشير إلى ما إذا كان هناك تغيير مقترَح على avoidWidowAndOrphan.

object (ShadingSuggestionState)

قناع يشير إلى الحقول في shading التي تم تغييرها في هذا الاقتراح

boolean

يشير إلى ما إذا كان هناك تغيير مقترَح على pageBreakBefore.

{
  "backgroundColorSuggested": boolean
}

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في Shading.

{
  "listId": string,
  "nestingLevel": integer,
  "textStyle": {
    object (TextStyle)
  }
}

string

رقم تعريف القائمة التي تنتمي إليها هذه الفقرة.

integer

مستوى التداخل لهذه الفقرة في القائمة.

object (TextStyle)

نمط النص الخاص بالفقرة الذي تم تطبيقه على هذه الفقرة

{
  "bullet": {
    object (Bullet)
  },
  "bulletSuggestionState": {
    object (BulletSuggestionState)
  }
}

object (Bullet)

Bullet لا يتضمن سوى التغييرات التي تم إجراؤها في هذا الاقتراح. ويمكن استخدام ذلك مع bulletSuggestionState للاطّلاع على الحقول التي تم تغييرها وقيمها الجديدة.

object (BulletSuggestionState)

قناع يشير إلى الحقول التي تم تغييرها في القاعدة Bullet في هذا الاقتراح

{
  "listIdSuggested": boolean,
  "nestingLevelSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}

boolean

يشير إلى ما إذا كان هناك تغيير مقترَح على listId.

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في nestingLevel.

object (TextStyleSuggestionState)

قناع يشير إلى الحقول التي تم تغييرها في text style في هذا الاقتراح

{
  "objectIds": [
    string
  ]
}

string

أرقام تعريف الكائنات

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "sectionStyle": {
    object (SectionStyle)
  }
}

string

أرقام تعريف الإدراج المقترَحة قد يحتوي SectionBreak على أرقام تعريف إدراج متعددة إذا كان تغييرًا مقترحًا مدمجًا. إذا كانت فارغة، فهذا لا يعني إدراجًا مقترحًا.

string

أرقام تعريف الحذف المقترَحة إذا كان الحقل فارغًا، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذا المحتوى.

object (SectionStyle)

نمط القسم بعد فاصل القسم هذا.

{
  "columnProperties": [
    {
      object (SectionColumnProperties)
    }
  ],
  "columnSeparatorStyle": enum (ColumnSeparatorStyle),
  "contentDirection": enum (ContentDirection),
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "sectionType": enum (SectionType),
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "flipPageOrientation": boolean
}

object (SectionColumnProperties)

خصائص أعمدة القسم

إذا كان القسم فارغًا، سيحتوي على عمود واحد يتضمّن السمات التلقائية في محرِّر "مستندات Google". يمكن تعديل أيّ قسم ليتضمّن 3 أعمدة كحدّ أقصى.

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

enum (ColumnSeparatorStyle)

نمط فواصل الأعمدة.

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

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

enum (ContentDirection)

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

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

object (Dimension)

هو هامش الصفحة العلوي للقسم. في حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على marginTop من DocumentStyle.

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

object (Dimension)

هامش الصفحة السفلي للقسم في حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على marginBottom من DocumentStyle.

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

object (Dimension)

هامش الصفحة الأيمن من القسم في حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على marginRight من DocumentStyle. يؤدي تعديل الهامش الأيمن إلى تغيير حجم الأعمدة في هذا القسم. وبما أنّ الهامش يؤثر في عرض العمود، يتم تطبيقه قبل خصائص العمود.

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

object (Dimension)

هامش الصفحة الأيسر من القسم في حال عدم ضبط القيمة، تكون القيمة التلقائية هي marginLeft من DocumentStyle. يؤدي تعديل الهامش الأيسر إلى تغيير حجم الأعمدة في هذا القسم. وبما أنّ الهامش يؤثر في عرض العمود، يتم تطبيقه قبل خصائص العمود.

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

object (Dimension)

هامش عنوان القسم في حال عدم ضبط القيمة، تكون القيمة التلقائية هي marginHeader من DocumentStyle. في حال تعديلها، يتم ضبط useCustomHeaderFooterMargins على true في DocumentStyle. تشير قيمة useCustomHeaderFooterMargins في DocumentStyle إلى ما إذا كان يتمّ الالتزام بهامش العنوان لهذا القسم.

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

object (Dimension)

هامش تذييل القسم. في حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على marginFooter من DocumentStyle. وفي حال تعديل السياسة، يتم ضبط useCustomHeaderFooterMargins على "صحيح" في DocumentStyle. تشير قيمة useCustomHeaderFooterMargins في DocumentStyle إلى ما إذا كان يتم الالتزام بهامش تذييل لهذا القسم.

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

enum (SectionType)

النتائج فقط. تمثّل هذه السمة نوع القسم.

string

رقم تعريف العنوان التلقائي. في حال عدم ضبط القيمة، يتم اكتسابها من سمة SectionBreak's SectionStyle السابقة. وفي حال ترك القيمة بدون ضبط في قسم SectionBreak الأول، سيتم اكتسابها من قيمة defaultHeaderId في DocumentStyle.

هذا الحقل للقراءة فقط.

string

معرّف التذييل التلقائي. في حال عدم ضبط القيمة، يتم اكتسابها من سمة SectionBreak's SectionStyle السابقة. في حال ترك القيمة بدون ضبط في قسم SectionBreak الأول، سيتم اكتسابها من قيمة defaultFooterId في DocumentStyle.

هذا الموقع للقراءة فقط.

string

رقم تعريف العنوان المستخدَم للصفحة الأولى من القسم فقط. إذا كانت useFirstPageHeaderFooter صحيحة، يتم استخدام هذه القيمة للرأس في الصفحة الأولى من القسم. وإذا كانت خاطئة، سيستخدم العنوان في الصفحة الأولى من القسم السمة defaultHeaderId. وفي حال ترك هذه السياسة بدون ضبط، يتم اكتساب القيمة من نمط القسم "SectionBreak's" السابق. إذا لم يتم ضبط القيمة في القسم الأول من "فاصل القسم"، يتم اكتسابها من firstPageHeaderId في "أسلوب المستند".

هذا الموقع للقراءة فقط.

string

رقم تعريف التذييل المستخدَم للصفحة الأولى من القسم فقط إذا كانت قيمة useFirstPageHeaderFooter صحيحة، يتم استخدام هذه القيمة للجزء السفلي من الصفحة في الصفحة الأولى من القسم. وإذا كانت خاطئة، يستخدم التذييل في الصفحة الأولى من القسم السمة defaultFooterId. في حال عدم ضبط القيمة، يتم اكتسابها من سمة SectionBreak's SectionStyle السابقة. في حال ترك القيمة بدون ضبط في قسم SectionBreak الأول، سيتم اكتسابها من قيمة firstPageFooterId في DocumentStyle.

هذا الموقع للقراءة فقط.

string

معرّف العنوان المستخدَم للصفحات الزوجية فقط. إذا كانت قيمة useEvenPageHeaderFooter في DocumentStyle صحيحة، يتم استخدام هذه القيمة للرؤوس في الصفحات الزوجية في القسم. وإذا كانت خاطئة، فإن رؤوس الصفحات الزوجية تستخدم defaultHeaderId. وفي حال ترك هذه السياسة بدون ضبط، يتم اكتساب القيمة من نمط القسم "SectionBreak's" السابق. إذا لم يتم ضبط القيمة في الفاصل الأول للقسم، يتم اكتسابها من evenPageHeaderId في DocumentStyle.

هذا الموقع للقراءة فقط.

string

يتم استخدام رقم تعريف التذييل في الصفحات الزوجية فقط. إذا كانت قيمة useEvenPageHeaderFooter في DocumentStyle صحيحة، يتم استخدام هذه القيمة للتذييلات في الصفحات الزوجية في القسم. أما إذا كانت القيمة "خطأ"، فستستخدم التذييلات في الصفحات الزوجية علامة defaultFooterId. وفي حال ترك هذه السياسة بدون ضبط، يتم اكتساب القيمة من نمط القسم "SectionBreak's" السابق. في حال ترك القيمة بدون ضبط في قسم SectionBreak الأول، سيتم اكتسابها من قيمة evenPageFooterId في DocumentStyle.

هذا الحقل للقراءة فقط.

boolean

يشير إلى ما إذا كان سيتم استخدام معرّفات الرأس / التذييل للصفحة الأولى للصفحة الأولى من القسم. في حال عدم ضبطها، يتم اكتسابها من useFirstPageHeaderFooter في DocumentStyle للقسم الأول. إذا لم يتم ضبط القيمة للقطاعات اللاحقة، يجب تفسيرها على أنّها خطأ.

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

integer

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

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

boolean

اختياريّ. يشير إلى ما إذا كان سيتم قلب سمة pageSize في DocumentStyle لهذا القسم، ما يسمح بتغيير اتجاه الصفحة بين الوضعَين العمودي والأفقي. في حال عدم ضبط القيمة، يتم اكتسابها من flipPageOrientation في DocumentStyle.

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

{
  "width": {
    object (Dimension)
  },
  "paddingEnd": {
    object (Dimension)
  }
}

object (Dimension)

النتائج فقط. عرض العمود.

object (Dimension)

المسافة الفارغة في نهاية العمود

{
  "rows": integer,
  "columns": integer,
  "tableRows": [
    {
      object (TableRow)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableStyle": {
    object (TableStyle)
  }
}

integer

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

integer

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

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

object (TableRow)

محتوى كل صف ونمطه

string

معرّفات الإدراج المقترَحة قد يحتوي Table على أرقام تعريف إدراج متعددة إذا كان تغييرًا مقترحًا مدمجًا. إذا كانت فارغة، فهذا لا يعني إدراجًا مقترحًا.

string

أرقام تعريف الحذف المقترَحة إذا كان الحقل فارغًا، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذا المحتوى.

object (TableStyle)

نمط الجدول.

{
  "startIndex": integer,
  "endIndex": integer,
  "tableCells": [
    {
      object (TableCell)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "suggestedTableRowStyleChanges": {
    string: {
      object (SuggestedTableRowStyle)
    },
    ...
  }
}

integer

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

integer

فهرس النهاية المستند إلى الصفر لهذا الصف، حصريًا، في وحدات ترميز UTF-16

object (TableCell)

محتوى كل خلية وأسلوبها في هذا الصف

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

string

معرّفات الإدراج المقترَحة قد يتضمّن العنصر TableRow أرقام تعريف إدراج متعددة إذا كان تغييرًا مقترَحا متداخلًا. إذا كانت فارغة، هذا يعني أنّها ليست إدراجًا مقترَحًا.

string

أرقام تعريف الحذف المقترَحة وإذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذا المحتوى.

object (TableRowStyle)

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

map (key: string, value: object (SuggestedTableRowStyle))

يتم تغيير النمط المقترح إلى هذا الصف، ويعتمد ذلك على رقم تعريف الاقتراح.

{
  "startIndex": integer,
  "endIndex": integer,
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "suggestedTableCellStyleChanges": {
    string: {
      object (SuggestedTableCellStyle)
    },
    ...
  }
}

integer

فهرس البدء المستند إلى الصفر لهذه الخلية، بوحدات ترميز UTF-16

integer

الفهرس النهائي القائم على صفر لهذه الخلية، حصري، بوحدات رمز UTF-16.

object (StructuralElement)

محتوى الخلية

object (TableCellStyle)

نمط الخلية.

string

معرّفات الإدراج المقترَحة قد يتضمّن العنصر TableCell أرقام تعريف إدراج متعددة إذا كان تغييرًا مقترَحا متداخلًا. إذا كانت فارغة، هذا يعني أنّها ليست إدراجًا مقترَحًا.

string

أرقام تعريف الحذف المقترَحة وإذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذا المحتوى.

map (key: string, value: object (SuggestedTableCellStyle))

التغييرات المقترحة على نمط خلية الجدول، استنادًا إلى رقم تعريف الاقتراح.

{
  "rowSpan": integer,
  "columnSpan": integer,
  "backgroundColor": {
    object (OptionalColor)
  },
  "borderLeft": {
    object (TableCellBorder)
  },
  "borderRight": {
    object (TableCellBorder)
  },
  "borderTop": {
    object (TableCellBorder)
  },
  "borderBottom": {
    object (TableCellBorder)
  },
  "paddingLeft": {
    object (Dimension)
  },
  "paddingRight": {
    object (Dimension)
  },
  "paddingTop": {
    object (Dimension)
  },
  "paddingBottom": {
    object (Dimension)
  },
  "contentAlignment": enum (ContentAlignment)
}

integer

امتداد الصف للخلية.

هذا الحقل للقراءة فقط.

integer

نطاق العمود للخلية

هذا الموقع للقراءة فقط.

object (OptionalColor)

لون خلفية الخلية.

object (TableCellBorder)

الحد الأيسر للخلية

object (TableCellBorder)

الحد الأيمن للخلية.

object (TableCellBorder)

الحد العلوي للخلية.

object (TableCellBorder)

الحدّ السفلي للخلية

object (Dimension)

المساحة المتروكة اليسرى للخلية.

object (Dimension)

المساحة الفارغة على يسار الخلية

object (Dimension)

المساحة المتروكة في أعلى الخلية

object (Dimension)

المساحة المتروكة في أسفل الخلية

enum (ContentAlignment)

محاذاة المحتوى في خلية الجدول يتطابق المحاذاة التلقائية مع محاذاة خلايا الجدول التي تم إنشاؤها حديثًا في محرِّر "مستندات Google".

{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}

object (OptionalColor)

لون الحدود

لا يمكن أن يكون هذا اللون شفافًا.

object (Dimension)

عرض الحدود.

enum (DashStyle)

نمط الخطوط المتقطّعة للحدود

{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "tableCellStyleSuggestionState": {
    object (TableCellStyleSuggestionState)
  }
}

object (TableCellStyle)

TableCellStyle يتضمّن التغييرات التي تم إجراؤها في هذا الاقتراح فقط ويمكن استخدام ذلك مع tableCellStyleSuggestionState للاطّلاع على الحقول التي تم تغييرها وقيمها الجديدة.

object (TableCellStyleSuggestionState)

قناع يشير إلى الحقول التي تم تغييرها في قاعدة TableCellStyle هذه في هذا الاقتراح

{
  "rowSpanSuggested": boolean,
  "columnSpanSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "paddingLeftSuggested": boolean,
  "paddingRightSuggested": boolean,
  "paddingTopSuggested": boolean,
  "paddingBottomSuggested": boolean,
  "contentAlignmentSuggested": boolean
}

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في rowSpan.

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في columnSpan.

boolean

يشير إلى ما إذا كان هناك تغيير مقترَح على backgroundColor.

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في borderLeft.

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في borderRight.

boolean

يشير إلى ما إذا كان هناك تغيير مقترَح على borderTop.

boolean

يشير إلى ما إذا كان هناك تغيير مقترَح على borderBottom.

boolean

يشير إلى ما إذا كان هناك تغيير مقترَح على paddingLeft.

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في paddingRight.

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في paddingTop.

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في paddingBottom.

boolean

يشير إلى ما إذا كان هناك تغيير مقترَح على contentAlignment.

{
  "minRowHeight": {
    object (Dimension)
  },
  "tableHeader": boolean,
  "preventOverflow": boolean
}

object (Dimension)

الحد الأدنى لارتفاع الصف سيتم عرض الصف في محرِّر "مستندات Google" بارتفاع يساوي هذه القيمة أو أكبر منها لعرض كل المحتوى في خلايا الصف.

boolean

ما إذا كان الصف هو عنوان جدول.

boolean

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

{
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "tableRowStyleSuggestionState": {
    object (TableRowStyleSuggestionState)
  }
}

object (TableRowStyle)

TableRowStyle يتضمّن التغييرات التي تم إجراؤها في هذا الاقتراح فقط ويمكن استخدام هذا الخيار مع tableRowStyleSuggestionState لمعرفة الحقول التي تم تغييرها وقيمها الجديدة.

object (TableRowStyleSuggestionState)

قناع يشير إلى الحقول التي تم تغييرها في قاعدة TableRowStyle هذه في هذا الاقتراح

{
  "minRowHeightSuggested": boolean
}

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في minRowHeight.

{
  "tableColumnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}

object (TableColumnProperties)

خصائص كل عمود.

يُرجى العلم أنّ الجداول في "مستندات Google" تحتوي على صفوف والصفوف تحتوي على خلايا، تمامًا مثل صفحات HTML. وبالتالي، يمكن العثور على خصائص الصف في tableRowStyle للصف.

{
  "widthType": enum (WidthType),
  "width": {
    object (Dimension)
  }
}

enum (WidthType)

نوع عرض العمود

object (Dimension)

عرض العمود. يتمّ ضبطها عندما يكون widthType للعمود هو FIXED_WIDTH.

{
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}

object (StructuralElement)

محتوى جدول المحتويات

string

معرّفات الإدراج المقترَحة قد يحتوي TableOfContents على أرقام تعريف إدراج متعددة إذا كان تغييرًا مقترحًا مدمجًا. إذا كانت فارغة، هذا يعني أنّها ليست إدراجًا مقترَحًا.

string

أرقام تعريف الحذف المقترَحة وإذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذا المحتوى.

{
  "headerId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

string

رقم تعريف العنوان.

object (StructuralElement)

محتوى العنوان

وتبدأ فهارس محتوى العنوان من الصفر.

{
  "footerId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

string

رقم تعريف التذييل.

object (StructuralElement)

محتوى التذييل.

تبدأ فهارس محتوى التذييل من الصفر.

{
  "footnoteId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

string

رقم تعريف الحاشية السفلية.

object (StructuralElement)

محتوى الحاشية السفلية

تبدأ الفهارس لمحتوى الحاشية من الصفر.

{
  "background": {
    object (Background)
  },
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "useEvenPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "pageSize": {
    object (Size)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "useCustomHeaderFooterMargins": boolean,
  "flipPageOrientation": boolean
}

object (Background)

خلفية المستند. لا يمكن أن يكون للمستندات لون خلفية شفاف.

string

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

هذا الموقع للقراءة فقط.

string

معرّف التذييل التلقائي. وفي حال تركها بدون ضبط، لن يكون هناك تذييل تلقائي.

هذا الحقل للقراءة فقط.

string

معرّف الرأس المستخدَم فقط للصفحات الزوجية تحدِّد قيمة useEvenPageHeaderFooter ما إذا كان سيتم استخدام defaultHeaderId أو هذه القيمة للعنوان في الصفحات الزوجية. في حال عدم ضبط هذا الخيار، لن يكون هناك عنوان للصفحات الزوجية.

هذا الموقع للقراءة فقط.

string

يتم استخدام رقم تعريف التذييل في الصفحات الزوجية فقط. تحدد قيمة useEvenPageHeaderFooter ما إذا كان سيتم استخدام defaultFooterId أو هذه القيمة للتذييل في الصفحات الزوجية. وفي حال تركها بدون ضبط، لن يظهر تذييل للصفحات الزوجية.

هذا الحقل للقراءة فقط.

string

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

هذا الحقل للقراءة فقط.

string

رقم تعريف التذييل المستخدَم للصفحة الأولى فقط. في حال عدم ضبطه، لن يتوفّر تذييل فريد للصفحة الأولى. تحدّد قيمة useFirstPageHeaderFooter ما إذا كان سيتم استخدام defaultFooterId أو هذه القيمة للجزء السفلي من الصفحة الأولى. وفي حال تركها بدون ضبط، لن يظهر تذييل للصفحة الأولى.

هذا الحقل للقراءة فقط.

boolean

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

boolean

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

integer

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

object (Dimension)

هامش الصفحة العلوي

يؤدي تحديث هامش الصفحة العلوية في نمط المستند إلى محو هامش الصفحة العلوي في جميع أنماط الأقسام.

object (Dimension)

هامش أسفل الصفحة.

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

object (Dimension)

هامش الصفحة الأيمن.

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

object (Dimension)

هامش الصفحة الأيسر.

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

object (Size)

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

object (Dimension)

مقدار المساحة بين أعلى الصفحة ومحتوى العنوان

object (Dimension)

مقدار المساحة بين أسفل الصفحة ومحتوى التذييل

boolean

يشير إلى ما إذا كان يتم الالتزام بـ DocumentStyle marginHeader وSectionStyle marginHeader وDocumentStyle marginFooter وSectionStyle marginFooter. عند ضبط هذه السياسة على "خطأ"، يتم استخدام القيم التلقائية لهامش رأس الصفحة وتذييلها في "أدوات تحرير المستندات".

هذا الحقل للقراءة فقط.

boolean

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

{
  "color": {
    object (OptionalColor)
  }
}

object (OptionalColor)