REST Resource: documents

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

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

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

string

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

title

string

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

tabs[]

object (Tab)

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

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

revisionId

string

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

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

suggestionsViewMode

enum (SuggestionsViewMode)

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

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

body

object (Body)

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

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

headers

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

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

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

footers

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

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

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

footnotes

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

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

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

documentStyle

object (DocumentStyle)

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

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

suggestedDocumentStyleChanges

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

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

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

namedStyles

object (NamedStyles)

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

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

suggestedNamedStylesChanges

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

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

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

lists

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

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

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

namedRanges

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

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

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

inlineObjects

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

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

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

positionedObjects

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

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

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

علامة تبويب

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

تمثيل JSON
{
  "tabProperties": {
    object (TabProperties)
  },
  "childTabs": [
    {
      object (Tab)
    }
  ],

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

object (TabProperties)

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

childTabs[]

object (Tab)

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

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

object (DocumentTab)

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

TabProperties

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

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

string

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

title

string

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

parentTabId

string

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

index

integer

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

nestingLevel

integer

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

DocumentTab

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

تمثيل JSON
{
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
الحقول
body

object (Body)

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

headers

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

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

footers

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

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

footnotes

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

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

documentStyle

object (DocumentStyle)

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

suggestedDocumentStyleChanges

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

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

namedStyles

object (NamedStyles)

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

suggestedNamedStylesChanges

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

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

lists

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

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

namedRanges

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

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

inlineObjects

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

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

positionedObjects

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

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

الجسم

نص المستند

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

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

object (StructuralElement)

محتوى النص

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

StructuralElement

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

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

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

integer

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

endIndex

integer

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

حقل الربط content محتوى العنصر الهيكلي يمكن أن يكون content واحدًا فقط مما يلي:
paragraph

object (Paragraph)

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

sectionBreak

object (SectionBreak)

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

table

object (Table)

نوع جدول من العناصر الهيكلية

tableOfContents

object (TableOfContents)

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

الفقرة

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

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

object (ParagraphElement)

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

paragraphStyle

object (ParagraphStyle)

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

suggestedParagraphStyleChanges

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

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

bullet

object (Bullet)

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

suggestedBulletChanges

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

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

positionedObjectIds[]

string

أرقام تعريف العناصر المُحدَّدة بدقة والمرتبطة بهذه الفقرة

suggestedPositionedObjectIds

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

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

ParagraphElement

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

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

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

integer

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

endIndex

integer

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

حقل الربط content محتوى عنصر الفقرة يمكن أن يكون content واحدًا فقط مما يلي:
textRun

object (TextRun)

عنصر فقرة نصي

autoText

object (AutoText)

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

pageBreak

object (PageBreak)

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

columnBreak

object (ColumnBreak)

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

footnoteReference

object (FootnoteReference)

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

horizontalRule

object (HorizontalRule)

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

equation

object (Equation)

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

inlineObjectElement

object (InlineObjectElement)

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

person

object (Person)

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

TextRun

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

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

string

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

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

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)

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

foregroundColor

object (OptionalColor)

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

fontSize

object (Dimension)

حجم خط النص

weightedFontFamily

object (WeightedFontFamily)

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

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

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

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

baselineOffset

enum (BaselineOffset)

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

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

OptionalColor

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

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

object (Color)

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

اللون

لون واحد

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

object (RgbColor)

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

RgbColor

لون أحمر أخضر أزرق

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

number

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

green

number

المكوّن الأخضر للّون، من 0.0 إلى 1.0

blue

number

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

السمة

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

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

number

مقدار المجال

unit

enum (Unit)

وحدات المقدار

الوحدة

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

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

WeightedFontFamily

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

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

string

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

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

weight

integer

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

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

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

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

BaselineOffset

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

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

SuggestedTextStyle

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

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

object (TextStyle)

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

textStyleSuggestionState

object (TextStyleSuggestionState)

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

TextStyleSuggestionState

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

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

boolean

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

italicSuggested

boolean

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

underlineSuggested

boolean

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

strikethroughSuggested

boolean

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

smallCapsSuggested

boolean

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

backgroundColorSuggested

boolean

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

foregroundColorSuggested

boolean

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

fontSizeSuggested

boolean

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

weightedFontFamilySuggested

boolean

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

baselineOffsetSuggested

boolean

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

AutoText

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

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

enum (Type)

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

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

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

suggestedTextStyleChanges

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

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

النوع

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

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

PageBreak

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

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

string

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

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

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

suggestedTextStyleChanges

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

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

ColumnBreak

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

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

string

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

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

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

suggestedTextStyleChanges

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

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

FootnoteReference

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

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

string

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

footnoteNumber

string

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

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

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

suggestedTextStyleChanges

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

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

HorizontalRule

ParagraphElement يمثّل خطًا أفقيًا.

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

string

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

نمط النص الخاص بعنصر 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)

