REST Resource: documents

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

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

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

string

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

string

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

object (Tab)

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

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

string

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

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

enum (SuggestionsViewMode)

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

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

object (Body)

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

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

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

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

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

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

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

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

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

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

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

object (DocumentStyle)

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

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

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

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

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

object (NamedStyles)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

علامة تبويب

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

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

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

object (TabProperties)

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

object (Tab)

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

object (DocumentTab)

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

TabProperties

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

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

string

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

string

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

string

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

integer

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

integer

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

DocumentTab

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

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

object (Body)

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

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

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

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

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

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

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

object (DocumentStyle)

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

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

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

object (NamedStyles)

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

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

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

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

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

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

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

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

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

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

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

الجسم

نص المستند

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

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

object (StructuralElement)

محتوى النص

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

StructuralElement

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

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

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

integer

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

integer

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

object (Paragraph)

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

object (SectionBreak)

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

object (Table)

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

object (TableOfContents)

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

الفقرة

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

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

object (ParagraphElement)

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

object (ParagraphStyle)

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

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

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

object (Bullet)

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

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

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

string

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

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

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

ParagraphElement

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

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

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

integer

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

integer

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

object (TextRun)

عنصر فقرة نصي
autoText

object (AutoText)

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

object (PageBreak)

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

object (ColumnBreak)

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

object (FootnoteReference)

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

object (HorizontalRule)

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

object (Equation)

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

object (InlineObjectElement)

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

object (Person)

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

TextRun

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

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

string

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

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

string

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

string

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

object (TextStyle)

نمط النص لهذا الإجراء.
suggestedTextStyleChanges

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

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

TextStyle

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

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

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

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

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

object (OptionalColor)

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

object (OptionalColor)

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

object (Dimension)

حجم خط النص
weightedFontFamily

object (WeightedFontFamily)

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

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

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

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

enum (BaselineOffset)

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

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

OptionalColor

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

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

object (Color)

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

اللون

لون خالص

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

object (RgbColor)

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

RgbColor

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

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

number

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

number

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

number

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

السمة

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

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

number

مقدار المجال
unit

enum (Unit)

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

الوحدة

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

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

WeightedFontFamily

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

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

string

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

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

integer

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

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

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

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

BaselineOffset

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

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

SuggestedTextStyle

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

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

object (TextStyle)

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

object (TextStyleSuggestionState)

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

TextStyleSuggestionState

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

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

AutoText

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

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

enum (Type)

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

string

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

string

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

object (TextStyle)

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

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

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

النوع

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

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

PageBreak

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

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

string

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

string

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

object (TextStyle)

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

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

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

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

ColumnBreak

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

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

string

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

string

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

object (TextStyle)

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

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

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

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

FootnoteReference

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

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

string

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

string

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

string

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

string

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

object (TextStyle)

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

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

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

HorizontalRule

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

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

string

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

string

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

object (TextStyle)

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

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

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

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

معادلة

ParagraphElement يمثّل معادلة

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

string

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

string

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

InlineObjectElement

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

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

string

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

string

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

string

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

object (TextStyle)

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

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

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

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

شخص

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

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

string

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

string

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

string

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

object (TextStyle)

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

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

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

object (PersonProperties)

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

PersonProperties

الخصائص الخاصة بـ Person المرتبط

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

string

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

string

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

RichLinkProperties

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

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

string

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

string

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

string

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

ParagraphStyle

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

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

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

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

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

string

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

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

enum (NamedStyleType)

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

بما أنّ تعديل نوع النمط المُعنوَن يؤثر في الخصائص الأخرى ضمن ParagraphStyle، يتم تطبيق نوع النمط المُعنوَن قبل تعديل الخصائص الأخرى.
alignment

enum (Alignment)

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

number

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

enum (ContentDirection)

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

enum (SpacingMode)

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

object (Dimension)

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

object (Dimension)

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

object (ParagraphBorder)

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

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

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

object (ParagraphBorder)

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

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

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

object (ParagraphBorder)

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

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

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

