REST Resource: documents

المورد: مستند

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

تمثيل JSON 
{
  "documentId": string,
  "title": string,
  "tabs": [
    {
      object (Tab)
    }
  ],
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "commentsViewMode": enum (CommentsViewMode),
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "suggestions": [
    {
      object (SuggestionThread)
    }
  ],
  "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.
commentsViewMode

enum (CommentsViewMode)

النتائج فقط. تمثّل هذه السمة وضع عرض التعليقات المطبَّق على المستند.
comments[]

object (CommentThread)

النتائج فقط. التعليقات المرتبطة بالمستند يتم ملء هذا الحقل فقط إذا تم ضبط المَعلمة commentsViewMode على طلب التعليقات (مثل COMMENTS_VIEW_MODE_INCLUDED).
suggestions[]

object (SuggestionThread)

النتائج فقط. الاقتراحات المرتبطة بالمستند يتم ملء هذا الحقل فقط إذا تم ضبط المَعلمة commentsViewMode على طلب التعليقات (مثل COMMENTS_VIEW_MODE_INCLUDED).
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)
    }
  ],

  "documentTab": {
    object (DocumentTab)
  }
}
الحقول
tabProperties

object (TabProperties)

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

object (Tab)

علامات التبويب الفرعية المتداخلة ضمن علامة التبويب هذه
محتوى علامة التبويب في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
documentTab

object (DocumentTab)

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

TabProperties

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

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

string

المعرّف غير القابل للتغيير للعلامة
title

string

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

string

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

integer

الفهرس المبدوء من الصفر لعلامة التبويب ضمن العنصر الرئيسي
nestingLevel

integer

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

string

اختيارية: رمز الإيموجي المعروض مع علامة التبويب يتم تمثيل رمز إيموجي صالح بسلسلة Unicode غير فارغة. أي مجموعة من الأحرف لا تمثّل إيموجي واحدًا تكون غير صالحة.

إذا كان الإيموجي غير صالح، سيتم عرض رسالة الخطأ "400: طلب غير صالح".

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

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)
    },
    ...
  },
  "commentAnchors": {
    string: {
      object (CommentAnchor)
    },
    ...
  }
}
الحقول
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))

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

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

يتم تثبيت التعليق في علامة تبويب في المستند، ويتم تحديد المفتاح حسب رقم تعريف نقطة الربط. يتم ملء هذا الحقل فقط إذا تم ضبط المَعلمة commentsViewMode على طلب التعليقات (مثل COMMENTS_VIEW_MODE_INCLUDED).

النص

نص المستند

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

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

object (StructuralElement)

محتوى النص

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

StructuralElement

يصف StructuralElement المحتوى الذي يوفّر بنية للمستند.

تمثيل JSON 
{
  "startIndex": integer,
  "endIndex": integer,

  "paragraph": {
    object (Paragraph)
  },
  "sectionBreak": {
    object (SectionBreak)
  },
  "table": {
    object (Table)
  },
  "tableOfContents": {
    object (TableOfContents)
  }
}
الحقول
startIndex

integer

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

integer

الفهرس النهائي المستند إلى الصفر لهذا العنصر البنيوي، باستثناء، في وحدات رموز UTF-16.
محتوى العنصر البنيوي في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
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

يصف ParagraphElement المحتوى ضمن Paragraph.

تمثيل JSON 
{
  "startIndex": integer,
  "endIndex": integer,

  "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)
  },
  "dateElement": {
    object (DateElement)
  }
}
الحقول
startIndex

integer

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

integer

الفهرس النهائي المستند إلى الصفر لعنصر الفقرة هذا، باستثناء، في وحدات رموز UTF-16.
محتوى عنصر الفقرة. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
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)

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

object (DateElement)

عنصر فقرة يمثّل تاريخًا
نهاية الحقول التي يستبعد كلّ منها الآخر

TextRun

ParagraphElement يمثّل سلسلة من النصوص التي تتضمّن التنسيق نفسه.

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

string

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

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

string

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

string

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

object (TextStyle)

نمط النص في هذا المقطع
suggestedTextStyleChanges

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

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

