- المرجع: مستند
- علامة التبويب
- 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 ( |
الحقول | |
---|---|
document |
النتائج فقط. رقم تعريف المستند |
title |
عنوان المستند. |
tabs[] |
علامات التبويب التي تشكّل جزءًا من مستند يمكن أن تحتوي علامات التبويب على علامات تبويب فرعية، وهي علامة تبويب مضمّنة في علامة تبويب أخرى. يتم تمثيل علامات التبويب الفرعية بحقل |
revision |
النتائج فقط. رقم تعريف المراجعة للمستند. يمكن استخدامها في طلبات التعديل لتحديد نسخة المستند التي سيتم تطبيق التعديلات عليها وطريقة معالجة الطلب في حال تم تعديل المستند منذ تلك النسخة. لا يتمّ تعبئة هذا الحقل إلّا إذا كان لدى المستخدِم إذن وصول للتعديل في المستند. رقم تعريف النسخة ليس رقمًا تسلسليًا بل سلسلة غير شفافة. قد يتغيّر تنسيق معرّف المراجعة بمرور الوقت. لا يمكن ضمان صلاحية معرّف المراجعة الذي تم إرجاعه إلا لمدة 24 ساعة بعد إرجاعه، ولا يمكن مشاركته مع جميع المستخدمين. إذا لم يتغيّر رقم تعريف المراجعة بين المكالمات، يعني ذلك أنّه لم يتم تغيير المستند. في المقابل، يعني رقم التعريف المتغيّر (للمستند والمستخدم نفسهما) عادةً أنّه تم تعديل المستند. ومع ذلك، يمكن أن يرجع سبب تغيير رقم التعريف أيضًا إلى عوامل داخلية، مثل تغييرات تنسيق رقم التعريف. |
suggestions |
النتائج فقط. وضع عرض الاقتراحات الذي تم تطبيقه على المستند ملاحظة: عند تعديل مستند، يجب أن تستند التغييرات إلى مستند يتضمّن |
body |
النتائج فقط. النص الرئيسي للمستند. الحقل القديم: استخدِم بدلاً من ذلك |
headers |
النتائج فقط. العناوين في المستند، مفعَّلة حسب رقم تعريف العنوان الحقل القديم: استخدِم بدلاً من ذلك |
footers |
النتائج فقط. تتضمن هذه السمة التذييلات في المستند، مع ترتيبها حسب معرّف التذييل. الحقل القديم: استخدِم بدلاً من ذلك |
footnotes |
النتائج فقط. الحواشي السفلية في المستند، مرتَّبة حسب معرّف الحاشية السفلية الحقل القديم: استخدِم بدلاً من ذلك |
document |
النتائج فقط. نمط المستند الحقل القديم: استخدِم بدلاً من ذلك |
suggested |
النتائج فقط. التغييرات المقترَحة على نمط المستند، مرتَّبة حسب معرّف الاقتراح الحقل القديم: استخدِم بدلاً من ذلك |
named |
النتائج فقط. الأنماط المُعنوَنة للمستند الحقل القديم: استخدِم بدلاً من ذلك |
suggested |
النتائج فقط. التغييرات المقترَحة على الأنماط المُسمّاة للمستند، مع ترتيبها حسب معرّف الاقتراح الحقل القديم: استخدِم بدلاً من ذلك |
lists |
النتائج فقط. القوائم في المستند، مفعَّلة حسب معرّف القائمة الحقل القديم: استخدِم بدلاً من ذلك |
named |
النتائج فقط. النطاقات المُعنوَنة في المستند، مرتَّبة حسب الاسم الحقل القديم: استخدِم بدلاً من ذلك |
inline |
النتائج فقط. العناصر المضمّنة في المستند، مفعَّلة حسب رقم تعريف العنصر الحقل القديم: استخدِم بدلاً من ذلك |
positioned |
النتائج فقط. العناصر التي تمّ وضعها في المستند، مع ترتيبها حسب معرّف العنصر الحقل القديم: استخدِم بدلاً من ذلك |
علامة تبويب
علامة تبويب في مستند
تمثيل JSON |
---|
{ "tabProperties": { object ( |
الحقول | |
---|---|
tab |
خصائص علامة التبويب، مثل رقم التعريف والعنوان |
child |
علامات التبويب الفرعية المُدمجة في علامة التبويب هذه |
حقل الربط content محتوى علامة التبويب يمكن أن يكون content واحدًا فقط مما يلي: |
|
document |
علامة تبويب تتضمّن محتوى المستند، مثل النصوص والصور |
TabProperties
خصائص علامة تبويب
تمثيل JSON |
---|
{ "tabId": string, "title": string, "parentTabId": string, "index": integer, "nestingLevel": integer } |
الحقول | |
---|---|
tab |
النتائج فقط. رقم تعريف علامة التبويب لا يمكن تغيير هذا الحقل. |
title |
اسم علامة التبويب الذي يظهر للمستخدم |
parent |
اختيارية: معرّف علامة التبويب الرئيسية فارغة عندما تكون علامة التبويب الحالية علامة تبويب على مستوى الجذر، ما يعني أنّها لا تحتوي على أي علامات تبويب رئيسية |
index |
الفهرس المبدوء من الصفر لعلامة التبويب ضمن العنصر الرئيسي |
nesting |
النتائج فقط. عمق علامة التبويب في المستند تبدأ علامات التبويب على مستوى الجذر من 0. |
DocumentTab
علامة تبويب تتضمّن محتوى المستند
تمثيل JSON |
---|
{ "body": { object ( |
الحقول | |
---|---|
body |
النص الرئيسي لعلامة التبويب الخاصة بالمستند. |
headers |
العناوين في علامة تبويب المستند، مفعَّلة حسب رقم تعريف العنوان |
footers |
تتضمن هذه السمة التذييلات في علامة تبويب المستند، ويتم ترتيبها حسب رقم تعريف التذييل. |
footnotes |
الحواشي السفلية في علامة تبويب المستند، مرتّبة حسب معرّف الحاشية السفلية |
document |
نمط علامة التبويب للمستند |
suggested |
التغييرات المقترَحة على أسلوب علامة تبويب المستند، مرتَّبة حسب معرّف الاقتراح |
named |
الأنماط المُعنوَنة لعلامة تبويب المستند |
suggested |
التغييرات المقترَحة على الأنماط المُسمّاة لعلامة تبويب المستند، مع ترتيبها حسب معرّف الاقتراح |
lists |
القوائم في علامة تبويب "المستند"، مفعَّلة حسب معرّف القائمة |
named |
النطاقات المُعنوَنة في علامة تبويب المستند، مرتَّبة حسب الاسم |
inline |
العناصر المضمّنة في علامة تبويب المستند، مفعَّلة حسب رقم تعريف العنصر |
positioned |
الكائنات التي تمّ وضعها في علامة تبويب المستند، مع ترتيبها حسب معرّف الكائن |
الجسم
نص المستند
يحتوي النص عادةً على محتوى المستند بالكامل باستثناء headers
وfooters
وfootnotes
.
تمثيل JSON |
---|
{
"content": [
{
object ( |
الحقول | |
---|---|
content[] |
محتوى النص تبدأ فهارس محتوى النصّ من الصفر. |
StructuralElement
يصف عنصر البنية المحتوى الذي يقدّم بنية للمستند.
تمثيل JSON |
---|
{ "startIndex": integer, "endIndex": integer, // Union field |
الحقول | |
---|---|
start |
مؤشر البداية المستند إلى الصفر لهذا العنصر الهيكلي، بوحدات ترميز UTF-16 |
end |
فهرس النهاية المستند إلى الصفر لهذا العنصر الهيكلي، حصريًا، في وحدات ترميز UTF-16. |
حقل الربط content محتوى العنصر الهيكلي يمكن أن يكون content واحدًا فقط مما يلي: |
|
paragraph |
نوع فقرة من العنصر الهيكلي |
section |
نوع فاصل قسم من العنصر الهيكلي. |
table |
نوع جدول من العناصر الهيكلية |
table |
نوع عنصر هيكلي لجدول المحتويات |
الفقرة
StructuralElement
يمثّل فقرة. الفقرة هي نطاق من المحتوى ينتهي بحرف سطر جديد.
تمثيل JSON |
---|
{ "elements": [ { object ( |
الحقول | |
---|---|
elements[] |
محتوى الفقرة، مقسّمًا إلى أجزائه المكونة |
paragraph |
نمط هذه الفقرة. |
suggested |
يتغيّر نمط الفقرة المقترَح إلى هذه الفقرة، استنادًا إلى معرّف الاقتراح. |
bullet |
علامة نقطية لهذه الفقرة إذا لم يكن متوفّرًا، يعني ذلك أنّ الفقرة لا تنتمي إلى قائمة. |
suggested |
التغييرات المقترَحة على الرمز النقطي لهذه الفقرة |
positioned |
أرقام تعريف العناصر المُحدَّدة بدقة والمرتبطة بهذه الفقرة |
suggested |
أرقام تعريف العناصر التي تمّ وضعها والمقترَحة لإرفاقها بهذه الفقرة، مرتّبة حسب رقم تعريف الاقتراح |
ParagraphElement
يصف عنصر ParagraphElement المحتوى ضمن Paragraph
.
تمثيل JSON |
---|
{ "startIndex": integer, "endIndex": integer, // Union field |
الحقول | |
---|---|
start |
فهرس البدء بالاستناد إلى الصفر لعنصر الفقرة هذا، بوحدات ترميز UTF-16 |
end |
فهرس النهاية بالاستناد إلى الصفر لعنصر الفقرة هذا، حصريًا، في وحدات ترميز UTF-16. |
حقل الربط content محتوى عنصر الفقرة يمكن أن يكون content واحدًا فقط مما يلي: |
|
text |
عنصر فقرة نصي |
auto |
عنصر فقرة نص تلقائي |
page |
عنصر فقرة فاصل صفحة |
column |
عنصر فقرة فاصل عمود |
footnote |
عنصر فقرة مرجع حاشية سفلية |
horizontal |
عنصر فقرة خط أفقي |
equation |
عنصر فقرة معادلة |
inline |
عنصر فقرة كائن مضمّن |
person |
عنصر فقرة يرتبط بشخص أو عنوان بريد إلكتروني. |
rich |
عنصر فقرة يرتبط بمورد على Google (مثل ملف في Google Drive أو فيديو على YouTube أو حدث في "تقويم Google") |
TextRun
ParagraphElement
يمثّل سلسلة من النصوص التي لها النمط نفسه.
تمثيل JSON |
---|
{ "content": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
الحقول | |
---|---|
content |
نصّ هذه العملية. يتم استبدال أي عناصر غير نصية في المجموعة بحرف Unicode U+E907. |
suggested |
معرّفات الإدراج المقترَحة قد يحتوي العنصر |
suggested |
أرقام تعريف الحذف المقترَحة إذا كان الحقل فارغًا، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذا المحتوى. |
text |
نمط النص لهذا الإجراء. |
suggested |
يتغيّر نمط النص المقترَح إلى هذه السلسلة، استنادًا إلى معرّف الاقتراح. |
TextStyle
يمثّل التصميم الذي يمكن تطبيقه على النص.
يتم تمثيل أنماط النصوص المُكتسَبة كحقول غير محدّدة في هذه الرسالة. يعتمد العنصر الرئيسي لنمط النص على مكان تحديد نمط النص:
- يرث TextStyle للنص في
Paragraph
منnamed style type
المطابق للفقرة. - يكتسب تنسيق النص في
named style
تنسيقًا منnormal text
. - يرث TextStyle للنمط المُعنوَن
normal text
من نمط النص التلقائي في محرِّر "مستندات Google". - قد يكتسب عنصر TextStyle في عنصر
Paragraph
المضمّن في جدول نمط النص من نمط الجدول.
إذا لم يكتسب نمط النص قيمة من عنصر رئيسي، سيؤدي إلغاء ضبط الحقول إلى إعادة النمط إلى قيمة تتطابق مع القيم التلقائية في محرِّر "مستندات Google".
تمثيل JSON |
---|
{ "bold": boolean, "italic": boolean, "underline": boolean, "strikethrough": boolean, "smallCaps": boolean, "backgroundColor": { object ( |
الحقول | |
---|---|
bold |
يشير إلى ما إذا كان سيتم عرض النص غامقًا أم لا. |
italic |
ما إذا كان النص مائلًا أم لا |
underline |
ما إذا كان النص مُسطَّرًا أم لا |
strikethrough |
ما إذا كان النص مشطوبًا أم لا |
small |
ما إذا كان النص مكتوبًا بأحرف صغيرة كبيرة أم لا |
background |
لون خلفية النص إذا تم ضبطه، يكون اللون إما لونًا أحمر أخضر أزرق أو شفافًا، وذلك استنادًا إلى الحقل |
foreground |
لون المقدّمة للنص إذا تم ضبطه، يكون اللون إما لونًا أحمر أخضر أزرق أو شفافًا، وذلك استنادًا إلى الحقل |
font |
حجم خط النص |
weighted |
مجموعة الخطوط ودرجة عرض النص إذا حدّد طلب التعديل قيمًا لكل من إذا لم يتم ضبط في حال ضبط |
baseline |
الإزاحة العمودية للنص عن موضعه المعتاد يتم عرض النص الذي يتضمّن Offsets لقاعدة |
link |
وجهة الرابط التشعّبي للنص في حال عدم ضبط القيمة، لن يظهر أي رابط. لا يتم اكتساب الروابط من النص الرئيسي. يؤدي تغيير الرابط في طلب التعديل إلى إجراء بعض التغييرات الأخرى على نمط نص النطاق:
|
OptionalColor
لون يمكن أن يكون معتمًا بالكامل أو شفافًا بالكامل
تمثيل JSON |
---|
{
"color": {
object ( |
الحقول | |
---|---|
color |
في حال ضبط هذا الخيار، سيتم استخدامه كلون غير شفاف. وفي حال عدم ضبطها، يشير ذلك إلى لون شفاف. |
اللون
لون واحد
تمثيل JSON |
---|
{
"rgbColor": {
object ( |
الحقول | |
---|---|
rgb |
قيمة اللون بتنسيق RGB |
RgbColor
لون أحمر أخضر أزرق
تمثيل 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 } |
الحقول | |
---|---|
font |
مجموعة خطوط النص يمكن أن تكون مجموعة الخطوط أي خط من قائمة "الخط" في "مستندات Google" أو من Google Fonts. إذا لم يتم التعرّف على اسم الخط، يتم عرض النص برمز |
weight |
سمك الخط يمكن أن يحتوي هذا الحقل على أي قيمة مضاعفة لـ القيمة التلقائية هي يشكّل عرض الخط مكوّنًا واحدًا فقط من عرض الخط المعروض. يحدّد كلّ من
|
BaselineOffset
الطرق التي يمكن بها إزاحة النص عموديًا عن موضعه المعتاد
عمليات التعداد | |
---|---|
BASELINE_OFFSET_UNSPECIFIED |
يتم اكتساب قيمة الإزاحة من خط الأساس للنص من العنصر الرئيسي. |
NONE |
النص ليس مائلًا عموديًا. |
SUPERSCRIPT |
يتم وضع النص بشكل مائل للأعلى (نص مرتفع). |
SUBSCRIPT |
النص مُعدَّل عموديًا للأسفل (نص منخفض). |
رابط
إشارة إلى جزء آخر من مستند أو مرجع عنوان URL خارجي
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الربط destination وجهة الرابط يمكن أن يكون destination واحدًا فقط مما يلي: |
|
url |
عنوان URL خارجي |
tab |
رقم تعريف علامة تبويب في هذا المستند. |
bookmark |
إشارة مرجعية في هذا المستند في المستندات التي تحتوي على علامة تبويب واحدة، تستمر الروابط المؤدية إلى الإشارات المرجعية ضمن علامة التبويب الواحدة في عرض |
heading |
عنوان في هذا المستند في المستندات التي تحتوي على علامة تبويب واحدة، تستمر الروابط المؤدية إلى العناوين ضمن علامة التبويب الواحدة في عرض |
bookmark |
رقم تعريف إشارة مرجعية في هذا المستند. الحقل القديم: بدلاً من ذلك، اضبط في حال استخدام هذا الحقل في طلب كتابة، تُعتبر الإشارة المرجعية من رقم تعريف علامة التبويب المحدّد في الطلب. إذا لم يتم تحديد معرّف علامة تبويب في الطلب، يُعتبَر أنّه من علامة التبويب الأولى في المستند. |
heading |
معرّف عنوان في هذا المستند. الحقل القديم: بدلاً من ذلك، اضبط إذا تم استخدام هذا الحقل في طلب كتابة، يُعتبر العنوان من معرّف علامة التبويب المحدّد في الطلب. إذا لم يتم تحديد معرّف علامة تبويب في الطلب، يُعتبَر أنّه من علامة التبويب الأولى في المستند. |
BookmarkLink
إشارة إلى إشارة مرجعية في هذا المستند
تمثيل JSON |
---|
{ "id": string, "tabId": string } |
الحقول | |
---|---|
id |
رقم تعريف إشارة مرجعية في هذا المستند. |
tab |
معرّف علامة التبويب التي تحتوي على الإشارة المرجعية هذه. |
HeadingLink
إشارة إلى عنوان في هذا المستند
تمثيل JSON |
---|
{ "id": string, "tabId": string } |
الحقول | |
---|---|
id |
معرّف عنوان في هذا المستند. |
tab |
معرّف علامة التبويب التي تحتوي على هذا العنوان |
SuggestedTextStyle
تغيير مقترَح على TextStyle
تمثيل JSON |
---|
{ "textStyle": { object ( |
الحقول | |
---|---|
text |
|
text |
قناع يشير إلى الحقول التي تم تغييرها في |
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 } |
الحقول | |
---|---|
bold |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
italic |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
underline |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
strikethrough |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
small |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
background |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
foreground |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
font |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
weighted |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
baseline |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
link |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
AutoText
ParagraphElement
يمثّل مكانًا في النص يتم استبداله ديناميكيًا بمحتوى يمكن أن يتغيّر بمرور الوقت، مثل رقم الصفحة.
تمثيل JSON |
---|
{ "type": enum ( |
الحقول | |
---|---|
type |
نوع هذا النص التلقائي |
suggested |
معرّفات الإدراج المقترَحة قد يحتوي |
suggested |
أرقام تعريف الحذف المقترَحة إذا كان الحقل فارغًا، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذا المحتوى. |
text |
نمط النص لهذا النص التلقائي. |
suggested |
يتغيّر نمط النص المقترَح إلى هذا النص التلقائي، ويتم تحديده حسب معرّف الاقتراح. |
النوع
أنواع النصوص التلقائية
عمليات التعداد | |
---|---|
TYPE_UNSPECIFIED |
نوع نص تلقائي غير محدّد |
PAGE_NUMBER |
اكتب نصًا تلقائيًا يمثّل رقم الصفحة الحالي. |
PAGE_COUNT |
اكتب نصًا تلقائيًا يمثّل العدد الإجمالي للصفحات في المستند. |
PageBreak
ParagraphElement
يمثّل فاصل صفحة. يؤدي فاصل الصفحة إلى بدء النص اللاحق في أعلى الصفحة التالية.
تمثيل JSON |
---|
{ "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
الحقول | |
---|---|
suggested |
معرّفات الإدراج المقترَحة قد يتضمّن العنصر |
suggested |
أرقام تعريف الحذف المقترَحة إذا كان الحقل فارغًا، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذا المحتوى. |
text |
نمط النص الخاص بفاصل الصفحة هذا. على غرار محتوى النص، مثل سطور النص وإشارات الحواشي السفلية، يمكن أن يؤثر نمط النص الخاص بفاصل الصفحة في تنسيق المحتوى بالإضافة إلى نمط النص الذي يتم إدراجه بجانبه. |
suggested |
يتغيّر نمط النص المقترَح إلى "فاصل صفحة" هذا، ويتم تحديده حسب معرّف الاقتراح. |
ColumnBreak
ParagraphElement
يمثّل فاصل أعمدة. يؤدي فاصل الأعمدة إلى بدء النص اللاحق في أعلى العمود التالي.
تمثيل JSON |
---|
{ "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
الحقول | |
---|---|
suggested |
معرّفات الإدراج المقترَحة قد يتضمّن العنصر |
suggested |
معرّفات الحذف المقترَحة. إذا كان الحقل فارغًا، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذا المحتوى. |
text |
نمط النص الخاص بفاصل الأعمدة هذا. على غرار محتوى النص، مثل سطور النص وإشارات الحواشي السفلية، يمكن أن يؤثر أسلوب نص فاصل الأعمدة في تنسيق المحتوى بالإضافة إلى أسلوب النص المُدرَج بجانبه. |
suggested |
يتغيّر نمط النص المقترَح إلى عنصر ColumnBreak هذا، والذي يتمّ تحديده باستخدام معرّف الاقتراح. |
FootnoteReference
ParagraphElement
يمثّل مرجعًا للحاشية السفلية. مرجع الحاشية السفلية هو المحتوى المضمّن الذي يتم عرضه برقم ويُستخدَم لتحديد الحاشية السفلية.
تمثيل JSON |
---|
{ "footnoteId": string, "footnoteNumber": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
الحقول | |
---|---|
footnote |
معرّف |
footnote |
الرقم المعروض لهذه الهامش السفلي. |
suggested |
معرّفات الإدراج المقترَحة قد يتضمّن العنصر |
suggested |
أرقام تعريف الحذف المقترَحة إذا كان الحقل فارغًا، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذا المحتوى. |
text |
نمط النص الخاص بـ FootnoteReference هذا. |
suggested |
يتغيّر نمط النص المقترَح إلى FootnoteReference هذا، ويتمّ ترتيبه حسب معرّف الاقتراح. |
HorizontalRule
ParagraphElement
يمثّل خطًا أفقيًا.
تمثيل JSON |
---|
{ "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
الحقول | |
---|---|
suggested |
معرّفات الإدراج المقترَحة قد يحتوي العنصر |
suggested |
أرقام تعريف الحذف المقترَحة إذا كان الحقل فارغًا، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذا المحتوى. |
text |
نمط النص الخاص بعنصر HorizontalRule هذا. على غرار محتوى النص، مثل سطور النص وإشارات الحواشي السفلية، يمكن أن يؤثّر أسلوب النص في الخط الأفقي في تنسيق المحتوى بالإضافة إلى أسلوب النص الذي يتم إدراجه بجانبه. |
suggested |
يتغيّر نمط النص المقترَح إلى هذا العنصر HorizontalRule، والذي يتمّ تحديده باستخدام معرّف الاقتراح. |
معادلة
ParagraphElement
يمثّل معادلة
تمثيل JSON |
---|
{ "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ] } |
الحقول | |
---|---|
suggested |
معرّفات الإدراج المقترَحة قد يحتوي |
suggested |
أرقام تعريف الحذف المقترَحة إذا كان الحقل فارغًا، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذا المحتوى. |
InlineObjectElement
ParagraphElement
يحتوي على InlineObject
تمثيل JSON |
---|
{ "inlineObjectId": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
الحقول | |
---|---|
inline |
معرّف |
suggested |
معرّفات الإدراج المقترَحة قد يحتوي |
suggested |
أرقام تعريف الحذف المقترَحة إذا كان الحقل فارغًا، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذا المحتوى. |
text |
نمط النص لهذا العنصر InlineObjectElement. على غرار محتوى النص، مثل سطور النص وإشارات الحواشي السفلية، يمكن أن يؤثّر أسلوب النص لعنصر عنصر مضمّن في تنسيق المحتوى بالإضافة إلى أسلوب النص المُدرَج بجانبه. |
suggested |
يتغيّر نمط النص المقترَح إلى عنصر InlineObject هذا، والذي يتمّ ترتيبه حسب رقم تعريف الاقتراح. |
شخص
شخص أو عنوان بريد إلكتروني مذكور في مستند تتصرف هذه الإشارات كعنصر واحد غير قابل للتغيير يحتوي على اسم المستخدم أو عنوان بريده الإلكتروني.
تمثيل JSON |
---|
{ "personId": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
الحقول | |
---|---|
person |
النتائج فقط. المعرّف الفريد لهذا الرابط. |
suggested |
أرقام تعريف الاقتراحات التي تُدرج رابط هذا المستخدم في المستند قد يتضمّن العنصر |
suggested |
أرقام تعريف الاقتراحات التي تزيل رابط هذا الشخص من المستند قد يكون لدى |
text |
نمط النص لهذا |
suggested |
يتغيّر نمط النص المقترَح إلى هذا النمط |
person |
النتائج فقط. سمات هذا |
PersonProperties
الخصائص الخاصة بـ Person
المرتبط
تمثيل JSON |
---|
{ "name": string, "email": string } |
الحقول | |
---|---|
name |
النتائج فقط. اسم المستخدم إذا كان معروضًا في نص الرابط بدلاً من عنوان بريده الإلكتروني |
email |
النتائج فقط. عنوان البريد الإلكتروني المرتبط بهذا |
RichLink
رابط يؤدي إلى مرجع في Google (مثل ملف في Drive أو فيديو على YouTube أو حدث في "تقويم Google")
تمثيل JSON |
---|
{ "richLinkId": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
الحقول | |
---|---|
rich |
النتائج فقط. رقم تعريف هذا الرابط. |
suggested |
أرقام تعريف للاقتراحات التي تُدرِج هذا الرابط في المستند قد يتضمّن العنصر |
suggested |
أرقام تعريف الاقتراحات التي تزيل هذا الرابط من المستند قد يكون لدى |
text |
نمط النص لهذا |
suggested |
يتغيّر نمط النص المقترَح إلى هذا النمط |
rich |
النتائج فقط. سمات هذا |
RichLinkProperties
الخصائص الخاصة بـ RichLink
تمثيل JSON |
---|
{ "title": string, "uri": string, "mimeType": string } |
الحقول | |
---|---|
title |
النتائج فقط. عنوان |
uri |
النتائج فقط. معرّف الموارد المنتظم (URI) الخاص بالسمة |
mime |
النتائج فقط. نوع MIME لل |
ParagraphStyle
الأنماط التي تنطبق على فقرة كاملة
يتم تمثيل أنماط الفقرات المُكتسَبة كحقول غير محدّدة في هذه الرسالة. يعتمد العنصر الرئيسي لتنسيق الفقرة على مكان تحديد تنسيق الفقرة:
- يكتسب ParagraphStyle في
Paragraph
سمةnamed style type
الخاصة بالفقرة المقابلة. - يكتسب ParagraphStyle في
named style
النمط المُعنوَنnormal text
. - يرث ParagraphStyle للنمط المُعنوَن
normal text
من نمط الفقرة التلقائي في محرِّر "مستندات Google". - قد يكتسب ParagraphStyle في عنصر
Paragraph
المضمّن في جدول نمط الفقرة من نمط الجدول.
إذا لم يكتسب أسلوب الفقرة قيمة من عنصر رئيسي، سيؤدي إلغاء ضبط الحقول إلى إعادة الأسلوب إلى قيمة تتطابق مع الإعدادات التلقائية في محرِّر "مستندات Google".
تمثيل JSON |
---|
{ "headingId": string, "namedStyleType": enum ( |
الحقول | |
---|---|
heading |
رقم تعريف العنوان للفقرة. إذا كانت فارغة، هذا يعني أنّ هذه الفقرة ليست عنوانًا. هذا الموقع للقراءة فقط. |
named |
نوع النمط المُعنوَن للفقرة. بما أنّ تعديل نوع النمط المُعنوَن يؤثر في الخصائص الأخرى ضمن ParagraphStyle، يتم تطبيق نوع النمط المُعنوَن قبل تعديل الخصائص الأخرى. |
alignment |
محاذاة النص لهذه الفقرة. |
line |
مقدار المساحة بين السطور، كنسبة مئوية من القيمة العادية، حيث يتم تمثيل القيمة العادية على النحو 100.0. في حال عدم ضبط القيمة، يتم اكتسابها من العنصر الرئيسي. |
direction |
اتجاه النص في هذه الفقرة في حال عدم ضبط القيمة، تكون القيمة التلقائية هي |
spacing |
وضع التباعد للفقرة |
space |
مقدار المساحة الإضافية فوق الفقرة في حال عدم ضبط القيمة، يتم اكتسابها من العنصر الرئيسي. |
space |
مقدار المساحة الإضافية أسفل الفقرة في حال عدم ضبط القيمة، يتم اكتسابها من العنصر الرئيسي. |
border |
الحدود بين هذه الفقرة والفقرات التالية والسابقة في حال عدم ضبط القيمة، يتم اكتسابها من العنصر الرئيسي. يتم عرض الحدّ بيني عندما تحتوي الفقرة المجاورة على سمات الحدود والبادئة نفسها. لا يمكن تعديل حدود الفقرات جزئيًا. عند تغيير حدود فقرة، يجب تحديد الحدود الجديدة بالكامل. |
border |
الحدّ في أعلى هذه الفقرة في حال عدم ضبط القيمة، يتم اكتسابها من العنصر الرئيسي. يتم عرض الحدّ العلوي عندما تحتوي الفقرة أعلاه على خصائص مختلفة للحدّ والبادئة. لا يمكن تعديل حدود الفقرات جزئيًا. عند تغيير حدود فقرة، يجب تحديد الحدود الجديدة بالكامل. |
border |
الحدّ في أسفل هذه الفقرة في حال عدم ضبط القيمة، يتم اكتسابها من العنصر الرئيسي. يتم عرض الحدّ السفلي عندما تحتوي الفقرة أدناه على سمات حدود ومَعلمات مسافة بادئة مختلفة. لا يمكن تعديل حدود الفقرات جزئيًا. عند تغيير حدود فقرة، يجب تحديد الحدود الجديدة بالكامل. |
border |
الحدّ الأيسر لهذه الفقرة في حال عدم ضبط القيمة، يتم اكتسابها من العنصر الرئيسي. لا يمكن تعديل حدود الفقرات جزئيًا. عند تغيير حدود فقرة، يجب تحديد الحدود الجديدة بالكامل. |
border |
الحدّ على يسار هذه الفقرة في حال عدم ضبط القيمة، يتم اكتسابها من العنصر الرئيسي. لا يمكن تعديل حدود الفقرات جزئيًا. عند تغيير حدود فقرة، يجب تحديد الحدود الجديدة بالكامل. |
indent |
مقدار المسافة البادئة للسطر الأول من الفقرة في حال عدم ضبط القيمة، يتم اكتسابها من العنصر الرئيسي. |
indent |
مقدار المسافة البادئة للفقرة على الجانب الذي يتوافق مع بداية النص، استنادًا إلى اتجاه الفقرة الحالي في حال عدم ضبط القيمة، يتم اكتسابها من العنصر الرئيسي. |
indent |
مقدار المسافة البادئة للفقرة على الجانب الذي يتوافق مع نهاية النص، استنادًا إلى اتجاه الفقرة الحالي. في حال عدم ضبط القيمة، يتم اكتسابها من العنصر الرئيسي. |
tab |
قائمة بمواضع توقف علامات التبويب لهذه الفقرة لا يتم اكتساب قائمة نقاط توقف علامات التبويب. هذا الموقع للقراءة فقط. |
keep |
ما إذا كان يجب عرض جميع أسطر الفقرة في الصفحة أو العمود نفسهَين إن أمكن في حال عدم ضبط القيمة، يتم اكتسابها من العنصر الرئيسي. |
keep |
ما إذا كان يجب وضع جزء على الأقل من هذه الفقرة في الصفحة أو العمود نفسهما اللذَين ستظهر فيهما الفقرة التالية، إن أمكن. في حال عدم ضبط القيمة، يتم اكتسابها من العنصر الرئيسي. |
avoid |
ما إذا كان يجب تجنُّب الفقرات التي تتضمّن فقرات قصيرة في أعلى الصفحة أو أسفلها في حال عدم ضبط القيمة، يتم اكتسابها من العنصر الرئيسي. |
shading |
تظليل الفقرة في حال عدم ضبط القيمة، يتم اكتسابها من العنصر الرئيسي. |
page |
ما إذا كان يجب أن تبدأ الفقرة الحالية دائمًا في بداية الصفحة في حال عدم ضبط القيمة، يتم اكتسابها من العنصر الرئيسي. يمكن أن تؤدي محاولة تعديل |
NamedStyleType
أنواع الأنماط المُعنوَنة
عمليات التعداد | |
---|---|
NAMED_STYLE_TYPE_UNSPECIFIED |
نوع النمط المُعنوَن غير محدّد. |
NORMAL_TEXT |
نص عادي |
TITLE |
العنوان |
SUBTITLE |
الترجمة. |
HEADING_1 |
العنوان 1. |
HEADING_2 |
العنوان 2. |
HEADING_3 |
العنوان 3. |
HEADING_4 |
العنوان 4 |
HEADING_5 |
العنوان 5. |
HEADING_6 |
العنوان 6 |
محاذاة
أنواع محاذاة النص لفقرة
عمليات التعداد | |
---|---|
ALIGNMENT_UNSPECIFIED |
يتم اكتساب محاذاة الفقرة من العنصر الرئيسي. |
START |
تتم محاذاة الفقرة مع بداية السطر. يتمّ محاذاة النص من اليسار إلى اليمين في حال كان من اليسار إلى اليمين، ويتمّ محاذاة النص من اليمين إلى اليسار في حال كان من اليمين إلى اليسار. |
CENTER |
الفقرة في المنتصف |
END |
يتم محاذاة الفقرة مع نهاية السطر. محاذاة جهة اليمين للنص من اليمين إلى اليسار، ومحاذاة جهة اليسار في الحالات الأخرى |
JUSTIFIED |
الفقرة مُعدَّة للعرض على يمين الصفحة. |
ContentDirection
يمكن أن يتدفق محتوى الاتجاهات.
عمليات التعداد | |
---|---|
CONTENT_DIRECTION_UNSPECIFIED |
لم يتم تحديد اتجاه المحتوى. |
LEFT_TO_RIGHT |
ينتقل المحتوى من اليسار إلى اليمين. |
RIGHT_TO_LEFT |
ينتقل المحتوى من اليمين إلى اليسار. |
SpacingMode
الأوضاع المختلفة لمسافات الفقرات
عمليات التعداد | |
---|---|
SPACING_MODE_UNSPECIFIED |
يتم اكتساب وضع المسافة من العنصر الرئيسي. |
NEVER_COLLAPSE |
يتم عرض تباعد الفقرات دائمًا. |
COLLAPSE_LISTS |
يتم حذف مسافات الفقرات بين عناصر القائمة. |
ParagraphBorder
إطار حول فقرة
تمثيل JSON |
---|
{ "color": { object ( |
الحقول | |
---|---|
color |
لون الحدود |
width |
عرض الحدود. |
padding |
المساحة الفارغة حول الحدود |
dash |
نمط الخطوط المتقطّعة للحدود |
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 ( |
الحقول | |
---|---|
offset |
الإزاحة بين موضع علامة التبويب هذا وهامش البدء |
alignment |
محاذاة هذا الفاصل في حال عدم ضبط القيمة، تكون القيمة التلقائية هي |
TabStopAlignment
محاذاة علامة التبويب
عمليات التعداد | |
---|---|
TAB_STOP_ALIGNMENT_UNSPECIFIED |
لم يتم تحديد محاذاة موضع علامة التبويب. |
START |
يتم محاذاة نقطة توقف علامة التبويب مع بداية السطر. هذا هو الخيار التلقائي. |
CENTER |
تتم محاذاة موضع علامة التبويب مع وسط السطر. |
END |
يتم محاذاة موضع علامة التبويب مع نهاية السطر. |
التظليل
تظليل فقرة
تمثيل JSON |
---|
{
"backgroundColor": {
object ( |
الحقول | |
---|---|
background |
لون خلفية تمويه هذه الفقرة. |
SuggestedParagraphStyle
تغيير مقترَح على ParagraphStyle
تمثيل JSON |
---|
{ "paragraphStyle": { object ( |
الحقول | |
---|---|
paragraph |
|
paragraph |
قناع يشير إلى الحقول التي تم تغييرها في |
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 ( |
الحقول | |
---|---|
heading |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
named |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
alignment |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
line |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
direction |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
spacing |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
space |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
space |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
border |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
border |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
border |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
border |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
border |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
indent |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
indent |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
indent |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
keep |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
keep |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
avoid |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
shading |
قناع يشير إلى الحقول التي تم تغييرها في |
page |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
ShadingSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في Shading
الأساسية في هذا التغيير المقترَح بالنسبة إلى أيّ حقل تم ضبطه على "صحيح"، تتوفّر قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{ "backgroundColorSuggested": boolean } |
الحقول | |
---|---|
background |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
تعداد نقطي
يصف النقطة في فقرة.
تمثيل JSON |
---|
{
"listId": string,
"nestingLevel": integer,
"textStyle": {
object ( |
الحقول | |
---|---|
list |
رقم تعريف القائمة التي تنتمي إليها هذه الفقرة. |
nesting |
مستوى تداخل هذه الفقرة في القائمة. |
text |
نمط النص الخاص بالفقرة الذي تم تطبيقه على هذه الفقرة |
SuggestedBullet
تغيير مقترَح على Bullet
تمثيل JSON |
---|
{ "bullet": { object ( |
الحقول | |
---|---|
bullet |
|
bullet |
قناع يشير إلى الحقول التي تم تغييرها في |
BulletSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في Bullet
الأساسية في هذا الاقتراح بالنسبة إلى أيّ حقل تم ضبطه على true، تتوفّر قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{
"listIdSuggested": boolean,
"nestingLevelSuggested": boolean,
"textStyleSuggestionState": {
object ( |
الحقول | |
---|---|
list |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
nesting |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
text |
قناع يشير إلى الحقول التي تم تغييرها في |
ObjectReferences
مجموعة من معرّفات العناصر
تمثيل JSON |
---|
{ "objectIds": [ string ] } |
الحقول | |
---|---|
object |
أرقام تعريف العناصر |
SectionBreak
StructuralElement
يمثّل فاصل قسم. القسم هو نطاق من المحتوى الذي يتضمّن SectionStyle
نفسه. يمثّل فاصل الأقسام بداية قسم جديد، وينطبق أسلوب القسم على القسم بعد فاصل الأقسام.
يبدأ نص المستند دائمًا بفاصل قسم.
تمثيل JSON |
---|
{
"suggestedInsertionIds": [
string
],
"suggestedDeletionIds": [
string
],
"sectionStyle": {
object ( |
الحقول | |
---|---|
suggested |
معرّفات الإدراج المقترَحة قد يتضمّن العنصر |
suggested |
أرقام تعريف الحذف المقترَحة إذا كان الحقل فارغًا، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذا المحتوى. |
section |
تنسيق القسم بعد فاصل القسم هذا. |
SectionStyle
النمط الذي ينطبق على قسم
تمثيل JSON |
---|
{ "columnProperties": [ { object ( |
الحقول | |
---|---|
column |
خصائص أعمدة القسم إذا كان القسم فارغًا، سيحتوي على عمود واحد يتضمّن السمات التلقائية في محرِّر "مستندات Google". يمكن تعديل قسم بحيث لا يحتوي على أكثر من 3 أعمدة. عند تعديل هذه السمة، يجب ضبط قيمة محدّدة. سيؤدي إلغاء ضبط هذه السمة إلى ظهور خطأ 400 "الخطأ 400: طلب غير صالح". |
column |
نمط فواصل الأعمدة يمكن ضبط هذا النمط حتى إذا كان هناك عمود واحد في القسم. عند تعديل هذه السمة، يجب ضبط قيمة محدّدة. يؤدي إلغاء ضبط هذه السمة إلى ظهور خطأ 400 "الخطأ 400: طلب غير صالح". |
content |
اتجاه المحتوى في هذا القسم. في حال عدم ضبط القيمة، تكون القيمة التلقائية هي عند تعديل هذه السمة، يجب ضبط قيمة محدّدة. يؤدي إلغاء ضبط هذه السمة إلى ظهور خطأ 400 "الخطأ 400: طلب غير صالح". |
margin |
هو هامش الصفحة العلوي للقسم. في حال عدم ضبط القيمة، تكون القيمة التلقائية هي عند تعديل هذه السمة، يجب ضبط قيمة محدّدة. يؤدي إلغاء ضبط هذه السمة إلى ظهور خطأ 400 "الخطأ 400: طلب غير صالح". |
margin |
هامش الصفحة السفلي للقسم في حال عدم ضبط القيمة، تكون القيمة التلقائية هي عند تعديل هذه السمة، يجب ضبط قيمة محدّدة. يؤدي إلغاء ضبط هذه السمة إلى ظهور خطأ 400 "الخطأ 400: طلب غير صالح". |
margin |
هامش الصفحة الأيمن للقسم في حال عدم ضبط القيمة، تكون القيمة التلقائية هي عند تعديل هذه السمة، يجب ضبط قيمة محدّدة. يؤدي إلغاء ضبط هذه السمة إلى ظهور خطأ 400 "الخطأ 400: طلب غير صالح". |
margin |
هامش الصفحة الأيسر للقسم في حال عدم ضبط القيمة، تكون القيمة التلقائية هي عند تعديل هذه السمة، يجب ضبط قيمة محدّدة. يؤدي إلغاء ضبط هذه السمة إلى ظهور خطأ 400 "الخطأ 400: طلب غير صالح". |
margin |
هامش عنوان القسم في حال عدم ضبط القيمة، تكون القيمة التلقائية هي عند تعديل هذه السمة، يجب ضبط قيمة محدّدة. يؤدي إلغاء ضبط هذه السمة إلى ظهور خطأ 400 "الخطأ 400: طلب غير صالح". |
margin |
هامش تذييل القسم. في حال عدم ضبط القيمة، تكون القيمة التلقائية هي عند تعديل هذه السمة، يجب ضبط قيمة محدّدة. يؤدي إلغاء ضبط هذه السمة إلى ظهور خطأ 400 "الخطأ 400: طلب غير صالح". |
section |
النتائج فقط. نوع القسم |
default |
رقم تعريف العنوان التلقائي. في حال عدم ضبط القيمة، يتم اكتسابها من سمة هذا الموقع للقراءة فقط. |
default |
معرّف التذييل التلقائي في حال عدم ضبط القيمة، يتم اكتسابها من هذا الموقع للقراءة فقط. |
first |
رقم تعريف العنوان المستخدَم للصفحة الأولى من القسم فقط. إذا كانت قيمة هذا الموقع للقراءة فقط. |
first |
رقم تعريف التذييل المستخدَم للصفحة الأولى من القسم فقط إذا كانت قيمة هذا الموقع للقراءة فقط. |
even |
معرّف العنوان المستخدَم للصفحات الزوجية فقط. إذا كانت قيمة هذا الموقع للقراءة فقط. |
even |
معرّف التذييل المستخدَم للصفحات الزوجية فقط إذا كانت قيمة هذا الموقع للقراءة فقط. |
use |
يشير إلى ما إذا كان سيتم استخدام معرّفات الرأس / التذييل للصفحة الأولى للصفحة الأولى من القسم. في حال عدم ضبطها، يتم اكتسابها من عند تعديل هذه السمة، يجب ضبط قيمة محدّدة. يؤدي إلغاء ضبط هذه السمة إلى ظهور خطأ 400 "الخطأ 400: طلب غير صالح". |
page |
رقم الصفحة التي يجب بدء احتساب عدد صفحات هذا القسم منها. في حال عدم ضبط هذا الخيار، يستمر ترقيم الصفحات من القسم السابق. إذا لم يتم ضبط القيمة في عند تعديل هذه السمة، يجب ضبط قيمة محدّدة. يؤدي إلغاء ضبط هذه السمة إلى ظهور خطأ 400 "الخطأ 400: طلب غير صالح". |
flip |
اختيارية: يشير إلى ما إذا كان سيتم قلب سمة عند تعديل هذه السمة، يجب ضبط قيمة محدّدة. يؤدي إلغاء ضبط هذه السمة إلى ظهور خطأ 400 "الخطأ 400: طلب غير صالح". |
SectionColumnProperties
السمات التي تنطبق على عمود القسم
تمثيل JSON |
---|
{ "width": { object ( |
الحقول | |
---|---|
width |
النتائج فقط. عرض العمود |
padding |
المسافة الفارغة في نهاية العمود |
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 |
عدد الأعمدة في الجدول من الممكن أن يكون الجدول غير مستطيل، لذلك قد تحتوي بعض الصفوف على عدد مختلف من الخلايا. |
table |
محتوى كل صف ونمطه |
suggested |
معرّفات الإدراج المقترَحة قد يتضمّن العنصر |
suggested |
أرقام تعريف الحذف المقترَحة إذا كان الحقل فارغًا، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذا المحتوى. |
table |
نمط الجدول. |
TableRow
محتوى صف ونمطه في Table
تمثيل JSON |
---|
{ "startIndex": integer, "endIndex": integer, "tableCells": [ { object ( |
الحقول | |
---|---|
start |
فهرس البدء المستند إلى الصفر لهذا الصف، بوحدات ترميز UTF-16 |
end |
فهرس النهاية المستند إلى الصفر لهذا الصف، حصريًا، في وحدات ترميز UTF-16 |
table |
محتوى كل خلية وأسلوبها في هذا الصف من الممكن أن يكون الجدول غير مستطيل، لذلك قد تحتوي بعض الصفوف على عدد مختلف من الخلايا مقارنةً بالصفوف الأخرى في الجدول نفسه. |
suggested |
معرّفات الإدراج المقترَحة قد يحتوي العنصر |
suggested |
أرقام تعريف الحذف المقترَحة إذا كان الحقل فارغًا، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذا المحتوى. |
table |
نمط صف الجدول. |
suggested |
يتغيّر النمط المقترَح إلى هذا الصف، مع تحديده حسب معرّف الاقتراح. |
TableCell
محتوى خلية وأسلوبها في Table
تمثيل JSON |
---|
{ "startIndex": integer, "endIndex": integer, "content": [ { object ( |
الحقول | |
---|---|
start |
فهرس البدء المستند إلى الصفر لهذه الخلية، بوحدات ترميز UTF-16 |
end |
فهرس النهاية المستند إلى الصفر لهذه الخلية، حصريًا، في وحدات ترميز UTF-16 |
content[] |
محتوى الخلية |
table |
أسلوب الخلية. |
suggested |
معرّفات الإدراج المقترَحة قد يحتوي العنصر |
suggested |
أرقام تعريف الحذف المقترَحة إذا كان الحقل فارغًا، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذا المحتوى. |
suggested |
التغييرات المقترَحة على أسلوب خلية الجدول، مرتّبة حسب رقم تعريف الاقتراح |
TableCellStyle
نمط TableCell
يتم تمثيل أنماط خلايا الجدول المُكتسَبة كحقول غير محدّدة في هذه الرسالة. يمكن أن يكتسب نمط خلية الجدول سمات من نمط الجدول.
تمثيل JSON |
---|
{ "rowSpan": integer, "columnSpan": integer, "backgroundColor": { object ( |
الحقول | |
---|---|
row |
نطاق الصف للخلية. هذا الموقع للقراءة فقط. |
column |
نطاق العمود للخلية هذا الموقع للقراءة فقط. |
background |
لون خلفية الخلية. |
border |
الحد الأيسر للخلية |
border |
الحد الأيمن للخلية |
border |
الحد العلوي للخلية |
border |
الحدّ السفلي للخلية |
padding |
المساحة الفارغة على يمين الخلية |
padding |
المساحة الفارغة على يسار الخلية |
padding |
المساحة المتروكة في أعلى الخلية |
padding |
المساحة المتروكة في أسفل الخلية |
content |
محاذاة المحتوى في خلية الجدول يتطابق المحاذاة التلقائية مع محاذاة خلايا الجدول التي تم إنشاؤها حديثًا في محرِّر "مستندات Google". |
TableCellBorder
حد حول خلية جدول
لا يمكن أن تكون حدود خلايا الجدول شفافة. لإخفاء حدود خلية الجدول، اضبط عرضها على 0.
تمثيل JSON |
---|
{ "color": { object ( |
الحقول | |
---|---|
color |
لون الحدود لا يمكن أن يكون هذا اللون شفافًا. |
width |
عرض الحدود. |
dash |
نمط الخطوط المتقطّعة للحدود |
ContentAlignment
أنواع محاذاة المحتوى
مشتق من مجموعة فرعية من قيم النوع البسيط "ST_TextAnchoringType" في القسم 20.1.10.59 من "تنسيقات ملفات Office Open XML - أساسيات ومرجع لغة الترميز"، الجزء 1 من الإصدار 4 من ECMA-376.
عمليات التعداد | |
---|---|
CONTENT_ALIGNMENT_UNSPECIFIED |
محاذاة محتوى غير محدّدة يتم اكتساب محاذاة المحتوى من العنصر الرئيسي إذا كان متوفّرًا. |
CONTENT_ALIGNMENT_UNSUPPORTED |
محاذاة محتوى غير متوافقة |
TOP |
محاذاة تُحاذا المحتوى مع أعلى حامل المحتوى يتوافق مع ECMA-376 ST_TextAnchoringType 't'. |
MIDDLE |
هو محاذاة تُحاذا المحتوى في منتصف حامل المحتوى. يتوافق مع ECMA-376 ST_TextAnchoringType 'ctr'. |
BOTTOM |
محاذاة تُحاذا المحتوى مع أسفل حامل المحتوى يتوافق مع ECMA-376 ST_TextAnchoringType 'b'. |
SuggestedTableCellStyle
تغيير مقترَح على TableCellStyle
تمثيل JSON |
---|
{ "tableCellStyle": { object ( |
الحقول | |
---|---|
table |
|
table |
قناع يشير إلى الحقول التي تم تغييرها في |
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 } |
الحقول | |
---|---|
row |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
column |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
background |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
border |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
border |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
border |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
border |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
padding |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
padding |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
padding |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
padding |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
content |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
TableRowStyle
الأنماط التي تنطبق على صف الجدول
تمثيل JSON |
---|
{
"minRowHeight": {
object ( |
الحقول | |
---|---|
min |
الحد الأدنى لارتفاع الصف سيتم عرض الصف في محرِّر "مستندات Google" بارتفاع يساوي هذه القيمة أو أكبر منها لعرض كل المحتوى في خلايا الصف. |
table |
ما إذا كان الصف هو عنوان جدول. |
prevent |
ما إذا كان لا يمكن أن يتدفق الصف خارج حدود الصفحة أو العمود |
SuggestedTableRowStyle
تغيير مقترَح على TableRowStyle
تمثيل JSON |
---|
{ "tableRowStyle": { object ( |
الحقول | |
---|---|
table |
|
table |
قناع يشير إلى الحقول التي تم تغييرها في |
TableRowStyleSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في TableRowStyle
الأساسية في هذا الاقتراح بالنسبة إلى أيّ حقل تم ضبطه على true، تتوفّر قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{ "minRowHeightSuggested": boolean } |
الحقول | |
---|---|
min |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
TableStyle
الأنماط التي تنطبق على جدول
تمثيل JSON |
---|
{
"tableColumnProperties": [
{
object ( |
الحقول | |
---|---|
table |
خصائص كل عمود يُرجى العلم أنّ الجداول في "مستندات Google" تحتوي على صفوف والصفوف تحتوي على خلايا، تمامًا مثل صفحات HTML. وبالتالي، يمكن العثور على خصائص الصف في |
TableColumnProperties
خصائص عمود في جدول
تمثيل JSON |
---|
{ "widthType": enum ( |
الحقول | |
---|---|
width |
نوع عرض العمود |
width |
عرض العمود يتمّ ضبطها عندما يكون |
WidthType
نوع عرض العمود
عمليات التعداد | |
---|---|
WIDTH_TYPE_UNSPECIFIED |
لم يتم تحديد نوع عرض العمود. |
EVENLY_DISTRIBUTED |
يتم توزيع عرض العمود بالتساوي بين الأعمدة الأخرى الموزّعة بالتساوي. يتم تحديد عرض العمود تلقائيًا وسيحصل على جزء متساوٍ من العرض المتبقي للجدول بعد احتساب جميع الأعمدة ذات العرض المحدّد. |
FIXED_WIDTH |
عرض عمود ثابت تحتوي السمة [width][google.apps.docs.v1.TableColumnProperties.width على عرض العمود. |
TableOfContents
StructuralElement
يمثّل جدول محتويات.
تمثيل JSON |
---|
{
"content": [
{
object ( |
الحقول | |
---|---|
content[] |
محتوى جدول المحتويات |
suggested |
معرّفات الإدراج المقترَحة قد يتضمّن العنصر |
suggested |
أرقام تعريف الحذف المقترَحة إذا كان الحقل فارغًا، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذا المحتوى. |
العنوان
عنوان مستند
تمثيل JSON |
---|
{
"headerId": string,
"content": [
{
object ( |
الحقول | |
---|---|
header |
رقم تعريف العنوان |
content[] |
محتوى العنوان تبدأ فهارس محتوى العنوان من الصفر. |
حاشية سفلية
حاشية سفلية لمستند
تمثيل JSON |
---|
{
"footnoteId": string,
"content": [
{
object ( |
الحقول | |
---|---|
footnote |
رقم تعريف الحاشية السفلية. |
content[] |
محتوى الحاشية السفلية تبدأ الفهارس لمحتوى الحاشية من الصفر. |
DocumentStyle
نمط المستند
تمثيل JSON |
---|
{ "background": { object ( |
الحقول | |
---|---|
background |
خلفية المستند لا يمكن أن يكون لون خلفية المستندات شفافًا. |
default |
رقم تعريف العنوان التلقائي. إذا لم يتم ضبطه، لن يكون هناك عنوان تلقائي. هذا الموقع للقراءة فقط. |
default |
معرّف التذييل التلقائي إذا لم يتم ضبطه، لن يظهر تذييل تلقائي. هذا الموقع للقراءة فقط. |
even |
معرّف العنوان المستخدَم للصفحات الزوجية فقط. تحدِّد قيمة هذا الموقع للقراءة فقط. |
even |
معرّف التذييل المستخدَم للصفحات الزوجية فقط تحدّد قيمة هذا الموقع للقراءة فقط. |
first |
رقم تعريف العنوان المستخدَم للصفحة الأولى فقط. وفي حال عدم ضبطه، لن يتوفّر عنوان فريد للصفحة الأولى. تحدِّد قيمة هذا الموقع للقراءة فقط. |
first |
رقم تعريف التذييل المستخدَم للصفحة الأولى فقط. في حال عدم ضبطه، لن يتوفّر تذييل فريد للصفحة الأولى. تحدّد قيمة هذا الموقع للقراءة فقط. |
use |
يشير إلى ما إذا كان سيتم استخدام معرّفات الرأس / التذييل للصفحة الأولى. |
use |
يشير إلى ما إذا كان سيتم استخدام معرّفات الرؤوس / التذييلات للصفحات الزوجية في الصفحات الزوجية. |
page |
رقم الصفحة التي يجب بدء احتساب عدد الصفحات منها. |
margin |
هامش الصفحة العلوي يؤدي تعديل هامش الصفحة العلوي في أسلوب المستند إلى محو هامش الصفحة العلوي في جميع أنماط الأقسام. |
margin |
هامش أسفل الصفحة. يؤدي تعديل هامش الصفحة السفلي في نمط المستند إلى محو هامش الصفحة السفلي في جميع أنماط الأقسام. |
margin |
هامش الصفحة الأيمن يؤدي تعديل هامش الصفحة الأيمن في نمط المستند إلى محو هامش الصفحة الأيمن في جميع أنماط الأقسام. وقد يؤدي ذلك أيضًا إلى تغيير حجم الأعمدة في جميع الأقسام. |
margin |
هامش الصفحة الأيسر يؤدي تعديل هامش الصفحة الأيسر في أسلوب المستند إلى محو هامش الصفحة الأيسر في جميع أنماط الأقسام. وقد يؤدي ذلك أيضًا إلى تغيير حجم الأعمدة في جميع الأقسام. |
page |
حجم صفحة في المستند |
margin |
مقدار المساحة بين أعلى الصفحة ومحتوى العنوان |
margin |
مقدار المساحة بين أسفل الصفحة ومحتوى التذييل |
use |
يشير إلى ما إذا كان يتم الالتزام بـ DocumentStyle هذا الموقع للقراءة فقط. |
flip |
اختيارية: يشير إلى ما إذا كان سيتم قلب سمات |
الخلفية
يمثّل خلفية المستند.
تمثيل JSON |
---|
{
"color": {
object ( |
الحقول | |
---|---|
color |
لون الخلفية |
الحجم
العرض والارتفاع
تمثيل JSON |
---|
{ "height": { object ( |
الحقول | |
---|---|
height |
ارتفاع الجسم |
width |
عرض الجسم |
SuggestedDocumentStyle
تغيير مقترَح على DocumentStyle
تمثيل JSON |
---|
{ "documentStyle": { object ( |
الحقول | |
---|---|
document |
|
document |
قناع يشير إلى الحقول التي تم تغييرها في |
DocumentStyleSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في DocumentStyle
الأساسية في هذا الاقتراح بالنسبة إلى أيّ حقل تم ضبطه على "صحيح"، تتوفّر قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{ "backgroundSuggestionState": { object ( |
الحقول | |
---|---|
background |
قناع يشير إلى الحقول التي تم تغييرها في |
default |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
default |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
even |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
even |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
first |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
first |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
use |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
use |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
page |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
margin |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
margin |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
margin |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
margin |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
page |
قناع يشير إلى الحقول التي تم تغييرها في [size] [google.apps.docs.v1.DocumentStyle.size] في هذا الاقتراح |
margin |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
margin |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
use |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
flip |
اختيارية: يشير إلى ما إذا كان هناك تغيير مقترَح على |
BackgroundSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في Background
الأساسية في هذا الاقتراح في أي حقل تم ضبطه على true، يكون لدى Backgound
قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{ "backgroundColorSuggested": boolean } |
الحقول | |
---|---|
background |
يشير إلى ما إذا تم تعديل لون الخلفية الحالي في هذا الاقتراح. |
SizeSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في Size
الأساسية في هذا الاقتراح في أي حقل تم ضبطه على true، يكون لدى Size
قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{ "heightSuggested": boolean, "widthSuggested": boolean } |
الحقول | |
---|---|
height |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
width |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
NamedStyles
الأنماط المُعنوَنة يمكن للفقرات في المستند اكتساب TextStyle
وParagraphStyle
من هذه الأنماط المُسمّاة.
تمثيل JSON |
---|
{
"styles": [
{
object ( |
الحقول | |
---|---|
styles[] |
الأنماط المُعنوَنة هناك إدخال لكل قيمة من قيم |
NamedStyle
نمط مُعنوَن يمكن للفقرات في المستند اكتساب TextStyle
وParagraphStyle
من هذا النمط المُعنوَن عندما يكون لها نوع النمط المُعنوَن نفسه.
تمثيل JSON |
---|
{ "namedStyleType": enum ( |
الحقول | |
---|---|
named |
نوع هذا النمط المُعنوَن |
text |
نمط النص لهذا النمط المُسمّى. |
paragraph |
نمط الفقرة لهذا النمط المُعنوَن. |
SuggestedNamedStyles
تغيير مقترَح على NamedStyles
تمثيل JSON |
---|
{ "namedStyles": { object ( |
الحقول | |
---|---|
named |
|
named |
قناع يشير إلى الحقول التي تم تغييرها في |
NamedStylesSuggestionState
حالة اقتراح رسالة NamedStyles
.
تمثيل JSON |
---|
{
"stylesSuggestionStates": [
{
object ( |
الحقول | |
---|---|
styles |
قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح في يتطابق ترتيب حالات اقتراح الأنماط المُسمّاة هذه مع ترتيب النمط المُسمّى المقابل ضمن اقتراح |
NamedStyleSuggestionState
حالة اقتراح لرسالة NamedStyle
تمثيل JSON |
---|
{ "namedStyleType": enum ( |
الحقول | |
---|---|
named |
نوع النمط المُسمّى الذي تتوافق معه حالة الاقتراح هذه. يتم توفير هذا الحقل لتسهيل مطابقة NamedStyleSuggestionState مع |
text |
قناع يشير إلى الحقول التي تم تغييرها في |
paragraph |
قناع يشير إلى الحقول التي تم تغييرها في |
قائمة
تمثّل القائمة سمات القائمة لمجموعة من الفقرات التي تنتمي جميعها إلى القائمة نفسها. تحتوي الفقرة التي تشكّل جزءًا من قائمة على إشارة إلى رقم تعريف القائمة في bullet
.
تمثيل JSON |
---|
{ "listProperties": { object ( |
الحقول | |
---|---|
list |
خصائص القائمة |
suggested |
التغييرات المقترَحة على خصائص القائمة، مرتَّبة حسب رقم تعريف الاقتراح |
suggested |
معرّف الإدراج المقترَح. إذا كانت فارغة، هذا يعني أنّها ليست إدراجًا مقترَحًا. |
suggested |
أرقام تعريف الحذف المقترَحة إذا كانت فارغة، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذه القائمة. |
ListProperties
خصائص list
التي تصف مظهر علامات النقاط والشعور بها التي تنتمي إلى فقرات مرتبطة بقائمة
تمثيل JSON |
---|
{
"nestingLevels": [
{
object ( |
الحقول | |
---|---|
nesting |
يصف خصائص النقاط في المستوى المرتبط. تحتوي القائمة على 9 مستويات كحد أقصى من التداخل، ويتوافق مستوى التداخل 0 مع المستوى الأعلى ومستوى التداخل 8 مع المستوى الأكثر تداخلاً. يتم عرض مستويات التداخل بترتيب تصاعدي، مع عرض المستوى الأقل تداخلًا أولاً. |
NestingLevel
يحتوي على سمات تصف مظهر قائمة نقطية وأسلوبها على مستوى معيّن من التداخل.
تمثيل JSON |
---|
{ "bulletAlignment": enum ( |
الحقول | |
---|---|
bullet |
محاذاة النقطة ضمن المساحة المخصّصة لعرضها |
glyph |
سلسلة التنسيق المستخدَمة في الرموز النقطية على مستوى التداخل هذا. يحتوي تنسيق الرمز المميّز على عنصر نائب واحد أو أكثر، ويتم استبدال هذه العناصر النائبة بالقيم المناسبة استنادًا إلى على سبيل المثال، يشير تنسيق الرمز
يمكن أن يحتوي تنسيق الرمز الرسومي على عناصر نائبة لمستوى الدمج الحالي بالإضافة إلى عناصر نائبة لمستويات الدمج الرئيسية. على سبيل المثال، يمكن أن تحتوي القائمة على تنسيق حرف رسومي
بالنسبة إلى مستويات التعشيش التي يتم ترتيبها، تعتمد السلسلة التي تستبدل العنصر النائب في تنسيق الرمز المميّز لفقرة معيّنة على ترتيب الفقرة ضمن القائمة. |
indent |
مقدار المسافة البادئة للسطر الأول من الفقرات في هذا المستوى من التداخل |
indent |
مقدار المسافة البادئة للفقرات في هذا المستوى من التداخل يتم تطبيقه على الجانب الذي يتوافق مع بداية النص، استنادًا إلى اتجاه محتوى الفقرة. |
text |
نمط نص الرموز النقطية في هذا المستوى من التداخل. |
start |
رقم عنصر القائمة الأول في مستوى الدمج هذا. يتم التعامل مع القيمة 0 على أنّها القيمة 1 في القوائم الأبجدية وقوائم الأرقام الرومانية. بالنسبة إلى القيمتَين 0 و1، ستبدأ قوائم الأحرف والأرقام الرومانية من يتم تجاهل هذه القيمة لمستويات التعشيش التي تحتوي على رموز غير مرتبة. |
حقل الربط glyph_kind نوع الرمز المميّز المستخدَم في الرموز النقطية تحدّد هذه السمة الرمز المصغّر للنقطة التي تحلّ محلّ العناصر النائبة في glyph_format . يمكن أن يكون glyph_kind واحدًا فقط مما يلي: |
|
glyph |
نوع الرمز المميّز المستخدَم في الرموز النقطية عند ترتيب الفقرات على هذا المستوى من التداخل يحدِّد نوع الرمز الرسومي نوع الرمز الرسومي المستخدَم لاستبدال العناصر النائبة داخل |
glyph |
رمز رمز مخصّص يستخدمه الرموز النقطية عندما تكون الفقرات في هذا المستوى من التداخل غير مرتبة. يحلّ رمز الرمز الجغرافي محلّ العناصر النائبة داخل |
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 ( |
الحقول | |
---|---|
list |
|
list |
قناع يشير إلى الحقول التي تم تغييرها في |
ListPropertiesSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في ListProperties
الأساسية في هذا الاقتراح بالنسبة إلى أيّ حقل تم ضبطه على "صحيح"، تتوفّر قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{
"nestingLevelsSuggestionStates": [
{
object ( |
الحقول | |
---|---|
nesting |
قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح في يتم عرض حالات اقتراح مستوى التداخل بترتيب تصاعدي لمستوى التداخل، مع عرض أقل مستوى تداخل أولاً. |
NestingLevelSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في NestingLevel
الأساسية في هذا الاقتراح بالنسبة إلى أيّ حقل تم ضبطه على "صحيح"، تتوفّر قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{
"bulletAlignmentSuggested": boolean,
"glyphTypeSuggested": boolean,
"glyphFormatSuggested": boolean,
"glyphSymbolSuggested": boolean,
"indentFirstLineSuggested": boolean,
"indentStartSuggested": boolean,
"textStyleSuggestionState": {
object ( |
الحقول | |
---|---|
bullet |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
glyph |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
glyph |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
glyph |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
indent |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
indent |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
text |
قناع يشير إلى الحقول التي تم تغييرها في |
start |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
NamedRanges
مجموعة من جميع NamedRange
في المستند التي تتشارك اسمًا معيّنًا
تمثيل JSON |
---|
{
"name": string,
"namedRanges": [
{
object ( |
الحقول | |
---|---|
name |
الاسم الذي يتشاركه جميع |
named |
|
NamedRange
مجموعة من Range
تتضمّن معرّف النطاق المُعنوَن نفسه
تسمح النطاقات المُسمّاة للمطوّرين بربط أجزاء من مستند بتصنيف عشوائي يحدّده المستخدم حتى يمكن قراءة محتوياتها أو تعديلها لاحقًا آليًا. يمكن أن يحتوي المستند على نطاقات مُسمّاة متعددة تحمل الاسم نفسه، ولكن لكل نطاق مُعنوَن رقم تعريف فريد.
يتم إنشاء نطاق مُعنوَن باستخدام رمز Range
واحد، ويؤدي المحتوى المُدرَج داخل نطاق مُعنوَن إلى توسيع هذا النطاق بشكل عام. ومع ذلك، يمكن أن تؤدي بعض التغييرات في المستند إلى تقسيم النطاق إلى نطاقات متعددة.
النطاقات المُعنوَنة ليست خاصة. يمكن لجميع التطبيقات والمتعاونين الذين لديهم إذن الوصول إلى المستند الاطّلاع على النطاقات المُسمّاة فيه.
تمثيل JSON |
---|
{
"namedRangeId": string,
"name": string,
"ranges": [
{
object ( |
الحقول | |
---|---|
named |
رقم تعريف النطاق المُعنوَن. |
name |
اسم النطاق المُعنوَن |
ranges[] |
النطاقات التي تنتمي إلى هذا النطاق المُعنوَن |
النطاق
تحدّد نطاقًا متّصلاً من النص.
تمثيل JSON |
---|
{ "segmentId": string, "startIndex": integer, "endIndex": integer, "tabId": string } |
الحقول | |
---|---|
segment |
رقم تعريف الرأس أو التذييل أو الحاشية السفلية الذي يتضمّن هذا النطاق يشير رقم تعريف المقطع الفارغ إلى نص المستند. |
start |
فهرس البدء المستند إلى الصفر لهذا النطاق، بوحدات ترميز UTF-16 في جميع الاستخدامات الحالية، يجب تقديم فهرس بداية. هذا الحقل هو Int32Value لاستيعاب حالات الاستخدام المستقبلية التي تتضمّن نطاقات مفتوحة. |
end |
فهرس النهاية المستند إلى الصفر لهذا النطاق، حصريًا، في وحدات ترميز UTF-16 في جميع الاستخدامات الحالية، يجب تقديم فهرس نهاية. هذا الحقل هو Int32Value لاستيعاب حالات الاستخدام المستقبلية التي تتضمّن نطاقات مفتوحة. |
tab |
علامة التبويب التي تحتوي على هذا النطاق عند حذف هذا العنصر، ينطبق الطلب على علامة التبويب الأولى. في مستند يحتوي على علامة تبويب واحدة:
في مستند يحتوي على علامات تبويب متعددة:
|
InlineObject
عنصر يظهر مضمّنًا مع النص يحتوي InlineObject على EmbeddedObject
مثل صورة.
تمثيل JSON |
---|
{ "objectId": string, "inlineObjectProperties": { object ( |
الحقول | |
---|---|
object |
رقم تعريف هذا العنصر المضمّن. يمكن استخدامها لتعديل سمات عنصر. |
inline |
سمات هذا العنصر المضمّن |
suggested |
التغييرات المقترَحة على خصائص الكائنات المضمّنة، مفعَّلة حسب رقم تعريف الاقتراح |
suggested |
معرّف الإدراج المقترَح. إذا كانت فارغة، هذا يعني أنّها ليست إدراجًا مقترَحًا. |
suggested |
أرقام تعريف الحذف المقترَحة إذا كان الحقل فارغًا، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذا المحتوى. |
InlineObjectProperties
خصائص InlineObject
تمثيل JSON |
---|
{
"embeddedObject": {
object ( |
الحقول | |
---|---|
embedded |
العنصر المضمّن لهذا العنصر المضمّن. |
EmbeddedObject
عنصر مضمّن في المستند
تمثيل JSON |
---|
{ "title": string, "description": string, "embeddedObjectBorder": { object ( |
الحقول | |
---|---|
title |
عنوان العنصر المضمّن. يتم دمج |
description |
وصف العنصر المضمّن يتم دمج |
embedded |
حدود الجسم المضمّن |
size |
الحجم الظاهر للصورة بعد الاقتصاص |
margin |
الهامش العلوي للكائن المضمّن |
margin |
الهامش السفلي للكائن المضمّن |
margin |
الهامش الأيمن للعنصر المضمّن |
margin |
الهامش الأيسر للكائن المضمّن |
linked |
إشارة إلى محتوى المصدر الخارجي المرتبط على سبيل المثال، يحتوي على إشارة إلى الرسم البياني المصدر في "جداول بيانات Google" عندما يكون العنصر المضمّن رسمًا بيانيًا مرتبطًا. إذا لم يتم ضبطه، لن يكون الكائن المضمّن مرتبطًا. |
حقل الربط properties السمات الخاصة بكل نوع من أنواع الكائنات المضمّنة يمكن أن يكون properties واحدًا فقط مما يلي: |
|
embedded |
خصائص رسم مضمّن |
image |
خصائص الصورة |
EmbeddedDrawingProperties
لا يحتوي هذا النوع على أي حقول.
سمات رسم مضمّن تُستخدَم للتمييز بين أنواع الكائنات الرسم المضمّن هو رسم تم إنشاؤه وتعديله داخل مستند. يُرجى العلم أنّ التفاصيل المفصّلة غير متاحة.
ImageProperties
خصائص الصورة
تمثيل JSON |
---|
{
"contentUri": string,
"sourceUri": string,
"brightness": number,
"contrast": number,
"transparency": number,
"cropProperties": {
object ( |
الحقول | |
---|---|
content |
معرّف موارد منتظم (URI) للصورة مع مدة صلاحية تلقائية تبلغ 30 دقيقة يتم وضع علامة على عنوان URL هذا بالحساب الخاص بمقدّم الطلب. يمكن لأي مستخدم لديه معرّف URI الوصول إلى الصورة بفعالية بصفته مقدّم الطلب الأصلي. قد لا تتمكّن من الوصول إلى الصورة في حال تغيير إعدادات مشاركة المستند. |
source |
معرّف الموارد المنتظم (URI) المصدر هو معرّف الموارد المنتظم المستخدَم لإدراج الصورة. يمكن أن يكون معرّف الموارد المنتظم (URI) للمصدر فارغًا. |
brightness |
تأثير سطوع الصورة. يجب أن تكون القيمة في النطاق [-1.0, 1.0]، حيث تعني القيمة 0 عدم وجود تأثير. |
contrast |
تأثير التباين في الصورة يجب أن تكون القيمة في النطاق [-1.0, 1.0]، حيث تعني القيمة 0 عدم وجود تأثير. |
transparency |
تأثير شفافية الصورة. يجب أن تكون القيمة في النطاق [0.0, 1.0]، حيث يشير الصفر إلى عدم وجود تأثير ويشير الرقم 1 إلى الشفافية. |
crop |
خصائص الاقتصاص للصورة |
angle |
زاوية تدوير الصورة في اتجاه عقارب الساعة، بالراديان |
CropProperties
خصائص اقتصاص صورة
يتم تمثيل مستطيل الاقتصاص باستخدام Offsets الكسور من الحواف الأربعة للمحتوى الأصلي.
- إذا كانت القيمة المطلقة للعنصر في النطاق (0, 1)، يتم وضع الحافة المقابلة لمستطيل الاقتصاص داخل المستطيل الحدودي الأصلي للصورة.
- إذا كانت الإزاحة سالبة أو أكبر من 1، يتم وضع الحافة المقابلة لمستطيل الاقتصاص خارج المستطيل الحدودي الأصلي للصورة.
- إذا كانت جميع العناصر المُحوَّلة بزاوية 360 درجة ودرجة الدوران 0، لن يتم اقتصاص الصورة.
تمثيل JSON |
---|
{ "offsetLeft": number, "offsetRight": number, "offsetTop": number, "offsetBottom": number, "angle": number } |
الحقول | |
---|---|
offset |
يحدِّد هذا المقياس المسافة التي تفصل بين الحافة اليسرى لمستطيل الاقتصاص والحافة اليسرى للمحتوى الأصلي كنسبة مئوية من عرض المحتوى الأصلي. |
offset |
يحدِّد هذا المقياس مدى بُعد الحافة اليمنى لمستطيل الاقتصاص عن الحافة اليمنى للمحتوى الأصلي كنسبة مئوية من عرض المحتوى الأصلي. |
offset |
يحدِّد هذا المقياس المسافة التي تفصل بين أعلى مستطيل الاقتصاص وأعلى المحتوى الأصلي كنسبة مئوية من ارتفاع المحتوى الأصلي. |
offset |
يحدِّد هذا المقياس المسافة بين الحافة السفلية لمربّع الاقتصاص والحافة السفلية للمحتوى الأصلي كنسبة مئوية من ارتفاع المحتوى الأصلي. |
angle |
زاوية الدوران باتجاه عقارب الساعة لمستطيل الاقتصاص حول مركزه، بوحدات الراديان يتم تطبيق التدوير بعد الفواصل. |
EmbeddedObjectBorder
إطار حول EmbeddedObject
تمثيل JSON |
---|
{ "color": { object ( |
الحقول | |
---|---|
color |
لون الحدود |
width |
عرض الحدود. |
dash |
نمط الخطوط المتقطّعة للحدود |
property |
حالة سمة الحدود |
PropertyState
الحالات المحتملة لموقع جغرافي
عمليات التعداد | |
---|---|
RENDERED |
إذا كانت حالة السمة هي RENDERED، سيحتوي العنصر على السمة المقابلة عند عرضها في المستند. هذه هي القيمة الافتراضية. |
NOT_RENDERED |
إذا كانت حالة السمة هي NOT_RENDERED، يعني ذلك أنّ العنصر لا يحتوي على السمة المقابلة عند عرضه في المستند. |
LinkedContentReference
إشارة إلى محتوى المصدر الخارجي المرتبط
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الربط reference المرجع الخاص بنوع المحتوى المرتبط يمكن أن يكون reference واحدًا فقط مما يلي: |
|
sheets |
إشارة إلى الرسم البياني المرتبط. |
SheetsChartReference
إشارة إلى رسم بياني مرتبط تم تضمينه من "جداول بيانات Google"
تمثيل JSON |
---|
{ "spreadsheetId": string, "chartId": integer } |
الحقول | |
---|---|
spreadsheet |
رقم تعريف جدول بيانات "جداول بيانات Google" الذي يحتوي على الرسم البياني المصدر |
chart |
معرّف الرسم البياني المحدّد في جدول بيانات "جداول بيانات Google" المضمّن |
SuggestedInlineObjectProperties
تغيير مقترَح على InlineObjectProperties
تمثيل JSON |
---|
{ "inlineObjectProperties": { object ( |
الحقول | |
---|---|
inline |
|
inline |
قناع يشير إلى الحقول التي تم تغييرها في |
InlineObjectPropertiesSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في InlineObjectProperties
الأساسية في هذا الاقتراح بالنسبة إلى أيّ حقل تم ضبطه على true، تتوفّر قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{
"embeddedObjectSuggestionState": {
object ( |
الحقول | |
---|---|
embedded |
قناع يشير إلى الحقول التي تم تغييرها في |
EmbeddedObjectSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في EmbeddedObject
الأساسية في هذا الاقتراح بالنسبة إلى أيّ حقل تم ضبطه على true، تتوفّر قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{ "embeddedDrawingPropertiesSuggestionState": { object ( |
الحقول | |
---|---|
embedded |
قناع يشير إلى الحقول التي تم تغييرها في |
image |
قناع يشير إلى الحقول التي تم تغييرها في |
title |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
description |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
embedded |
قناع يشير إلى الحقول التي تم تغييرها في |
size |
قناع يشير إلى الحقول التي تم تغييرها في |
margin |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
margin |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
margin |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
margin |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
linked |
قناع يشير إلى الحقول التي تم تغييرها في |
EmbeddedDrawingPropertiesSuggestionState
لا يحتوي هذا النوع على أي حقول.
قناع يشير إلى الحقول التي تم تغييرها في EmbeddedDrawingProperties
الأساسية في هذا الاقتراح بالنسبة إلى أيّ حقل تم ضبطه على "صحيح"، تتوفّر قيمة مقترَحة جديدة.
ImagePropertiesSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في ImageProperties
الأساسية في هذا الاقتراح بالنسبة إلى أيّ حقل تم ضبطه على "صحيح"، تتوفّر قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{
"contentUriSuggested": boolean,
"sourceUriSuggested": boolean,
"brightnessSuggested": boolean,
"contrastSuggested": boolean,
"transparencySuggested": boolean,
"cropPropertiesSuggestionState": {
object ( |
الحقول | |
---|---|
content |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
source |
يشير إلى ما إذا كان هناك تغيير مقترَح على [sourceUri] [google.apps.docs.v1.EmbeddedObject.source_uri]. |
brightness |
يشير إلى ما إذا كان هناك تغيير مقترَح على [brightness] [google.apps.docs.v1.EmbeddedObject.brightness]. |
contrast |
يشير إلى ما إذا كان هناك تغيير مقترَح على [contrast] [google.apps.docs.v1.EmbeddedObject.contrast]. |
transparency |
يشير إلى ما إذا كان هناك تغيير مقترَح على [الشفافية] [google.apps.docs.v1.EmbeddedObject.transparency]. |
crop |
قناع يشير إلى الحقول التي تم تغييرها في |
angle |
يشير إلى ما إذا كان هناك تغيير مقترَح على [angle] [google.apps.docs.v1.EmbeddedObject.angle]. |
CropPropertiesSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في CropProperties
الأساسية في هذا الاقتراح بالنسبة إلى أيّ حقل تم ضبطه على true، تتوفّر قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{ "offsetLeftSuggested": boolean, "offsetRightSuggested": boolean, "offsetTopSuggested": boolean, "offsetBottomSuggested": boolean, "angleSuggested": boolean } |
الحقول | |
---|---|
offset |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
offset |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
offset |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
offset |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
angle |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
EmbeddedObjectBorderSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في EmbeddedObjectBorder
الأساسية في هذا الاقتراح بالنسبة إلى أيّ حقل تم ضبطه على "صحيح"، تتوفّر قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{ "colorSuggested": boolean, "widthSuggested": boolean, "dashStyleSuggested": boolean, "propertyStateSuggested": boolean } |
الحقول | |
---|---|
color |
يشير إلى ما إذا كان هناك تغيير مقترَح على [color] [google.apps.docs.v1.EmbeddedBorderObject.color]. |
width |
يشير إلى ما إذا كان هناك تغيير مقترَح على [width] [google.apps.docs.v1.EmbeddedBorderObject.width]. |
dash |
يشير إلى ما إذا كان هناك تغيير مقترَح على [dashStyle] [google.apps.docs.v1.EmbeddedBorderObject.dash_style]. |
property |
يشير إلى ما إذا كان هناك تغيير مقترَح على [propertyState] [google.apps.docs.v1.EmbeddedBorderObject.property_state]. |
LinkedContentReferenceSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في LinkedContentReference
الأساسية في هذا الاقتراح بالنسبة إلى أيّ حقل تم ضبطه على "صحيح"، تتوفّر قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{
"sheetsChartReferenceSuggestionState": {
object ( |
الحقول | |
---|---|
sheets |
قناع يشير إلى الحقول التي تم تغييرها في |
SheetsChartReferenceSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في SheetsChartReference
الأساسية في هذا الاقتراح بالنسبة إلى أيّ حقل تم ضبطه على "صحيح"، تتوفّر قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{ "spreadsheetIdSuggested": boolean, "chartIdSuggested": boolean } |
الحقول | |
---|---|
spreadsheet |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
chart |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
PositionedObject
عنصر مرتبط بعنصر Paragraph
ويتم وضعه نسبةً إلى بداية الفقرة. يحتوي العنصر PositionedObject على EmbeddedObject
، مثل صورة.
تمثيل JSON |
---|
{ "objectId": string, "positionedObjectProperties": { object ( |
الحقول | |
---|---|
object |
رقم تعريف هذا العنصر الذي تمّ تحديد موضع له. |
positioned |
خصائص هذا العنصر الذي تمّ تحديد موقعه |
suggested |
التغييرات المقترَحة على خصائص الكائنات التي تمّ وضعها، مع ترتيبها حسب معرّف الاقتراح |
suggested |
معرّف الإدراج المقترَح. إذا كانت فارغة، هذا يعني أنّها ليست إدراجًا مقترَحًا. |
suggested |
أرقام تعريف الحذف المقترَحة إذا كان الحقل فارغًا، يعني ذلك أنّه ما مِن عمليات حذف مقترَحة لهذا المحتوى. |
PositionedObjectProperties
خصائص PositionedObject
تمثيل JSON |
---|
{ "positioning": { object ( |
الحقول | |
---|---|
positioning |
موضع هذا العنصر الذي تمّ تحديد موضعه بالنسبة إلى السطر الجديد من |
embedded |
العنصر المضمّن لهذا العنصر المُحدَّد الموقع |
PositionedObjectPositioning
موضع PositionedObject
يتم وضع الجسم المُحدَّد بالنسبة إلى بداية Paragraph
المرتبط به.
تمثيل JSON |
---|
{ "layout": enum ( |
الحقول | |
---|---|
layout |
تنسيق هذا العنصر الذي تم وضعه |
left |
إزاحة الحافة اليسرى للعنصر الذي تمّ وضعه نسبةً إلى بداية |
top |
إزاحة الحافة العلوية للجسم الذي تمّ تحديد موضعه بالنسبة إلى بداية |
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 ( |
الحقول | |
---|---|
positioned |
|
positioned |
قناع يشير إلى الحقول التي تم تغييرها في |
PositionedObjectPropertiesSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في PositionedObjectProperties
الأساسية في هذا الاقتراح بالنسبة إلى أيّ حقل تم ضبطه على "صحيح"، تتوفّر قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{ "positioningSuggestionState": { object ( |
الحقول | |
---|---|
positioning |
قناع يشير إلى الحقول التي تم تغييرها في |
embedded |
قناع يشير إلى الحقول التي تم تغييرها في |
PositionedObjectPositioningSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في PositionedObjectPositioning
الأساسية في هذا الاقتراح بالنسبة إلى أيّ حقل تم ضبطه على "صحيح"، تتوفّر قيمة مقترَحة جديدة.
تمثيل JSON |
---|
{ "layoutSuggested": boolean, "leftOffsetSuggested": boolean, "topOffsetSuggested": boolean } |
الحقول | |
---|---|
layout |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
left |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
top |
يشير إلى ما إذا كان هناك تغيير مقترَح على |
SuggestionsViewMode
وضع عرض الاقتراحات الذي تم تطبيقه على المستند ويشير إلى كيفية عرض التغييرات المقترَحة يوفّر هذا الخيار خيارات لقراءة المستند مع جميع الاقتراحات المضمّنة أو المقبولة أو المرفوضة.
عمليات التعداد | |
---|---|
DEFAULT_FOR_CURRENT_ACCESS |
يعتمد SuggestionsViewMode المُطبَّق على المستند الذي تم إرجاعه على مستوى وصول المستخدم الحالي. إذا كان لدى المستخدم إذن بالاطّلاع فقط، يتم تطبيق PREVIEW_WITHOUT_SUGGESTIONS . وبخلاف ذلك، يتم تطبيق SUGGESTIONS_INLINE . هذا هو وضع عرض الاقتراحات التلقائي. |
SUGGESTIONS_INLINE |
يحتوي المستند الذي تم إرجاعه على اقتراحات مضمّنة. سيتم تمييز التغييرات المقترَحة عن المحتوى الأساسي في المستند. ستؤدي طلبات استرداد مستند باستخدام هذا الوضع إلى عرض خطأ 403 إذا لم يكن لدى المستخدم إذن بعرض التغييرات المقترَحة. |
PREVIEW_SUGGESTIONS_ACCEPTED |
المستند الذي يتم إرجاعه هو معاينة تم قبول جميع التغييرات المقترَحة فيها. ستؤدي طلبات استرداد مستند باستخدام هذا الوضع إلى عرض خطأ 403 إذا لم يكن لدى المستخدم إذن بعرض التغييرات المقترَحة. |
PREVIEW_WITHOUT_SUGGESTIONS |
المستند الذي يتم إرجاعه هو معاينة تم رفض جميع التغييرات المقترَحة فيها إذا كانت هناك أي اقتراحات في المستند. |
الطُرق |
|
---|---|
|
تُطبِّق تعديلًا واحدًا أو أكثر على المستند. |
|
ينشئ مستندًا فارغًا باستخدام العنوان الوارد في الطلب. |
|
تحصل على أحدث إصدار من المستند المحدّد. |