ParagraphStyle

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

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

  • يكتسب ParagraphStyle في Paragraph سمة named style type الخاصة بالفقرة المقابلة.
  • يكتسب ParagraphStyle في named style النمط المُعنوَن 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 "طلب غير صالح".

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.48 من "تنسيقات ملفات Office Open XML - أساسيات ومرجع لغة الترميز"، الجزء 1 من الإصدار 4 من ECMA-376.

عمليات التعداد
DASH_STYLE_UNSPECIFIED نمط الشرطة غير محدَّد.
SOLID خطّ متصل تتوافق مع قيمة ECMA-376 ST_PresetLineDashVal‏ "solid". هذا هو نمط الفاصل التلقائي.
DOT خط منقط تتوافق مع قيمة ECMA-376 ST_PresetLineDashVal‏ "dot".
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 يتم محاذاة موضع علامة التبويب مع نهاية السطر.

التظليل

تظليل فقرة

تمثيل 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 الأساسية في هذا الاقتراح بالنسبة إلى أيّ حقل تم ضبطه على true، تتوفّر قيمة مقترَحة جديدة.

تمثيل 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 "الخطأ 400: طلب غير صالح".

columnSeparatorStyle

enum (ColumnSeparatorStyle)

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

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

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

contentDirection

enum (ContentDirection)

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

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

marginTop

object (Dimension)

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

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

marginBottom

object (Dimension)

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

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

marginRight

object (Dimension)

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

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

marginLeft

object (Dimension)

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

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

marginHeader

object (Dimension)

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

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

sectionType

enum (SectionType)

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

defaultHeaderId

string

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

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

firstPageHeaderId

string

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

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

evenPageHeaderId

string

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

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

pageNumberStart

integer

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

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

flipPageOrientation

boolean

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

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

SectionColumnProperties

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

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

object (Dimension)

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

paddingEnd

object (Dimension)

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

ColumnSeparatorStyle

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

عمليات التعداد
COLUMN_SEPARATOR_STYLE_UNSPECIFIED نمط غير محدّد لفاصل الأعمدة
NONE لا تتضمّن الأعمدة خطوطًا فاصلة بين الأعمدة.
BETWEEN_EACH_COLUMN تعرِض هذه السمة خطًا فاصلة بين كل عمود.

SectionType

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

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

جدول

StructuralElement يمثّل جدولاً.

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

integer

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

columns

integer

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

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

tableRows[]

object (TableRow)

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

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

tableStyle

object (TableStyle)

نمط الجدول.

TableRow

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

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

integer

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

endIndex

integer

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

tableCells[]

object (TableCell)

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

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

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

tableRowStyle

object (TableRowStyle)

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

suggestedTableRowStyleChanges

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

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

TableCell

محتوى خلية وأسلوبها في Table

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

integer

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

endIndex

integer

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

content[]

object (StructuralElement)

محتوى الخلية

tableCellStyle

object (TableCellStyle)

أسلوب الخلية.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

suggestedTableCellStyleChanges

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

التغييرات المقترَحة على أسلوب خلية الجدول، مرتّبة حسب رقم تعريف الاقتراح

TableCellStyle

نمط TableCell

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

تمثيل JSON
{
  "rowSpan": integer,
  "columnSpan": integer,
  "backgroundColor": {
    object (OptionalColor)
  },
  "borderLeft": {
    object (TableCellBorder)
  },
  "borderRight": {
    object (TableCellBorder)
  },
  "borderTop": {
    object (TableCellBorder)
  },
  "borderBottom": {
    object (TableCellBorder)
  },
  "paddingLeft": {
    object (Dimension)
  },
  "paddingRight": {
    object (Dimension)
  },
  "paddingTop": {
    object (Dimension)
  },
  "paddingBottom": {
    object (Dimension)
  },
  "contentAlignment": enum (ContentAlignment)
}
الحقول
rowSpan

integer

نطاق الصف للخلية.

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

columnSpan

integer

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

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

backgroundColor

object (OptionalColor)

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

borderLeft

object (TableCellBorder)

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

borderRight

object (TableCellBorder)

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

borderTop

object (TableCellBorder)

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

borderBottom

