REST Resource: documents

المرجع: مستند

مستند في "مستندات Google"

تمثيل JSON 
{
  "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)
    },
    ...
  }
}
الحقول
documentId

string

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

string

تمثّل هذه السمة عنوان المستند.
tabs[]

object (Tab)

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

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

string

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

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

enum (SuggestionsViewMode)

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

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

object (Body)

النتائج فقط. تمثّل هذه السمة النص الأساسي للمستند.

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

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

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

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

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

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

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

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

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

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

object (DocumentStyle)

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

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

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

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

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

object (NamedStyles)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

علامة تبويب

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

تمثيل JSON 
{
  "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.
}
الحقول
tabProperties

object (TabProperties)

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

object (Tab)

علامات التبويب الفرعية المتداخلة داخل علامة التبويب هذه.
حقل الاتحاد content. محتوى علامة التبويب يمكن أن يكون content واحدًا فقط مما يلي:
documentTab

object (DocumentTab)

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

TabProperties

خصائص علامة التبويب

تمثيل JSON 
{
  "tabId": string,
  "title": string,
  "parentTabId": string,
  "index": integer,
  "nestingLevel": integer
}
الحقول
tabId

string

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

string

اسم علامة التبويب المرئي للمستخدم
parentTabId

string

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

integer

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

integer

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

DocumentTab

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

تمثيل JSON 
{
  "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)
    },
    ...
  }
}
الحقول
body

object (Body)

النص الأساسي لعلامة التبويب في المستند.
headers

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

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

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

التذييلات في علامة تبويب المستند، تعتمد على رقم تعريف التذييل.
footnotes

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

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

object (DocumentStyle)

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

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

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

object (NamedStyles)

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

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

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

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

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

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

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

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

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

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

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

النص الأساسي

نص المستند.

يشتمل النص عادةً على محتوى المستند بالكامل باستثناء headers وfooters وfootnotes.

تمثيل JSON 
{
  "content": [
    {
      object (StructuralElement)
    }
  ]
}
الحقول
content[]

object (StructuralElement)

محتوى الجسم

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

StructuralElement

يصف StructialElement المحتوى الذي يوفر هيكلاً للوثيقة.

تمثيل JSON 
{
  "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.
}
الحقول
startIndex

integer

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

integer

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

object (Paragraph)

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

object (SectionBreak)

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

object (Table)

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

object (TableOfContents)

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

الفقرة

تمثّل هذه السمة StructuralElement فقرة. الفقرة هي نطاق من المحتوى يتم إنهاؤه بحرف جديد.

تمثيل JSON 
{
  "elements": [
    {
      object (ParagraphElement)
    }
  ],
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "suggestedParagraphStyleChanges": {
    string: {
      object (SuggestedParagraphStyle)
    },
    ...
  },
  "bullet": {
    object (Bullet)
  },
  "suggestedBulletChanges": {
    string: {
      object (SuggestedBullet)
    },
    ...
  },
  "positionedObjectIds": [
    string
  ],
  "suggestedPositionedObjectIds": {
    string: {
      object (ObjectReferences)
    },
    ...
  }
}
الحقول
elements[]

object (ParagraphElement)

محتوى الفقرة مقسمًا إلى الأجزاء المكونة لها.
paragraphStyle

object (ParagraphStyle)

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

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

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

object (Bullet)

الرمز النقطي لهذه الفقرة. في حال عدم توفّر الفقرة، لا تنتمي الفقرة إلى قائمة.
suggestedBulletChanges

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

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

string

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

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

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

ParagraphElement

تصف فقرة الفقرة المحتوى المتوفّر ضمن Paragraph.

تمثيل JSON 
{
  "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.
}
الحقول
startIndex

integer

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

integer

فهرس النهاية الصفرية لعنصر الفقرة هذا، بشكل حصري، بوحدات رمز UTF-16.
حقل الاتحاد content. محتوى عنصر الفقرة. يمكن أن يكون content واحدًا فقط مما يلي:
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)

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

TextRun

تمثّل هذه السمة ParagraphElement مجموعة نصية من جميع النصوص التي لها النمط نفسه.

تمثيل JSON 
{
  "content": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
الحقول
content

string

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

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

string

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

string

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

object (TextStyle)

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

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

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

نمط النص

يمثل النمط الذي يمكن تطبيقه على النص.

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

  • يتم اكتساب نمط النص في Paragraph من عنصر named style type المقابل للفقرة.
  • يتم اكتساب نمط النص في named style من النمط normal text المُسمى.
  • يتم اكتساب نمط النص للنمط المُسمّى normal text من نمط النص التلقائي في أدوات تحرير المستندات.
  • قد يكتسب نمط النص في عنصر Paragraph المضمّن في جدول نمط النص من نمط الجدول.

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

تمثيل JSON 
{
  "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)
  }
}
الحقول
bold

boolean

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

boolean

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

boolean

ما إذا كان النص مسطرًا أم لا
strikethrough

boolean

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

boolean

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

object (OptionalColor)

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

object (OptionalColor)

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

object (Dimension)

حجم خط النص
weightedFontFamily

object (WeightedFontFamily)

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

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

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

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

enum (BaselineOffset)

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

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

OptionalColor

لون يمكن أن يكون معتمًا بالكامل أو شفافًا بالكامل.

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

object (Color)

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

اللون

لون خالص

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

object (RgbColor)

تمثّل هذه السمة قيمة اللون RGB.

RgbColor

لون النموذج اللوني أحمر أخضر أزرق (RGB)

تمثيل JSON 
{
  "red": number,
  "green": number,
  "blue": number
}
الحقول
red

number

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

number

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

number

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

السمة

حجم في اتجاه واحد بالوحدات المحددة.

تمثيل JSON 
{
  "magnitude": number,
  "unit": enum (Unit)
}
الحقول
magnitude

number

المقدار.
unit

enum (Unit)

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

الوحدة

وحدات القياس.

عمليات التعداد
UNIT_UNSPECIFIED الوحدات غير معروفة.
PT نقطة، 1/72 من البوصة.

WeightedFontFamily

يمثل مجموعة الخطوط وحجم النص.

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

string

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

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

integer

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

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

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

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

BaselineOffset

الطرق التي يمكن بها إزاحة النص عموديًا عن موضعه العادي.

عمليات التعداد
BASELINE_OFFSET_UNSPECIFIED يتم اكتساب إزاحة خط الأساس للنص من العنصر الرئيسي.
NONE لا تتم إزاحة النص عموديًا.
SUPERSCRIPT تتم إزاحة النص عموديًا لأعلى (مرتفع).
SUBSCRIPT تتم إزاحة النص عموديًا إلى أسفل (نص منخفض).

SuggestedTextStyle

تغيير مقترَح إلى TextStyle

تمثيل JSON 
{
  "textStyle": {
    object (TextStyle)
  },
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}
الحقول
textStyle

object (TextStyle)

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

object (TextStyleSuggestionState)

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

TextStyleSuggestionState

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

تمثيل JSON 
{
  "boldSuggested": boolean,
  "italicSuggested": boolean,
  "underlineSuggested": boolean,
  "strikethroughSuggested": boolean,
  "smallCapsSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "foregroundColorSuggested": boolean,
  "fontSizeSuggested": boolean,
  "weightedFontFamilySuggested": boolean,
  "baselineOffsetSuggested": boolean,
  "linkSuggested": boolean
}
الحقول
boldSuggested

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

AutoText

