- المورد: مستند
- علامة تبويب
- TabProperties
- DocumentTab
- النص الأساسي
- StructuralElement
- فقرة
- ParagraphElement
- TextRun
- TextStyle
- OptionalColor
- اللون
- RgbColor
- السمة
- الوحدة
- WeightedFontFamily
- BaselineOffset
- الرابط
- BookmarkLink
- HeadingLink
- SuggestedTextStyle
- TextStyleSuggestionState
- AutoText
- النوع
- PageBreak
- ColumnBreak
- FootnoteReference
- HorizontalRule
- المعادلة
- InlineObjectElement
- شخص
- PersonProperties
- RichLink
- RichLinkProperties
- ParagraphStyle
- NamedStyleType
- المحاذاة
- ContentDirection
- SpacingMode
- ParagraphBorder
- DashStyle
- TabStop
- TabStopAlignment
- التظليل
- SuggestedParagraphStyle
- ParagraphStyleSuggestionState
- ShadingSuggestionState
- تعداد نقطي
- SuggestedBullet
- BulletSuggestionState
- ObjectReferences
- SectionBreak
- SectionStyle
- SectionColumnProperties
- ColumnSeparatorStyle
- SectionType
- جدول
- TableRow
- TableCell
- TableCellStyle
- TableCellBorder
- ContentAlignment
- SuggestedTableCellStyle
- TableCellStyleSuggestionState
- TableRowStyle
- SuggestedTableRowStyle
- TableRowStyleSuggestionState
- TableStyle
- TableColumnProperties
- WidthType
- TableOfContents
- العنوان
- التذييل
- الحاشية السفلية
- DocumentStyle
- الخلفية
- المقاس
- SuggestedDocumentStyle
- DocumentStyleSuggestionState
- BackgroundSuggestionState
- SizeSuggestionState
- NamedStyles
- NamedStyle
- SuggestedNamedStyles
- NamedStylesSuggestionState
- NamedStyleSuggestionState
- قائمة
- ListProperties
- NestingLevel
- BulletAlignment
- GlyphType
- SuggestedListProperties
- ListPropertiesSuggestionState
- NestingLevelSuggestionState
- NamedRanges
- NamedRange
- النطاق
- InlineObject
- InlineObjectProperties
- EmbeddedObject
- EmbeddedDrawingProperties
- ImageProperties
- CropProperties
- EmbeddedObjectBorder
- PropertyState
- LinkedContentReference
- SheetsChartReference
- SuggestedInlineObjectProperties
- InlineObjectPropertiesSuggestionState
- EmbeddedObjectSuggestionState
- EmbeddedDrawingPropertiesSuggestionState
- ImagePropertiesSuggestionState
- CropPropertiesSuggestionState
- EmbeddedObjectBorderSuggestionState
- LinkedContentReferenceSuggestionState
- SheetsChartReferenceSuggestionState
- PositionedObject
- PositionedObjectProperties
- PositionedObjectPositioning
- PositionedObjectLayout
- SuggestedPositionedObjectProperties
- PositionedObjectPropertiesSuggestionState
- PositionedObjectPositioningSuggestionState
- SuggestionsViewMode
- الطُرق
المرجع: مستند
مستند في "مستندات Google"
تمثيل JSON |
---|
{ "documentId": string, "title": string, "tabs": [ { object ( |
الحقول | |
---|---|
documentId |
النتائج فقط. رقم تعريف المستند. |
title |
تمثّل هذه السمة عنوان المستند. |
tabs[] |
علامات التبويب التي تشكِّل جزءًا من مستند يمكن أن تحتوي علامات التبويب على علامات تبويب فرعية، وهي علامة تبويب مدمجة في علامة تبويب أخرى. يتم تمثيل علامات التبويب الفرعية بالحقل |
revisionId |
النتائج فقط. معرّف النسخة السابقة للمستند. يمكن استخدامها في طلبات التحديث لتحديد مراجعة المستند التي تريد تطبيق التحديثات عليها وكيف يجب أن يتصرف الطلب إذا تم تعديل المستند منذ تلك المراجعة. لا تتم تعبئة هذا الحقل إلا إذا كان لدى المستخدم الإذن بتعديل المستند. معرّف النسخة السابقة ليس رقمًا تسلسليًا ولكنه سلسلة مبهمة. قد يتغير تنسيق رقم تعريف النسخة السابقة بمرور الوقت. إنّ معرّف النسخة السابقة الذي تم إرجاعه مضمون فقط لمدة 24 ساعة بعد إرجاعه ولا يمكن مشاركته بين المستخدمين. إذا لم يتغير رقم تعريف النسخة السابقة بين المكالمات، فلن يتغير المستند. وفي المقابل، يعني تغيير المعرّف (للمستند والمستخدم نفسه) عادةً أنّه تم تعديل المستند. ومع ذلك، قد يرجع تغيير رقم التعريف أيضًا إلى عوامل داخلية، مثل التغييرات في تنسيق المعرّف. |
suggestionsViewMode |
النتائج فقط. وضع عرض الاقتراحات المطبَّق على المستند ملاحظة: عند تعديل مستند، يجب أن تستند التغييرات إلى مستند يحتوي على |
body |
النتائج فقط. تمثّل هذه السمة النص الأساسي للمستند. حقل قديم: بدلاً من ذلك، يمكنك استخدام |
headers |
النتائج فقط. العناوين في المستند، مرتبطة بمعرّف العنوان. حقل قديم: بدلاً من ذلك، يمكنك استخدام |
footers |
النتائج فقط. التذييلات في المستند، مرتبطة برقم تعريف التذييل. حقل قديم: بدلاً من ذلك، يمكنك استخدام |
footnotes |
النتائج فقط. الحواشي السفلية في المستند، مرتبطة برقم تعريف الحاشية السفلية. حقل قديم: بدلاً من ذلك، يمكنك استخدام |
documentStyle |
النتائج فقط. نمط المستند. حقل قديم: بدلاً من ذلك، يمكنك استخدام |
suggestedDocumentStyleChanges |
النتائج فقط. التغييرات المقترَحة على نمط المستند، استنادًا إلى رقم تعريف الاقتراح حقل قديم: بدلاً من ذلك، يمكنك استخدام |
namedStyles |
النتائج فقط. الأنماط المُسَمّاة للمستند حقل قديم: بدلاً من ذلك، يمكنك استخدام |
suggestedNamedStylesChanges |
النتائج فقط. التغييرات المقترحة على الأنماط المُسَمّاة للمستند، استنادًا إلى رقم تعريف الاقتراح حقل قديم: بدلاً من ذلك، يمكنك استخدام |
lists |
النتائج فقط. القوائم الموجودة في المستند، مرتبطة برقم تعريف القائمة. حقل قديم: بدلاً من ذلك، يمكنك استخدام |
namedRanges |
النتائج فقط. النطاقات المُعنونة في المستند، مفصولة حسب الاسم. حقل قديم: بدلاً من ذلك، يمكنك استخدام |
inlineObjects |
النتائج فقط. تمثّل هذه السمة العناصر المضمَّنة في المستند، استنادًا إلى رقم تعريف الكائن. حقل قديم: بدلاً من ذلك، يمكنك استخدام |
positionedObjects |
النتائج فقط. يشير ذلك المصطلح إلى العناصر الموضوعة في المستند، استنادًا إلى رقم تعريف الكائن. حقل قديم: بدلاً من ذلك، يمكنك استخدام |
علامة تبويب
علامة تبويب في مستند
تمثيل JSON |
---|
{ "tabProperties": { object ( |
الحقول | |
---|---|
tabProperties |
خصائص علامة التبويب، مثل رقم التعريف والعنوان. |
childTabs[] |
علامات التبويب الفرعية المتداخلة داخل علامة التبويب هذه. |
حقل الاتحاد content . محتوى علامة التبويب يمكن أن يكون content واحدًا فقط مما يلي: |
|
documentTab |
علامة تبويب تتضمّن محتوى المستند، مثلاً النصوص والصور. |
TabProperties
خصائص علامة التبويب
تمثيل JSON |
---|
{ "tabId": string, "title": string, "parentTabId": string, "index": integer, "nestingLevel": integer } |
الحقول | |
---|---|
tabId |
النتائج فقط. رقم تعريف علامة التبويب. لا يمكن تغيير هذا الحقل. |
title |
اسم علامة التبويب المرئي للمستخدم |
parentTabId |
اختياريّ. رقم تعريف علامة التبويب الرئيسية. فارغة عندما تكون علامة التبويب الحالية هي علامة تبويب على مستوى الجذر، ما يعني أنّه ليس لها أي عناصر رئيسية |
index |
الفهرس القائم على علامة صفرية لعلامة التبويب داخل العنصر الرئيسي. |
nestingLevel |
النتائج فقط. عمق علامة التبويب في المستند. تبدأ علامات التبويب على مستوى الجذر من 0. |
DocumentTab
علامة تبويب تتضمّن محتوى المستند
تمثيل JSON |
---|
{ "body": { object ( |
الحقول | |
---|---|
body |
النص الأساسي لعلامة التبويب في المستند. |
headers |
العناوين في علامة تبويب المستند، مرتبطة بمعرّف العنوان |
footers |
التذييلات في علامة تبويب المستند، تعتمد على رقم تعريف التذييل. |
footnotes |
الحواشي السفلية في علامة تبويب المستند، مرتبطة بمعرّف الحاشية السفلية. |
documentStyle |
نمط علامة تبويب المستند. |
suggestedDocumentStyleChanges |
التغييرات المقترَحة على نمط علامة تبويب المستند، استنادًا إلى رقم تعريف الاقتراح |
namedStyles |
الأنماط المُعنونة في علامة تبويب المستند. |
suggestedNamedStylesChanges |
التغييرات المقترحة على الأنماط المُعنونة لعلامة تبويب المستند، تعتمد على رقم تعريف الاقتراح |
lists |
القوائم الموجودة في علامة تبويب المستند، مرتَّبة حسب رقم تعريف القائمة. |
namedRanges |
النطاقات المُعنونة في علامة تبويب المستند، مفصولة حسب الاسم. |
inlineObjects |
الكائنات المضمّنة في علامة تبويب المستند، استنادًا إلى رقم تعريف الكائن. |
positionedObjects |
العناصر التي تم وضعها في علامة تبويب المستند، استنادًا إلى رقم تعريف الكائن. |
النص الأساسي
نص المستند.
يشتمل النص عادةً على محتوى المستند بالكامل باستثناء headers
وfooters
وfootnotes
.
تمثيل JSON |
---|
{
"content": [
{
object ( |
الحقول | |
---|---|
content[] |
محتوى الجسم وتبدأ فهارس محتوى الجسم بصفر. |
StructuralElement
يصف StructialElement المحتوى الذي يوفر هيكلاً للوثيقة.
تمثيل JSON |
---|
{ "startIndex": integer, "endIndex": integer, // Union field |
الحقول | |
---|---|
startIndex |
يشير إلى فهرس البدء القائم على الصفر لهذا العنصر الهيكلي، بوحدات رمز UTF-16. |
endIndex |
يشير إلى فهرس النهاية صفر الخاص بهذا العنصر الهيكلي، بشكل حصري، في وحدات ترميز UTF-16. |
حقل الاتحاد content . محتوى العنصر الهيكلي. يمكن أن يكون content واحدًا فقط مما يلي: |
|
paragraph |
نوع فقرة من العنصر الهيكلي. |
sectionBreak |
نوع فاصل الأقسام للعنصر الهيكلي. |
table |
يشير ذلك المصطلح إلى نوع جدول من العناصر الهيكلية. |
tableOfContents |
نوع جدول المحتويات للعنصر الهيكلي. |
الفقرة
تمثّل هذه السمة StructuralElement
فقرة. الفقرة هي نطاق من المحتوى يتم إنهاؤه بحرف جديد.
تمثيل JSON |
---|
{ "elements": [ { object ( |
الحقول | |
---|---|
elements[] |
محتوى الفقرة مقسمًا إلى الأجزاء المكونة لها. |
paragraphStyle |
نمط هذه الفقرة. |
suggestedParagraphStyleChanges |
يتغير نمط الفقرة المقترح إلى هذه الفقرة، تبعًا لرقم تعريف الاقتراح. |
bullet |
الرمز النقطي لهذه الفقرة. في حال عدم توفّر الفقرة، لا تنتمي الفقرة إلى قائمة. |
suggestedBulletChanges |
التغييرات المقترحة على التعداد النقطي لهذه الفقرة |
positionedObjectIds[] |
أرقام تعريف العناصر الموضوعة المرتبطة بهذه الفقرة |
suggestedPositionedObjectIds |
أرقام تعريف العناصر الموضوعة والمقترَحة إرفاقها بهذه الفقرة، استنادًا إلى رقم تعريف الاقتراح. |
ParagraphElement
تصف فقرة الفقرة المحتوى المتوفّر ضمن Paragraph
.
تمثيل JSON |
---|
{ "startIndex": integer, "endIndex": integer, // Union field |
الحقول | |
---|---|
startIndex |
فهرس البدء المستنِد إلى صفر لعنصر الفقرة هذا، بوحدات رمز UTF-16. |
endIndex |
فهرس النهاية الصفرية لعنصر الفقرة هذا، بشكل حصري، بوحدات رمز UTF-16. |
حقل الاتحاد content . محتوى عنصر الفقرة. يمكن أن يكون content واحدًا فقط مما يلي: |
|
textRun |
عنصر تشغيل نص برمجي. |
autoText |
عنصر فقرة نص تلقائي |
pageBreak |
عنصر فاصل صفحة على الويب |
columnBreak |
عنصر فاصل عمودي لفقرة |
footnoteReference |
عنصر فقرة مرجع حاشية سفلية. |
horizontalRule |
عنصر أفقي لفقرة القاعدة. |
equation |
عنصر فقرة معادلة |
inlineObjectElement |
عنصر مضمّن في عنصر الفقرة. |
person |
عنصر فقرة يرتبط بشخص أو عنوان بريد إلكتروني. |
richLink |
يشير ذلك المصطلح إلى عنصر فقرة يرتبط بأحد موارد Google (مثل ملف في Google Drive أو فيديو على YouTube أو حدث في "تقويم Google"). |
TextRun
تمثّل هذه السمة ParagraphElement
مجموعة نصية من جميع النصوص التي لها النمط نفسه.
تمثيل JSON |
---|
{ "content": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
الحقول | |
---|---|
content |
نص عملية التشغيل هذه. يتم استبدال أي عناصر غير نصية في عملية التشغيل بحرف يونيكود U+E907. |
suggestedInsertionIds[] |
أرقام تعريف الإدراج المقترَحة قد يحتوي |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترَحة وإذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذا المحتوى. |
textStyle |
نمط النص لعملية التشغيل هذه. |
suggestedTextStyleChanges |
يتغير نمط النص المقترَح إلى هذه العملية، استنادًا إلى رقم تعريف الاقتراح. |
نمط النص
يمثل النمط الذي يمكن تطبيقه على النص.
يتم تمثيل أنماط النص المكتسَبة كحقول لم يتم ضبطها في هذه الرسالة. يعتمد العنصر الأصل لنمط النص على مكان تحديد نمط النص:
- يتم اكتساب نمط النص في
Paragraph
من عنصرnamed style type
المقابل للفقرة. - يتم اكتساب نمط النص في
named style
من النمطnormal text
المُسمى. - يتم اكتساب نمط النص للنمط المُسمّى
normal text
من نمط النص التلقائي في أدوات تحرير المستندات. - قد يكتسب نمط النص في عنصر
Paragraph
المضمّن في جدول نمط النص من نمط الجدول.
إذا لم يتم اكتساب نمط النص من العنصر الرئيسي، سيؤدي إلغاء تعيين الحقول إلى إرجاع النمط إلى قيمة تطابق الإعدادات الافتراضية في محرر المستندات.
تمثيل JSON |
---|
{ "bold": boolean, "italic": boolean, "underline": boolean, "strikethrough": boolean, "smallCaps": boolean, "backgroundColor": { object ( |
الحقول | |
---|---|
bold |
ما إذا كان النص يتم عرضه بالخط الغامق أم لا |
italic |
ما إذا كان النص مائلاً أم لا |
underline |
ما إذا كان النص مسطرًا أم لا |
strikethrough |
ما إذا كان النص مشطوبًا أم لا |
smallCaps |
ما إذا كان النص مكتوبًا بأحرف كبيرة صغيرة أم لا. |
backgroundColor |
لون خلفية النص وفي حال ضبط اللون، يكون اللون إما اللون الأحمر والأخضر والأزرق أو شفافًا، بناءً على الحقل |
foregroundColor |
لون مقدّمة النص وفي حال ضبط اللون، يكون اللون إما اللون الأحمر والأخضر والأزرق أو شفافًا، بناءً على الحقل |
fontSize |
حجم خط النص |
weightedFontFamily |
مجموعة الخطوط وحجم النص المعروض إذا حدّد طلب التعديل قيمًا لكل من وإذا لم يتم ضبط السياسة إذا تم ضبط |
baselineOffset |
الإزاحة العمودية للنص عن موضعه العادي يتم تلقائيًا عرض النص الذي يحتوي على إزاحة خط أساسية |
link |
وجهة الرابط التشعبي للنص. وفي حال ترك هذه السياسة بدون ضبط، لن يتم توفير الرابط. لا يتم اكتساب الروابط من النص الرئيسي. يؤدي تغيير الرابط في طلب التحديث إلى بعض التغييرات الأخرى في نمط النص للنطاق:
|
OptionalColor
لون يمكن أن يكون معتمًا بالكامل أو شفافًا بالكامل.
تمثيل JSON |
---|
{
"color": {
object ( |
الحقول | |
---|---|
color |
وفي حال ضبطها، سيتم استخدامه كلون معتم. وفي حال ترك هذه السياسة بدون ضبط، يعني ذلك لونًا شفافًا. |
اللون
لون خالص
تمثيل JSON |
---|
{
"rgbColor": {
object ( |
الحقول | |
---|---|
rgbColor |
تمثّل هذه السمة قيمة اللون RGB. |
RgbColor
لون النموذج اللوني أحمر أخضر أزرق (RGB)
تمثيل JSON |
---|
{ "red": number, "green": number, "blue": number } |
الحقول | |
---|---|
red |
العنصر الأحمر للون، من 0.0 إلى 1.0. |
green |
العنصر الأخضر للون، من 0.0 إلى 1.0. |
blue |
المكون الأزرق للون، من 0.0 إلى 1.0. |
السمة
حجم في اتجاه واحد بالوحدات المحددة.
تمثيل JSON |
---|
{
"magnitude": number,
"unit": enum ( |
الحقول | |
---|---|
magnitude |
المقدار. |
unit |
يشير ذلك المصطلح إلى وحدات المقدار. |
الوحدة
وحدات القياس.
عمليات التعداد | |
---|---|
UNIT_UNSPECIFIED |
الوحدات غير معروفة. |
PT |
نقطة، 1/72 من البوصة. |
WeightedFontFamily
يمثل مجموعة الخطوط وحجم النص.
تمثيل JSON |
---|
{ "fontFamily": string, "weight": integer } |
الحقول | |
---|---|
fontFamily |
مجموعة الخطوط للنص. يمكن أن تكون مجموعة الخطوط أي خط من قائمة الخطوط في "مستندات Google" أو من Google Fonts. إذا لم يتم التعرّف على اسم الخط، سيتم عرض النص باللغة |
weight |
تمثّل هذه السمة سمك الخط. يمكن أن يحتوي هذا الحقل على أي قيمة تكون من مضاعفات القيمة التلقائية هي يشكل عرض الخط مكونًا واحدًا فقط من سُمك الخط المعروض. عند الجمع بين
|
BaselineOffset
الطرق التي يمكن بها إزاحة النص عموديًا عن موضعه العادي.
عمليات التعداد | |
---|---|
BASELINE_OFFSET_UNSPECIFIED |
يتم اكتساب إزاحة خط الأساس للنص من العنصر الرئيسي. |
NONE |
لا تتم إزاحة النص عموديًا. |
SUPERSCRIPT |
تتم إزاحة النص عموديًا لأعلى (مرتفع). |
SUBSCRIPT |
تتم إزاحة النص عموديًا إلى أسفل (نص منخفض). |
رابط
مرجع إلى جزء آخر من مستند أو مورد عنوان URL خارجي
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد destination . وجهة الرابط. يمكن أن يكون destination واحدًا فقط مما يلي: |
|
url |
عنوان URL خارجي. |
tabId |
رقم تعريف علامة تبويب في هذا المستند. |
bookmark |
إشارة مرجعية في هذا المستند. في المستندات التي تحتوي على علامة تبويب واحدة، تستمر الروابط المؤدية إلى الإشارات المرجعية داخل علامة التبويب المفرد في عرض |
heading |
عنوان في هذا المستند. في المستندات التي تحتوي على علامة تبويب واحدة، تستمر الروابط المؤدية إلى العناوين ضمن علامة التبويب المفرد في عرض |
bookmarkId |
رقم تعريف إشارة مرجعية في هذا المستند. حقل قديم: بدلاً من ذلك، اضبط إذا تم استخدام هذا الحقل في طلب كتابة، سيتم اعتبار الإشارة المرجعية مأخوذة من رقم تعريف علامة التبويب المحدّد في الطلب. إذا لم يتم تحديد رقم تعريف علامة التبويب في الطلب، سيتم اعتباره من علامة التبويب الأولى في المستند. |
headingId |
تمثّل هذه السمة رقم تعريف عنوان في هذا المستند. حقل قديم: بدلاً من ذلك، اضبط إذا تم استخدام هذا الحقل في طلب كتابة، سيتم اعتبار العنوان من رقم تعريف علامة التبويب المحدّد في الطلب. إذا لم يتم تحديد رقم تعريف علامة التبويب في الطلب، سيتم اعتباره من علامة التبويب الأولى في المستند. |
BookmarkLink
مرجع إلى إشارة مرجعية في هذا المستند.
تمثيل JSON |
---|
{ "id": string, "tabId": string } |
الحقول | |
---|---|
id |
رقم تعريف إشارة مرجعية في هذا المستند. |
tabId |
الرقم التعريفي لعلامة التبويب التي تحتوي على هذه الإشارة المرجعية. |
HeadingLink
مرجع لعنوان في هذا المستند.
تمثيل JSON |
---|
{ "id": string, "tabId": string } |
الحقول | |
---|---|
id |
تمثّل هذه السمة رقم تعريف عنوان في هذا المستند. |
tabId |
تمثّل هذه السمة رقم تعريف علامة التبويب التي تحتوي على هذا العنوان. |
SuggestedTextStyle
تغيير مقترَح إلى TextStyle
تمثيل JSON |
---|
{ "textStyle": { object ( |
الحقول | |
---|---|
textStyle |
|
textStyleSuggestionState |
قناع يشير إلى الحقول التي تم تغييرها في قاعدة |
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 |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
italicSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
underlineSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
strikethroughSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
smallCapsSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
backgroundColorSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
foregroundColorSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
fontSizeSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
weightedFontFamilySuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
baselineOffsetSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
linkSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
AutoText
تمثّل هذه السمة ParagraphElement
موضعًا في النص يتم استبداله ديناميكيًا بمحتوى يمكن أن يتغيّر بمرور الوقت، مثل رقم الصفحة.
تمثيل JSON |
---|
{ "type": enum ( |
الحقول | |
---|---|
type |
نوع هذا النص التلقائي |
suggestedInsertionIds[] |
أرقام تعريف الإدراج المقترَحة قد يحتوي |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترَحة وإذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذا المحتوى. |
textStyle |
نمط النص لهذا النص التلقائي. |
suggestedTextStyleChanges |
يتغير نمط النص المقترح إلى هذا النص التلقائي، استنادًا إلى رقم تعريف الاقتراح. |
النوع
أنواع النص التلقائي
عمليات التعداد | |
---|---|
TYPE_UNSPECIFIED |
نوع نص تلقائي غير محدَّد |
PAGE_NUMBER |
اكتب نصًّا تلقائيًا يمثّل رقم الصفحة الحالية. |
PAGE_COUNT |
اكتب نصًا تلقائيًا يمثّل إجمالي عدد الصفحات في المستند. |
PageBreak
ParagraphElement
يمثّل فاصل صفحة. يؤدي فاصل الصفحة إلى بدء النص اللاحق أعلى الصفحة التالية.
تمثيل JSON |
---|
{ "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
الحقول | |
---|---|
suggestedInsertionIds[] |
أرقام تعريف الإدراج المقترَحة قد يحتوي |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترَحة وإذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذا المحتوى. |
textStyle |
نمط نص فاصل الصفحات هذا. على غرار المحتوى النصي، مثل سلاسل النصوص ومراجع الحواشي السفلية، يمكن أن يؤثر نمط نص فاصل الصفحة على تخطيط المحتوى بالإضافة إلى نمط النص المدرَج بجانبه. |
suggestedTextStyleChanges |
يتغير نمط النص المقترح إلى فاصل الصفحات هذا، استنادًا إلى رقم تعريف الاقتراح. |
ColumnBreak
تمثّل هذه السمة ParagraphElement
فاصل أعمدة. يؤدي فاصل العمود إلى بدء النص اللاحق أعلى العمود التالي.
تمثيل JSON |
---|
{ "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
الحقول | |
---|---|
suggestedInsertionIds[] |
أرقام تعريف الإدراج المقترَحة قد يحتوي |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترَحة وإذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذا المحتوى. |
textStyle |
نمط النص لفاصل العمود هذا. على غرار المحتوى النصي، مثل سلاسل النصوص ومراجع الحواشي السفلية، يمكن أن يؤثر نمط نص فاصل الأعمدة على تخطيط المحتوى بالإضافة إلى نمط النص المدرَج بجانبه. |
suggestedTextStyleChanges |
يتغير نمط النص المقترح إلى ColumnBreak، وهو مرتبط بمعرّف الاقتراح. |
FootnoteReference
عنصر ParagraphElement
يمثل مرجع حاشية سفلية. مرجع الحاشية السفلية هو المحتوى المضمّن المعروض برقم ويتم استخدامه لتحديد الحاشية السفلية.
تمثيل JSON |
---|
{ "footnoteId": string, "footnoteNumber": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
الحقول | |
---|---|
footnoteId |
رقم تعريف |
footnoteNumber |
الرقم المعروض لهذه الحاشية السفلية. |
suggestedInsertionIds[] |
أرقام تعريف الإدراج المقترَحة قد يحتوي |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترَحة وإذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذا المحتوى. |
textStyle |
نمط النص في FootnoteReference. |
suggestedTextStyleChanges |
يتم تغيير نمط النص المقترَح إلى FootnoteReference هذا، استنادًا إلى رقم تعريف الاقتراح. |
HorizontalRule
عنصر ParagraphElement
يمثل خطًا أفقيًا
تمثيل JSON |
---|
{ "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
الحقول | |
---|---|
suggestedInsertionIds[] |
أرقام تعريف الإدراج المقترَحة قد يحتوي |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترَحة وإذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذا المحتوى. |
textStyle |
نمط النص لهذه القاعدة الأفقية. على غرار المحتوى النصي، مثل عمليات تنفيذ النصوص ومراجع الحواشي السفلية، يمكن أن يؤثر نمط نص القاعدة الأفقية على تخطيط المحتوى بالإضافة إلى نمط النص المُدرج بجانبه. |
suggestedTextStyleChanges |
يتغير نمط النص المقترح إلى قاعدة الأفقية هذه، تبعًا لرقم تعريف الاقتراح. |
معادلة
تمثّل هذه السمة ParagraphElement
معادلة.
تمثيل JSON |
---|
{ "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ] } |
الحقول | |
---|---|
suggestedInsertionIds[] |
أرقام تعريف الإدراج المقترَحة قد يحتوي |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترَحة وإذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذا المحتوى. |
InlineObjectElement
السمة ParagraphElement
التي تحتوي على InlineObject
تمثيل JSON |
---|
{ "inlineObjectId": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
الحقول | |
---|---|
inlineObjectId |
رقم تعريف |
suggestedInsertionIds[] |
أرقام تعريف الإدراج المقترَحة قد يحتوي |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترَحة وإذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذا المحتوى. |
textStyle |
نمط النص لـ InlineObjectElement هذا. على غرار المحتوى النصي، مثل عمليات تنفيذ النصوص ومراجع الحواشي السفلية، يمكن أن يؤثر نمط نص عنصر الكائن المضمّن على تخطيط المحتوى بالإضافة إلى نمط النص المدرَج بجانبه. |
suggestedTextStyleChanges |
يتغير نمط النص المقترح إلى InlineObject هذا، استنادًا إلى رقم تعريف الاقتراح. |
شخص
شخص أو عنوان بريد إلكتروني مذكور في مستند. يتم استخدام هذه الإشارات كعنصر واحد غير قابل للتغيير يحتوي على اسم الشخص أو عنوان بريده الإلكتروني.
تمثيل JSON |
---|
{ "personId": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
الحقول | |
---|---|
personId |
النتائج فقط. المعرّف الفريد لهذا الرابط. |
suggestedInsertionIds[] |
أرقام التعريف للاقتراحات التي تُدرج رابط هذا الشخص في المستند يمكن أن يحتوي |
suggestedDeletionIds[] |
أرقام التعريف للاقتراحات التي تزيل رابط هذا الشخص من المستند. يمكن أن يتضمّن |
textStyle |
نمط النص لسمة |
suggestedTextStyleChanges |
يتغير نمط النص المقترح إلى |
personProperties |
النتائج فقط. تمثّل هذه السمة خصائص |
PersonProperties
المواقع الخاصة بـ Person
مرتبط
تمثيل JSON |
---|
{ "name": string, "email": string } |
الحقول | |
---|---|
name |
النتائج فقط. اسم الشخص إذا تم عرضه في نص الرابط بدلاً من عنوان البريد الإلكتروني له. |
email |
النتائج فقط. عنوان البريد الإلكتروني المرتبط بـ |
RichLink
رابط إلى مورد Google (مثل ملف في Drive أو فيديو على YouTube أو حدث في "تقويم Google").
تمثيل JSON |
---|
{ "richLinkId": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
الحقول | |
---|---|
richLinkId |
النتائج فقط. رقم تعريف هذا الرابط. |
suggestedInsertionIds[] |
أرقام التعريف للاقتراحات التي تُدرج هذا الرابط في المستند. يمكن أن يحتوي |
suggestedDeletionIds[] |
أرقام التعريف للاقتراحات التي تزيل هذا الرابط من المستند. يمكن أن يتضمّن |
textStyle |
نمط النص لسمة |
suggestedTextStyleChanges |
يتغير نمط النص المقترح إلى |
richLinkProperties |
النتائج فقط. تمثّل هذه السمة خصائص |
RichLinkProperties
الخصائص الخاصة بـ RichLink
.
تمثيل JSON |
---|
{ "title": string, "uri": string, "mimeType": string } |
الحقول | |
---|---|
title |
النتائج فقط. تمثّل هذه السمة عنوان |
uri |
النتائج فقط. تمثّل هذه السمة معرّف الموارد المنتظم (URI) الخاص بـ |
mimeType |
النتائج فقط. نوع MIME لـ |
نمط الفقرة
الأنماط التي تنطبق على فقرة كاملة
يتم تمثيل أنماط الفقرات المكتسَبة كحقول غير محددة في هذه الرسالة. يعتمد العنصر الرئيسي لنمط الفقرة على مكان تعريف نمط الفقرة:
- يكتسِب نمط الفقرة في
Paragraph
من عنصرnamed style type
المقابل للفقرة. - نمط الفقرة في
named style
مكتسب من النمط المسمىnormal text
. - يكتسب نمط الفقرة الخاص بالنمط المُسمّى
normal text
من نمط الفقرة التلقائي في أداة تحرير المستندات. - قد يكتسب نمط الفقرة في عنصر
Paragraph
المضمّن في جدول نمط الفقرة الخاص به من نمط الجدول.
إذا لم يتم اكتساب نمط الفقرة من العنصر الرئيسي، سيؤدي إلغاء تعيين الحقول إلى إرجاع النمط إلى قيمة تطابق الإعدادات الافتراضية في محرر المستندات.
تمثيل JSON |
---|
{ "headingId": string, "namedStyleType": enum ( |
الحقول | |
---|---|
headingId |
رقم تعريف عنوان الفقرة إذا كانت فارغة، فإن هذه الفقرة ليست عنوانًا. هذا الموقع للقراءة فقط. |
namedStyleType |
نوع النمط المسمى للفقرة. نظرًا لأن تحديث نوع النمط المعنوَن يؤثر على الخصائص الأخرى ضمن "نمط الفقرة"، يتم تطبيق نوع النمط المعنوَن قبل أن يتم تحديث الخصائص الأخرى. |
alignment |
محاذاة النص لهذه الفقرة. |
lineSpacing |
مقدار المسافة بين السطور، كنسبة مئوية من الطبيعي، حيث يتم تمثيل القيمة العادية 100.0. في حال ترك السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي. |
direction |
اتجاه نص هذه الفقرة. في حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على |
spacingMode |
وضع التباعد للفقرة. |
spaceAbove |
مقدار المساحة الإضافية فوق الفقرة. في حال ترك السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي. |
spaceBelow |
مقدار المساحة الإضافية أسفل الفقرة. في حال ترك السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي. |
borderBetween |
الحد بين هذه الفقرة والفقرات التالية والسابقة. في حال ترك السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي. يتم عرض الحد البيني عندما يكون للفقرة المجاورة خصائص الحدود والمسافة البادئة نفسها. لا يمكن تعديل حدود الفقرة جزئيًا. عند تغيير حد فقرة، يجب تحديد الحد الجديد بأكمله. |
borderTop |
الحد أعلى هذه الفقرة. في حال ترك السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي. يتم عرض الحد العلوي عندما تحتوي الفقرة أعلاه على خصائص مختلفة للحدود والمسافة البادئة. لا يمكن تعديل حدود الفقرة جزئيًا. عند تغيير حد فقرة، يجب تحديد الحد الجديد بأكمله. |
borderBottom |
الحد الموجود أسفل هذه الفقرة. في حال ترك السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي. يتم عرض الحد السفلي عندما يكون للفقرة أدناه خصائص مختلفة للحدود والمسافة البادئة. لا يمكن تعديل حدود الفقرة جزئيًا. عند تغيير حد فقرة، يجب تحديد الحد الجديد بأكمله. |
borderLeft |
الحد إلى يسار هذه الفقرة. في حال ترك السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي. لا يمكن تعديل حدود الفقرة جزئيًا. عند تغيير حد فقرة، يجب تحديد الحد الجديد بأكمله. |
borderRight |
الحد إلى يمين هذه الفقرة. في حال ترك السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي. لا يمكن تعديل حدود الفقرة جزئيًا. عند تغيير حد فقرة، يجب تحديد الحد الجديد بأكمله. |
indentFirstLine |
مقدار المسافة البادئة للسطر الأول من الفقرة. في حال ترك السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي. |
indentStart |
مقدار المسافة البادئة للفقرة على الجانب المقابل لبداية النص، بناءً على اتجاه الفقرة الحالي. في حال ترك السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي. |
indentEnd |
مقدار المسافة البادئة للفقرة على الجانب المقابل لنهاية النص، بناءً على اتجاه الفقرة الحالي. في حال ترك السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي. |
tabStops[] |
قائمة بعلامات الجدولة لهذه الفقرة. قائمة علامات الجدولة غير مكتسبة. هذا الموقع للقراءة فقط. |
keepLinesTogether |
ما إذا كان يجب تخطيط جميع سطور الفقرة في نفس الصفحة أو العمود إن أمكن ذلك. في حال ترك السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي. |
keepWithNext |
ما إذا كان يجب تخطيط جزء على الأقل من هذه الفقرة في نفس الصفحة أو العمود مثل الفقرة التالية إن أمكن. في حال ترك السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي. |
avoidWidowAndOrphan |
لتحديد ما إذا كان يجب تجنب الأرامل والأرومات في الفقرة. في حال ترك السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي. |
shading |
تظليل الفقرة. في حال ترك السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي. |
pageBreakBefore |
لتحديد ما إذا كان يجب أن تبدأ الفقرة الحالية دائمًا في بداية الصفحة. في حال ترك السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي. يمكن أن تؤدي محاولة تعديل |
NamedStyleType
أنواع الأنماط المُعنونة.
عمليات التعداد | |
---|---|
NAMED_STYLE_TYPE_UNSPECIFIED |
نوع النمط المسمى غير محدد. |
NORMAL_TEXT |
نص عادي. |
TITLE |
العنوان. |
SUBTITLE |
العنوان الفرعي. |
HEADING_1 |
العنوان 1. |
HEADING_2 |
العنوان 2. |
HEADING_3 |
العنوان 3. |
HEADING_4 |
العنوان 4. |
HEADING_5 |
العنوان 5. |
HEADING_6 |
العنوان 6. |
محاذاة
أنواع محاذاة النص لفقرة.
عمليات التعداد | |
---|---|
ALIGNMENT_UNSPECIFIED |
محاذاة الفقرة مكتسبة من العنصر الرئيسي. |
START |
تتم محاذاة الفقرة مع بداية السطر. تمت المحاذاة إلى اليسار لنص LTR، والمحاذاة لليمين بخلاف ذلك. |
CENTER |
يتم توسيط الفقرة. |
END |
تتم محاذاة الفقرة مع نهاية السطر. تمت المحاذاة لليمين مع نص LTR، والمحاذاة لليسار. |
JUSTIFIED |
تم تبرير الفقرة. |
ContentDirection
يمكن أن يتدفق محتوى الاتجاهات.
عمليات التعداد | |
---|---|
CONTENT_DIRECTION_UNSPECIFIED |
لم يتم تحديد اتجاه المحتوى. |
LEFT_TO_RIGHT |
ينتقل المحتوى من اليسار إلى اليمين. |
RIGHT_TO_LEFT |
انتقال المحتوى من اليسار إلى اليمين. |
SpacingMode
الأوضاع المختلفة لتباعد الفقرات.
عمليات التعداد | |
---|---|
SPACING_MODE_UNSPECIFIED |
وضع التباعد مكتسَب من المؤسسة الرئيسية. |
NEVER_COLLAPSE |
يتم عرض تباعد الفقرات دائمًا. |
COLLAPSE_LISTS |
يتم تخطّي تباعد الفقرات بين عناصر القائمة. |
ParagraphBorder
حدود حول فقرة
تمثيل JSON |
---|
{ "color": { object ( |
الحقول | |
---|---|
color |
لون الحدود |
width |
عرض الحدود. |
padding |
المساحة المتروكة للحدود. |
dashStyle |
نمط الشرطة للحدود. |
DashStyle
أنواع الشرطات التي يمكن عرض الهندسة الخطية باستخدامها. تستند هذه القيم إلى دالة "ST_PresetLineDashVal" بسيطة كما هو موضح في القسم 20.1.10.48 من "تنسيقات ملفات Office Open XML - الأساسيات ومراجع اللغة الترميزية"، الجزء 1 من ECMA-376 الإصدار الرابع.
عمليات التعداد | |
---|---|
DASH_STYLE_UNSPECIFIED |
نمط شرطة غير محدّد |
SOLID |
خط متصل يتوافق مع قيمة ECMA-376 ST_PresetLineDashVal "solid". هذا هو نمط الشرطة التلقائي. |
DOT |
خط منقط يتوافق مع قيمة ECMA-376 ST_PresetLineDashVal 'dot'. |
DASH |
خط متقطع. يتوافق مع قيمة ECMA-376 ST_PresetLineDashVal "شرطة". |
TabStop
علامة جدولة داخل فقرة.
تمثيل JSON |
---|
{ "offset": { object ( |
الحقول | |
---|---|
offset |
الفارق بين نقطة توقف علامة التبويب هذه وهامش البداية |
alignment |
محاذاة علامة التبويب هذه. وفي حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على |
TabStopAlignment
محاذاة علامة الجدولة.
عمليات التعداد | |
---|---|
TAB_STOP_ALIGNMENT_UNSPECIFIED |
لم يتم تحديد محاذاة علامة الجدولة. |
START |
تتم محاذاة علامة الجدولة مع بداية السطر. هذا هو الخيار التلقائي. |
CENTER |
تتم محاذاة محطة الجدولة إلى وسط الخط. |
END |
تتم محاذاة علامة الجدولة إلى نهاية السطر. |
تظليل
تظليل الفقرة.
تمثيل JSON |
---|
{
"backgroundColor": {
object ( |
الحقول | |
---|---|
backgroundColor |
لون خلفية تظليل الفقرة هذا |
SuggestedParagraphStyle
تغيير مقترَح إلى ParagraphStyle
تمثيل JSON |
---|
{ "paragraphStyle": { object ( |
الحقول | |
---|---|
paragraphStyle |
|
paragraphStyleSuggestionState |
قناع يشير إلى الحقول التي تم تغييرها في قاعدة |
ParagraphStyleSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في قاعدة ParagraphStyle
هذه في هذا الاقتراح بالنسبة إلى أي حقل تم ضبطه على "صحيح"، هناك قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{
"headingIdSuggested": boolean,
"namedStyleTypeSuggested": boolean,
"alignmentSuggested": boolean,
"lineSpacingSuggested": boolean,
"directionSuggested": boolean,
"spacingModeSuggested": boolean,
"spaceAboveSuggested": boolean,
"spaceBelowSuggested": boolean,
"borderBetweenSuggested": boolean,
"borderTopSuggested": boolean,
"borderBottomSuggested": boolean,
"borderLeftSuggested": boolean,
"borderRightSuggested": boolean,
"indentFirstLineSuggested": boolean,
"indentStartSuggested": boolean,
"indentEndSuggested": boolean,
"keepLinesTogetherSuggested": boolean,
"keepWithNextSuggested": boolean,
"avoidWidowAndOrphanSuggested": boolean,
"shadingSuggestionState": {
object ( |
الحقول | |
---|---|
headingIdSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
namedStyleTypeSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
alignmentSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
lineSpacingSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
directionSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
spacingModeSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
spaceAboveSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
spaceBelowSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
borderBetweenSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
borderTopSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
borderBottomSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
borderLeftSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
borderRightSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
indentFirstLineSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
indentStartSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
indentEndSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
keepLinesTogetherSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
keepWithNextSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
avoidWidowAndOrphanSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
shadingSuggestionState |
قناع يشير إلى الحقول في |
pageBreakBeforeSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
ShadingSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في قاعدة Shading
في هذا التغيير المقترَح. بالنسبة إلى أي حقل تم ضبطه على "صحيح"، هناك قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{ "backgroundColorSuggested": boolean } |
الحقول | |
---|---|
backgroundColorSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
تعداد نقطي
لوصف الرمز النقطي للفقرة.
تمثيل JSON |
---|
{
"listId": string,
"nestingLevel": integer,
"textStyle": {
object ( |
الحقول | |
---|---|
listId |
رقم تعريف القائمة التي تنتمي إليها هذه الفقرة. |
nestingLevel |
مستوى التداخل لهذه الفقرة في القائمة. |
textStyle |
نمط النص الخاص بالفقرة الذي تم تطبيقه على هذا التعداد النقطي. |
SuggestedBullet
تغيير مقترَح إلى Bullet
تمثيل JSON |
---|
{ "bullet": { object ( |
الحقول | |
---|---|
bullet |
|
bulletSuggestionState |
قناع يشير إلى الحقول التي تم تغييرها في قاعدة |
BulletSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في قاعدة Bullet
هذه في هذا الاقتراح بالنسبة إلى أي حقل تم ضبطه على "صحيح"، هناك قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{
"listIdSuggested": boolean,
"nestingLevelSuggested": boolean,
"textStyleSuggestionState": {
object ( |
الحقول | |
---|---|
listIdSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
nestingLevelSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
textStyleSuggestionState |
قناع يشير إلى الحقول في |
ObjectReferences
مجموعة من معرّفات العناصر.
تمثيل JSON |
---|
{ "objectIds": [ string ] } |
الحقول | |
---|---|
objectIds[] |
أرقام تعريف الكائنات |
SectionBreak
تمثّل هذه السمة StructuralElement
فاصل أقسام. القسم هو نطاق من المحتوى يتضمّن السمة SectionStyle
نفسها. يمثل فاصل الأقسام بداية قسم جديد، وينطبق نمط القسم على القسم بعد فاصل الأقسام.
يبدأ نص المستند دائمًا بفاصل أقسام.
تمثيل JSON |
---|
{
"suggestedInsertionIds": [
string
],
"suggestedDeletionIds": [
string
],
"sectionStyle": {
object ( |
الحقول | |
---|---|
suggestedInsertionIds[] |
أرقام تعريف الإدراج المقترَحة قد يحتوي |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترَحة وإذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذا المحتوى. |
sectionStyle |
نمط القسم بعد فاصل القسم هذا. |
SectionStyle
النمط الذي ينطبق على القسم.
تمثيل JSON |
---|
{ "columnProperties": [ { object ( |
الحقول | |
---|---|
columnProperties[] |
خصائص أعمدة القسم. إذا كان القسم فارغًا، سيحتوي القسم على عمود واحد بالخصائص التلقائية في "أدوات تحرير المستندات". يمكن تعديل أيّ قسم ليتضمّن 3 أعمدة كحدّ أقصى. عند تعديل هذه السمة، يجب ضبط قيمة ملموسة. سيؤدي إلغاء ضبط هذه السمة إلى ظهور خطأ 400 في الطلب غير صالح. |
columnSeparatorStyle |
نمط فواصل الأعمدة. يمكن ضبط هذا النمط حتى في حالة وجود عمود واحد في القسم. عند تعديل هذه السمة، يجب ضبط قيمة ملموسة. يؤدي إلغاء ضبط هذه السمة إلى ظهور الخطأ 400 في الطلب غير الصحيح. |
contentDirection |
هو اتجاه محتوى هذا القسم. وفي حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على عند تعديل هذه السمة، يجب ضبط قيمة ملموسة. يؤدي إلغاء ضبط هذه السمة إلى ظهور الخطأ 400 في الطلب غير الصحيح. |
marginTop |
الهامش العلوي من القسم. في حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على عند تعديل هذه السمة، يجب ضبط قيمة ملموسة. يؤدي إلغاء ضبط هذه السمة إلى ظهور الخطأ 400 في الطلب غير الصحيح. |
marginBottom |
الهامش السفلي من القسم في حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على عند تعديل هذه السمة، يجب ضبط قيمة ملموسة. يؤدي إلغاء ضبط هذه السمة إلى ظهور الخطأ 400 في الطلب غير الصحيح. |
marginRight |
هامش الصفحة الأيمن من القسم في حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على عند تعديل هذه السمة، يجب ضبط قيمة ملموسة. يؤدي إلغاء ضبط هذه السمة إلى ظهور الخطأ 400 في الطلب غير الصحيح. |
marginLeft |
هامش الصفحة الأيسر من القسم في حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على عند تعديل هذه السمة، يجب ضبط قيمة ملموسة. يؤدي إلغاء ضبط هذه السمة إلى ظهور الخطأ 400 في الطلب غير الصحيح. |
marginHeader |
هامش رأس القسم. في حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على عند تعديل هذه السمة، يجب ضبط قيمة ملموسة. يؤدي إلغاء ضبط هذه السمة إلى ظهور الخطأ 400 في الطلب غير الصحيح. |
marginFooter |
هامش التذييل في القسم. في حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على عند تعديل هذه السمة، يجب ضبط قيمة ملموسة. يؤدي إلغاء ضبط هذه السمة إلى ظهور الخطأ 400 في الطلب غير الصحيح. |
sectionType |
النتائج فقط. تمثّل هذه السمة نوع القسم. |
defaultHeaderId |
رقم تعريف الرأس التلقائي. وفي حال ترك هذه السياسة بدون ضبط، يتم اكتساب القيمة من نمط القسم " هذا الموقع للقراءة فقط. |
defaultFooterId |
رقم تعريف التذييل التلقائي. وفي حال ترك هذه السياسة بدون ضبط، يتم اكتساب القيمة من نمط القسم " هذا الموقع للقراءة فقط. |
firstPageHeaderId |
رقم تعريف العنوان المستخدَم فقط في الصفحة الأولى من القسم إذا كانت هذا الموقع للقراءة فقط. |
firstPageFooterId |
رقم تعريف التذييل المُستخدَم للصفحة الأولى فقط من القسم. إذا كانت القيمة هذا الموقع للقراءة فقط. |
evenPageHeaderId |
رقم تعريف الرأس المستخدَم فقط للصفحات الزوجية. إذا كانت قيمة هذا الموقع للقراءة فقط. |
evenPageFooterId |
يتم استخدام رقم تعريف التذييل في الصفحات الزوجية فقط. إذا كانت قيمة هذا الموقع للقراءة فقط. |
useFirstPageHeaderFooter |
يشير إلى ما إذا كان يجب استخدام أرقام تعريف رأس / تذييل الصفحة الأولى للصفحة الأولى من القسم. في حال ترك هذه السياسة بدون ضبط، سيتم اكتسابها من سمة عند تعديل هذه السمة، يجب ضبط قيمة ملموسة. يؤدي إلغاء ضبط هذه السمة إلى ظهور الخطأ 400 في الطلب غير الصحيح. |
pageNumberStart |
رقم الصفحة الذي يتم من خلاله بدء احتساب عدد الصفحات لهذا القسم. في حال ترك هذه السياسة بدون ضبط، سيستمر ترقيم الصفحات من القسم السابق. إذا لم يتم ضبط القيمة في أول عند تعديل هذه السمة، يجب ضبط قيمة ملموسة. يؤدي إلغاء ضبط هذه السمة إلى ظهور الخطأ 400 في الطلب غير الصحيح. |
flipPageOrientation |
اختياريّ. للإشارة إلى ما إذا كان سيتم قلب أبعاد عند تعديل هذه السمة، يجب ضبط قيمة ملموسة. يؤدي إلغاء ضبط هذه السمة إلى ظهور الخطأ 400 في الطلب غير الصحيح. |
SectionColumnProperties
السمات التي تنطبق على عمود القسم
تمثيل JSON |
---|
{ "width": { object ( |
الحقول | |
---|---|
width |
النتائج فقط. عرض العمود. |
paddingEnd |
المساحة المتروكة في نهاية العمود. |
ColumnSeparatorStyle
نمط فواصل الأعمدة بين الأعمدة.
عمليات التعداد | |
---|---|
COLUMN_SEPARATOR_STYLE_UNSPECIFIED |
نمط فاصل عمود غير محدَّد |
NONE |
لا توجد خطوط فاصلة بين الأعمدة. |
BETWEEN_EACH_COLUMN |
لعرض خط فاصل بين كل عمود |
SectionType
يمثل هذا الحقل موضع بداية القسم الحالي بالنسبة إلى القسم السابق.
عمليات التعداد | |
---|---|
SECTION_TYPE_UNSPECIFIED |
لم يتم تحديد نوع القسم. |
CONTINUOUS |
يبدأ القسم بعد الفقرة الأخيرة من القسم السابق مباشرةً. |
NEXT_PAGE |
يبدأ القسم في الصفحة التالية. |
جدول
تمثّل هذه السمة StructuralElement
جدولاً.
تمثيل JSON |
---|
{ "rows": integer, "columns": integer, "tableRows": [ { object ( |
الحقول | |
---|---|
rows |
عدد الصفوف في الجدول. |
columns |
عدد الأعمدة في الجدول من الممكن أن يكون الجدول غير مستطيل، لذلك قد تحتوي بعض الصفوف على عدد مختلف من الخلايا. |
tableRows[] |
محتوى ونمط كل صف. |
suggestedInsertionIds[] |
أرقام تعريف الإدراج المقترَحة قد يحتوي |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترَحة وإذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذا المحتوى. |
tableStyle |
نمط الجدول. |
TableRow
محتوى ونمط صف في Table
تمثيل JSON |
---|
{ "startIndex": integer, "endIndex": integer, "tableCells": [ { object ( |
الحقول | |
---|---|
startIndex |
فهرس البداية المستند إلى صفر لهذا الصف بوحدات رمز UTF-16. |
endIndex |
الفهرس النهائي القائم على صفر لهذا الصف، حصري، بوحدات رمز UTF-16. |
tableCells[] |
محتوى ونمط كل خلية في هذا الصف. من الممكن أن يكون الجدول غير مستطيل، لذلك قد تحتوي بعض الصفوف على عدد خلايا مختلف عن الصفوف الأخرى في نفس الجدول. |
suggestedInsertionIds[] |
أرقام تعريف الإدراج المقترَحة قد يحتوي |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترَحة وإذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذا المحتوى. |
tableRowStyle |
نمط صف الجدول. |
suggestedTableRowStyleChanges |
يتم تغيير النمط المقترح إلى هذا الصف، ويعتمد ذلك على رقم تعريف الاقتراح. |
TableCell
محتوى ونمط خلية في Table
تمثيل JSON |
---|
{ "startIndex": integer, "endIndex": integer, "content": [ { object ( |
الحقول | |
---|---|
startIndex |
فهرس البداية المستند إلى صفر لهذه الخلية، بوحدات رمز UTF-16. |
endIndex |
الفهرس النهائي القائم على صفر لهذه الخلية، حصري، بوحدات رمز UTF-16. |
content[] |
محتوى الخلية. |
tableCellStyle |
نمط الخلية. |
suggestedInsertionIds[] |
أرقام تعريف الإدراج المقترَحة قد يحتوي |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترَحة وإذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذا المحتوى. |
suggestedTableCellStyleChanges |
التغييرات المقترحة على نمط خلية الجدول، استنادًا إلى رقم تعريف الاقتراح. |
TableCellStyle
نمط TableCell
.
يتم تمثيل أنماط خلايا الجدول المكتسَبة كحقول لم يتم ضبطها في هذه الرسالة. يمكن أن يكتسب نمط خلية الجدول من نمط الجدول.
تمثيل JSON |
---|
{ "rowSpan": integer, "columnSpan": integer, "backgroundColor": { object ( |
الحقول | |
---|---|
rowSpan |
امتداد الصف للخلية. هذا الموقع للقراءة فقط. |
columnSpan |
امتداد العمود للخلية. هذا الموقع للقراءة فقط. |
backgroundColor |
لون خلفية الخلية. |
borderLeft |
الحد الأيسر للخلية. |
borderRight |
الحد الأيمن للخلية. |
borderTop |
الحد العلوي للخلية. |
borderBottom |
الحد السفلي للخلية. |
paddingLeft |
المساحة المتروكة اليسرى للخلية. |
paddingRight |
المساحة المتروكة اليمنى للخلية. |
paddingTop |
المساحة المتروكة العلوية للخلية. |
paddingBottom |
المساحة المتروكة السفلية للخلية. |
contentAlignment |
محاذاة المحتوى في خلية الجدول. تتطابق المحاذاة التلقائية مع محاذاة خلايا الجدول التي تم إنشاؤها حديثًا في "أدوات تحرير المستندات". |
TableCellBorder
حد حول خلية جدول.
لا يمكن أن تكون حدود خلايا الجدول شفافة. لإخفاء حد خلية الجدول، اجعل عرضه 0.
تمثيل JSON |
---|
{ "color": { object ( |
الحقول | |
---|---|
color |
لون الحدود لا يمكن أن يكون هذا اللون شفافًا. |
width |
عرض الحدود. |
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 |
قناع يشير إلى الحقول التي تم تغييرها في قاعدة |
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 |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
columnSpanSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
backgroundColorSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
borderLeftSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
borderRightSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
borderTopSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
borderBottomSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
paddingLeftSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
paddingRightSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
paddingTopSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
paddingBottomSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
contentAlignmentSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
TableRowStyle
الأنماط التي تنطبق على صف في الجدول
تمثيل JSON |
---|
{
"minRowHeight": {
object ( |
الحقول | |
---|---|
minRowHeight |
تمثّل هذه السمة الحد الأدنى لارتفاع الصف. سيتم عرض الصف في "محرّر مستندات Google" على ارتفاع مساوٍ لهذه القيمة أو أكبر منها لعرض كل المحتوى في خلايا الصف. |
tableHeader |
ما إذا كان الصفّ عنوان جدول. |
preventOverflow |
تحديد ما إذا كان الصف لا يمكن أن يتجاوز حدود الصفحة أو الأعمدة |
SuggestedTableRowStyle
تغيير مقترَح إلى TableRowStyle
تمثيل JSON |
---|
{ "tableRowStyle": { object ( |
الحقول | |
---|---|
tableRowStyle |
|
tableRowStyleSuggestionState |
قناع يشير إلى الحقول التي تم تغييرها في قاعدة |
TableRowStyleSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في قاعدة TableRowStyle
هذه في هذا الاقتراح بالنسبة إلى أي حقل تم ضبطه على "صحيح"، هناك قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{ "minRowHeightSuggested": boolean } |
الحقول | |
---|---|
minRowHeightSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
TableStyle
الأنماط التي تنطبق على الجدول.
تمثيل JSON |
---|
{
"tableColumnProperties": [
{
object ( |
الحقول | |
---|---|
tableColumnProperties[] |
خصائص كل عمود. ملاحظة: في "مستندات Google"، تحتوي الجداول على صفوف وصفوف تحتوي على خلايا، وهي تشبه HTML. وبالتالي، يمكن العثور على سمات أحد الصفوف في |
TableColumnProperties
خصائص العمود في الجدول.
تمثيل JSON |
---|
{ "widthType": enum ( |
الحقول | |
---|---|
widthType |
نوع عرض العمود |
width |
عرض العمود. يتم ضبط هذه القيمة عند ضبط قيمة |
WidthType
نوع عرض العمود.
عمليات التعداد | |
---|---|
WIDTH_TYPE_UNSPECIFIED |
لم يتم تحديد نوع عرض العمود. |
EVENLY_DISTRIBUTED |
يتم توزيع عرض العمود بالتساوي بين الأعمدة الأخرى الموزعة بالتساوي. ويتم تحديد عرض العمود تلقائيًا وسيكون له جزء مساوٍ من العرض المتبقي للجدول بعد مراعاة جميع الأعمدة ذات العرض المحدّد. |
FIXED_WIDTH |
عرض عمود ثابت. تحتوي السمة [width][google.apps.docs.v1.TableColumnProperties.width على عرض العمود. |
TableOfContents
تمثّل هذه السمة StructuralElement
جدول محتوى.
تمثيل JSON |
---|
{
"content": [
{
object ( |
الحقول | |
---|---|
content[] |
محتوى جدول المحتويات. |
suggestedInsertionIds[] |
أرقام تعريف الإدراج المقترَحة قد يحتوي |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترَحة وإذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذا المحتوى. |
العنوان
عنوان المستند.
تمثيل JSON |
---|
{
"headerId": string,
"content": [
{
object ( |
الحقول | |
---|---|
headerId |
رقم تعريف العنوان. |
content[] |
محتوى رأس الصفحة وتبدأ فهارس محتوى العنوان من الصفر. |
حاشية سفلية
حاشية سفلية لمستند
تمثيل JSON |
---|
{
"footnoteId": string,
"content": [
{
object ( |
الحقول | |
---|---|
footnoteId |
رقم تعريف الحاشية السفلية. |
content[] |
محتويات الحاشية السفلية. تبدأ فهارس محتوى الحاشية السفلية من الصفر. |
DocumentStyle
نمط المستند.
تمثيل JSON |
---|
{ "background": { object ( |
الحقول | |
---|---|
background |
خلفية المستند. لا يمكن أن يكون للمستندات لون خلفية شفاف. |
defaultHeaderId |
رقم تعريف الرأس التلقائي. وفي حال ترك هذه السياسة بدون ضبط، لا يتوفّر عنوان تلقائي. هذا الموقع للقراءة فقط. |
defaultFooterId |
رقم تعريف التذييل التلقائي. وفي حال تركها بدون ضبط، لن يكون هناك تذييل تلقائي. هذا الموقع للقراءة فقط. |
evenPageHeaderId |
رقم تعريف الرأس المستخدَم فقط للصفحات الزوجية. وتحدِّد قيمة هذا الموقع للقراءة فقط. |
evenPageFooterId |
يتم استخدام رقم تعريف التذييل في الصفحات الزوجية فقط. تحدد قيمة هذا الموقع للقراءة فقط. |
firstPageHeaderId |
رقم تعريف العنوان المستخدَم فقط للصفحة الأولى وفي حال عدم ضبطها، لن يتوفّر عنوان فريد للصفحة الأولى. وتحدِّد قيمة هذا الموقع للقراءة فقط. |
firstPageFooterId |
رقم تعريف التذييل المُستخدَم للصفحة الأولى فقط. وفي حال تركها بدون ضبط، لن يكون هناك تذييل فريد للصفحة الأولى. تحدّد قيمة هذا الموقع للقراءة فقط. |
useFirstPageHeaderFooter |
يشير إلى ما إذا كان يجب استخدام أرقام تعريف رأس / تذييل الصفحة الأولى للصفحة الأولى. |
useEvenPageHeaderFooter |
يشير إلى ما إذا كان يجب استخدام أرقام تعريف رؤوس / تذييل الصفحات الزوجية للصفحات الزوجية. |
pageNumberStart |
رقم الصفحة الذي يتم من خلاله بدء حساب عدد الصفحات. |
marginTop |
هامش أعلى الصفحة يؤدي تحديث هامش الصفحة العلوية في نمط المستند إلى محو هامش الصفحة العلوي في جميع أنماط الأقسام. |
marginBottom |
هامش الصفحة السفلي. يؤدي تحديث هامش الصفحة السفلية في نمط المستند إلى محو هامش الصفحة السفلية في جميع أنماط الأقسام. |
marginRight |
هامش الصفحة الأيمن. يؤدي تحديث هامش الصفحة الأيمن في نمط المستند إلى محو هامش الصفحة الأيمن في جميع أنماط الأقسام. وقد يؤدي أيضًا إلى تغيير حجم الأعمدة في جميع الأقسام. |
marginLeft |
هامش الصفحة الأيسر. يؤدي تحديث هامش الصفحة الأيمن في نمط المستند إلى محو هامش الصفحة الأيسر في جميع أنماط الأقسام. وقد يؤدي أيضًا إلى تغيير حجم الأعمدة في جميع الأقسام. |
pageSize |
حجم صفحة في المستند. |
marginHeader |
مقدار المسافة بين أعلى الصفحة ومحتوى الرأس. |
marginFooter |
مقدار المسافة بين أسفل الصفحة ومحتوى التذييل. |
useCustomHeaderFooterMargins |
يشير إلى ما إذا تم الالتزام بـ DocumentStyle هذا الموقع للقراءة فقط. |
flipPageOrientation |
اختياريّ. تحدّد هذه السمة ما إذا كان سيتم قلب أبعاد |
الخلفية
يمثّل خلفية أحد المستندات.
تمثيل JSON |
---|
{
"color": {
object ( |
الحقول | |
---|---|
color |
لون الخلفية |
حجم الملف
العرض والارتفاع.
تمثيل JSON |
---|
{ "height": { object ( |
الحقول | |
---|---|
height |
تمثّل هذه السمة ارتفاع العنصر. |
width |
تمثّل هذه السمة عرض العنصر. |
SuggestedDocumentStyle
تغيير مقترَح على DocumentStyle
تمثيل JSON |
---|
{ "documentStyle": { object ( |
الحقول | |
---|---|
documentStyle |
|
documentStyleSuggestionState |
قناع يشير إلى الحقول التي تم تغييرها في قاعدة |
DocumentStyleSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في قاعدة DocumentStyle
هذه في هذا الاقتراح بالنسبة إلى أي حقل تم ضبطه على "صحيح"، هناك قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{ "backgroundSuggestionState": { object ( |
الحقول | |
---|---|
backgroundSuggestionState |
قناع يشير إلى الحقول في |
defaultHeaderIdSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
defaultFooterIdSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
evenPageHeaderIdSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
evenPageFooterIdSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
firstPageHeaderIdSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
firstPageFooterIdSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
useFirstPageHeaderFooterSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
useEvenPageHeaderFooterSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
pageNumberStartSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
marginTopSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
marginBottomSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
marginRightSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
marginLeftSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
pageSizeSuggestionState |
قناع يشير إلى الحقول في [size] تم تغيير [google.apps.docs.v1.DocumentStyle.size] في هذا الاقتراح. |
marginHeaderSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
marginFooterSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
useCustomHeaderFooterMarginsSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
flipPageOrientationSuggested |
اختياريّ. تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
BackgroundSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في قاعدة Background
هذه في هذا الاقتراح بالنسبة إلى أي حقل تم ضبطه على "صحيح"، يتضمّن Backgound
قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{ "backgroundColorSuggested": boolean } |
الحقول | |
---|---|
backgroundColorSuggested |
يشير إلى ما إذا كان لون الخلفية الحالي قد تم تعديله في هذا الاقتراح. |
SizeSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في قاعدة Size
هذه في هذا الاقتراح بالنسبة إلى أي حقل تم ضبطه على "صحيح"، يتضمّن Size
قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{ "heightSuggested": boolean, "widthSuggested": boolean } |
الحقول | |
---|---|
heightSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
widthSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
NamedStyles
الأنماط المُعنونة. يمكن أن تكتسب الفقرات في المستند TextStyle
وParagraphStyle
من هذه الأنماط المُسمّاة.
تمثيل JSON |
---|
{
"styles": [
{
object ( |
الحقول | |
---|---|
styles[] |
الأنماط المُعنونة. يتوفّر إدخال لكل |
NamedStyle
نمط مُسمّى. يمكن أن تكتسب الفقرات في المستند TextStyle
وParagraphStyle
من هذا النمط المُسمّى عندما يكون لها نوع النمط المُسمى نفسه.
تمثيل JSON |
---|
{ "namedStyleType": enum ( |
الحقول | |
---|---|
namedStyleType |
نوع هذا النمط المسمى. |
textStyle |
نمط النص لهذا النمط المحدد. |
paragraphStyle |
نمط الفقرة لهذا النمط المسمى. |
SuggestedNamedStyles
تغيير مقترَح على NamedStyles
تمثيل JSON |
---|
{ "namedStyles": { object ( |
الحقول | |
---|---|
namedStyles |
|
namedStylesSuggestionState |
قناع يشير إلى الحقول التي تم تغييرها في قاعدة |
NamedStylesSuggestionState
حالة الاقتراح لرسالة NamedStyles
تمثيل JSON |
---|
{
"stylesSuggestionStates": [
{
object ( |
الحقول | |
---|---|
stylesSuggestionStates[] |
قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح ضمن يتطابق ترتيب حالات اقتراحات الأنماط المُسمّاة هذه مع ترتيب النمط المُسمّى المقابل ضمن اقتراح |
NamedStyleSuggestionState
حالة اقتراح لرسالة NamedStyle
تمثيل JSON |
---|
{ "namedStyleType": enum ( |
الحقول | |
---|---|
namedStyleType |
نوع النمط المُسمى الذي تتوافق معه حالة الاقتراح هذه. يتم توفير هذا الحقل لتسهيل مطابقة حالة NamedStylesuggestionState مع |
textStyleSuggestionState |
قناع يشير إلى الحقول في |
paragraphStyleSuggestionState |
قناع يشير إلى الحقول في |
قائمة
تمثل القائمة سمات القائمة لمجموعة من الفقرات التي تنتمي جميعها إلى القائمة نفسها. تشتمل الفقرة التي هي جزء من القائمة على مرجع إلى رقم تعريف القائمة في bullet
الخاصة بها.
تمثيل JSON |
---|
{ "listProperties": { object ( |
الحقول | |
---|---|
listProperties |
خصائص القائمة. |
suggestedListPropertiesChanges |
التغييرات المقترَحة على خصائص القائمة، استنادًا إلى رقم تعريف الاقتراح |
suggestedInsertionId |
رقم تعريف الإدراج المقترَح إذا كانت فارغة، فهذا لا يعني إدراجًا مقترحًا. |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترَحة إذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذه القائمة. |
ListProperties
سمات list
التي تصف شكل ومضمون الرموز النقطية التي تنتمي إلى الفقرات المرتبطة بقائمة.
تمثيل JSON |
---|
{
"nestingLevels": [
{
object ( |
الحقول | |
---|---|
nestingLevels[] |
تصف خصائص الرموز النقطية على المستوى المرتبط. تحتوي القائمة على 9 مستويات تداخل بحد أقصى مع مستوى التداخل 0 المقابل للمستوى الأعلى ومستوى التداخل 8 الذي يتوافق مع المستوى الأكثر دمجًا. يتم عرض مستويات التداخل بترتيب تصاعدي مع إرجاع الأقل متداخلة أولاً. |
NestingLevel
يحتوي على خصائص تصف شكل ومظهر القائمة النقطية للقائمة على مستوى معين من التداخل.
تمثيل JSON |
---|
{ "bulletAlignment": enum ( |
الحقول | |
---|---|
bulletAlignment |
محاذاة الرمز النقطي داخل المساحة المخصصة لعرض الرمز النقطي. |
glyphFormat |
سلسلة التنسيق المستخدمة بواسطة الرموز النقطية في هذا المستوى من التداخل. يحتوي تنسيق الرسم البياني على عنصر نائب واحد أو أكثر، ويتم استبدال هذه العناصر النائبة بالقيم المناسبة استنادًا إلى على سبيل المثال، يشير تنسيق الأحرف الرسومية
يمكن أن يحتوي تنسيق الرسم البياني على عناصر نائبة لمستوى التداخل الحالي بالإضافة إلى عناصر نائبة لمستويات التداخل الرئيسي. على سبيل المثال، يمكن أن تحتوي القائمة على تنسيق حرفي
بالنسبة إلى مستويات التداخل المرتبة، تعتمد السلسلة التي تحل محل عنصر نائب بتنسيق حرفي لفقرة معينة على ترتيب الفقرة داخل القائمة. |
indentFirstLine |
مقدار المسافة البادئة للسطر الأول من الفقرات في هذا المستوى من التداخل. |
indentStart |
مقدار المسافة البادئة للفقرات في هذا المستوى من التداخل. يُطبَّق على الجانب الذي يتوافق مع بداية النص، بناءً على اتجاه محتوى الفقرة. |
textStyle |
نمط نص الرموز النقطية في هذا المستوى من التداخل. |
startNumber |
رقم أول عنصر قائمة في مستوى التداخل هذا. ويتم التعامل مع القيمة 0 على أنّها القيمة 1 للقوائم ذات الأحرف الكبيرة وقوائم الأرقام الرومانية. بالنسبة إلى القيمتين 0 و1، ستبدأ قوائم الأرقام ذات الحروف والرومانية في يتم تجاهل هذه القيمة لدمج المستويات مع الرموز الرسومية غير المرتبة. |
حقل الاتحاد glyph_kind . نوع الحرف الرسومي الذي تستخدمه الرموز النقطية. يحدّد ذلك الرمز الرسومي للتعداد النقطي الذي يحل محل العناصر النائبة في glyph_format . يمكن أن يكون glyph_kind واحدًا فقط مما يلي: |
|
glyphType |
نوع الحرف الرسومي الذي يستخدمه الرموز النقطية عندما يتم ترتيب الفقرات في هذا المستوى من التداخل. يحدد نوع الحرف الرسومي نوع الحرف الرسومي المستخدَم لاستبدال العناصر النائبة داخل |
glyphSymbol |
رمز حرفي مخصص يستخدمه الرموز النقطية عندما تكون الفقرات في هذا المستوى من التداخل غير مرتبة. يحل الرمز الرسومي محل العناصر النائبة داخل |
BulletAlignment
أنواع المحاذاة للرمز النقطي.
عمليات التعداد | |
---|---|
BULLET_ALIGNMENT_UNSPECIFIED |
لم يتم تحديد محاذاة الرموز النقطية. |
START |
تتم محاذاة الرمز النقطي مع بداية المساحة المخصصة لعرض الرمز النقطي. تمت المحاذاة إلى اليسار لنص LTR، والمحاذاة لليمين بخلاف ذلك. |
CENTER |
تتم محاذاة الرمز النقطي مع مركز المساحة المخصصة لعرض الرمز النقطي. |
END |
تتم محاذاة الرمز النقطي مع نهاية المساحة المخصصة لعرض الرمز النقطي. تمت المحاذاة لليمين مع نص LTR، والمحاذاة لليسار. |
GlyphType
يتم ترتيب أنواع الأحرف الرسومية التي تستخدمها الرموز النقطية عندما يتم ترتيب الفقرات في هذا المستوى من التداخل.
عمليات التعداد | |
---|---|
GLYPH_TYPE_UNSPECIFIED |
نوع الحرف الرسومي غير محدّد أو غير متوافق. |
NONE |
سلسلة فارغة. |
DECIMAL |
رقم، مثل 1 أو 2 أو 3 |
ZERO_DECIMAL |
هو رقم تكون فيه الأرقام المكوَّنة من رقم واحد مسبوقة بصفر، مثل 01 أو 02 أو 03 . لا تبدأ الأرقام التي تحتوي على أكثر من رقم واحد بصفر. |
UPPER_ALPHA |
أحرف كبيرة، مثل A أو B أو C |
ALPHA |
حرف صغير، مثل a أو b أو c |
UPPER_ROMAN |
رقم روماني كبير، مثل I أو II أو III . |
ROMAN |
رقم روماني صغير، مثل i أو ii أو iii |
SuggestedListProperties
تغيير مقترَح في "ListProperties
"
تمثيل JSON |
---|
{ "listProperties": { object ( |
الحقول | |
---|---|
listProperties |
|
listPropertiesSuggestionState |
قناع يشير إلى الحقول التي تم تغييرها في قاعدة |
ListPropertiesSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في قاعدة ListProperties
هذه في هذا الاقتراح بالنسبة إلى أي حقل تم ضبطه على "صحيح"، هناك قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{
"nestingLevelsSuggestionStates": [
{
object ( |
الحقول | |
---|---|
nestingLevelsSuggestionStates[] |
قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح ضمن يتم عرض حالات اقتراح مستوى التداخل بترتيب تصاعدي لمستوى التداخل مع عرض أقل العناصر المتداخلة أولاً. |
NestingLevelSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في قاعدة NestingLevel
هذه في هذا الاقتراح بالنسبة إلى أي حقل تم ضبطه على "صحيح"، هناك قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{
"bulletAlignmentSuggested": boolean,
"glyphTypeSuggested": boolean,
"glyphFormatSuggested": boolean,
"glyphSymbolSuggested": boolean,
"indentFirstLineSuggested": boolean,
"indentStartSuggested": boolean,
"textStyleSuggestionState": {
object ( |
الحقول | |
---|---|
bulletAlignmentSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
glyphTypeSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
glyphFormatSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
glyphSymbolSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
indentFirstLineSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
indentStartSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
textStyleSuggestionState |
قناع يشير إلى الحقول في |
startNumberSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
NamedRanges
هي مجموعة من جميع NamedRange
في المستند التي تشترك في اسم معيّن.
تمثيل JSON |
---|
{
"name": string,
"namedRanges": [
{
object ( |
الحقول | |
---|---|
name |
الاسم الذي تشترك فيه جميع |
namedRanges[] |
إنّ |
NamedRange
مجموعة من Range
لها رقم تعريف النطاق المُعن نفسه.
تتيح النطاقات المُعنونة للمطوّرين ربط أجزاء من مستند بتصنيف عشوائي من تحديد المستخدم حتى يمكن قراءة محتواها أو تعديله آليًا في وقت لاحق. يمكن أن يحتوي المستند على عدة نطاقات مُسَمّاة تحمل الاسم نفسه، ولكن لكل نطاق مُعنوَن رقم تعريف فريد.
يتم إنشاء نطاق مُعنوَن باستخدام علامة Range
واحدة، ويؤدي إدراج المحتوى داخل نطاق مُعنوَن بشكل عام إلى توسيع هذا النطاق. ومع ذلك، يمكن أن تؤدي تغييرات معينة في المستند إلى تقسيم النطاق إلى نطاقات متعددة.
النطاقات المُعنونة ليست خاصة. ويمكن لجميع التطبيقات والمتعاونين الذين لديهم الإذن بالوصول إلى المستند الاطّلاع على النطاقات المُعنونة به.
تمثيل JSON |
---|
{
"namedRangeId": string,
"name": string,
"ranges": [
{
object ( |
الحقول | |
---|---|
namedRangeId |
رقم تعريف النطاق المعنوَن. |
name |
اسم النطاق المُعنون. |
ranges[] |
النطاقات التي تنتمي إلى هذا النطاق المعنوَن. |
النطاق
لتحديد نطاق نص متجاور.
تمثيل JSON |
---|
{ "segmentId": string, "startIndex": integer, "endIndex": integer, "tabId": string } |
الحقول | |
---|---|
segmentId |
رقم تعريف الرأس أو التذييل أو الحاشية السفلية التي يحتوي عليها هذا النطاق. يشير رقم تعريف المقطع الفارغ إلى نص المستند. |
startIndex |
فهرس البدء المستنِد إلى صفر لهذا النطاق، بوحدات رمز UTF-16. يجب توفير فهرس بدء في جميع الاستخدامات الحالية. يمثّل هذا الحقل قيمة Int32Value لاستيعاب حالات الاستخدام المستقبلية مع النطاقات المفتوحة. |
endIndex |
الفهرس النهائي القائم على صفر لهذا النطاق، حصري، بوحدات رموز UTF-16. يجب توفير فهرس نهائي في جميع الاستخدامات الحالية. يمثّل هذا الحقل قيمة Int32Value لاستيعاب حالات الاستخدام المستقبلية مع النطاقات المفتوحة. |
tabId |
علامة التبويب التي تحتوي على هذا النطاق. وعند إسقاط الطلب، يتم تطبيق الطلب على علامة التبويب الأولى. في مستند يحتوي على علامة تبويب واحدة:
في مستند يحتوي على علامات تبويب متعددة:
|
InlineObject
يشير ذلك المصطلح إلى كائن يظهر بشكل مضمّن مع النص. يحتوي InlineObject على EmbeddedObject
مثل صورة.
تمثيل JSON |
---|
{ "objectId": string, "inlineObjectProperties": { object ( |
الحقول | |
---|---|
objectId |
رقم تعريف هذا العنصر المضمّن ويمكن استخدامها لتعديل خصائص أحد العناصر. |
inlineObjectProperties |
خصائص هذا الكائن المضمّن |
suggestedInlineObjectPropertiesChanges |
التغييرات المقترَحة على خصائص العناصر المضمّنة كمفتاح مرتبط برقم تعريف الاقتراح |
suggestedInsertionId |
رقم تعريف الإدراج المقترَح إذا كانت فارغة، فهذا لا يعني إدراجًا مقترحًا. |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترَحة وإذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذا المحتوى. |
InlineObjectProperties
خصائص InlineObject
تمثيل JSON |
---|
{
"embeddedObject": {
object ( |
الحقول | |
---|---|
embeddedObject |
الكائن المضمّن في هذا الكائن المضمّن |
EmbeddedObject
تمثّل هذه السمة كائنًا مضمَّنًا في المستند.
تمثيل JSON |
---|
{ "title": string, "description": string, "embeddedObjectBorder": { object ( |
الحقول | |
---|---|
title |
تمثّل هذه السمة عنوان العنصر المضمّن. تم دمج كل من |
description |
وصف العنصر المضمّن تم دمج كل من |
embeddedObjectBorder |
حدود الكائن المضمّن |
size |
الحجم المرئي للصورة بعد الاقتصاص. |
marginTop |
الهامش العلوي من العنصر المضمّن. |
marginBottom |
الهامش السفلي من العنصر المضمّن. |
marginRight |
الهامش الأيمن من الكائن المضمّن |
marginLeft |
الهامش الأيسر من العنصر المضمّن |
linkedContentReference |
مرجع لمحتوى المصدر المرتبط الخارجي على سبيل المثال، يحتوي على مرجع إلى الرسم البياني المصدر في "جداول بيانات Google" عندما يكون العنصر المضمّن رسمًا بيانيًا مرتبطًا. وفي حال ترك هذه السياسة بدون ضبط، لن يتم ربط الكائن المضمّن. |
حقل الاتحاد properties . السمات الخاصة بكل نوع من أنواع الكائنات المضمّنة يمكن أن يكون properties واحدًا فقط مما يلي: |
|
embeddedDrawingProperties |
خصائص الرسم المضمّن. |
imageProperties |
خصائص الصورة. |
EmbeddedDrawingProperties
لا يحتوي هذا النوع على أي حقول.
خصائص الرسم المضمّن المستخدمة لتمييز نوع الكائن. الرسم المضمّن هو رسم يتم إنشاؤه وتعديله داخل مستند. يُرجى العلم أنّه لا تتوفّر إمكانية الحصول على تفاصيل شاملة.
ImageProperties
خصائص الصورة.
تمثيل JSON |
---|
{
"contentUri": string,
"sourceUri": string,
"brightness": number,
"contrast": number,
"transparency": number,
"cropProperties": {
object ( |
الحقول | |
---|---|
contentUri |
معرف موارد منتظم (URI) للصورة مع فترة افتراضية مدتها 30 دقيقة. تم وضع علامة على عنوان URI هذا باستخدام حساب مُقدِّم الطلب. ويمكن لأي شخص لديه معرّف الموارد المنتظم (URI) الوصول إلى الصورة كمقدِّم الطلب الأصلي بفاعلية. قد يتم فقدان إمكانية الوصول إلى الصورة في حال تغيير إعدادات مشاركة المستند. |
sourceUri |
معرف الموارد المنتظم (URI) المصدر هو معرف الموارد المنتظم (URI) المستخدم لإدراج الصورة. يمكن أن يكون معرّف الموارد المنتظم (URI) المصدر فارغًا. |
brightness |
تأثير سطوع الصورة يجب أن تكون القيمة ضمن الفاصل الزمني [ -1.0, 1.0]، حيث تعني القيمة 0 عدم وجود تأثير. |
contrast |
تأثير التباين للصورة يجب أن تكون القيمة ضمن الفاصل الزمني [ -1.0, 1.0]، حيث تعني القيمة 0 عدم وجود تأثير. |
transparency |
تأثير الشفافية للصورة يجب أن تكون القيمة ضمن الفاصل الزمني [0.0، 1.0]، حيث يشير الرقم 0 إلى عدم وجود تأثير ويعني 1 الشفافية. |
cropProperties |
خصائص اقتصاص الصورة |
angle |
زاوية تدوير الصورة في اتجاه عقارب الساعة بوحدات الراديان. |
CropProperties
خصائص اقتصاص الصورة
يتم تمثيل مستطيل الاقتصاص باستخدام إزاحة كسرية من الحواف الأربع للمحتوى الأصلي.
- إذا كانت الإزاحة في الفاصل الزمني (0، 1)، يتم وضع الحافة المقابلة لمستطيل الاقتصاص داخل مستطيل الإزاحة الأصلي للصورة.
- إذا كانت الإزاحة سالبة أو أكبر من 1، فسيتم وضع الحافة المقابلة لمستطيل الاقتصاص خارج مستطيل الإزاحة الأصلي للصورة.
- إذا كانت جميع الإزاحة وزاوية التدوير 0، فلن يتم اقتصاص الصورة.
تمثيل JSON |
---|
{ "offsetLeft": number, "offsetRight": number, "offsetTop": number, "offsetBottom": number, "angle": number } |
الحقول | |
---|---|
offsetLeft |
تحدد الإزاحة مدى بُعد الحافة اليسرى لمستطيل الاقتصاص عن الحافة اليسرى للمحتوى الأصلي كجزء من عرض المحتوى الأصلي. |
offsetRight |
تحدد الإزاحة مدى بُعد الحافة اليمنى لمستطيل الاقتصاص عن الحافة اليمنى للمحتوى الأصلي كجزء من عرض المحتوى الأصلي. |
offsetTop |
تحدد الإزاحة مدى بُعد الحافة العلوية لمستطيل الاقتصاص عن الحافة العلوية للمحتوى الأصلي كجزء من ارتفاع المحتوى الأصلي. |
offsetBottom |
تحدد الإزاحة مدى بُعد الحافة السفلية لمستطيل الاقتصاص عن الحافة السفلية للمحتوى الأصلي كجزء من ارتفاع المحتوى الأصلي. |
angle |
زاوية التدوير في اتجاه عقارب الساعة لمستطيل الاقتصاص حول مركزه بوحدات الراديان. يتم تطبيق التدوير بعد الإزاحة. |
EmbeddedObjectBorder
حدود حول EmbeddedObject
تمثيل JSON |
---|
{ "color": { object ( |
الحقول | |
---|---|
color |
لون الحدود |
width |
عرض الحدود. |
dashStyle |
نمط الشرطة للحدود. |
propertyState |
تشير هذه السمة إلى حالة الخاصية للموقع الحدودي. |
PropertyState
الحالات المحتملة للموقع.
عمليات التعداد | |
---|---|
RENDERED |
إذا كانت حالة الخاصية هي RENDERED، يكون للعنصر الخاصية المقابلة عند عرضه في المستند. هذه هي القيمة الافتراضية. |
NOT_RENDERED |
إذا كانت حالة الخاصية NOT_RENDERED هي، لن يكون للعنصر الخاصية المقابلة لها عند عرضه في المستند. |
LinkedContentReference
مرجع لمحتوى المصدر المرتبط الخارجي
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد reference . المرجع الخاص بنوع المحتوى المرتبط. يمكن أن يكون reference واحدًا فقط مما يلي: |
|
sheetsChartReference |
مرجع للرسم البياني المرتبط. |
SheetsChartReference
مرجع إلى رسم بياني مرتبط مضمّن من "جداول بيانات Google".
تمثيل JSON |
---|
{ "spreadsheetId": string, "chartId": integer } |
الحقول | |
---|---|
spreadsheetId |
رقم تعريف جدول بيانات Google الذي يحتوي على المخطط المصدر. |
chartId |
رقم تعريف الرسم البياني المحدد في جدول بيانات "جداول بيانات Google" المضمّن. |
SuggestedInlineObjectProperties
تغيير مقترَح في "InlineObjectProperties
"
تمثيل JSON |
---|
{ "inlineObjectProperties": { object ( |
الحقول | |
---|---|
inlineObjectProperties |
تمثّل هذه السمة |
inlineObjectPropertiesSuggestionState |
قناع يشير إلى الحقول التي تم تغييرها في قاعدة |
InlineObjectPropertiesSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في قاعدة InlineObjectProperties
هذه في هذا الاقتراح بالنسبة إلى أي حقل تم ضبطه على "صحيح"، هناك قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{
"embeddedObjectSuggestionState": {
object ( |
الحقول | |
---|---|
embeddedObjectSuggestionState |
قناع يشير إلى الحقول في |
EmbeddedObjectSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في قاعدة EmbeddedObject
هذه في هذا الاقتراح بالنسبة إلى أي حقل تم ضبطه على "صحيح"، هناك قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{ "embeddedDrawingPropertiesSuggestionState": { object ( |
الحقول | |
---|---|
embeddedDrawingPropertiesSuggestionState |
قناع يشير إلى الحقول في |
imagePropertiesSuggestionState |
قناع يشير إلى الحقول في |
titleSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
descriptionSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
embeddedObjectBorderSuggestionState |
قناع يشير إلى الحقول في |
sizeSuggestionState |
قناع يشير إلى الحقول في |
marginLeftSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
marginRightSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
marginTopSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
marginBottomSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
linkedContentReferenceSuggestionState |
قناع يشير إلى الحقول في |
EmbeddedDrawingPropertiesSuggestionState
لا يحتوي هذا النوع على أي حقول.
قناع يشير إلى الحقول التي تم تغييرها في قاعدة EmbeddedDrawingProperties
هذه في هذا الاقتراح بالنسبة إلى أي حقل تم ضبطه على "صحيح"، هناك قيمة مقترَحة جديدة.
ImagePropertiesSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في قاعدة ImageProperties
هذه في هذا الاقتراح بالنسبة إلى أي حقل تم ضبطه على "صحيح"، هناك قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{
"contentUriSuggested": boolean,
"sourceUriSuggested": boolean,
"brightnessSuggested": boolean,
"contrastSuggested": boolean,
"transparencySuggested": boolean,
"cropPropertiesSuggestionState": {
object ( |
الحقول | |
---|---|
contentUriSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
sourceUriSuggested |
يشير إلى ما إذا كان هناك تغيير مقترح على [sourceUri] [google.apps.docs.v1.EmbedObject.source_uri]. |
brightnessSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترح على مستوى [السطوع]. [google.apps.docs.v1.inlineObject.brightness]. |
contrastSuggested |
يشير إلى ما إذا كان هناك تغيير مقترح على [التباين] [google.apps.docs.v1.EmbedObject.contrast]. |
transparencySuggested |
تشير إلى ما إذا كان هناك تغيير مقترح على [transparency] [google.apps.docs.v1.EmbedObject.transparency]. |
cropPropertiesSuggestionState |
قناع يشير إلى الحقول في |
angleSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في [angle] [google.apps.docs.v1.inlineObject.angle]. |
CropPropertiesSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في قاعدة CropProperties
هذه في هذا الاقتراح بالنسبة إلى أي حقل تم ضبطه على "صحيح"، هناك قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{ "offsetLeftSuggested": boolean, "offsetRightSuggested": boolean, "offsetTopSuggested": boolean, "offsetBottomSuggested": boolean, "angleSuggested": boolean } |
الحقول | |
---|---|
offsetLeftSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
offsetRightSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
offsetTopSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
offsetBottomSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
angleSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
EmbeddedObjectBorderSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في قاعدة EmbeddedObjectBorder
هذه في هذا الاقتراح بالنسبة إلى أي حقل تم ضبطه على "صحيح"، هناك قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{ "colorSuggested": boolean, "widthSuggested": boolean, "dashStyleSuggested": boolean, "propertyStateSuggested": boolean } |
الحقول | |
---|---|
colorSuggested |
تشير إلى ما إذا كان هناك تغيير مقترح إلى [color] [google.apps.docs.v1.IncludeBorderObject.color]. |
widthSuggested |
تشير هذه القيمة إلى ما إذا كان هناك تغيير مقترح على [width] [google.apps.docs.v1.IncludeBorderObject.width]. |
dashStyleSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترح على [dashStyle] [google.apps.docs.v1.IncludeBorderObject.dash_style]. |
propertyStateSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترح في سمة [propertyState] [google.apps.docs.v1.IncludeBorderObject.property_state]. |
LinkedContentReferenceSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في قاعدة LinkedContentReference
هذه في هذا الاقتراح بالنسبة إلى أي حقل تم ضبطه على "صحيح"، هناك قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{
"sheetsChartReferenceSuggestionState": {
object ( |
الحقول | |
---|---|
sheetsChartReferenceSuggestionState |
قناع يشير إلى الحقول في |
SheetsChartReferenceSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في قاعدة SheetsChartReference
هذه في هذا الاقتراح بالنسبة إلى أي حقل تم ضبطه على "صحيح"، هناك قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{ "spreadsheetIdSuggested": boolean, "chartIdSuggested": boolean } |
الحقول | |
---|---|
spreadsheetIdSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
chartIdSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
PositionedObject
كائن مرتبط بـ Paragraph
ويتم وضعه نسبةً إلى بداية الفقرة. يحتوي عنصر PositionedObject على EmbeddedObject
مثل صورة.
تمثيل JSON |
---|
{ "objectId": string, "positionedObjectProperties": { object ( |
الحقول | |
---|---|
objectId |
رقم تعريف هذا العنصر الذي تم تحديد موضعه. |
positionedObjectProperties |
خصائص هذا العنصر الذي تم تحديد موضعه. |
suggestedPositionedObjectPropertiesChanges |
التغييرات المقترَحة على خصائص العناصر الموضوعة بشكل رئيسي حسب رقم تعريف الاقتراح |
suggestedInsertionId |
رقم تعريف الإدراج المقترَح إذا كانت فارغة، فهذا لا يعني إدراجًا مقترحًا. |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترَحة وإذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذا المحتوى. |
PositionedObjectProperties
خصائص PositionedObject
تمثيل JSON |
---|
{ "positioning": { object ( |
الحقول | |
---|---|
positioning |
يشير إلى موضع هذا العنصر الذي تم تحديد موضعه بالنسبة إلى السطر الجديد من |
embeddedObject |
الكائن المضمّن في هذا العنصر الذي تم تحديد موضعه. |
PositionedObjectPositioning
تمثّل هذه السمة موضع PositionedObject
. يتم وضع العنصر الموضوع بالنسبة إلى بداية Paragraph
الذي تم ربطه به.
تمثيل JSON |
---|
{ "layout": enum ( |
الحقول | |
---|---|
layout |
تنسيق هذا العنصر الذي تم تحديد موضعه |
leftOffset |
إزاحة الحافة اليسرى للكائن الموضع بالنسبة إلى بداية |
topOffset |
إزاحة الحافة العلوية للكائن الموضع بالنسبة إلى بداية |
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 |
قناع يشير إلى الحقول التي تم تغييرها في قاعدة |
PositionedObjectPropertiesSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في قاعدة PositionedObjectProperties
هذه في هذا الاقتراح بالنسبة إلى أي حقل تم ضبطه على "صحيح"، هناك قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{ "positioningSuggestionState": { object ( |
الحقول | |
---|---|
positioningSuggestionState |
قناع يشير إلى الحقول في |
embeddedObjectSuggestionState |
قناع يشير إلى الحقول في |
PositionedObjectPositioningSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في قاعدة PositionedObjectPositioning
هذه في هذا الاقتراح بالنسبة إلى أي حقل تم ضبطه على "صحيح"، هناك قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{ "layoutSuggested": boolean, "leftOffsetSuggested": boolean, "topOffsetSuggested": boolean } |
الحقول | |
---|---|
layoutSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
leftOffsetSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
topOffsetSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح في |
SuggestionsViewMode
وضع عرض الاقتراحات المطبَّق على المستند، ويشير إلى كيفية تمثيل التغييرات المقترَحة. ويتم توفير خيارات لقراءة المستند مع تضمين كل الاقتراحات المضمَّنة أو المقبولة أو المرفوضة.
عمليات التعداد | |
---|---|
DEFAULT_FOR_CURRENT_ACCESS |
يعتمد تطبيق SuggestionsViewMode على المستند المعروض على مستوى الوصول الحالي للمستخدم. وإذا كان المستخدم لديه إذن بالاطّلاع فقط، يتم تطبيق PREVIEW_WITHOUT_SUGGESTIONS . وبخلاف ذلك، يتم تطبيق SUGGESTIONS_INLINE . هذا هو وضع عرض الاقتراحات التلقائي. |
SUGGESTIONS_INLINE |
يحتوي المستند المعروض على اقتراحات مضمَّنة. سيتم تمييز التغييرات المقترَحة عن المحتوى الأساسي داخل المستند. إذا لم يكن لدى المستخدم إذن بعرض التغييرات المقترَحة، ستعرض طلبات استرداد مستند باستخدام هذا الوضع خطأ 403. |
PREVIEW_SUGGESTIONS_ACCEPTED |
المستند المعروض هو معاينة تم قبول جميع التغييرات المقترَحة فيها. إذا لم يكن لدى المستخدم إذن بعرض التغييرات المقترَحة، ستعرض طلبات استرداد مستند باستخدام هذا الوضع خطأ 403. |
PREVIEW_WITHOUT_SUGGESTIONS |
المستند المعروض هو معاينة تم رفض جميع التغييرات المقترَحة فيها إذا كانت هناك أي اقتراحات في المستند. |
الطُرق |
|
---|---|
|
يتم تطبيق تعديل واحد أو أكثر على المستند. |
|
ينشئ مستندًا فارغًا باستخدام العنوان الوارد في الطلب. |
|
للحصول على أحدث نسخة من المستند المحدّد. |