TextStyle

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

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

  • يرث TextStyle للنص في Paragraph من named style type المقابل للفقرة.
  • يرث named style نمط normal text المسمّى.
  • يرث TextStyle للنمط المسمّى normal text من نمط النص التلقائي في محرِّر "مستندات Google".
  • قد يرث TextStyle في عنصر Paragraph مضمّن في جدول نمط النص من نمط الجدول.

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

تمثيل 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)

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

object (OptionalColor)

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

object (Dimension)

حجم خط النص
weightedFontFamily

object (WeightedFontFamily)

مجموعة الخطوط وسُمك الخط المعروض للنص

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

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

في حال ضبط weightedFontFamily، يجب أيضًا ضبط weightedFontFamily#fontFamily بقيمة غير فارغة. في ما عدا ذلك، سيتم عرض رسالة الخطأ 400 Bad Request.
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، ضِمنًا. يتوافق هذا النطاق مع القيم الرقمية الموضّحة في القسم 15.6 من مواصفات CSS 2.1، مع عدم السماح بالقيم غير الرقمية.

القيمة التلقائية هي 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)

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

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

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

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

ColumnBreak

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

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

string

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

string

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

object (TextStyle)

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

على غرار المحتوى النصي، مثل سلاسل النصوص ومراجع الحواشي السفلية، يمكن أن يؤثر نمط النص لفاصل الأعمدة في تخطيط المحتوى بالإضافة إلى نمط النص المُدرَج بجانبه.
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)

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

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

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

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

معادلة

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)

DateElement

تمثّل هذه السمة مثيلاً لتاريخ مذكور في مستند.

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

string

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

string

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

string

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

object (TextStyle)

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

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

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

object (DateElementProperties)

خصائص DateElement هذه
suggestedDateElementPropertiesChanges

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

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

DateElementProperties

سمات DateElement

تمثيل JSON 
{
  "timestamp": string,
  "timeZoneId": string,
  "locale": string,
  "dateFormat": enum (DateFormat),
  "timeFormat": enum (TimeFormat),
  "displayText": string
}
الحقول
timestamp

string (Timestamp format)

تمثّل هذه السمة النقطة الزمنية المراد عرضها، وذلك بالثواني والنانو ثانية منذ بداية حقبة يونكس: 1 يناير 1970 عند منتصف الليل بالتوقيت العالمي المنسَّق.

من المتوقّع أن يكون الطابع الزمني بالتوقيت العالمي المنسّق. في حال ضبط timeZoneId، يتم تعديل الطابع الزمني وفقًا للمنطقة الزمنية. على سبيل المثال، سيتم عرض الطابع الزمني 18000 بتنسيق التاريخ DATE_FORMAT_ISO8601 وتنسيق الوقت TIME_FORMAT_HOUR_MINUTE على النحو التالي: 1970-01-01 5:00 AM. سيتم استبدال الطابع الزمني 18000 الذي يتضمّن تنسيق التاريخ DATE_FORMAT_ISO8601 وتنسيق الوقت TIME_FORMAT_HOUR_MINUTE والمنطقة الزمنية America/New_York بالطابع الزمني 1970-01-01 12:00 AM.
timeZoneId

string

المنطقة الزمنية لعنصر التاريخ، كما هو محدّد في مشروع Unicode Common Locale Data Repository (CLDR) مثلاً: America/New_York في حال عدم ضبطها، تكون المنطقة الزمنية التلقائية هي etc/UTC.
locale

string

رمز اللغة الخاص بـ DateElement. مثلاً: en في حال عدم ضبطها، تكون اللغة التلقائية هي en.

تتوفّر هذه الميزة باللغات التالية: af وam وar وas وaz وbe وbg وbn وca وcs وda وde وel وen وen-CA وen-GB وes وes-419 وet وeu وfa وfi وfil وfr وfr-CA وgl وgu وhi وhr وhu وhy وid وis وit وiw وja وka وkk وkm وkn وko وlo وlt وlv وmk وml وmn وmr وms وne وnl وno وor وpa وpl وpt-BR وpt-PT وro وru وsi وsk وsl وsq وsr وsv وsw وta وte وth وtr وuk وur وuz وvi وzh-CN وzh-HK وzh-TW وzu وcy وmy.
dateFormat