تمثّل هذه السمة ParagraphElement موضعًا في النص يتم استبداله ديناميكيًا بمحتوى يمكن أن يتغيّر بمرور الوقت، مثل رقم الصفحة.

تمثيل JSON 
{
  "type": enum (Type),
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
الحقول
type

enum (Type)

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

string

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

string

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

object (TextStyle)

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

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

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

النوع

أنواع النص التلقائي

عمليات التعداد
TYPE_UNSPECIFIED نوع نص تلقائي غير محدَّد
PAGE_NUMBER اكتب نصًّا تلقائيًا يمثّل رقم الصفحة الحالية.
PAGE_COUNT اكتب نصًا تلقائيًا يمثّل إجمالي عدد الصفحات في المستند.

PageBreak

ParagraphElement يمثّل فاصل صفحة. يؤدي فاصل الصفحة إلى بدء النص اللاحق أعلى الصفحة التالية.

تمثيل JSON 
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
الحقول
suggestedInsertionIds[]

string

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

string

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

object (TextStyle)

نمط نص فاصل الصفحات هذا.

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

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

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

ColumnBreak

تمثّل هذه السمة ParagraphElement فاصل أعمدة. يؤدي فاصل العمود إلى بدء النص اللاحق أعلى العمود التالي.

تمثيل JSON 
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
الحقول
suggestedInsertionIds[]

string

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

string

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

object (TextStyle)

نمط النص لفاصل العمود هذا.

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

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

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

FootnoteReference

عنصر ParagraphElement يمثل مرجع حاشية سفلية. مرجع الحاشية السفلية هو المحتوى المضمّن المعروض برقم ويتم استخدامه لتحديد الحاشية السفلية.

تمثيل JSON 
{
  "footnoteId": string,
  "footnoteNumber": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
الحقول
footnoteId

string

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

string

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

string

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

string

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

object (TextStyle)

نمط النص في FootnoteReference.
suggestedTextStyleChanges

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

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

HorizontalRule

عنصر ParagraphElement يمثل خطًا أفقيًا

تمثيل JSON 
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
الحقول
suggestedInsertionIds[]

string

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

string

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

object (TextStyle)

نمط النص لهذه القاعدة الأفقية.

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

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

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

معادلة

تمثّل هذه السمة ParagraphElement معادلة.

تمثيل JSON 
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}
الحقول
suggestedInsertionIds[]

string

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

string

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

InlineObjectElement

السمة ParagraphElement التي تحتوي على InlineObject

تمثيل JSON 
{
  "inlineObjectId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
الحقول
inlineObjectId

string

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

string

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

string

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

object (TextStyle)

نمط النص لـ InlineObjectElement هذا.

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

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

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

شخص

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

تمثيل JSON 
{
  "personId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "personProperties": {
    object (PersonProperties)
  }
}
الحقول
personId

string

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

string

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

string

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

object (TextStyle)

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

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

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

object (PersonProperties)

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

PersonProperties

المواقع الخاصة بـ Person مرتبط

تمثيل JSON 
{
  "name": string,
  "email": string
}
الحقول
name

string

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

string

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

RichLinkProperties

الخصائص الخاصة بـ RichLink.

تمثيل JSON 
{
  "title": string,
  "uri": string,
  "mimeType": string
}
الحقول
title

string

النتائج فقط. تمثّل هذه السمة عنوان RichLink كما هو موضّح في الرابط. يتطابق هذا العنوان مع عنوان المورد المرتبط عند إدراج الرابط أو آخر تعديل له. هذا الحقل موجود دائمًا.
uri

string

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

string

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

نمط الفقرة

الأنماط التي تنطبق على فقرة كاملة

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

  • يكتسِب نمط الفقرة في Paragraph من عنصر named style type المقابل للفقرة.
  • نمط الفقرة في named style مكتسب من النمط المسمى normal text.
  • يكتسب نمط الفقرة الخاص بالنمط المُسمّى normal text من نمط الفقرة التلقائي في أداة تحرير المستندات.
  • قد يكتسب نمط الفقرة في عنصر Paragraph المضمّن في جدول نمط الفقرة الخاص به من نمط الجدول.

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

تمثيل JSON 
{
  "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
}
الحقول
headingId

string

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

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

enum (NamedStyleType)

نوع النمط المسمى للفقرة.

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

enum (Alignment)

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

number

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

enum (ContentDirection)

اتجاه نص هذه الفقرة. في حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على LEFT_TO_RIGHT لأنّ اتجاه الفقرة غير مكتسب.
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

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

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

NamedStyleType

أنواع الأنماط المُعنونة.

عمليات التعداد
NAMED_STYLE_TYPE_UNSPECIFIED نوع النمط المسمى غير محدد.
NORMAL_TEXT نص عادي.
TITLE العنوان.
SUBTITLE العنوان الفرعي.
HEADING_1 العنوان 1.
HEADING_2 العنوان 2.
HEADING_3 العنوان 3.
HEADING_4 العنوان 4.
HEADING_5 العنوان 5.
HEADING_6 العنوان 6.

محاذاة

أنواع محاذاة النص لفقرة.

عمليات التعداد
ALIGNMENT_UNSPECIFIED محاذاة الفقرة مكتسبة من العنصر الرئيسي.
START تتم محاذاة الفقرة مع بداية السطر. تمت المحاذاة إلى اليسار لنص LTR، والمحاذاة لليمين بخلاف ذلك.
CENTER يتم توسيط الفقرة.
END تتم محاذاة الفقرة مع نهاية السطر. تمت المحاذاة لليمين مع نص LTR، والمحاذاة لليسار.
JUSTIFIED تم تبرير الفقرة.

ContentDirection

يمكن أن يتدفق محتوى الاتجاهات.

عمليات التعداد
CONTENT_DIRECTION_UNSPECIFIED لم يتم تحديد اتجاه المحتوى.
LEFT_TO_RIGHT ينتقل المحتوى من اليسار إلى اليمين.
RIGHT_TO_LEFT انتقال المحتوى من اليسار إلى اليمين.

SpacingMode

الأوضاع المختلفة لتباعد الفقرات.

عمليات التعداد
SPACING_MODE_UNSPECIFIED وضع التباعد مكتسَب من المؤسسة الرئيسية.
NEVER_COLLAPSE يتم عرض تباعد الفقرات دائمًا.
COLLAPSE_LISTS يتم تخطّي تباعد الفقرات بين عناصر القائمة.

ParagraphBorder

حدود حول فقرة

تمثيل JSON 
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "padding": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}
الحقول
color

object (OptionalColor)

لون الحدود
width

object (Dimension)

عرض الحدود.
padding

object (Dimension)

المساحة المتروكة للحدود.
dashStyle

enum (DashStyle)

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

DashStyle

أنواع الشرطات التي يمكن عرض الهندسة الخطية باستخدامها. تستند هذه القيم إلى دالة "ST_PresetLineDashVal" بسيطة كما هو موضح في القسم 20.1.10.48 من "تنسيقات ملفات Office Open XML - الأساسيات ومراجع اللغة الترميزية"، الجزء 1 من ECMA-376 الإصدار الرابع.

عمليات التعداد
DASH_STYLE_UNSPECIFIED نمط شرطة غير محدّد
SOLID خط متصل يتوافق مع قيمة ECMA-376 ST_PresetLineDashVal "solid". هذا هو نمط الشرطة التلقائي.
DOT خط منقط يتوافق مع قيمة ECMA-376 ST_PresetLineDashVal 'dot'.
DASH خط متقطع. يتوافق مع قيمة ECMA-376 ST_PresetLineDashVal "شرطة".