object (TableCellBorder)

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

paddingLeft

object (Dimension)

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

paddingRight

object (Dimension)

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

paddingTop

object (Dimension)

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

paddingBottom

object (Dimension)

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

contentAlignment

enum (ContentAlignment)

محاذاة المحتوى في خلية الجدول يتطابق المحاذاة التلقائية مع محاذاة خلايا الجدول التي تم إنشاؤها حديثًا في محرِّر "مستندات 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.59 من "تنسيقات ملفات Office Open XML - أساسيات ومرجع لغة الترميز"، الجزء 1 من الإصدار 4 من 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 الأساسية في هذا الاقتراح بالنسبة إلى أيّ حقل تم ضبطه على true، تتوفّر قيمة مقترَحة جديدة.

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

boolean

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

TableStyle

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

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

object (TableColumnProperties)

خصائص كل عمود

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

TableColumnProperties

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

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

enum (WidthType)

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

width

object (Dimension)

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

WidthType

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

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

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

يتم تحديد عرض العمود تلقائيًا وسيحصل على جزء متساوٍ من العرض المتبقي للجدول بعد احتساب جميع الأعمدة ذات العرض المحدّد.

FIXED_WIDTH عرض عمود ثابت تحتوي السمة [width][google.apps.docs.v1.TableColumnProperties.width على عرض العمود.

TableOfContents

StructuralElement يمثّل جدول محتويات.

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

object (StructuralElement)

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

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

حاشية سفلية

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

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

string

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

content[]

object (StructuralElement)

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

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

DocumentStyle

نمط المستند

تمثيل JSON
{
  "background": {
    object (Background)
  },
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "useEvenPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "pageSize": {
    object (Size)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "useCustomHeaderFooterMargins": boolean,
  "flipPageOrientation": boolean
}
الحقول
background

object (Background)

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

defaultHeaderId

string

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

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

evenPageHeaderId

string

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

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

firstPageHeaderId

string

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

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

pageNumberStart

integer

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

marginTop

object (Dimension)

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

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

marginBottom

object (Dimension)

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

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

marginRight

object (Dimension)

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

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

marginLeft

object (Dimension)

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

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

pageSize

object (Size)

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

marginHeader

object (Dimension)

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

flipPageOrientation

boolean

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

الخلفية

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

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

object (OptionalColor)

لون الخلفية

الحجم

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

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

object (Dimension)

ارتفاع الجسم

width

object (Dimension)

عرض الجسم

SuggestedDocumentStyle

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

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

object (DocumentStyle)

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

documentStyleSuggestionState

object (DocumentStyleSuggestionState)

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

DocumentStyleSuggestionState

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

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

object (BackgroundSuggestionState)

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

defaultHeaderIdSuggested

boolean

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

evenPageHeaderIdSuggested

boolean

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

firstPageHeaderIdSuggested

boolean

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

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

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

boolean

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

SizeSuggestionState

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

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

boolean

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

widthSuggested

boolean

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

NamedStyles

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

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

object (NamedStyle)

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

هناك إدخال لكل قيمة من قيم named style types المحتملة.

NamedStyle

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

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

enum (NamedStyleType)

نوع هذا النمط المُعنوَن

textStyle

object (TextStyle)

نمط النص لهذا النمط المُسمّى.

paragraphStyle

object (ParagraphStyle)

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

SuggestedNamedStyles

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

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

object (NamedStyles)

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

namedStylesSuggestionState

object (NamedStylesSuggestionState)

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

NamedStylesSuggestionState

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

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

object (NamedStyleSuggestionState)

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

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

NamedStyleSuggestionState

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

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

enum (NamedStyleType)

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

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

textStyleSuggestionState

object (TextStyleSuggestionState)

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

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

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

قائمة

تمثّل القائمة سمات القائمة لمجموعة من الفقرات التي تنتمي جميعها إلى القائمة نفسها. تحتوي الفقرة التي تشكّل جزءًا من قائمة على إشارة إلى رقم تعريف القائمة في bullet.

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

object (ListProperties)

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

suggestedListPropertiesChanges

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

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

suggestedInsertionId

string

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

suggestedDeletionIds[]

string

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

ListProperties

خصائص list التي تصف مظهر علامات النقاط والشعور بها التي تنتمي إلى فقرات مرتبطة بقائمة

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

object (NestingLevel)

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

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

NestingLevel

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

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

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

enum (BulletAlignment)

محاذاة النقطة ضمن المساحة المخصّصة لعرضها

glyphFormat

string

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

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

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

A.

B.

C.

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

1.

2.

2.1.

2.2.

3.

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

indentFirstLine

object (Dimension)

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

indentStart

object (Dimension)

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

textStyle

object (TextStyle)

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

startNumber

integer

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

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

يتم تجاهل هذه القيمة لمستويات التعشيش التي تحتوي على رموز غير مرتبة.

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

enum (GlyphType)

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

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

glyphSymbol

string

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

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

BulletAlignment

أنواع محاذاة النقاط

عمليات التعداد
BULLET_ALIGNMENT_UNSPECIFIED لم يتم تحديد محاذاة النقاط.
START يتم محاذاة النقطة في بداية المساحة المخصّصة لعرضها. تتم محاذاة النص من اليسار إلى اليمين للغة التي تُقرأ من اليسار إلى اليمين، وتتم محاذاة النص من اليمين إلى اليسار في الحالات الأخرى.
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

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

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

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

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

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

string

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

name

string

اسم النطاق المُعنوَن

ranges[]

object (Range)

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

النطاق

تحدّد نطاقًا متّصلاً من النص.

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

string

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

startIndex

integer

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

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

endIndex

integer

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

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

tabId

string

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

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

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

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

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

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

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

InlineObject

عنصر يظهر مضمّنًا مع النص يحتوي InlineObject على EmbeddedObject مثل صورة.

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

string

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

inlineObjectProperties

object (InlineObjectProperties)

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

suggestedInlineObjectPropertiesChanges

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

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

suggestedInsertionId

string

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

suggestedDeletionIds[]

string

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

InlineObjectProperties

خصائص InlineObject

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

object (EmbeddedObject)

العنصر المضمّن لهذا العنصر المضمّن.

EmbeddedObject

عنصر مضمّن في المستند

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

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

string

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

description

string

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

embeddedObjectBorder

object (EmbeddedObjectBorder)

حدود الجسم المضمّن

size

object (Size)

الحجم الظاهر للصورة بعد الاقتصاص

marginTop

object (Dimension)

الهامش العلوي للكائن المضمّن

marginBottom

object (Dimension)

الهامش السفلي للكائن المضمّن

marginRight

object (Dimension)

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

marginLeft

object (Dimension)

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

linkedContentReference

object (LinkedContentReference)

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

إذا لم يتم ضبطه، لن يكون الكائن المضمّن مرتبطًا.

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

object (EmbeddedDrawingProperties)

خصائص رسم مضمّن

imageProperties

object (ImageProperties)

خصائص الصورة

EmbeddedDrawingProperties

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

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

ImageProperties

خصائص الصورة

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

string

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

sourceUri

string

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

brightness

number

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

contrast

number

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

transparency

number

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

cropProperties

object (CropProperties)

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

angle

number

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

CropProperties

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

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

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

number

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

offsetRight

number

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

offsetTop

number

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

offsetBottom

number

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

angle

number

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

EmbeddedObjectBorder

إطار حول EmbeddedObject

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

object (OptionalColor)

لون الحدود

width

object (Dimension)

عرض الحدود.

dashStyle

enum (DashStyle)

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

propertyState

enum (PropertyState)

حالة سمة الحدود

PropertyState

الحالات المحتملة لموقع جغرافي

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

LinkedContentReference

إشارة إلى محتوى المصدر الخارجي المرتبط

تمثيل JSON
{

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

object (SheetsChartReference)

إشارة إلى الرسم البياني المرتبط.

SheetsChartReference

إشارة إلى رسم بياني مرتبط تم تضمينه من "جداول بيانات Google"

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

string

رقم تعريف جدول بيانات "جداول بيانات Google" الذي يحتوي على الرسم البياني المصدر

chartId

integer

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

SuggestedInlineObjectProperties

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

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

object (InlineObjectProperties)

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

inlineObjectPropertiesSuggestionState

object (InlineObjectPropertiesSuggestionState)

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

InlineObjectPropertiesSuggestionState

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

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

object (EmbeddedObjectSuggestionState)

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

EmbeddedObjectSuggestionState

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

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

يشير إلى ما إذا كان هناك تغيير مقترَح على [brightness] [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 الأساسية في هذا الاقتراح بالنسبة إلى أيّ حقل تم ضبطه على true، تتوفّر قيمة مقترَحة جديدة.

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

SuggestionsViewMode

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

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

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

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

PREVIEW_SUGGESTIONS_ACCEPTED

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

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

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

الطُرق

batchUpdate

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

create

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

get

تحصل على أحدث إصدار من المستند المحدّد.