REST Resource: documents

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

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

تمثيل JSON 
{
  "documentId": string,
  "title": string,
  "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)
    },
    ...
  },
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
الحقول
documentId

string

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

string

تمثّل هذه السمة عنوان المستند.
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))

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

string

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

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

enum (SuggestionsViewMode)

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

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

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

إخراج فقط. الكائنات المضمّنة في المستند، المرتبطة بمعرّف الكائن.
positionedObjects

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

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

النص الأساسي

نص المستند.

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

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

object (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 المحتوى ضمن 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)

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

تشغيل النص

تمثّل هذه السمة 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 للنص في Paragraph من العنصر named style type المقابل للفقرة.
  • يكتسب TextStyle على named style من النمط normal text المُسمّى.
  • يتم اكتساب نمط النص للنمط المُسمّى normal text من النمط التلقائي للنص في أداة تحرير "مستندات Google".
  • قد يكتسب TextStyle في عنصر Paragraph المتوفّر في جدول نمط النص الخاص به من نمط الجدول.

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

تمثيل JSON 
{
  "bold": boolean,
  "italic": boolean,
  "underline": boolean,
  "strikethrough": boolean,
  "smallCaps": boolean,
  "backgroundColor": {
    object (OptionalColor)
  },
  "foregroundColor": {
    object (OptionalColor)
  },
  "fontSize": {
    object (Dimension)
  },
  "weightedFontFamily": {
    object (WeightedFontFamily)
  },
  "baselineOffset": enum (BaselineOffset),
  "link": {
    object (Link)
  }
}
الحقول
bold

boolean

يوضّح هذا الإعداد ما إذا كان النص غامقًا أم لا.
italic

boolean

تحديد ما إذا كان النص مائلاً أم لا
underline

boolean

تحديد ما إذا كان النص مسطّرًا أم لا
strikethrough

boolean

يشير ذلك إلى ما إذا كان النص يتوسطه خط.
smallCaps

boolean

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

object (OptionalColor)

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

object (OptionalColor)

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

object (Dimension)

حجم خط النص.
weightedFontFamily

object (WeightedFontFamily)

مجموعة الخطوط وكثافة النص المعروضة

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

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

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

enum (BaselineOffset)

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

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

اللون الاختياري

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

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

object (Color)

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

اللون

لون خالص.

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

object (RgbColor)

تمثّل هذه السمة قيمة لون نموذج أحمر أخضر أزرق.

لون RGB

لون نموذج أحمر أخضر أزرق:

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

number

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

number

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

number

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

السمة

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

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

number

المقدار.
unit

enum (Unit)

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

الوحدة

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

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

weightedFontFamily

لتمثيل مجموعة خطوط وعرض النص.

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

string

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

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

integer

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

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

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

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

إزاحة خط الأساس

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

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

نمط النص المقترح

تغيير مقترح على 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.

نص تلقائي

تمثّل هذه السمة 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 اكتب للنص التلقائي الذي يمثل إجمالي عدد الصفحات في المستند.

فاصل صفحة

تمثّل هذه السمة 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))

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

فاصل أعمدة

تمثّل هذه السمة 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))

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

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

تمثّل هذه السمة 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 هذا، وفقًا لمعرّف الاقتراح.

قاعدة أفقية

تمثّل هذه السمة ParagraphElement خطًا أفقيًا.

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

string

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

string

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

object (TextStyle)

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

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

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

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

المعادلة

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

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

string

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

string

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

InlineObjectElement

تمثّل هذه السمة ParagraphElement الذي يتضمّن InlineObject.

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

string

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

string

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

string

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

object (TextStyle)

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

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

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

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

شخص

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

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

string

إخراج فقط. المعرّف الفريد لهذا الرابط
suggestedInsertionIds[]

string

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

string

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

object (TextStyle)

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

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

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

object (PersonProperties)

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

خصائص الأشخاص

الخصائص الخاصة بسمة 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 على Paragraph من العنصر named style type المقابل للفقرة.
  • يتم اكتساب نمط الفقرة على named style من النمط المسمى normal text.
  • يتم اكتساب نمط الفقرة للنمط المسمى normal text من نمط الفقرة التلقائي في أداة تحرير "مستندات Google".
  • قد يكتسب ParagraphStyle في عنصر Paragraph المتوفّر في جدول نمط الفقرة الخاص به من نمط الجدول.

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

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