enum (DateFormat)

تحدّد هذه السمة طريقة عرض جزء التاريخ من DateElement في المستند.

إذا لم يتم ضبطها، تكون القيمة التلقائية هي DATE_FORMAT_MONTH_DAY_YEAR_ABBREVIATED، ما يشير إلى أنّه سيتم تنسيق DateElement على النحو MMM d, y في en، أو ما يعادله بلغة أخرى.
timeFormat

enum (TimeFormat)

تحدّد هذه السمة كيفية عرض جزء الوقت من DateElement في المستند.

إذا لم يتم ضبط هذا الخيار، ستكون القيمة التلقائية هي TIME_FORMAT_DISABLED، ما يشير إلى أنّه يجب عدم عرض أي وقت.
displayText

string

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

DateFormat

تنسيقات التاريخ المحتملة لـ DateElement.

عمليات التعداد
DATE_FORMAT_UNSPECIFIED لم يتم تحديد تنسيق التاريخ.
DATE_FORMAT_CUSTOM النتائج فقط. يتم استيراد تنسيق التاريخ من مصدر خارجي.
DATE_FORMAT_MONTH_DAY_ABBREVIATED تنسيق التاريخ هو شهر مختصر متبوعًا باليوم. على سبيل المثال، "1 يناير".
DATE_FORMAT_MONTH_DAY_FULL يكون تنسيق التاريخ هو الشهر متبوعًا باليوم. على سبيل المثال، "01 يناير".
DATE_FORMAT_MONTH_DAY_YEAR_ABBREVIATED تنسيق التاريخ هو شهر مختصر متبوعًا باليوم والسنة. على سبيل المثال، "1 يناير 1970".
DATE_FORMAT_ISO8601 يجب أن يكون التاريخ بالتنسيق ISO 8601. على سبيل المثال، "1970-01-01".

TimeFormat

تنسيقات الوقت المحتملة لـ DateElement

عمليات التعداد
TIME_FORMAT_UNSPECIFIED لم يتم تحديد تنسيق الوقت.
TIME_FORMAT_DISABLED تشير إلى أنّ التاريخ لا يتضمّن وقتًا.
TIME_FORMAT_HOUR_MINUTE يعرض تنسيق الوقت الساعة والدقيقة. على سبيل المثال، "1 يناير 1970 الساعة 12:00 ظهرًا".
TIME_FORMAT_HOUR_MINUTE_TIMEZONE يعرض تنسيق الوقت الساعة والدقيقة والمنطقة الزمنية. على سبيل المثال، "1 يناير 1970 الساعة 12:00 ظهرًا بالتوقيت العالمي المنسق".

SuggestedDateElementProperties

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

تمثيل JSON 
{
  "dateElementProperties": {
    object (DateElementProperties)
  },
  "dateElementPropertiesSuggestionState": {
    object (DateElementPropertiesSuggestionState)
  }
}
الحقول
dateElementProperties

object (DateElementProperties)

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

object (DateElementPropertiesSuggestionState)

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

DateElementPropertiesSuggestionState

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

تمثيل JSON 
{
  "timestampSuggested": boolean,
  "timeZoneIdSuggested": boolean,
  "localeSuggested": boolean,
  "dateFormatSuggested": boolean,
  "timeFormatSuggested": boolean
}
الحقول
timestampSuggested

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

ParagraphStyle

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

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

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

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

تمثيل 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)

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

بما أنّ تعديل نوع النمط المسمّى يؤثر في الخصائص الأخرى ضمن ParagraphStyle، يتم تطبيق نوع النمط المسمّى قبل تعديل الخصائص الأخرى.
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 Bad Request.

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 تتم محاذاة الفقرة مع بداية السطر. تتم محاذاته إلى اليمين إذا كان النص مكتوبًا بلغة تُقرأ من اليسار إلى اليمين، وإلى اليسار في الحالات الأخرى.
CENTER تكون الفقرة في المنتصف.
END تتم محاذاة الفقرة مع نهاية السطر. تتم محاذاته إلى اليمين إذا كان النص مكتوبًا من اليسار إلى اليمين، وإلى اليسار في الحالات الأخرى.
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.49 من "تنسيقات ملفات Office Open XML - الأساسيات ومرجع لغة الترميز"، الجزء 1 من الإصدار الخامس من ECMA-376.

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