TabStop

علامة جدولة داخل فقرة.

تمثيل JSON 
{
  "offset": {
    object (Dimension)
  },
  "alignment": enum (TabStopAlignment)
}
الحقول
offset

object (Dimension)

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

enum (TabStopAlignment)

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

TabStopAlignment

محاذاة علامة الجدولة.

عمليات التعداد
TAB_STOP_ALIGNMENT_UNSPECIFIED لم يتم تحديد محاذاة علامة الجدولة.
START تتم محاذاة علامة الجدولة مع بداية السطر. هذا هو الخيار التلقائي.
CENTER تتم محاذاة محطة الجدولة إلى وسط الخط.
END تتم محاذاة علامة الجدولة إلى نهاية السطر.

تظليل

تظليل الفقرة.

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

object (OptionalColor)

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

SuggestedParagraphStyle

تغيير مقترَح إلى ParagraphStyle

تمثيل JSON 
{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}
الحقول
paragraphStyle

object (ParagraphStyle)

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

object (ParagraphStyleSuggestionState)

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

ParagraphStyleSuggestionState

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

تمثيل JSON 
{
  "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
}
الحقول
headingIdSuggested

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

object (ShadingSuggestionState)

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

boolean

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

ShadingSuggestionState

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

تمثيل JSON 
{
  "backgroundColorSuggested": boolean
}
الحقول
backgroundColorSuggested

boolean

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

تعداد نقطي

لوصف الرمز النقطي للفقرة.

تمثيل JSON 
{
  "listId": string,
  "nestingLevel": integer,
  "textStyle": {
    object (TextStyle)
  }
}
الحقول
listId

string

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

integer

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

object (TextStyle)

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

SuggestedBullet

تغيير مقترَح إلى Bullet

تمثيل JSON 
{
  "bullet": {
    object (Bullet)
  },
  "bulletSuggestionState": {
    object (BulletSuggestionState)
  }
}
الحقول
bullet

object (Bullet)

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

object (BulletSuggestionState)

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

BulletSuggestionState

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

تمثيل JSON 
{
  "listIdSuggested": boolean,
  "nestingLevelSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}
الحقول
listIdSuggested

boolean

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

boolean

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

object (TextStyleSuggestionState)

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

ObjectReferences

مجموعة من معرّفات العناصر.

تمثيل JSON 
{
  "objectIds": [
    string
  ]
}
الحقول
objectIds[]

string

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

SectionBreak

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

يبدأ نص المستند دائمًا بفاصل أقسام.

تمثيل JSON 
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "sectionStyle": {
    object (SectionStyle)
  }
}
الحقول
suggestedInsertionIds[]

string

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

string

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

object (SectionStyle)

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

SectionStyle

النمط الذي ينطبق على القسم.

تمثيل JSON 
{
  "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
}
الحقول
columnProperties[]

object (SectionColumnProperties)

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

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

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

enum (ColumnSeparatorStyle)

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

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

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

enum (ContentDirection)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

enum (SectionType)

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

string

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

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

string

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

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

string

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

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

string

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

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

string

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

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

boolean

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

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

integer

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

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

boolean

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

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

SectionColumnProperties

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

تمثيل JSON 
{
  "width": {
    object (Dimension)
  },
  "paddingEnd": {
    object (Dimension)
  }
}
الحقول
width

object (Dimension)

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

object (Dimension)

المساحة المتروكة في نهاية العمود.

ColumnSeparatorStyle

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

عمليات التعداد
COLUMN_SEPARATOR_STYLE_UNSPECIFIED نمط فاصل عمود غير محدَّد
NONE لا توجد خطوط فاصلة بين الأعمدة.
BETWEEN_EACH_COLUMN لعرض خط فاصل بين كل عمود

SectionType

يمثل هذا الحقل موضع بداية القسم الحالي بالنسبة إلى القسم السابق.

عمليات التعداد
SECTION_TYPE_UNSPECIFIED لم يتم تحديد نوع القسم.
CONTINUOUS يبدأ القسم بعد الفقرة الأخيرة من القسم السابق مباشرةً.
NEXT_PAGE يبدأ القسم في الصفحة التالية.

جدول

تمثّل هذه السمة StructuralElement جدولاً.

تمثيل JSON 
{
  "rows": integer,
  "columns": integer,
  "tableRows": [
    {
      object (TableRow)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableStyle": {
    object (TableStyle)
  }
}
الحقول
rows

integer

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

integer

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

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

object (TableRow)

محتوى ونمط كل صف.
suggestedInsertionIds[]

string

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

string

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

object (TableStyle)

نمط الجدول.

TableRow

محتوى ونمط صف في Table

تمثيل JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "tableCells": [
    {
      object (TableCell)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "suggestedTableRowStyleChanges": {
    string: {
      object (SuggestedTableRowStyle)
    },
    ...
  }
}
الحقول
startIndex

integer

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

integer

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

object (TableCell)

محتوى ونمط كل خلية في هذا الصف.

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

string

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

string

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

object (TableRowStyle)

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

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

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

TableCell

محتوى ونمط خلية في Table

تمثيل JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "suggestedTableCellStyleChanges": {
    string: {
      object (SuggestedTableCellStyle)
    },
    ...
  }
}
الحقول
startIndex

integer

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

integer

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

object (StructuralElement)

محتوى الخلية.
tableCellStyle

object (TableCellStyle)

نمط الخلية.
suggestedInsertionIds[]

string

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

string

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

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

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

TableCellStyle

نمط TableCell.

يتم تمثيل أنماط خلايا الجدول المكتسَبة كحقول لم يتم ضبطها في هذه الرسالة. يمكن أن يكتسب نمط خلية الجدول من نمط الجدول.

تمثيل JSON 
{
  "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)
}
الحقول
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)

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

TableCellBorder

حد حول خلية جدول.

لا يمكن أن تكون حدود خلايا الجدول شفافة. لإخفاء حد خلية الجدول، اجعل عرضه 0.

تمثيل JSON 
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}
الحقول
color

object (OptionalColor)

لون الحدود

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

object (Dimension)

عرض الحدود.
dashStyle

enum (DashStyle)

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

ContentAlignment

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

مشتقة من مجموعة فرعية من قيم "ST_TextAnchoringType" بسيطة في القسم 20.1.10.59 من "تنسيقات ملفات Office Open XML - الأساسيات ومراجع اللغة الترميزية"، الجزء 1 من ECMA-376 الإصدار الرابع.

عمليات التعداد
CONTENT_ALIGNMENT_UNSPECIFIED محاذاة محتوى غير محدّدة يتم اكتساب محاذاة المحتوى من العنصر الرئيسي في حالة وجوده.
CONTENT_ALIGNMENT_UNSUPPORTED عدم توافق المحتوى:
TOP محاذاة محاذاة المحتوى إلى أعلى مالك المحتوى يتوافق مع ECMA-376 ST_TextAnchoringType 't'.
MIDDLE محاذاة محاذاة المحتوى إلى منتصف مالك المحتوى يتطابق مع ECMA-376 ST_TextAnchoringType 'ctr'.
BOTTOM محاذاة محاذاة المحتوى لأسفل مالك المحتوى. يتوافق مع ECMA-376 ST_TextAnchoringType 'b'.

SuggestedTableCellStyle