string

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

هذا الموقع الإلكتروني للقراءة فقط.
namedStyleType

enum (NamedStyleType)

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

نظرًا لأن تعديل نوع النمط المُعنوَن يؤثر في الخصائص الأخرى ضمن 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 ينتقل المحتوى من اليمين إلى اليسار.

وضع التباعد

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

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

حدود الفقرة

حد حول فقرة.

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

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

نمط شرطة

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

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

TabStop

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

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

object (Dimension)

الإزاحة بين تتوقف علامة الجدولة هذه وهامش البدء.
alignment

enum (TabStopAlignment)

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

محاذاة علامة التبويب

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

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

التظليل

تظليل فقرة.

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

object (OptionalColor)

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

نمط الفقرة المقترح

تغيير مقترح على ParagraphStyle.

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

object (ParagraphStyle)

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

object (ParagraphStyleSuggestionState)

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

حالة اقتراح الفقرة

قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح من خلال قاعدة 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.

حالة اقتراح التظليل

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

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

boolean

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

تعداد نقطي

تصف النقطة الفاصلة للفقرة.

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

string

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

integer

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

object (TextStyle)

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

عنصر قائمة نقطية مقترحة

تغيير مقترح على Bullet.

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

object (Bullet)

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

object (BulletSuggestionState)

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

BulletSuggestionState

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

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

boolean

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

boolean

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

object (TextStyleSuggestionState)

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

مراجع الكائنات

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

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

string

أرقام تعريف العناصر.

فاصل أقسام

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

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

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

string

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

string

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

object (SectionStyle)

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

نمط القسم

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

تمثيل JSON 
{
  "columnProperties": [
    {
      object (SectionColumnProperties)
    }
  ],
  "columnSeparatorStyle": enum (ColumnSeparatorStyle),
  "contentDirection": enum (ContentDirection),
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "sectionType": enum (SectionType),
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "flipPageOrientation": boolean
}
الحقول
columnProperties[]

object (SectionColumnProperties)

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

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

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

enum (ColumnSeparatorStyle)

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

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

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

enum (ContentDirection)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

enum (SectionType)

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

string

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

هذا الموقع الإلكتروني للقراءة فقط.
firstPageHeaderId

string

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

هذا الموقع الإلكتروني للقراءة فقط.
firstPageFooterId

string

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

هذا الموقع الإلكتروني للقراءة فقط.
evenPageHeaderId

string

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

هذا الموقع الإلكتروني للقراءة فقط.
evenPageFooterId

string

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

هذا الموقع الإلكتروني للقراءة فقط.
useFirstPageHeaderFooter

boolean

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

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

integer

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

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

boolean

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

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

ItemColumnProperties (خصائص القسم)

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

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

object (Dimension)

إخراج فقط. تمثّل هذه السمة عرض العمود.
paddingEnd

object (Dimension)

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

نمط الفاصل العمودي

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

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

نوع القسم

لعرض كيفية وضع بداية القسم الحالي مقارنةً بالقسم السابق.

عمليات التعداد
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)

نمط الجدول.

صف الجدول

محتوى ونمط صف في 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)

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

محاذاة المحتوى

أنواع محاذاة المحتوى.

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

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

SuggestedTableCellStyle

تغيير مقترح على TableCellStyle.

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

object (TableCellStyle)

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

object (TableCellStyleSuggestionState)

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

TableCellStyleSuggestionState

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

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

نمط صف الجدول

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

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

object (Dimension)

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

boolean

ما إذا كان الصف عبارة عن عنوان جدول.
preventOverflow

boolean

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

نمط الجدول المقترَح

تغيير مقترح على TableRowStyle.

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

object (TableRowStyle)

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

object (TableRowStyleSuggestionState)

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

TablerowStyleSuggestionState

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

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

boolean

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

نمط الجدول

يشير ذلك المصطلح إلى الأنماط التي تنطبق على الجدول.

تمثيل 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 على عرض العمود.

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

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

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

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

نمط المستند

نمط المستند

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

object (Background)

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

string

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

هذا الموقع الإلكتروني للقراءة فقط.
evenPageHeaderId

string

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

هذا الموقع الإلكتروني للقراءة فقط.
evenPageFooterId

string

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