object (ParagraphBorder)

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

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

object (ParagraphBorder)

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

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

object (Dimension)

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

object (Dimension)

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

object (Dimension)

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

object (TabStop)

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

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

boolean

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

boolean

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

boolean

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

object (Shading)

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

boolean

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

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

NamedStyleType

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

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

محاذاة

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

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

ContentDirection

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

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

SpacingMode

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

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

ParagraphBorder

إطار حول فقرة

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

object (OptionalColor)

لون الحدود
width

object (Dimension)

عرض الحدود.
padding

object (Dimension)

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

enum (DashStyle)

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

DashStyle

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

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

TabStop

نقطة توقف علامة تبويب داخل فقرة

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

object (Dimension)

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

enum (TabStopAlignment)

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

TabStopAlignment

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

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

التظليل

تظليل فقرة

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

object (OptionalColor)

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

SuggestedParagraphStyle

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

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

object (ParagraphStyle)

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

object (ParagraphStyleSuggestionState)

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

ParagraphStyleSuggestionState

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

تمثيل JSON 
{
  "headingIdSuggested": boolean,
  "namedStyleTypeSuggested": boolean,
  "alignmentSuggested": boolean,
  "lineSpacingSuggested": boolean,
  "directionSuggested": boolean,
  "spacingModeSuggested": boolean,
  "spaceAboveSuggested": boolean,
  "spaceBelowSuggested": boolean,
  "borderBetweenSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "indentFirstLineSuggested": boolean,
  "indentStartSuggested": boolean,
  "indentEndSuggested": boolean,
  "keepLinesTogetherSuggested": boolean,
  "keepWithNextSuggested": boolean,
  "avoidWidowAndOrphanSuggested": boolean,
  "shadingSuggestionState": {
    object (ShadingSuggestionState)
  },
  "pageBreakBeforeSuggested": boolean
}
الحقول
headingIdSuggested

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

object (ShadingSuggestionState)

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

boolean

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

ShadingSuggestionState

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

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

boolean

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

تعداد نقطي

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

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

string

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

integer

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

object (TextStyle)

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

SuggestedBullet

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

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

object (Bullet)

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

object (BulletSuggestionState)

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

BulletSuggestionState

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

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

boolean

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

boolean

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

object (TextStyleSuggestionState)

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

ObjectReferences

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

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

string

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

SectionBreak

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

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

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

string

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

string

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

object (SectionStyle)

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

SectionStyle

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

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

object (SectionColumnProperties)

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

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

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

enum (ColumnSeparatorStyle)

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

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

عند تعديل هذه السمة، يجب ضبط قيمة محدّدة. يؤدي إلغاء ضبط هذه السمة إلى ظهور خطأ 400 "الخطأ 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 "الخطأ 400: طلب غير صالح".
marginLeft

object (Dimension)

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

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

object (Dimension)

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

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

enum (SectionType)

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

string

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

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

string

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

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

string

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

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

string

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

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

string

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

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

boolean

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

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

integer

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

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

boolean

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

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

SectionColumnProperties

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

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

object (Dimension)

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

object (Dimension)

الحشو في نهاية العمود

ColumnSeparatorStyle

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

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

SectionType

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

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

جدول

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

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

integer

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

integer

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

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

object (TableRow)

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

string

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

string

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

object (TableStyle)

نمط الجدول.

TableRow

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

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

integer

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

integer

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

object (TableCell)

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

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

string

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

string

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

object (TableRowStyle)

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

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

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

TableCell

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

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

integer

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

integer

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

object (StructuralElement)

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

object (TableCellStyle)

أسلوب الخلية.
suggestedInsertionIds[]

string

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

string

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

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

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

TableCellStyle

نمط TableCell.

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

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

integer

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

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

integer

امتداد العمود للخلية.

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

object (OptionalColor)

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

object (TableCellBorder)

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

object (TableCellBorder)

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

object (TableCellBorder)

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

object (TableCellBorder)

الحد السفلي للخلية.
paddingLeft