تغيير مقترَح إلى TableCellStyle

تمثيل JSON 
{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "tableCellStyleSuggestionState": {
    object (TableCellStyleSuggestionState)
  }
}
الحقول
tableCellStyle

object (TableCellStyle)

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

object (TableCellStyleSuggestionState)

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

TableCellStyleSuggestionState

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

تمثيل JSON 
{
  "rowSpanSuggested": boolean,
  "columnSpanSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "paddingLeftSuggested": boolean,
  "paddingRightSuggested": boolean,
  "paddingTopSuggested": boolean,
  "paddingBottomSuggested": boolean,
  "contentAlignmentSuggested": boolean
}
الحقول
rowSpanSuggested

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

TableRowStyle

الأنماط التي تنطبق على صف في الجدول

تمثيل JSON 
{
  "minRowHeight": {
    object (Dimension)
  },
  "tableHeader": boolean,
  "preventOverflow": boolean
}
الحقول
minRowHeight

object (Dimension)

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

boolean

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

boolean

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

SuggestedTableRowStyle

تغيير مقترَح إلى TableRowStyle

تمثيل JSON 
{
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "tableRowStyleSuggestionState": {
    object (TableRowStyleSuggestionState)
  }
}
الحقول
tableRowStyle

object (TableRowStyle)

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

object (TableRowStyleSuggestionState)

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

TableRowStyleSuggestionState

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

تمثيل JSON 
{
  "minRowHeightSuggested": boolean
}
الحقول
minRowHeightSuggested

boolean

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

TableStyle

الأنماط التي تنطبق على الجدول.