TabStop

موضع توقّف علامة تبويب ضمن فقرة

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

object (Dimension)

الإزاحة بين موضع التوقف هذا والهامش الأيمن
alignment

enum (TabStopAlignment)

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

TabStopAlignment

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

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

التظليل

تظليل الفقرة

تمثيل 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)

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

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

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

enum (ColumnSeparatorStyle)

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

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

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

enum (ContentDirection)

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

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

object (Dimension)

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.

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

object (Dimension)

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.

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

object (Dimension)

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.

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

object (Dimension)

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.

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

object (Dimension)

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.

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

enum (SectionType)

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

string

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.

هذه السمة مخصّصة للقراءة فقط.
firstPageHeaderId

string

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.

هذه السمة مخصّصة للقراءة فقط.
firstPageFooterId

string

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.

هذه السمة مخصّصة للقراءة فقط.
evenPageHeaderId

string

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.

هذه السمة مخصّصة للقراءة فقط.
evenPageFooterId

string

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.

هذه السمة مخصّصة للقراءة فقط.
useFirstPageHeaderFooter

boolean

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.

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

integer

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.

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

boolean

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.

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

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)

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

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.60 من "تنسيقات ملفات 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,
  "documentFormat": {
    object (DocumentFormat)
  }
}
الحقول
background

object (Background)

خلفية المستند يجب ألا تحتوي المستندات على لون خلفية شفاف.
defaultHeaderId

string

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.

هذه السمة مخصّصة للقراءة فقط.
evenPageHeaderId

string

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.

هذه السمة مخصّصة للقراءة فقط.
evenPageFooterId

string

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.

هذه السمة مخصّصة للقراءة فقط.
firstPageHeaderId

string

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.

هذه السمة مخصّصة للقراءة فقط.
firstPageFooterId

string

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.

هذه السمة مخصّصة للقراءة فقط.
useFirstPageHeaderFooter

boolean

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.
useEvenPageHeaderFooter

boolean

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.
pageNumberStart

integer

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.
marginTop

object (Dimension)

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

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.
marginBottom

object (Dimension)

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

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.
marginRight

object (Dimension)

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

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.
marginLeft

object (Dimension)

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

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.
pageSize

object (Size)

تمثّل هذه السمة حجم الصفحة في المستند.

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.
marginHeader

object (Dimension)

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.
flipPageOrientation

boolean

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

إذا كانت قيمة [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] هي PAGELESS، لن يتم عرض هذه السمة.
documentFormat

object (DocumentFormat)

تحدّد إعدادات التنسيق على مستوى المستند، مثل وضع المستند (صفحات أو بلا صفحات).

خلفية

تمثّل هذه السمة خلفية المستند.

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

object (OptionalColor)

لون الخلفية

الحجم

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

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

object (Dimension)

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

object (Dimension)

عرض العنصر

DocumentFormat

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

تمثيل JSON 
{
  "documentMode": enum (DocumentMode)
}
الحقول
documentMode

enum (DocumentMode)

تُستخدَم لتحديد ما إذا كان المستند يتضمّن صفحات أو لا.

DocumentMode

تُستخدَم لتحديد ما إذا كان المستند يتضمّن صفحات أو لا.

عمليات التعداد
DOCUMENT_MODE_UNSPECIFIED لم يتم تحديد وضع المستند.
PAGES يحتوي المستند على صفحات.
PAGELESS المستند بلا صفحات.

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,

  "glyphType": enum (GlyphType),
  "glyphSymbol": string
}
الحقول
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_format. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
glyphType

enum (GlyphType)

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

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

string

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

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

BulletAlignment