هذا الموقع الإلكتروني للقراءة فقط.
firstPageHeaderId

string

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

هذا الموقع الإلكتروني للقراءة فقط.
firstPageFooterId

string

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

هذا الموقع الإلكتروني للقراءة فقط.
useFirstPageHeaderFooter

boolean

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

boolean

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

integer

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

object (Dimension)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

object (Size)

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

object (Dimension)

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

boolean

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

الخلفية

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

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

object (OptionalColor)

لون الخلفية

حجم الملف

عرض وارتفاع.

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

object (Dimension)

ارتفاع الكائن.
width

object (Dimension)

عرض العنصر.

نمط مستند مقترح

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

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

object (DocumentStyle)

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

object (DocumentStyleSuggestionState)

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

DocumentStyleSuggestionState

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

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

object (BackgroundSuggestionState)

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

object (SizeSuggestionState)

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

boolean

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

boolean

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

BackgroundSuggestionState (حالة اقتراح الخلفية)

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

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

boolean

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

حالة SizeSuggestionState

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

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

boolean

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

boolean

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

الأنماط المُسَمّاة

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

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

object (NamedStyle)

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

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

نمط مُسمّى

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

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

enum (NamedStyleType)

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

object (TextStyle)

نمط النص لهذا النمط المُعنوَن.
paragraphStyle

object (ParagraphStyle)

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

أنماط الاسم المقترحة

تغيير مقترح على 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

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

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

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

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

object (NestingLevel)

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

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

مستوى التداخل

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

تمثيل 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. على سبيل المثال، إذا كان الرمز الرسومي هو الدائرة الصلبة المقابلة لنقطة رمز يونيكود U+25cf والقيمة glyphFormat هي %0، يكون الرمز الرسومي المعروض هو الدائرة الصلبة.

محاذاة نقطية

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

عمليات التعداد
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

الخصائص المقترحة

تغيير مقترح على 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.

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

حالة اقتراح NestingLevel

قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح من خلال قاعدة 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.

نطاقات مُعنوَنة

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

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

string

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

object (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
}
الحقول
segmentId

string

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

integer

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

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

integer

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

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

وضع عرض الاقتراحات

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

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

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

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

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

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

عنصر مضمّن

كائن يظهر مضمّنًا مع النص. يحتوي الكائن 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)

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

inlineObject

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

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

خصائص صورة معيّنة.

inlineDrawingProperties

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

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

خصائص الصورة

خصائص صورة معيّنة.

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

string

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

string

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

number

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

number

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

number

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

object (CropProperties)

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

number

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

خصائص الاقتصاص

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

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

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

number

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

number

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

number

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

number

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

number

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

inlineObjectBorder

حدود حول 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، لن يحصل العنصر على الخاصية المقابلة عند عرضه في المستند.

مرجع المحتوى المرتبط

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

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

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

مرجع الرسم البياني لجداول البيانات

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

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

string

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

integer

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

SuggestedInlineObjectProperties

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

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

object (InlineObjectProperties)

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

object (InlineObjectPropertiesSuggestionState)

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

InlineObjectPropertiesSuggestionState

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

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

object (EmbeddedObjectSuggestionState)

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

inlineObjectSuggestionState.

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

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

object (EmbeddedDrawingPropertiesSuggestionState)

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

object (ImagePropertiesSuggestionState)

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

boolean

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

boolean

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

object (EmbeddedObjectBorderSuggestionState)

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

object (SizeSuggestionState)

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

boolean

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

boolean

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

boolean

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

boolean

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

object (LinkedContentReferenceSuggestionState)

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

inlineDrawingPropertiesSuggestionState.

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

قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح من خلال قاعدة 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.inlineObject.source_uri].
brightnessSuggested

boolean

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

boolean

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

boolean

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

object (CropPropertiesSuggestionState)

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

boolean

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

CropPropertiesSuggestionState

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

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

inlineObjectBorderSuggestionState

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

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

boolean

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

boolean

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

boolean

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

boolean

يشير إلى ما إذا كان هناك تغيير مقترَح على [propertyState] [google.apps.docs.v1.inlineBorderObject.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 العنصر الذي تم تحديد موضعه يظهر خلف النص.

SuggestPositionedObjectProperties

تغيير مقترح على 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.

الطُرق

batchUpdate

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

create

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

get

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