object (Dimension)

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

object (Dimension)

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

object (Dimension)

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

object (Dimension)

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

enum (ContentAlignment)

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

TableCellBorder

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

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

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

object (OptionalColor)

لون الحدود

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

object (Dimension)

عرض الحدود.
dashStyle

enum (DashStyle)

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

ContentAlignment

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

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

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

SuggestedTableCellStyle

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

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

object (TableCellStyle)

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

object (TableCellStyleSuggestionState)

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

TableCellStyleSuggestionState

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

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

TableRowStyle

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

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

object (Dimension)

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

boolean

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

boolean

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

SuggestedTableRowStyle

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

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

object (TableRowStyle)

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

object (TableRowStyleSuggestionState)

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

TableRowStyleSuggestionState

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

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

boolean

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

TableStyle

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

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

object (TableColumnProperties)

خصائص كل عمود

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

TableColumnProperties

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

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

enum (WidthType)

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

object (Dimension)

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

WidthType

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

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

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

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

TableOfContents

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

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

object (StructuralElement)

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

string

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

string

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

حاشية سفلية

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

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

string

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

object (StructuralElement)

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

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

DocumentStyle

نمط المستند

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

object (Background)

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

string

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

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

string

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

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

string

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

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

string

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

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

string

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

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

boolean

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

boolean

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

integer

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

object (Dimension)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

object (Size)

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

object (Dimension)

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

boolean

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

الخلفية

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

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

object (OptionalColor)

لون الخلفية

الحجم

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

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

object (Dimension)

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

object (Dimension)

عرض الجسم

SuggestedDocumentStyle

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

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

object (DocumentStyle)

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

object (DocumentStyleSuggestionState)

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

DocumentStyleSuggestionState

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

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

object (BackgroundSuggestionState)

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

object (SizeSuggestionState)

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

boolean

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

boolean

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

BackgroundSuggestionState

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

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

boolean

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

SizeSuggestionState

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

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

boolean

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

boolean

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

NamedStyles

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

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

object (NamedStyle)

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

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

NamedStyle

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

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

enum (NamedStyleType)

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

object (TextStyle)

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

object (ParagraphStyle)

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

SuggestedNamedStyles

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

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

object (NamedStyles)

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

object (NamedStylesSuggestionState)

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

NamedStylesSuggestionState

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

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

object (NamedStyleSuggestionState)

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

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

NamedStyleSuggestionState

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

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

enum (NamedStyleType)

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

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

object (TextStyleSuggestionState)

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

object (ParagraphStyleSuggestionState)

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

قائمة

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

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

object (ListProperties)

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

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

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

string

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

string

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

ListProperties

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

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

object (NestingLevel)

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

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

NestingLevel

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

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

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

enum (BulletAlignment)

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

string

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

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

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

A.

B.

C.

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

1.

2.

2.1.

2.2.

3.

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

object (Dimension)

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

object (Dimension)

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

object (TextStyle)

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

integer

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

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

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

enum (GlyphType)

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

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

string

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

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

BulletAlignment

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

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

GlyphType

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

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

SuggestedListProperties

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

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

object (ListProperties)

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

object (ListPropertiesSuggestionState)

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

ListPropertiesSuggestionState

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

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

object (NestingLevelSuggestionState)

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

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

NestingLevelSuggestionState

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

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

object (TextStyleSuggestionState)

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

boolean

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

NamedRanges

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

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

string

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

object (NamedRange)

NamedRange التي تحمل الاسم نفسه

NamedRange

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

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

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

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

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

string

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

string

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

object (Range)

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

النطاق

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

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

string

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

integer

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

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

integer

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

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

string

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

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

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

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

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

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

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

InlineObject

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

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

string

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

object (InlineObjectProperties)

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

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

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

string

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

string

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

InlineObjectProperties

خصائص InlineObject

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

object (EmbeddedObject)

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

EmbeddedObject

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

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

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

string

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

string

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

object (EmbeddedObjectBorder)

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

object (Size)

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