أنواع المحاذاة الخاصة بنقطة تعداد

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

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

مجموعة من Ranges لها معرّف النطاق المُعنوَن نفسه

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

يتم إنشاء نطاق مُعنوَن باستخدام 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)
  },

  "embeddedDrawingProperties": {
    object (EmbeddedDrawingProperties)
  },
  "imageProperties": {
    object (ImageProperties)
  }
}
الحقول
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" عندما يكون العنصر المضمّن عبارة عن رسم بياني مرتبط.

في حال عدم ضبطها، لن يتم ربط الكائن المضمّن.
السمات الخاصة بكل نوع من أنواع الكائنات المضمّنة في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
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) هذا باستخدام حساب مقدّم الطلب. يمكن لأي مستخدم لديه معرّف الموارد المنتظم الوصول إلى الصورة كما لو كان هو طالبها الأصلي. قد تفقد إمكانية الوصول إلى الصورة إذا تغيّرت إعدادات مشاركة المستند.
sourceUri

string

معرّف الموارد المنتظم المصدر هو معرّف الموارد المنتظم المستخدَم لإدراج الصورة. يمكن أن يكون معرّف الموارد المنتظم (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 
{

  "sheetsChartReference": {
    object (SheetsChartReference)
  }
}
الحقول
المرجع الخاص بنوع المحتوى المرتبط في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
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.EmbeddedObject.source_uri].
brightnessSuggested

boolean

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

boolean

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

boolean

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

object (CropPropertiesSuggestionState)

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

boolean

تشير إلى ما إذا كان هناك تغيير مقترَح على [angle] [google.apps.docs.v1.EmbeddedObject.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.EmbeddedBorderObject.color].
widthSuggested

boolean

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

boolean

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

boolean