تمثيل JSON 
{
  "tableColumnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
الحقول
tableColumnProperties[]

object (TableColumnProperties)

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

ملاحظة: في "مستندات Google"، تحتوي الجداول على صفوف وصفوف تحتوي على خلايا، وهي تشبه HTML. وبالتالي، يمكن العثور على سمات أحد الصفوف في tableRowStyle للصف.

TableColumnProperties

خصائص العمود في الجدول.

تمثيل JSON 
{
  "widthType": enum (WidthType),
  "width": {
    object (Dimension)
  }
}
الحقول
widthType

enum (WidthType)

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

object (Dimension)

عرض العمود. يتم ضبط هذه القيمة عند ضبط قيمة widthType في العمود على FIXED_WIDTH.

WidthType

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

عمليات التعداد
WIDTH_TYPE_UNSPECIFIED لم يتم تحديد نوع عرض العمود.
EVENLY_DISTRIBUTED

يتم توزيع عرض العمود بالتساوي بين الأعمدة الأخرى الموزعة بالتساوي.

ويتم تحديد عرض العمود تلقائيًا وسيكون له جزء مساوٍ من العرض المتبقي للجدول بعد مراعاة جميع الأعمدة ذات العرض المحدّد.
FIXED_WIDTH عرض عمود ثابت. تحتوي السمة [width][google.apps.docs.v1.TableColumnProperties.width على عرض العمود.

TableOfContents

تمثّل هذه السمة StructuralElement جدول محتوى.

تمثيل JSON 
{
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}
الحقول
content[]

object (StructuralElement)

محتوى جدول المحتويات.
suggestedInsertionIds[]

string

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

string

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

حاشية سفلية

حاشية سفلية لمستند

تمثيل JSON 
{
  "footnoteId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}
الحقول
footnoteId

string

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

object (StructuralElement)

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

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

DocumentStyle

نمط المستند.

تمثيل JSON 
{
  "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
}
الحقول
background

object (Background)

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

string

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

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

string

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

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

string

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

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

string

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

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

string

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

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

boolean

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

boolean

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

integer

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

object (Dimension)

هامش أعلى الصفحة

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

object (Dimension)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

object (Size)

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

object (Dimension)

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

boolean

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

الخلفية

يمثّل خلفية أحد المستندات.

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

object (OptionalColor)

لون الخلفية

حجم الملف

العرض والارتفاع.

تمثيل JSON 
{
  "height": {
    object (Dimension)
  },
  "width": {
    object (Dimension)
  }
}
الحقول
height

object (Dimension)

تمثّل هذه السمة ارتفاع العنصر.
width

object (Dimension)

تمثّل هذه السمة عرض العنصر.

SuggestedDocumentStyle

تغيير مقترَح على DocumentStyle

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

object (DocumentStyle)

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

object (DocumentStyleSuggestionState)

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

DocumentStyleSuggestionState

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

تمثيل JSON 
{
  "backgroundSuggestionState": {
    object (BackgroundSuggestionState)
  },
  "defaultHeaderIdSuggested": boolean,
  "defaultFooterIdSuggested": boolean,
  "evenPageHeaderIdSuggested": boolean,
  "evenPageFooterIdSuggested": boolean,
  "firstPageHeaderIdSuggested": boolean,
  "firstPageFooterIdSuggested": boolean,
  "useFirstPageHeaderFooterSuggested": boolean,
  "useEvenPageHeaderFooterSuggested": boolean,
  "pageNumberStartSuggested": boolean,
  "marginTopSuggested": boolean,
  "marginBottomSuggested": boolean,
  "marginRightSuggested": boolean,
  "marginLeftSuggested": boolean,
  "pageSizeSuggestionState": {
    object (SizeSuggestionState)
  },
  "marginHeaderSuggested": boolean,
  "marginFooterSuggested": boolean,
  "useCustomHeaderFooterMarginsSuggested": boolean,
  "flipPageOrientationSuggested": boolean
}
الحقول
backgroundSuggestionState

object (BackgroundSuggestionState)

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

object (SizeSuggestionState)

قناع يشير إلى الحقول في [size] تم تغيير [google.apps.docs.v1.DocumentStyle.size] في هذا الاقتراح.
marginHeaderSuggested

boolean

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

boolean

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

BackgroundSuggestionState

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

تمثيل JSON 
{
  "backgroundColorSuggested": boolean
}
الحقول
backgroundColorSuggested

boolean

يشير إلى ما إذا كان لون الخلفية الحالي قد تم تعديله في هذا الاقتراح.

SizeSuggestionState

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

تمثيل JSON 
{
  "heightSuggested": boolean,
  "widthSuggested": boolean
}
الحقول
heightSuggested

boolean

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

boolean

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

NamedStyles

الأنماط المُعنونة. يمكن أن تكتسب الفقرات في المستند TextStyle وParagraphStyle من هذه الأنماط المُسمّاة.

تمثيل JSON 
{
  "styles": [
    {
      object (NamedStyle)
    }
  ]
}
الحقول
styles[]

object (NamedStyle)

الأنماط المُعنونة.

يتوفّر إدخال لكل named style types من القيم المحتملة.

NamedStyle

نمط مُسمّى. يمكن أن تكتسب الفقرات في المستند TextStyle وParagraphStyle من هذا النمط المُسمّى عندما يكون لها نوع النمط المُسمى نفسه.

تمثيل JSON 
{
  "namedStyleType": enum (NamedStyleType),
  "textStyle": {
    object (TextStyle)
  },
  "paragraphStyle": {
    object (ParagraphStyle)
  }
}
الحقول
namedStyleType

enum (NamedStyleType)

نوع هذا النمط المسمى.
textStyle

object (TextStyle)

نمط النص لهذا النمط المحدد.
paragraphStyle

object (ParagraphStyle)

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

SuggestedNamedStyles

تغيير مقترَح على NamedStyles

تمثيل JSON 
{
  "namedStyles": {
    object (NamedStyles)
  },
  "namedStylesSuggestionState": {
    object (NamedStylesSuggestionState)
  }
}
الحقول
namedStyles

object (NamedStyles)

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

object (NamedStylesSuggestionState)

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

NamedStylesSuggestionState

حالة الاقتراح لرسالة NamedStyles

تمثيل JSON 
{
  "stylesSuggestionStates": [
    {
      object (NamedStyleSuggestionState)
    }
  ]
}
الحقول
stylesSuggestionStates[]

object (NamedStyleSuggestionState)

قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح ضمن NamedStyle المقابلة في styles.

يتطابق ترتيب حالات اقتراحات الأنماط المُسمّاة هذه مع ترتيب النمط المُسمّى المقابل ضمن اقتراح named styles.

NamedStyleSuggestionState

حالة اقتراح لرسالة NamedStyle

تمثيل JSON 
{
  "namedStyleType": enum (NamedStyleType),
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}
الحقول
namedStyleType

enum (NamedStyleType)

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

يتم توفير هذا الحقل لتسهيل مطابقة حالة NamedStylesuggestionState مع NamedStyle المقابلة لها.
textStyleSuggestionState

object (TextStyleSuggestionState)

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

object (ParagraphStyleSuggestionState)

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

قائمة

تمثل القائمة سمات القائمة لمجموعة من الفقرات التي تنتمي جميعها إلى القائمة نفسها. تشتمل الفقرة التي هي جزء من القائمة على مرجع إلى رقم تعريف القائمة في bullet الخاصة بها.

تمثيل JSON 
{
  "listProperties": {
    object (ListProperties)
  },
  "suggestedListPropertiesChanges": {
    string: {
      object (SuggestedListProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
الحقول
listProperties

object (ListProperties)

خصائص القائمة.
suggestedListPropertiesChanges

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

التغييرات المقترَحة على خصائص القائمة، استنادًا إلى رقم تعريف الاقتراح
suggestedInsertionId

string

رقم تعريف الإدراج المقترَح إذا كانت فارغة، فهذا لا يعني إدراجًا مقترحًا.
suggestedDeletionIds[]

string

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

ListProperties

سمات list التي تصف شكل ومضمون الرموز النقطية التي تنتمي إلى الفقرات المرتبطة بقائمة.

تمثيل JSON 
{
  "nestingLevels": [
    {
      object (NestingLevel)
    }
  ]
}
الحقول
nestingLevels[]

object (NestingLevel)

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

تحتوي القائمة على 9 مستويات تداخل بحد أقصى مع مستوى التداخل 0 المقابل للمستوى الأعلى ومستوى التداخل 8 الذي يتوافق مع المستوى الأكثر دمجًا. يتم عرض مستويات التداخل بترتيب تصاعدي مع إرجاع الأقل متداخلة أولاً.

NestingLevel

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

تمثيل JSON 
{
  "bulletAlignment": enum (BulletAlignment),
  "glyphFormat": string,
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "textStyle": {
    object (TextStyle)
  },
  "startNumber": integer,

  // Union field glyph_kind can be only one of the following:
  "glyphType": enum (GlyphType),
  "glyphSymbol": string
  // End of list of possible types for union field glyph_kind.
}
الحقول
bulletAlignment

enum (BulletAlignment)

محاذاة الرمز النقطي داخل المساحة المخصصة لعرض الرمز النقطي.
glyphFormat

string

سلسلة التنسيق المستخدمة بواسطة الرموز النقطية في هذا المستوى من التداخل.

يحتوي تنسيق الرسم البياني على عنصر نائب واحد أو أكثر، ويتم استبدال هذه العناصر النائبة بالقيم المناسبة استنادًا إلى glyphType أو glyphSymbol. تتبع العناصر النائبة النمط %[nestingLevel]. علاوة على ذلك، يمكن أن تحتوي العناصر النائبة على بادئات ولاحقات. وبالتالي، يتبع تنسيق الرسم البياني النمط <prefix>%[nestingLevel]<suffix>. ملاحظة: البادئة واللاحقة اختياريتان ويمكن أن تكونا سلاسل عشوائية.

على سبيل المثال، يشير تنسيق الأحرف الرسومية %0. إلى أنّ الحرف الرسومي المعروض سيستبدل العنصر النائب بالحرف الرسومي المقابل لمستوى التداخل 0 متبوعًا بنقطة كلاحقة. وبالتالي، إذا كانت القائمة تتضمن نوعًا من الأحرف الرسومية UPPER_ALPHA وذات التنسيق الرسومي %0. في مستوى التداخل 0، سيتم إنشاء قائمة تحتوي على أحرف رسومية يتم عرضها.

A.

B.

C.

يمكن أن يحتوي تنسيق الرسم البياني على عناصر نائبة لمستوى التداخل الحالي بالإضافة إلى عناصر نائبة لمستويات التداخل الرئيسي. على سبيل المثال، يمكن أن تحتوي القائمة على تنسيق حرفي %0. في مستوى التداخل 0 وتنسيق حرفي %0.%1. في مستوى التداخل 1. على افتراض أنّ مستويَي التداخل يحتويان على DECIMAL نوع رسوم رسومية، قد يؤدّي ذلك إلى إنشاء قائمة تحتوي على رموز رسومية معروضة.

1.

2.

2.1.

2.2.

3.

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

object (Dimension)

مقدار المسافة البادئة للسطر الأول من الفقرات في هذا المستوى من التداخل.
indentStart

object (Dimension)

مقدار المسافة البادئة للفقرات في هذا المستوى من التداخل. يُطبَّق على الجانب الذي يتوافق مع بداية النص، بناءً على اتجاه محتوى الفقرة.
textStyle

object (TextStyle)

نمط نص الرموز النقطية في هذا المستوى من التداخل.
startNumber

integer

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

ويتم التعامل مع القيمة 0 على أنّها القيمة 1 للقوائم ذات الأحرف الكبيرة وقوائم الأرقام الرومانية. بالنسبة إلى القيمتين 0 و1، ستبدأ قوائم الأرقام ذات الحروف والرومانية في a وi على التوالي.

يتم تجاهل هذه القيمة لدمج المستويات مع الرموز الرسومية غير المرتبة.
حقل الاتحاد glyph_kind. نوع الحرف الرسومي الذي تستخدمه الرموز النقطية. يحدّد ذلك الرمز الرسومي للتعداد النقطي الذي يحل محل العناصر النائبة في glyph_format. يمكن أن يكون glyph_kind واحدًا فقط مما يلي:
glyphType

enum (GlyphType)

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

يحدد نوع الحرف الرسومي نوع الحرف الرسومي المستخدَم لاستبدال العناصر النائبة داخل glyphFormat عندما يتم ترتيب الفقرات في هذا المستوى من التداخل. على سبيل المثال، إذا كان مستوى التداخل هو 0، وكان glyphFormat هو %0. ونوع الحرف الرسومي هو DECIMAL، سيحلّ الحرف الرسومي المعروض محل العنصر النائب %0 في تنسيق الرسم البياني برقم يتوافق مع ترتيب عنصر القائمة داخل القائمة.
glyphSymbol

string

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

يحل الرمز الرسومي محل العناصر النائبة داخل glyphFormat. على سبيل المثال، إذا كان الرمز الرسومي هو الدائرة الثابتة المقابلة لنقطة رمز Unicode U+25cf وكانت glyphFormat هي %0، سيكون الحرف الرسومي المعروض هو الدائرة المتصلة.

BulletAlignment

أنواع المحاذاة للرمز النقطي.

عمليات التعداد
BULLET_ALIGNMENT_UNSPECIFIED لم يتم تحديد محاذاة الرموز النقطية.
START تتم محاذاة الرمز النقطي مع بداية المساحة المخصصة لعرض الرمز النقطي. تمت المحاذاة إلى اليسار لنص LTR، والمحاذاة لليمين بخلاف ذلك.
CENTER تتم محاذاة الرمز النقطي مع مركز المساحة المخصصة لعرض الرمز النقطي.
END تتم محاذاة الرمز النقطي مع نهاية المساحة المخصصة لعرض الرمز النقطي. تمت المحاذاة لليمين مع نص LTR، والمحاذاة لليسار.

GlyphType

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

عمليات التعداد
GLYPH_TYPE_UNSPECIFIED نوع الحرف الرسومي غير محدّد أو غير متوافق.
NONE سلسلة فارغة.
DECIMAL رقم، مثل 1 أو 2 أو 3
ZERO_DECIMAL هو رقم تكون فيه الأرقام المكوَّنة من رقم واحد مسبوقة بصفر، مثل 01 أو 02 أو 03. لا تبدأ الأرقام التي تحتوي على أكثر من رقم واحد بصفر.
UPPER_ALPHA أحرف كبيرة، مثل A أو B أو C
ALPHA حرف صغير، مثل a أو b أو c
UPPER_ROMAN رقم روماني كبير، مثل I أو II أو III.
ROMAN رقم روماني صغير، مثل i أو ii أو iii

SuggestedListProperties

تغيير مقترَح في "ListProperties"

تمثيل JSON 
{
  "listProperties": {
    object (ListProperties)
  },
  "listPropertiesSuggestionState": {
    object (ListPropertiesSuggestionState)
  }
}
الحقول
listProperties

object (ListProperties)

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

object (ListPropertiesSuggestionState)

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

ListPropertiesSuggestionState

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

تمثيل JSON 
{
  "nestingLevelsSuggestionStates": [
    {
      object (NestingLevelSuggestionState)
    }
  ]
}
الحقول
nestingLevelsSuggestionStates[]

object (NestingLevelSuggestionState)

قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح ضمن NestingLevel المقابلة في nestingLevels.

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

NestingLevelSuggestionState

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

تمثيل JSON 
{
  "bulletAlignmentSuggested": boolean,
  "glyphTypeSuggested": boolean,
  "glyphFormatSuggested": boolean,
  "glyphSymbolSuggested": boolean,
  "indentFirstLineSuggested": boolean,
  "indentStartSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  },
  "startNumberSuggested": boolean
}
الحقول
bulletAlignmentSuggested

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

object (TextStyleSuggestionState)

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

boolean

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

NamedRanges

هي مجموعة من جميع NamedRange في المستند التي تشترك في اسم معيّن.

تمثيل JSON 
{
  "name": string,
  "namedRanges": [
    {
      object (NamedRange)
    }
  ]
}
الحقول
name

string

الاسم الذي تشترك فيه جميع named ranges.
namedRanges[]

object (NamedRange)

إنّ NamedRange تحمل الاسم نفسه.

NamedRange

مجموعة من Range لها رقم تعريف النطاق المُعن نفسه.

تتيح النطاقات المُعنونة للمطوّرين ربط أجزاء من مستند بتصنيف عشوائي من تحديد المستخدم حتى يمكن قراءة محتواها أو تعديله آليًا في وقت لاحق. يمكن أن يحتوي المستند على عدة نطاقات مُسَمّاة تحمل الاسم نفسه، ولكن لكل نطاق مُعنوَن رقم تعريف فريد.

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

النطاقات المُعنونة ليست خاصة. ويمكن لجميع التطبيقات والمتعاونين الذين لديهم الإذن بالوصول إلى المستند الاطّلاع على النطاقات المُعنونة به.

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

string

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

string

اسم النطاق المُعنون.
ranges[]

object (Range)

النطاقات التي تنتمي إلى هذا النطاق المعنوَن.

النطاق

لتحديد نطاق نص متجاور.

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

string

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

integer

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

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

integer

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

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

string

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

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

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

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

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

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

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

InlineObject

يشير ذلك المصطلح إلى كائن يظهر بشكل مضمّن مع النص. يحتوي InlineObject على EmbeddedObject مثل صورة.

تمثيل JSON 
{
  "objectId": string,
  "inlineObjectProperties": {
    object (InlineObjectProperties)
  },
  "suggestedInlineObjectPropertiesChanges": {
    string: {
      object (SuggestedInlineObjectProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
الحقول
objectId

string

رقم تعريف هذا العنصر المضمّن ويمكن استخدامها لتعديل خصائص أحد العناصر.
inlineObjectProperties

object (InlineObjectProperties)

خصائص هذا الكائن المضمّن
suggestedInlineObjectPropertiesChanges

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

التغييرات المقترَحة على خصائص العناصر المضمّنة كمفتاح مرتبط برقم تعريف الاقتراح
suggestedInsertionId

string

رقم تعريف الإدراج المقترَح إذا كانت فارغة، فهذا لا يعني إدراجًا مقترحًا.
suggestedDeletionIds[]

string

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

InlineObjectProperties

خصائص InlineObject

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

object (EmbeddedObject)

الكائن المضمّن في هذا الكائن المضمّن

EmbeddedObject

تمثّل هذه السمة كائنًا مضمَّنًا في المستند.

تمثيل JSON 
{
  "title": string,
  "description": string,
  "embeddedObjectBorder": {
    object (EmbeddedObjectBorder)
  },
  "size": {
    object (Size)
  },
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "linkedContentReference": {
    object (LinkedContentReference)
  },

  // Union field properties can be only one of the following:
  "embeddedDrawingProperties": {
    object (EmbeddedDrawingProperties)
  },
  "imageProperties": {
    object (ImageProperties)
  }
  // End of list of possible types for union field properties.
}
الحقول
title

string

تمثّل هذه السمة عنوان العنصر المضمّن. تم دمج كل من title وdescription لعرض نص بديل.
description

string

وصف العنصر المضمّن تم دمج كل من title وdescription لعرض نص بديل.
embeddedObjectBorder

object (EmbeddedObjectBorder)

حدود الكائن المضمّن
size

object (Size)

الحجم المرئي للصورة بعد الاقتصاص.
marginTop

object (Dimension)

الهامش العلوي من العنصر المضمّن.
marginBottom

object (Dimension)

الهامش السفلي من العنصر المضمّن.
marginRight

object (Dimension)

الهامش الأيمن من الكائن المضمّن
marginLeft

object (Dimension)

الهامش الأيسر من العنصر المضمّن
linkedContentReference

object (LinkedContentReference)

مرجع لمحتوى المصدر المرتبط الخارجي على سبيل المثال، يحتوي على مرجع إلى الرسم البياني المصدر في "جداول بيانات Google" عندما يكون العنصر المضمّن رسمًا بيانيًا مرتبطًا.

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

object (EmbeddedDrawingProperties)

خصائص الرسم المضمّن.
imageProperties

object (ImageProperties)

خصائص الصورة.

EmbeddedDrawingProperties

لا يحتوي هذا النوع على أي حقول.

خصائص الرسم المضمّن المستخدمة لتمييز نوع الكائن. الرسم المضمّن هو رسم يتم إنشاؤه وتعديله داخل مستند. يُرجى العلم أنّه لا تتوفّر إمكانية الحصول على تفاصيل شاملة.

ImageProperties

خصائص الصورة.

تمثيل JSON 
{
  "contentUri": string,
  "sourceUri": string,
  "brightness": number,
  "contrast": number,
  "transparency": number,
  "cropProperties": {
    object (CropProperties)
  },
  "angle": number
}
الحقول
contentUri

string

معرف موارد منتظم (URI) للصورة مع فترة افتراضية مدتها 30 دقيقة. تم وضع علامة على عنوان URI هذا باستخدام حساب مُقدِّم الطلب. ويمكن لأي شخص لديه معرّف الموارد المنتظم (URI) الوصول إلى الصورة كمقدِّم الطلب الأصلي بفاعلية. قد يتم فقدان إمكانية الوصول إلى الصورة في حال تغيير إعدادات مشاركة المستند.
sourceUri

string

معرف الموارد المنتظم (URI) المصدر هو معرف الموارد المنتظم (URI) المستخدم لإدراج الصورة. يمكن أن يكون معرّف الموارد المنتظم (URI) المصدر فارغًا.
brightness

number

تأثير سطوع الصورة يجب أن تكون القيمة ضمن الفاصل الزمني [ -1.0, 1.0]، حيث تعني القيمة 0 عدم وجود تأثير.
contrast

number

تأثير التباين للصورة يجب أن تكون القيمة ضمن الفاصل الزمني [ -1.0, 1.0]، حيث تعني القيمة 0 عدم وجود تأثير.
transparency

number

تأثير الشفافية للصورة يجب أن تكون القيمة ضمن الفاصل الزمني [0.0، 1.0]، حيث يشير الرقم 0 إلى عدم وجود تأثير ويعني 1 الشفافية.
cropProperties

object (CropProperties)

خصائص اقتصاص الصورة
angle

number

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

CropProperties

خصائص اقتصاص الصورة

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

  • إذا كانت الإزاحة في الفاصل الزمني (0، 1)، يتم وضع الحافة المقابلة لمستطيل الاقتصاص داخل مستطيل الإزاحة الأصلي للصورة.
  • إذا كانت الإزاحة سالبة أو أكبر من 1، فسيتم وضع الحافة المقابلة لمستطيل الاقتصاص خارج مستطيل الإزاحة الأصلي للصورة.
  • إذا كانت جميع الإزاحة وزاوية التدوير 0، فلن يتم اقتصاص الصورة.
تمثيل JSON 
{
  "offsetLeft": number,
  "offsetRight": number,
  "offsetTop": number,
  "offsetBottom": number,
  "angle": number
}
الحقول
offsetLeft

number

تحدد الإزاحة مدى بُعد الحافة اليسرى لمستطيل الاقتصاص عن الحافة اليسرى للمحتوى الأصلي كجزء من عرض المحتوى الأصلي.
offsetRight

number

تحدد الإزاحة مدى بُعد الحافة اليمنى لمستطيل الاقتصاص عن الحافة اليمنى للمحتوى الأصلي كجزء من عرض المحتوى الأصلي.
offsetTop

number

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

number

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

number

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

EmbeddedObjectBorder

حدود حول EmbeddedObject

تمثيل JSON 
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle),
  "propertyState": enum (PropertyState)
}
الحقول
color

object (OptionalColor)

لون الحدود
width

object (Dimension)

عرض الحدود.
dashStyle

enum (DashStyle)

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

enum (PropertyState)

تشير هذه السمة إلى حالة الخاصية للموقع الحدودي.

PropertyState

الحالات المحتملة للموقع.

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

LinkedContentReference

مرجع لمحتوى المصدر المرتبط الخارجي

تمثيل JSON 
{

  // Union field reference can be only one of the following:
  "sheetsChartReference": {
    object (SheetsChartReference)
  }
  // End of list of possible types for union field reference.
}
الحقول
حقل الاتحاد reference. المرجع الخاص بنوع المحتوى المرتبط. يمكن أن يكون reference واحدًا فقط مما يلي:
sheetsChartReference

object (SheetsChartReference)

مرجع للرسم البياني المرتبط.

SheetsChartReference

مرجع إلى رسم بياني مرتبط مضمّن من "جداول بيانات Google".

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

string

رقم تعريف جدول بيانات Google الذي يحتوي على المخطط المصدر.
chartId

integer

رقم تعريف الرسم البياني المحدد في جدول بيانات "جداول بيانات Google" المضمّن.

SuggestedInlineObjectProperties

تغيير مقترَح في "InlineObjectProperties"

تمثيل JSON 
{
  "inlineObjectProperties": {
    object (InlineObjectProperties)
  },
  "inlineObjectPropertiesSuggestionState": {
    object (InlineObjectPropertiesSuggestionState)
  }
}
الحقول
inlineObjectProperties

object (InlineObjectProperties)

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

object (InlineObjectPropertiesSuggestionState)

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

InlineObjectPropertiesSuggestionState

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

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

object (EmbeddedObjectSuggestionState)

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

EmbeddedObjectSuggestionState

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

تمثيل JSON 
{
  "embeddedDrawingPropertiesSuggestionState": {
    object (EmbeddedDrawingPropertiesSuggestionState)
  },
  "imagePropertiesSuggestionState": {
    object (ImagePropertiesSuggestionState)
  },
  "titleSuggested": boolean,
  "descriptionSuggested": boolean,
  "embeddedObjectBorderSuggestionState": {
    object (EmbeddedObjectBorderSuggestionState)
  },
  "sizeSuggestionState": {
    object (SizeSuggestionState)
  },
  "marginLeftSuggested": boolean,
  "marginRightSuggested": boolean,
  "marginTopSuggested": boolean,
  "marginBottomSuggested": boolean,
  "linkedContentReferenceSuggestionState": {
    object (LinkedContentReferenceSuggestionState)
  }
}
الحقول
embeddedDrawingPropertiesSuggestionState

object (EmbeddedDrawingPropertiesSuggestionState)

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

object (ImagePropertiesSuggestionState)

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

boolean

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

boolean

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

object (EmbeddedObjectBorderSuggestionState)

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

object (SizeSuggestionState)

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

boolean

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

boolean

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

boolean

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

boolean

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

object (LinkedContentReferenceSuggestionState)

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

EmbeddedDrawingPropertiesSuggestionState

لا يحتوي هذا النوع على أي حقول.

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

ImagePropertiesSuggestionState

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

تمثيل JSON 
{
  "contentUriSuggested": boolean,
  "sourceUriSuggested": boolean,
  "brightnessSuggested": boolean,
  "contrastSuggested": boolean,
  "transparencySuggested": boolean,
  "cropPropertiesSuggestionState": {
    object (CropPropertiesSuggestionState)
  },
  "angleSuggested": boolean
}
الحقول
contentUriSuggested

boolean

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

boolean

يشير إلى ما إذا كان هناك تغيير مقترح على [sourceUri] [google.apps.docs.v1.EmbedObject.source_uri].
brightnessSuggested

boolean

يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترح على مستوى [السطوع]. [google.apps.docs.v1.inlineObject.brightness].
contrastSuggested

boolean

يشير إلى ما إذا كان هناك تغيير مقترح على [التباين] [google.apps.docs.v1.EmbedObject.contrast].
transparencySuggested

boolean

تشير إلى ما إذا كان هناك تغيير مقترح على [transparency] [google.apps.docs.v1.EmbedObject.transparency].
cropPropertiesSuggestionState

object (CropPropertiesSuggestionState)

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

boolean

تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في [angle] [google.apps.docs.v1.inlineObject.angle].

CropPropertiesSuggestionState

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

تمثيل JSON 
{
  "offsetLeftSuggested": boolean,
  "offsetRightSuggested": boolean,
  "offsetTopSuggested": boolean,
  "offsetBottomSuggested": boolean,
  "angleSuggested": boolean
}
الحقول
offsetLeftSuggested

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

EmbeddedObjectBorderSuggestionState

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

تمثيل JSON 
{
  "colorSuggested": boolean,
  "widthSuggested": boolean,
  "dashStyleSuggested": boolean,
  "propertyStateSuggested": boolean
}
الحقول
colorSuggested

boolean

تشير إلى ما إذا كان هناك تغيير مقترح إلى [color] [google.apps.docs.v1.IncludeBorderObject.color].
widthSuggested

boolean

تشير هذه القيمة إلى ما إذا كان هناك تغيير مقترح على [width] [google.apps.docs.v1.IncludeBorderObject.width].
dashStyleSuggested

boolean

يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترح على [dashStyle] [google.apps.docs.v1.IncludeBorderObject.dash_style].
propertyStateSuggested

boolean

يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترح في سمة [propertyState] [google.apps.docs.v1.IncludeBorderObject.property_state].

LinkedContentReferenceSuggestionState

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

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

object (SheetsChartReferenceSuggestionState)

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

SheetsChartReferenceSuggestionState

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

تمثيل JSON 
{
  "spreadsheetIdSuggested": boolean,
  "chartIdSuggested": boolean
}
الحقول
spreadsheetIdSuggested

boolean

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

boolean

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

PositionedObject

كائن مرتبط بـ Paragraph ويتم وضعه نسبةً إلى بداية الفقرة. يحتوي عنصر PositionedObject على EmbeddedObject مثل صورة.

تمثيل JSON 
{
  "objectId": string,
  "positionedObjectProperties": {
    object (PositionedObjectProperties)
  },
  "suggestedPositionedObjectPropertiesChanges": {
    string: {
      object (SuggestedPositionedObjectProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
الحقول
objectId

string

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

object (PositionedObjectProperties)

خصائص هذا العنصر الذي تم تحديد موضعه.
suggestedPositionedObjectPropertiesChanges

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

التغييرات المقترَحة على خصائص العناصر الموضوعة بشكل رئيسي حسب رقم تعريف الاقتراح
suggestedInsertionId

string

رقم تعريف الإدراج المقترَح إذا كانت فارغة، فهذا لا يعني إدراجًا مقترحًا.
suggestedDeletionIds[]

string

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

PositionedObjectProperties

خصائص PositionedObject

تمثيل JSON 
{
  "positioning": {
    object (PositionedObjectPositioning)
  },
  "embeddedObject": {
    object (EmbeddedObject)
  }
}
الحقول
positioning

object (PositionedObjectPositioning)

يشير إلى موضع هذا العنصر الذي تم تحديد موضعه بالنسبة إلى السطر الجديد من Paragraph الذي يشير إلى هذا العنصر.
embeddedObject

object (EmbeddedObject)

الكائن المضمّن في هذا العنصر الذي تم تحديد موضعه.

PositionedObjectPositioning

تمثّل هذه السمة موضع PositionedObject. يتم وضع العنصر الموضوع بالنسبة إلى بداية Paragraph الذي تم ربطه به.

تمثيل JSON 
{
  "layout": enum (PositionedObjectLayout),
  "leftOffset": {
    object (Dimension)
  },
  "topOffset": {
    object (Dimension)
  }
}
الحقول
layout

enum (PositionedObjectLayout)

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

object (Dimension)

إزاحة الحافة اليسرى للكائن الموضع بالنسبة إلى بداية Paragraph المرتبط به. يمكن أن يعتمد الموضع الدقيق للعنصر على المحتوى الآخر في المستند وعلى تصميم المستند.
topOffset

object (Dimension)

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

PositionedObjectLayout

التنسيقات الممكنة لـ [PositionedObject][google.aps.docs.v1.PositionedObject].

عمليات التعداد
POSITIONED_OBJECT_LAYOUT_UNSPECIFIED لم يتم تحديد التنسيق.
WRAP_TEXT يلتف النص حول العنصر الموضوع.
BREAK_LEFT يقسم النص بحيث يكون الكائن في الموضع على اليسار والنص على اليمين.
BREAK_RIGHT يقسم النص بحيث يكون الكائن في الموضع على اليمين والنص على اليسار.
BREAK_LEFT_RIGHT يقسم النص بحيث لا يكون هناك نص على يسار أو يمين الكائن الموضوع.
IN_FRONT_OF_TEXT يظهر العنصر الموضوع أمام النص.
BEHIND_TEXT العنصر الموضوع خلف النص.

SuggestedPositionedObjectProperties

تغيير مقترَح في "PositionedObjectProperties"

تمثيل JSON 
{
  "positionedObjectProperties": {
    object (PositionedObjectProperties)
  },
  "positionedObjectPropertiesSuggestionState": {
    object (PositionedObjectPropertiesSuggestionState)
  }
}
الحقول
positionedObjectProperties

object (PositionedObjectProperties)

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

object (PositionedObjectPropertiesSuggestionState)

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

PositionedObjectPropertiesSuggestionState

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

تمثيل JSON 
{
  "positioningSuggestionState": {
    object (PositionedObjectPositioningSuggestionState)
  },
  "embeddedObjectSuggestionState": {
    object (EmbeddedObjectSuggestionState)
  }
}
الحقول
positioningSuggestionState

object (PositionedObjectPositioningSuggestionState)

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

object (EmbeddedObjectSuggestionState)

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

PositionedObjectPositioningSuggestionState

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

تمثيل JSON 
{
  "layoutSuggested": boolean,
  "leftOffsetSuggested": boolean,
  "topOffsetSuggested": boolean
}
الحقول
layoutSuggested

boolean

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

boolean

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

boolean

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

SuggestionsViewMode

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

عمليات التعداد
DEFAULT_FOR_CURRENT_ACCESS يعتمد تطبيق SuggestionsViewMode على المستند المعروض على مستوى الوصول الحالي للمستخدم. وإذا كان المستخدم لديه إذن بالاطّلاع فقط، يتم تطبيق PREVIEW_WITHOUT_SUGGESTIONS. وبخلاف ذلك، يتم تطبيق SUGGESTIONS_INLINE. هذا هو وضع عرض الاقتراحات التلقائي.
SUGGESTIONS_INLINE

يحتوي المستند المعروض على اقتراحات مضمَّنة. سيتم تمييز التغييرات المقترَحة عن المحتوى الأساسي داخل المستند.

إذا لم يكن لدى المستخدم إذن بعرض التغييرات المقترَحة، ستعرض طلبات استرداد مستند باستخدام هذا الوضع خطأ 403.
PREVIEW_SUGGESTIONS_ACCEPTED

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

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

الطُرق

batchUpdate

 يتم تطبيق تعديل واحد أو أكثر على المستند.

create

 ينشئ مستندًا فارغًا باستخدام العنوان الوارد في الطلب.

get

 للحصول على أحدث نسخة من المستند المحدّد.