object (Dimension)

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

object (Dimension)

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

object (Dimension)

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

object (Dimension)

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

object (LinkedContentReference)

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

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

object (EmbeddedDrawingProperties)

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

object (ImageProperties)

خصائص الصورة

EmbeddedDrawingProperties

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

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

ImageProperties

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

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

string

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

string

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

number

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

number

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

number

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

object (CropProperties)

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

number

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

CropProperties

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

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

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

number

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

number

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

number

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

number

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

number

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

EmbeddedObjectBorder

حدود حول EmbeddedObject

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

object (OptionalColor)

لون الحدود
width

object (Dimension)

عرض الحدود.
dashStyle

enum (DashStyle)

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

enum (PropertyState)

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

PropertyState

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

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

LinkedContentReference

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

تمثيل JSON 
{

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

object (SheetsChartReference)

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

SheetsChartReference

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

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

string

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

integer

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

SuggestedInlineObjectProperties

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

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

object (InlineObjectProperties)

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

object (InlineObjectPropertiesSuggestionState)

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

InlineObjectPropertiesSuggestionState

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

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

object (EmbeddedObjectSuggestionState)

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

EmbeddedObjectSuggestionState

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

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

object (EmbeddedDrawingPropertiesSuggestionState)

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

object (ImagePropertiesSuggestionState)

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

boolean

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

boolean

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

object (EmbeddedObjectBorderSuggestionState)

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

object (SizeSuggestionState)

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

boolean

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

boolean

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

boolean

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

boolean

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

object (LinkedContentReferenceSuggestionState)

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

EmbeddedDrawingPropertiesSuggestionState

لا يتضمّن هذا النوع أيّ حقول.

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

ImagePropertiesSuggestionState

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

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

object (CropPropertiesSuggestionState)

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

boolean

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

CropPropertiesSuggestionState

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

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

EmbeddedObjectBorderSuggestionState

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

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

boolean

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

boolean

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

boolean

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

boolean

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

LinkedContentReferenceSuggestionState

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

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

object (SheetsChartReferenceSuggestionState)

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

SheetsChartReferenceSuggestionState

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

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

boolean

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

boolean

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

PositionedObject

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

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

string

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

object (PositionedObjectProperties)

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

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

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

string

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

string

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

PositionedObjectProperties

خصائص PositionedObject

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

object (PositionedObjectPositioning)

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

object (EmbeddedObject)

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

PositionedObjectPositioning

موضع PositionedObject يتم وضع الجسم المُحدَّد بالنسبة إلى بداية Paragraph المرتبط به.

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

enum (PositionedObjectLayout)

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

object (Dimension)

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

object (Dimension)

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

PositionedObjectLayout

التنسيقات المحتمَلة لعنصر [PositionedObject][google.aps.docs.v1.PositionedObject]

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

SuggestedPositionedObjectProperties

تغيير مُقترَح على PositionedObjectProperties

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

object (PositionedObjectProperties)

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

object (PositionedObjectPropertiesSuggestionState)

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

PositionedObjectPropertiesSuggestionState

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

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

object (PositionedObjectPositioningSuggestionState)

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

object (EmbeddedObjectSuggestionState)

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

PositionedObjectPositioningSuggestionState

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

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

boolean

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

boolean

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

boolean

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

SuggestionsViewMode

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

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

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

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

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

ستؤدي طلبات استرداد مستند باستخدام هذا الوضع إلى عرض خطأ 403 إذا لم يكن لدى المستخدم إذن بعرض التغييرات المقترَحة.
PREVIEW_WITHOUT_SUGGESTIONS المستند المعروض هو معاينة تم رفض جميع التغييرات المقترَحة فيها إذا كانت هناك أي اقتراحات في المستند.

الطُرق

batchUpdate

 تُطبِّق تعديلًا واحدًا أو أكثر على المستند.

create

 ينشئ مستندًا فارغًا باستخدام العنوان الوارد في الطلب.

get

 تحصل على أحدث إصدار من المستند المحدّد.