تشير إلى ما إذا كان هناك تغيير مقترَح على [propertyState] [google.apps.docs.v1.EmbeddedBorderObject.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.

CommentAnchor

موقع جغرافي واحد أو أكثر في المستند مرتبط بـ CommentThreads مع anchorId نفسه ملاحظة: قد تشير نقاط ارتساء متعدّدة إلى الموقع الجغرافي نفسه.

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

string

تمثّل هذه السمة رقم تعريف مرجع التعليق.
ranges[]

object (Range)

مجموعة من Range في المستند مرتبطة بهذا العنصر الثابت.

SuggestionsViewMode

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

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

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

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

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

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

CommentsViewMode

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

في حال ضبط commentsViewMode على أي قيمة، يجب أيضًا ضبط includeTabsContent على true أو استخدام قناع حقل يشير إلى الحقل Document.tabs (أو أي حقل فرعي).

لا يمكن إرجاع التعليقات إلا إذا تم إرجاع الاقتراحات مضمّنة. إذا ضبطت commentsViewMode على COMMENTS_VIEW_MODE_INCLUDED أو COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS، يمكنك ضبط suggestionsViewMode على PREVIEW_WITHOUT_SUGGESTIONS أو PREVIEW_SUGGESTIONS_ACCEPTED فقط.

عمليات التعداد
COMMENTS_VIEW_MODE_UNSPECIFIED لم يتم تحديد قيمة CommentsViewMode. يتم تطبيق COMMENTS_VIEW_MODE_OMITTED.
COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS يعتمد CommentsViewMode الذي يتم تطبيقه على المستند الذي تم عرضه على مستوى وصول المستخدم الحالي. إذا كان لدى المستخدم إذن بالاطّلاع فقط، يتم تطبيق COMMENTS_VIEW_MODE_OMITTED. في الحالات الأخرى، يتم تطبيق COMMENTS_VIEW_MODE_INCLUDED.
COMMENTS_VIEW_MODE_OMITTED تم حذف التعليقات من المستند الذي تم إرجاعه.
COMMENTS_VIEW_MODE_INCLUDED

يتضمّن المستند الذي تم إرجاعه تعليقات.

ستعرض الطلبات باسترداد مستند باستخدام هذا الوضع رمز الخطأ 403 إذا لم يكن لدى المستخدم إذن بالاطّلاع على التعليقات.

عند ضبط هذه السمة، يجب أيضًا ضبط السمة suggestionsViewMode على SUGGESTIONS_INLINE. في ما عدا ذلك، يتم عرض رسالة الخطأ "400: طلب غير صالح".

CommentThread

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

تمثيل JSON 
{
  "commentId": string,
  "anchorId": string,
  "headPost": {
    object (Post)
  },
  "replies": [
    {
      object (Post)
    }
  ],
  "status": enum (Status),

  "plainTextQuote": string
}
الحقول
commentId

string

المعرّف الفريد لسلسلة المحادثات حول التعليق
anchorId

string

تمثّل هذه السمة معرّف CommentAnchor في المستند الذي ترتبط به سلسلة المحادثات هذه. يمكن ربط سلاسل محادثات متعددة بالتعليق CommentAnchor نفسه.
headPost

object (Post)

المشاركة الأولى في سلسلة المحادثات
replies[]

object (Post)

الردود على المشاركة الرئيسية
status

enum (Status)

تُستخدَم لتحديد ما إذا كانت سلسلة المحادثات مفتوحة أو تم حلّها.
تمثّل هذه السمة النص المقتبس من المستند عند إنشاء التعليق. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
plainTextQuote

string

تمثّل هذه السمة النص المقتبس من المستند عند إنشاء التعليق، ويكون منسّقًا كنص عادي.
نهاية الحقول التي يستبعد كلّ منها الآخر

نشر

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

تمثيل JSON 
{
  "postId": string,
  "content": string,
  "contentHtml": string,
  "author": {
    object (PostAuthor)
  },
  "createTime": string,
  "updateTime": string,
  "deleted": boolean,
  "fromImportedDocument": boolean,
  "fromCopiedDocument": boolean,
  "fromDocumentComparison": boolean,
  "assigneeEmail": string,

  "commentAction": enum (CommentActionType),
  "suggestionAction": enum (SuggestionActionType)
}
الحقول
postId

string

النتائج فقط. المعرّف الفريد للمشاركة
content

string

تمثّل هذه السمة محتوى المشاركة.

يجب أن تكون هذه السمة غير فارغة إذا لم تكن قيمة commentAction هي RESOLVE أو REOPEN.

سيتم التعامل مع هذا المحتوى النصي بشكل مشابه للتعليقات التي يتم إنشاؤها في محرّر "مستندات Google". وسيكون لها سلوكيات مشابهة في ما يتعلّق بالتنسيق والإشعارات وما إلى ذلك.

يجب ألا يتجاوز 2,048 وحدة رمز UTF-8.
contentHtml

string

النتائج فقط. محتوى المنشور بتنسيق HTML
author

object (PostAuthor)

النتائج فقط. المستخدم الذي أنشأ المشاركة
createTime

string (Timestamp format)

النتائج فقط. وقت إنشاء المشاركة
updateTime

string (Timestamp format)

النتائج فقط. يشير هذا الحقل إلى وقت آخر تعديل للمنشور.
deleted

boolean

النتائج فقط. تُستخدَم لتحديد ما إذا كانت المشاركة محذوفة أم لا. إذا كان true، ستكون حقول content وauthor فارغة.
fromImportedDocument

boolean

النتائج فقط. تُستخدَم لتحديد ما إذا كانت المشاركة من مستند مستورد. لا يمكن للمتصلين ضبط هذا الحقل مباشرةً.
fromCopiedDocument

boolean

النتائج فقط. تُستخدَم لتحديد ما إذا كانت المشاركة من مستند منسوخ. لا يمكن للمتصلين ضبط هذا الحقل مباشرةً.
fromDocumentComparison

boolean

النتائج فقط. تُستخدَم لتحديد ما إذا كانت المشاركة من عملية مقارنة مستندات. لا يمكن للمتصلين ضبط هذا الحقل مباشرةً.
assigneeEmail

string

اختيارية: البريد الإلكتروني للمستخدم الذي يتم تعيينه حديثًا في سلسلة المحادثات كجزء من هذا المنشور

تعرض هذه الطريقة رسالة الخطأ "400: طلب غير صالح" في الحالات التالية:

  • سلسلة المحادثات الرئيسية هي CommentThread لا تتضمّن headPost معيّنًا له.

  • سلسلة المحادثات الرئيسية هي SuggestionThread.

  • يتم تحديد commentAction على أنّه RESOLVE أو REOPEN.

  • يتجاوز assigneeEmail 2048 وحدة رمز UTF-8.
الإجراء الذي تم اتخاذه كجزء من إنشاء المنشور في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
commentAction

enum (CommentActionType)

اختيارية: نوع الإجراء للمشاركات التي تتضمّن تعليقات
suggestionAction

enum (SuggestionActionType)

النتائج فقط. نوع الإجراء الخاص بمنشورات الاقتراحات
نهاية الحقول التي يستبعد كلّ منها الآخر

PostAuthor

تمثّل هذه السمة مستخدمًا كتب تعليقًا أو منشورًا يتضمّن اقتراحًا.

تمثيل JSON 
{
  "displayName": string,
  "me": boolean,
  "anonymous": boolean,
  "user": string
}
الحقول
displayName

string

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

boolean

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

boolean

تُستخدَم لتحديد ما إذا كان المستخدم مجهول الهوية.
user

string

اسم المورد الخاص بمستخدم مؤلف المشاركة، والذي يمكن استخدامه أيضًا لتحديد المستخدم في Google People API التنسيق: users/{user} لن تتم تعبئة هذا الحقل إذا كان الحقل المجهول الهوية true أو إذا كانت المشاركة من مستند مستورد.

CommentActionType

تمثّل هذه السمة الإجراء المتّخذ مع هذا الردّ على سلسلة محادثات.

عمليات التعداد
COMMENT_ACTION_TYPE_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
NO_COMMENT_ACTION_CHANGE لم يتم إجراء أي تغيير على الإجراء في هذا المنشور.
RESOLVE تحلّ هذه المشاركة سلسلة المحادثات.
REOPEN يؤدي هذا المنشور إلى إعادة فتح سلسلة المحادثات.

SuggestionActionType

الإجراء الذي تم اتخاذه بشأن هذا الردّ على سلسلة اقتراحات

عمليات التعداد
SUGGESTION_ACTION_TYPE_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
NO_SUGGESTION_ACTION_CHANGE لم يتم إجراء أي تغيير على الإجراء في هذا المنشور.
ACCEPT تقبل هذه المشاركة الاقتراح.
REJECT ترفض هذه المشاركة الاقتراح.

الحالة

خيارات حالة سلسلة المحادثات

عمليات التعداد
STATUS_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
OPEN سلسلة التعليقات مفتوحة.
RESOLVED تم حلّ سلسلة التعليقات.

SuggestionThread

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

تمثيل JSON 
{
  "suggestionId": string,
  "headPost": {
    object (Post)
  },
  "replies": [
    {
      object (Post)
    }
  ],
  "status": enum (Status),
  "summaryText": string,
  "summaryHtml": string
}
الحقول
suggestionId

string

المعرّف الفريد للاقتراح
headPost

object (Post)

المشاركة الأولى في سلسلة المحادثات
replies[]

object (Post)

الردود على المشاركة الرئيسية
status

enum (Status)

ما إذا كانت سلسلة المحادثات مفتوحة أو مقبولة أو مرفوضة
summaryText

string

ملخّص للاختلافات المقترَحة في المستند، بتنسيق نص عادي قد يكون فارغًا.
summaryHtml

string

ملخّص للاختلافات المقترَحة في المستند بتنسيق HTML قد يكون فارغًا.

الحالة

خيارات حالة سلسلة اقتراحات المراجعة

عمليات التعداد
STATUS_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
OPEN سلسلة الاقتراحات مفتوحة.
ACCEPTED تم قبول سلسلة المحادثات الخاصة بالاقتراح.
REJECTED تم رفض سلسلة الاقتراحات.

الطُرق

batchUpdate

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

create

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

get

 تعرض هذه الطريقة أحدث إصدار من المستند المحدّد.