- المورد: مستند
- النص الأساسي
- عنصر بنيوي
- الفقرة
- عنصر الفقرة
- TextRun
- نمط النص
- اللون الاختياري
- اللون
- لون RgbColor
- السمة
- الوحدة
- weightedFontFamily
- المرجع الأساسي
- الرابط
- SuggestedTextStyle
- TextStyleSuggestionState
- النص التلقائي
- النوع
- فاصل صفحات
- فاصل أعمدة
- حاشية سفلية
- قاعدة أفقية
- المعادلة
- InlineObjectElement
- الشخص
- PersonProperties
- الرابط
- RichLinkProperties
- نمط الفقرة
- NamedStyleType
- المحاذاة
- ContentDirection
- SpacingMode
- ParagraphBorder:
- DashStyle
- TabStop
- محاذاة علامات التبويب
- تظليل
- SuggestParagraphStyle
- ParagraphStyleSuggestionState
- ShadingSuggestionState
- تعداد نقطي
- تعداد نقطي مقترَح
- BulletSuggestionState
- ObjectReferences
- sectionBreak
- sectionStyle
- sectionColumnProperties
- ColumnSeparatorStyle
- sectionType
- جدول
- Tablerow
- TableCell
- TableCellStyle
- TableCellBorder
- محاذاة المحتوى
- SuggestedTableCellStyle
- TableCellStyleSuggestionState
- TablerowStyle
- SuggestedTablerowStyle
- TablerowStyleSuggestionState
- TableStyle
- TableColumnProperties
- widthType (نوع العرض)
- جدول المحتويات
- العنوان
- التذييل
- حاشية سفلية
- DocumentStyle
- الخلفية
- المقاس
- SuggestedDocumentStyle
- DocumentStyleSuggestionState
- BackgroundSuggestionState
- SizeSuggestionState
- NamedStyles
- NamedStyle
- SuggestedNamedStyles
- NamedStylesSuggestionState
- NamedStyleSuggestionState
- القائمة
- ListProperties:
- NestingLevel
- محاذاة التعداد النقطي
- GlyphType
- SuggestedListProperties
- ListPropertiesSuggestionState
- NestingLevelSuggestionState
- نطاقات الأسماء
- نطاق الأسماء
- النطاق
- وضع عرض الاقتراحات
- InlineObject
- InlineObjectProperties
- inlineObject
- inlineDrawingProperties
- خصائص الصور
- CropProperties
- inlineObjectBorder
- PropertyState
- LinkedContentReference
- SheetsChartReference
- SuggestedInlineObjectProperties (الخصائص المقترَحة)
- InlineObjectPropertiesSuggestionState
- inlineObjectSuggestionState
- inlineDrawingPropertiesSuggestionState
- ImagePropertiesSuggestionState
- CropPropertiesSuggestionState
- embeddedObjectBorderSuggestionState
- LinkedContentReferenceSuggestionState
- SheetsChartReferenceSuggestionState
- PositionedObject
- PositionedObjectProperties
- PositionedObjectPositioning
- PositionedObjectLayout
- SuggestedPositionedObjectProperties
- PositionedObjectPropertiesSuggestionState
- PositionedObjectPositioningSuggestionState
- الطُرق
المورد: مستند
مستند "مستندات Google"
تمثيل JSON |
---|
{ "documentId": string, "title": string, "body": { object ( |
الحقول | |
---|---|
documentId |
إخراج فقط. رقم تعريف المستند. |
title |
تمثّل هذه السمة عنوان المستند. |
body |
إخراج فقط. النص الأساسي للمستند. |
headers |
إخراج فقط. هي العناوين في المستند، المرتبطة برقم تعريف العنوان. |
footers |
إخراج فقط. التذييلات في المستند، المرتبطة بمعرّف التذييل. |
footnotes |
إخراج فقط. الحواشي السفلية في المستند، مرتبطة بمعرّف الحاشية السفلية. |
documentStyle |
إخراج فقط. نمط المستند |
suggestedDocumentStyleChanges |
إخراج فقط. التغييرات المقترَحة على نمط المستند، استنادًا إلى رقم تعريف الاقتراح |
namedStyles |
إخراج فقط. الأنماط المسماة للمستند. |
suggestedNamedStylesChanges |
إخراج فقط. التغييرات المقترَحة على الأنماط المُعنوَنة في المستند، استنادًا إلى رقم تعريف الاقتراح |
lists |
إخراج فقط. القوائم في المستند، استنادًا إلى رقم تعريف القائمة |
namedRanges |
إخراج فقط. النطاقات المُعنونة في المستند، مرتَّبة حسب الاسم. |
revisionId |
إخراج فقط. معرّف النسخة السابقة للمستند. يمكن استخدامها في طلبات التعديل لتحديد النسخة السابقة من المستند التي سيتم تطبيق التعديلات عليها وكيف يجب أن يتصرف الطلب إذا كان المستند قد تم تعديله منذ هذه المراجعة. لا تتم تعبئتها إلا إذا كان المستخدم لديه الإذن بتعديل المستند. معرف النسخة السابقة ليس رقمًا تسلسليًا ولكنه سلسلة مبهمة. قد يتغير تنسيق معرّف النسخة السابقة بمرور الوقت. يمكن ضمان صلاحية رقم تعريف النسخة السابقة الذي تم إرجاعه لمدة 24 ساعة بعد إرجاعه، ولا يمكن مشاركته بين المستخدمين. إذا لم يتم تغيير معرف النسخة السابقة بين عمليات الاستدعاء، فهذا يعني أن المستند لم يتم تغييره. وفي المقابل، عادةً ما يعني تغيير المعرّف (للمستند نفسه والمستخدم نفسه) أنّه قد تم تعديل المستند. ومع ذلك، قد يرجع تغيير المعرّف أيضًا إلى عوامل داخلية، مثل التغييرات في تنسيق المعرّف. |
suggestionsViewMode |
إخراج فقط. تم تطبيق وضع عرض الاقتراحات على المستند. ملاحظة: عند تعديل مستند، يجب أن تستند التغييرات إلى مستند آخر يتضمّن |
inlineObjects |
إخراج فقط. الكائنات المضمّنة في المستند، المرتبطة بمعرّف الكائن. |
positionedObjects |
إخراج فقط. العناصر الموضوعة في المستند، المرتبطة برقم تعريف العنصر |
النص الأساسي
نص المستند.
يحتوي النص عادةً على محتوى المستند الكامل باستثناء headers
وfooters
وfootnotes
.
تمثيل JSON |
---|
{
"content": [
{
object ( |
الحقول | |
---|---|
content[] |
محتوى النص وتبدأ فهارس محتوى النص الأساسي من صفر. |
عنصر هيكل
يصف العنصر الهيكلي المحتوى الذي يوفر هيكلاً للوثيقة.
تمثيل 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"). |
تشغيل النص
تمثّل هذه السمة ParagraphElement
سلسلة من النصوص التي لها النمط نفسه.
تمثيل JSON |
---|
{ "content": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
الحقول | |
---|---|
content |
نص هذا التشغيل. يتم استبدال أي عناصر غير نصية في التشغيل بحرف Unicode U+E907. |
suggestedInsertionIds[] |
أرقام تعريف الإدراج المُقترَحة قد يحتوي |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترحة. إذا كان الحقل فارغًا، لن يتم اقتراح عمليات حذف لهذا المحتوى. |
textStyle |
نمط النص لهذا التشغيل. |
suggestedTextStyleChanges |
يتغير نمط النص المقترح في عملية التشغيل هذه، استنادًا إلى رقم تعريف الاقتراح. |
نمط النص
تمثل النمط الذي يمكن تطبيقه على النص.
يتم تمثيل أنماط النص المكتسَبة كحقول لم يتم ضبطها في هذه الرسالة. يعتمد عنصر رئيسي لنمط النص على مكان تعريف النمط:
- يتم اكتساب نمط TextStyle للنص في
Paragraph
من العنصرnamed style type
المقابل للفقرة. - يكتسب TextStyle على
named style
من النمطnormal text
المُسمّى. - يتم اكتساب نمط النص للنمط المُسمّى
normal text
من النمط التلقائي للنص في أداة تحرير "مستندات Google". - قد يكتسب TextStyle في عنصر
Paragraph
المتوفّر في جدول نمط النص الخاص به من نمط الجدول.
إذا لم يكتسب نمط النص من عنصر رئيسي، ستؤدي الحقول التي يتم إلغاء ضبطها إلى إعادة النمط إلى قيمة تطابق الإعدادات التلقائية في أداة تحرير المستندات.
تمثيل JSON |
---|
{ "bold": boolean, "italic": boolean, "underline": boolean, "strikethrough": boolean, "smallCaps": boolean, "backgroundColor": { object ( |
الحقول | |
---|---|
bold |
يوضّح هذا الإعداد ما إذا كان النص غامقًا أم لا. |
italic |
تحديد ما إذا كان النص مائلاً أم لا |
underline |
تحديد ما إذا كان النص مسطّرًا أم لا |
strikethrough |
يشير ذلك إلى ما إذا كان النص يتوسطه خط. |
smallCaps |
ما إذا كان النص مكتوبًا بأحرف كبيرة (في حال الكتابة بلغة أجنبية) |
backgroundColor |
لون خلفية النص وفي حال ضبط هذه السياسة، سيكون اللون إما نموذج أحمر أخضر أزرق أو شفاف، بناءً على الحقل |
foregroundColor |
لون المقدمة للنص. وفي حال ضبط هذه السياسة، سيكون اللون إما نموذج أحمر أخضر أزرق أو شفاف، بناءً على الحقل |
fontSize |
حجم خط النص. |
weightedFontFamily |
مجموعة الخطوط وكثافة النص المعروضة في حال تحديد طلب تعديل قيم لكل من وإذا لم يتم ضبط سياسة في حال ضبط سياسة |
baselineOffset |
إزاحة رأسية للنص من موضعه العادي إنّ النص الذي يتضمّن إزاحة أساسية |
link |
وجهة الرابط التشعبي للنص. وفي حال ترك هذه السياسة بدون ضبط، لن يكون هناك رابط. لا يتم اكتساب الروابط من النص الرئيسي. يؤدي تغيير الرابط في طلب تعديل إلى إجراء بعض التغييرات الأخرى على نمط النص في النطاق:
|
اللون الاختياري
لون يمكن أن يكون إما معتمًا بالكامل أو شفافًا تمامًا.
تمثيل JSON |
---|
{
"color": {
object ( |
الحقول | |
---|---|
color |
في حال ضبطها، سيتم استخدام هذا اللون كلون معتم. في حال ترك هذه السياسة بدون ضبط، سيمثّل هذا اللون لونًا شفافًا. |
اللون
لون خالص.
تمثيل JSON |
---|
{
"rgbColor": {
object ( |
الحقول | |
---|---|
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 |
كثافة الخط. يمكن أن يحتوي هذا الحقل على أي قيمة بمضاعفة القيمة التلقائية هي يشكل سمك الخط مكوّنًا واحدًا فقط من سمك الخط المعروض. إنّ تركيبة من
|
إزاحة خط الأساس
الطرق التي يمكن بها إزاحة النص عموديًا عن موضعه العادي.
عمليات التعداد | |
---|---|
BASELINE_OFFSET_UNSPECIFIED |
يتم اكتساب إزاحة مرجعية للنص من الأصل. |
NONE |
لم تتم إزاحة النص عموديًا. |
SUPERSCRIPT |
تمت إزاحة النص عموديًا لأعلى (فوق). |
SUBSCRIPT |
تتم إزاحة النص عموديًا لأسفل (نص منخفض). |
رابط
يشير إلى جزء آخر من مستند أو مورد عنوان URL خارجي.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد destination . وجهة الرابط. يمكن أن تكون السمة "destination " واحدة فقط مما يلي: |
|
url |
عنوان URL خارجي. |
bookmarkId |
معرّف الإشارة المرجعية في هذا المستند |
headingId |
معرّف عنوان في هذا المستند |
نمط النص المقترح
تغيير مقترح على 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 |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
نص تلقائي
تمثّل هذه السمة ParagraphElement
مكانًا في النص يتم استبداله ديناميكيًا بمحتوى يمكن أن يتغيّر بمرور الوقت، مثل رقم صفحة.
تمثيل JSON |
---|
{ "type": enum ( |
الحقول | |
---|---|
type |
نوع هذا النص التلقائي |
suggestedInsertionIds[] |
أرقام تعريف الإدراج المُقترَحة قد يحتوي |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترحة. إذا كان الحقل فارغًا، لن يتم اقتراح عمليات حذف لهذا المحتوى. |
textStyle |
نمط النص لهذا النص التلقائي. |
suggestedTextStyleChanges |
يتغيّر نمط النص المقترَح في هذا النص التلقائي، استنادًا إلى رقم تعريف الاقتراح. |
النوع
أنواع النصوص التلقائية.
عمليات التعداد | |
---|---|
TYPE_UNSPECIFIED |
نوع نص تلقائي غير محدد |
PAGE_NUMBER |
اكتب للنص التلقائي الذي يمثل رقم الصفحة الحالية. |
PAGE_COUNT |
اكتب للنص التلقائي الذي يمثل إجمالي عدد الصفحات في المستند. |
فاصل صفحة
تمثّل هذه السمة ParagraphElement
فاصل صفحة. يؤدي فاصل الصفحة إلى بدء النص التالي أعلى الصفحة التالية.
تمثيل JSON |
---|
{ "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
الحقول | |
---|---|
suggestedInsertionIds[] |
أرقام تعريف الإدراج المُقترَحة قد يحتوي |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترحة. إذا كان الحقل فارغًا، لن يتم اقتراح عمليات حذف لهذا المحتوى. |
textStyle |
نمط النص لفاصل الصفحة هذا. وعلى غرار المحتوى النصي، مثل إطارات النص ومراجع الحواشي السفلية، يمكن أن يؤثر نمط النص لفاصل الصفحة على تخطيط المحتوى وكذلك نمط النص المدرج بجواره. |
suggestedTextStyleChanges |
يتغيّر نمط النص المقترَح في فاصل الصفحة هذا، استنادًا إلى رقم تعريف الاقتراح. |
فاصل أعمدة
تمثّل هذه السمة ParagraphElement
فاصل أعمدة. يؤدي فاصل العمود إلى بدء النص التالي في أعلى العمود التالي.
تمثيل JSON |
---|
{ "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
الحقول | |
---|---|
suggestedInsertionIds[] |
أرقام تعريف الإدراج المُقترَحة قد يحتوي |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترحة. إذا كان الحقل فارغًا، لن يتم اقتراح عمليات حذف لهذا المحتوى. |
textStyle |
نمط النص لفاصل العمود هذا. على غرار المحتوى النصي، مثل إطارات النص ومراجع الحواشي السفلية، يمكن أن يؤثر نمط النص لفاصل العمود في تخطيط المحتوى وكذلك نمط النص المدرج بجواره. |
suggestedTextStyleChanges |
يتغيّر نمط النص المقترَح على فاصل العمود هذا، استنادًا إلى رقم تعريف الاقتراح. |
مرجع الحاشية السفلية
تمثّل هذه السمة ParagraphElement
مرجعًا للحاشية السفلية. مرجع الحاشية السفلية هو المحتوى المضمّن الذي يتم عرضه برقم ويستخدم لتحديد الحاشية السفلية.
تمثيل JSON |
---|
{ "footnoteId": string, "footnoteNumber": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
الحقول | |
---|---|
footnoteId |
هذا هو رقم تعريف |
footnoteNumber |
تمثّل هذه السمة العدد المعروض لهذه الحاشية السفلية. |
suggestedInsertionIds[] |
أرقام تعريف الإدراج المُقترَحة قد يحتوي |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترحة. إذا كان الحقل فارغًا، لن يتم اقتراح عمليات حذف لهذا المحتوى. |
textStyle |
نمط النص لـ FootnoteReference هذا. |
suggestedTextStyleChanges |
يتغيّر نمط النص المقترَح في FootnoteReference هذا، وفقًا لمعرّف الاقتراح. |
قاعدة أفقية
تمثّل هذه السمة 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 |
إخراج فقط. سمات |
خصائص الأشخاص
الخصائص الخاصة بسمة Person
المرتبطة.
تمثيل JSON |
---|
{ "name": string, "email": string } |
الحقول | |
---|---|
name |
إخراج فقط. اسم الشخص إذا تم عرضه في نص الرابط بدلاً من عنوان البريد الإلكتروني للشخص. |
email |
إخراج فقط. عنوان البريد الإلكتروني المرتبط بحساب " |
رابط غني
رابط إلى مورد 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 من |
نمط الفقرة
يشير ذلك المصطلح إلى الأنماط التي يتم تطبيقها على فقرة بالكامل.
يتم تمثيل أنماط الفقرات المُكتسَبة كحقول لم يتم ضبطها في هذه الرسالة. يعتمد أصل نمط الفقرة على مكان تعريف نمط الفقرة:
- يتم اكتساب نمط ParagraphStyle على
Paragraph
من العنصرnamed style type
المقابل للفقرة. - يتم اكتساب نمط الفقرة على
named style
من النمط المسمىnormal text
. - يتم اكتساب نمط الفقرة للنمط المسمى
normal text
من نمط الفقرة التلقائي في أداة تحرير "مستندات Google". - قد يكتسب ParagraphStyle في عنصر
Paragraph
المتوفّر في جدول نمط الفقرة الخاص به من نمط الجدول.
في حال لم يكتسب نمط الفقرة من عنصر رئيسي، ستُعيد الحقول التي يتم إلغاء ضبطها النمط إلى قيمة تطابق الإعدادات التلقائية في أداة تحرير المستندات.
تمثيل JSON |
---|
{ "headingId": string, "namedStyleType": enum ( |
الحقول | |
---|---|
headingId |
رقم تعريف عنوان الفقرة. إذا كانت هذه السمة فارغة، لن تكون هذه الفقرة عنوانًا. هذا الموقع الإلكتروني للقراءة فقط. |
namedStyleType |
نوع النمط المسمى للفقرة. نظرًا لأن تعديل نوع النمط المُعنوَن يؤثر في الخصائص الأخرى ضمن ParagraphStyle، يتم تطبيق نوع النمط المُعنوَن قبل تعديل الخصائص الأخرى. |
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 |
تتم محاذاة الفقرة مع بداية السطر. محاذاة إلى اليسار لنص من اليسار إلى اليمين، مع محاذاة إلى اليمين بخلاف ذلك. |
CENTER |
يجب أن تكون الفقرة في وسط الشاشة. |
END |
تتم محاذاة الفقرة إلى نهاية السطر. تمت المحاذاة إلى اليمين لنص من اليسار إلى اليمين، أو مع المحاذاة إلى اليسار بخلاف ذلك. |
JUSTIFIED |
الفقرة مبررة. |
ContentDirection
يمكن أن يتدفق محتوى الاتجاهات.
عمليات التعداد | |
---|---|
CONTENT_DIRECTION_UNSPECIFIED |
لم يتم تحديد اتجاه المحتوى. |
LEFT_TO_RIGHT |
ينتقل المحتوى من اليسار إلى اليمين. |
RIGHT_TO_LEFT |
ينتقل المحتوى من اليمين إلى اليسار. |
وضع التباعد
الأوضاع المختلفة لتباعد الفقرات.
عمليات التعداد | |
---|---|
SPACING_MODE_UNSPECIFIED |
يتم اكتساب وضع التباعد من الوحدة التنظيمية الرئيسية. |
NEVER_COLLAPSE |
يتم دائمًا عرض تباعد الفقرات. |
COLLAPSE_LISTS |
يتم تخطي تباعد الفقرات بين عناصر القائمة. |
حدود الفقرة
حد حول فقرة.
تمثيل JSON |
---|
{ "color": { object ( |
الحقول | |
---|---|
color |
لون الحدود |
width |
عرض الحد. |
padding |
المساحة المتروكة للحدود. |
dashStyle |
نمط الشرطة للحدود |
نمط شرطة
أنواع الشرطات التي يمكن عرض الأشكال الهندسية الخطية بها. تستند هذه القيم إلى النوع البسيط "ST_PresetLineDashVal" الموضح في الفقرة 20.1.10.48 من "تنسيقات ملف Office Open XML - الأساسيات ومرجع اللغة الترميزية"، الجزء 1 من الإصدار الرابع من ECMA-376.
عمليات التعداد | |
---|---|
DASH_STYLE_UNSPECIFIED |
نمط شَرطة غير محدَّد. |
SOLID |
خط متصل يتطابق مع قيمة ECMA-376 ST_PresetLineDashVal 'solid'. هذا هو نمط الشَرطة التلقائي. |
DOT |
سطر منقّط يتطابق مع القيمة "نقطة" لـ ECMA-376 ST_PresetLineDashVal. |
DASH |
خط متقطع. يتطابق مع قيمة ECMA-376 ST_PresetLineDashVal 'dash'. |
TabStop
تتوقف علامة الجدولة داخل فقرة.
تمثيل JSON |
---|
{ "offset": { object ( |
الحقول | |
---|---|
offset |
الإزاحة بين تتوقف علامة الجدولة هذه وهامش البدء. |
alignment |
تتوقف محاذاة علامة التبويب هذه. وفي حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على |
محاذاة علامة التبويب
يشير ذلك المصطلح إلى محاذاة علامة الجدولة.
عمليات التعداد | |
---|---|
TAB_STOP_ALIGNMENT_UNSPECIFIED |
لم يتم تحديد محاذاة إيقاف علامات التبويب. |
START |
تتم محاذاة علامة الجدولة مع بداية السطر. وهذا هو الخيار التلقائي. |
CENTER |
تتم محاذاة علامة الجدولة إلى وسط الخط. |
END |
تتم محاذاة علامة الجدولة مع نهاية السطر. |
التظليل
تظليل فقرة.
تمثيل JSON |
---|
{
"backgroundColor": {
object ( |
الحقول | |
---|---|
backgroundColor |
لون الخلفية لتظليل الفقرة هذا. |
نمط الفقرة المقترح
تغيير مقترح على ParagraphStyle
.
تمثيل JSON |
---|
{ "paragraphStyle": { object ( |
الحقول | |
---|---|
paragraphStyle |
|
paragraphStyleSuggestionState |
قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح من خلال قاعدة |
حالة اقتراح الفقرة
قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح من خلال قاعدة ParagraphStyle
الأساسية. بالنسبة إلى أي حقل تم ضبطه على "صحيح"، يتم تطبيق قيمة جديدة مقترَحة.
تمثيل JSON |
---|
{
"headingIdSuggested": boolean,
"namedStyleTypeSuggested": boolean,
"alignmentSuggested": boolean,
"lineSpacingSuggested": boolean,
"directionSuggested": boolean,
"spacingModeSuggested": boolean,
"spaceAboveSuggested": boolean,
"spaceBelowSuggested": boolean,
"borderBetweenSuggested": boolean,
"borderTopSuggested": boolean,
"borderBottomSuggested": boolean,
"borderLeftSuggested": boolean,
"borderRightSuggested": boolean,
"indentFirstLineSuggested": boolean,
"indentStartSuggested": boolean,
"indentEndSuggested": boolean,
"keepLinesTogetherSuggested": boolean,
"keepWithNextSuggested": boolean,
"avoidWidowAndOrphanSuggested": boolean,
"shadingSuggestionState": {
object ( |
الحقول | |
---|---|
headingIdSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
namedStyleTypeSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
alignmentSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
lineSpacingSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
directionSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
spacingModeSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
spaceAboveSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
spaceBelowSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
borderBetweenSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
borderTopSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
borderBottomSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
borderLeftSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
borderRightSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
indentFirstLineSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
indentStartSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
indentEndSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
keepLinesTogetherSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
keepWithNextSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
avoidWidowAndOrphanSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
shadingSuggestionState |
قناع يشير إلى الحقول في |
pageBreakBeforeSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
حالة اقتراح التظليل
قناع يشير إلى الحقول التي تم تغييرها في قاعدة Shading
الأساسية في هذا التغيير المقترَح. بالنسبة إلى أي حقل تم ضبطه على "صحيح"، يتم تطبيق قيمة جديدة مقترَحة.
تمثيل JSON |
---|
{ "backgroundColorSuggested": boolean } |
الحقول | |
---|---|
backgroundColorSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح على |
تعداد نقطي
تصف النقطة الفاصلة للفقرة.
تمثيل JSON |
---|
{
"listId": string,
"nestingLevel": integer,
"textStyle": {
object ( |
الحقول | |
---|---|
listId |
رقم تعريف القائمة التي تنتمي إليها هذه الفقرة. |
nestingLevel |
مستوى التداخل لهذه الفقرة في القائمة. |
textStyle |
نمط النص الخاص بالفقرة الذي تم تطبيقه على هذا التعداد النقطي. |
عنصر قائمة نقطية مقترحة
تغيير مقترح على Bullet
.
تمثيل JSON |
---|
{ "bullet": { object ( |
الحقول | |
---|---|
bullet |
|
bulletSuggestionState |
قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح من خلال قاعدة |
BulletSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح من خلال قاعدة Bullet
الأساسية. بالنسبة إلى أي حقل تم ضبطه على "صحيح"، يتم تطبيق قيمة جديدة مقترَحة.
تمثيل JSON |
---|
{
"listIdSuggested": boolean,
"nestingLevelSuggested": boolean,
"textStyleSuggestionState": {
object ( |
الحقول | |
---|---|
listIdSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح على |
nestingLevelSuggested |
تشير هذه السمة إلى ما إذا كان هناك تغيير مقترَح على |
textStyleSuggestionState |
قناع يشير إلى الحقول في |
مراجع الكائنات
مجموعة من معرّفات الكائنات.
تمثيل JSON |
---|
{ "objectIds": [ string ] } |
الحقول | |
---|---|
objectIds[] |
أرقام تعريف العناصر. |
فاصل أقسام
تمثّل هذه السمة StructuralElement
فاصل أقسام. القسم هو نطاق من المحتوى يتضمّن السمة SectionStyle
نفسها. يمثل فاصل الأقسام بداية قسم جديد، وينطبق نمط القسم على القسم بعد فاصل الأقسام.
يبدأ نص المستند دائمًا بفاصل أقسام.
تمثيل JSON |
---|
{
"suggestedInsertionIds": [
string
],
"suggestedDeletionIds": [
string
],
"sectionStyle": {
object ( |
الحقول | |
---|---|
suggestedInsertionIds[] |
أرقام تعريف الإدراج المُقترَحة قد يحتوي |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترحة. إذا كان الحقل فارغًا، لن يتم اقتراح عمليات حذف لهذا المحتوى. |
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 |
رقم تعريف العنوان التلقائي. وفي حال ترك هذه السياسة بدون ضبط، يتم اكتساب القيمة من نمط sectionStyle في هذا الموقع الإلكتروني للقراءة فقط. |
defaultFooterId |
رقم تعريف التذييل التلقائي. وفي حال ترك هذه السياسة بدون ضبط، يتم اكتساب القيمة من نمط sectionStyle في هذا الموقع الإلكتروني للقراءة فقط. |
firstPageHeaderId |
رقم تعريف العنوان مستخدَم فقط في الصفحة الأولى من القسم. إذا كانت قيمة هذا الموقع الإلكتروني للقراءة فقط. |
firstPageFooterId |
رقم تعريف التذييل المستخدَم فقط للصفحة الأولى من القسم إذا كانت القيمة هذا الموقع الإلكتروني للقراءة فقط. |
evenPageHeaderId |
معرّف العنوان يُستخدم للصفحات الزوجية فقط. إذا كانت قيمة هذا الموقع الإلكتروني للقراءة فقط. |
evenPageFooterId |
يتم استخدام رقم تعريف التذييل للصفحات الزوجية فقط. إذا كانت قيمة هذا الموقع الإلكتروني للقراءة فقط. |
useFirstPageHeaderFooter |
يشير إلى ما إذا كان سيتم استخدام أرقام تعريف رأس / تذييل الصفحة الأولى للصفحة الأولى من القسم. في حال ترك هذه السياسة بدون ضبط، سيتم نسخها من سمة عند تعديل هذه السمة، يجب ضبط قيمة ملموسة. يؤدي إلغاء تعيين هذه الخاصية إلى حدوث خطأ 400 في الطلب غير صالح. |
pageNumberStart |
رقم الصفحة الذي يتم منه بدء احتساب عدد صفحات هذا القسم. في حال ترك هذه السياسة بدون ضبط، يستمر ترقيم الصفحات من القسم السابق. وفي حال عدم ضبط القيمة في أول عند تعديل هذه السمة، يجب ضبط قيمة ملموسة. يؤدي إلغاء تعيين هذه الخاصية إلى حدوث خطأ 400 في الطلب غير صالح. |
flipPageOrientation |
اختياريّ. للإشارة إلى ما إذا كان سيتم قلب أبعاد عند تعديل هذه السمة، يجب ضبط قيمة ملموسة. يؤدي إلغاء تعيين هذه الخاصية إلى حدوث خطأ 400 في الطلب غير صالح. |
ItemColumnProperties (خصائص القسم)
الخصائص التي تنطبق على عمود قسم.
تمثيل JSON |
---|
{ "width": { object ( |
الحقول | |
---|---|
width |
إخراج فقط. تمثّل هذه السمة عرض العمود. |
paddingEnd |
المساحة المتروكة في نهاية العمود. |
نمط الفاصل العمودي
نمط فواصل الأعمدة بين الأعمدة.
عمليات التعداد | |
---|---|
COLUMN_SEPARATOR_STYLE_UNSPECIFIED |
نمط فاصل عمود غير محدد. |
NONE |
لا توجد خطوط فواصل الأعمدة بين الأعمدة. |
BETWEEN_EACH_COLUMN |
لعرض سطر فاصل عمود بين كل عمود. |
نوع القسم
لعرض كيفية وضع بداية القسم الحالي مقارنةً بالقسم السابق.
عمليات التعداد | |
---|---|
SECTION_TYPE_UNSPECIFIED |
لم يتم تحديد نوع القسم. |
CONTINUOUS |
يبدأ القسم بعد الفقرة الأخيرة من القسم السابق مباشرةً. |
NEXT_PAGE |
يبدأ القسم من الصفحة التالية. |
جدول
تمثّل هذه السمة StructuralElement
للجدول.
تمثيل JSON |
---|
{ "rows": integer, "columns": integer, "tableRows": [ { object ( |
الحقول | |
---|---|
rows |
عدد الصفوف في الجدول. |
columns |
عدد الأعمدة في الجدول. من الممكن أن يكون الجدول غير مستطيل، لذلك قد تحتوي بعض الصفوف على عدد مختلف من الخلايا. |
tableRows[] |
محتوى ونمط كل صف. |
suggestedInsertionIds[] |
أرقام تعريف الإدراج المُقترَحة قد يحتوي |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترحة. إذا كان الحقل فارغًا، لن يتم اقتراح عمليات حذف لهذا المحتوى. |
tableStyle |
نمط الجدول. |
صف الجدول
محتوى ونمط صف في 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 |
محاذاة المحتوى في خلية الجدول. تتطابق المحاذاة التلقائية مع محاذاة خلايا الجدول التي تم إنشاؤها حديثًا في أداة تحرير "مستندات Google". |
TableCellBorder
حد حول خلية جدول.
لا يمكن أن تكون حدود خلايا الجدول شفافة. لإخفاء حد خلية في الجدول، اجعل عرضه 0.
تمثيل JSON |
---|
{ "color": { object ( |
الحقول | |
---|---|
color |
لون الحدود لا يمكن أن يكون هذا اللون شفافًا. |
width |
عرض الحد. |
dashStyle |
نمط الشرطة للحدود |
محاذاة المحتوى
أنواع محاذاة المحتوى.
مشتق من مجموعة فرعية من قيم النوع البسيط "ST_TextAnchoringType" في القسم 20.1.10.59 من "Office Open XML Formats - Fundamentals and Markup Language Reference"، الجزء 1 من الإصدار الرابع من ECMA-376.
عمليات التعداد | |
---|---|
CONTENT_ALIGNMENT_UNSPECIFIED |
محاذاة محتوى غير محدد يتم اكتساب محاذاة المحتوى من المؤسسة الرئيسية في حال وجودها. |
CONTENT_ALIGNMENT_UNSUPPORTED |
محاذاة محتوى غير متوافقة |
TOP |
محاذاة تتماشى مع المحتوى أعلى حامل المحتوى. يتطابق مع ECMA-376 ST_TextAnchoringType 't'. |
MIDDLE |
محاذاة تتماشى مع المحتوى في وسط حامل المحتوى. يتطابق مع ECMA-376 ST_TextAnchoringType 'ctr'. |
BOTTOM |
محاذاة تتماشى مع المحتوى أسفل حامل المحتوى. يتطابق مع ECMA-376 ST_TextAnchoringType 'b'. |
SuggestedTableCellStyle
تغيير مقترح على TableCellStyle
.
تمثيل JSON |
---|
{ "tableCellStyle": { object ( |
الحقول | |
---|---|
tableCellStyle |
|
tableCellStyleSuggestionState |
قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح من خلال قاعدة |
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 |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
نمط صف الجدول
يشير ذلك المصطلح إلى الأنماط التي يتم تطبيقها على صف في الجدول.
تمثيل JSON |
---|
{
"minRowHeight": {
object ( |
الحقول | |
---|---|
minRowHeight |
الحد الأدنى لارتفاع الصف. سيتم عرض الصف في "أداة تعديل المستندات" على ارتفاع يساوي هذه القيمة أو أكبر منها لإظهار كل المحتوى في خلايا الصف. |
tableHeader |
ما إذا كان الصف عبارة عن عنوان جدول. |
preventOverflow |
ما إذا كان الصف لا يمكن أن يتجاوز حدود الصفحة أو العمود. |
نمط الجدول المقترَح
تغيير مقترح على TableRowStyle
.
تمثيل JSON |
---|
{ "tableRowStyle": { object ( |
الحقول | |
---|---|
tableRowStyle |
|
tableRowStyleSuggestionState |
قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح من خلال قاعدة |
TablerowStyleSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح من خلال قاعدة TableRowStyle
الأساسية. بالنسبة إلى أي حقل تم ضبطه على "صحيح"، يتم تطبيق قيمة جديدة مقترَحة.
تمثيل JSON |
---|
{ "minRowHeightSuggested": boolean } |
الحقول | |
---|---|
minRowHeightSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
نمط الجدول
يشير ذلك المصطلح إلى الأنماط التي تنطبق على الجدول.
تمثيل 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 على عرض العمود. |
جدول المحتويات
يمثّل StructuralElement
جدول محتويات.
تمثيل JSON |
---|
{
"content": [
{
object ( |
الحقول | |
---|---|
content[] |
محتوى جدول المحتويات. |
suggestedInsertionIds[] |
أرقام تعريف الإدراج المُقترَحة قد يحتوي |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترحة. إذا كان الحقل فارغًا، لن يتم اقتراح عمليات حذف لهذا المحتوى. |
العنوان
عنوان مستند.
تمثيل JSON |
---|
{
"headerId": string,
"content": [
{
object ( |
الحقول | |
---|---|
headerId |
رقم تعريف العنوان. |
content[] |
محتوى العنوان. وتبدأ فهارس محتوى العنوان من صفر. |
حاشية سفلية
حاشية سفلية للمستند.
تمثيل JSON |
---|
{
"footnoteId": string,
"content": [
{
object ( |
الحقول | |
---|---|
footnoteId |
معرِّف الحاشية السفلية. |
content[] |
محتوى الحاشية السفلية. تبدأ فهارس محتوى الحواشي السفلية من صفر. |
نمط المستند
نمط المستند
تمثيل JSON |
---|
{ "background": { object ( |
الحقول | |
---|---|
background |
خلفية المستند لا يمكن أن تكون المستندات بلون خلفية شفاف. |
defaultHeaderId |
رقم تعريف العنوان التلقائي. وفي حال تم ترك السياسة بدون ضبط، لا يكون هناك عنوان تلقائي. هذا الموقع الإلكتروني للقراءة فقط. |
defaultFooterId |
رقم تعريف التذييل التلقائي. وفي حال تم ترك السياسة بدون ضبط، لن يتوفّر تذييل تلقائي. هذا الموقع الإلكتروني للقراءة فقط. |
evenPageHeaderId |
معرّف العنوان يُستخدم للصفحات الزوجية فقط. تحدّد قيمة هذا الموقع الإلكتروني للقراءة فقط. |
evenPageFooterId |
يتم استخدام رقم تعريف التذييل للصفحات الزوجية فقط. تحدّد قيمة هذا الموقع الإلكتروني للقراءة فقط. |
firstPageHeaderId |
رقم تعريف العنوان مستخدَم في الصفحة الأولى فقط وفي حال تم ترك السياسة بدون ضبط، لا يتوفّر عنوان فريد للصفحة الأولى. تحدّد قيمة هذا الموقع الإلكتروني للقراءة فقط. |
firstPageFooterId |
رقم تعريف التذييل الذي يتم استخدامه للصفحة الأولى فقط. وفي حال تم ترك السياسة بدون ضبط، لا يكون هناك تذييل فريد للصفحة الأولى. تحدّد قيمة هذا الموقع الإلكتروني للقراءة فقط. |
useFirstPageHeaderFooter |
يشير إلى ما إذا كان سيتم استخدام أرقام تعريف رأس / تذييل الصفحة الأولى للصفحة الأولى. |
useEvenPageHeaderFooter |
يشير إلى ما إذا كان يجب استخدام أرقام تعريف رأس / تذييل الصفحات الزوجية للصفحات الزوجية. |
pageNumberStart |
رقم الصفحة الذي يتم منه بدء حساب عدد الصفحات. |
marginTop |
هامش الصفحة العلوية. يؤدي تحديث هامش الصفحة العلوية في نمط المستند إلى محو هامش الصفحة العلوية في جميع أنماط الأقسام. |
marginBottom |
هامش الصفحة السفلية. يؤدي تحديث هامش الصفحة السفلية في نمط المستند إلى محو هامش الصفحة السفلية في جميع أنماط الأقسام. |
marginRight |
هامش الصفحة الأيمن. يؤدي تحديث هامش الصفحة الأيمن في نمط المستند إلى محو هامش الصفحة الأيمن في جميع أنماط الأقسام. وقد يتسبب أيضًا في تغيير حجم الأعمدة في جميع الأقسام. |
marginLeft |
هامش الصفحة الأيسر. يؤدي تحديث هامش الصفحة الأيسر في نمط المستند إلى محو هامش الصفحة الأيسر في جميع أنماط الأقسام. وقد يتسبب أيضًا في تغيير حجم الأعمدة في جميع الأقسام. |
pageSize |
حجم الصفحة في المستند. |
marginHeader |
مقدار المسافة بين أعلى الصفحة ومحتويات العنوان. |
marginFooter |
مقدار المسافة بين أسفل الصفحة ومحتويات التذييل. |
useCustomHeaderFooterMargins |
يشير إلى ما إذا كان يتم احترام نمط المستند هذا الموقع الإلكتروني للقراءة فقط. |
flipPageOrientation |
اختياريّ. تشير هذه السمة إلى ما إذا كان سيتم قلب أبعاد |
الخلفية
تُمثِّل خلفية المستند.
تمثيل JSON |
---|
{
"color": {
object ( |
الحقول | |
---|---|
color |
لون الخلفية |
حجم الملف
عرض وارتفاع.
تمثيل JSON |
---|
{ "height": { object ( |
الحقول | |
---|---|
height |
ارتفاع الكائن. |
width |
عرض العنصر. |
نمط مستند مقترح
تغيير مقترح على 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 |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
الأنماط المُسَمّاة
الأنماط المُعنونة. يمكن أن تكتسب الفقرات في المستند TextStyle
وParagraphStyle
من هذه الأنماط المُسمّاة.
تمثيل JSON |
---|
{
"styles": [
{
object ( |
الحقول | |
---|---|
styles[] |
الأنماط المُعنونة. يتوفّر إدخال لكل |
نمط مُسمّى
نمط مُعنوَن. يمكن أن تكتسب الفقرات في المستند TextStyle
وParagraphStyle
من هذا النمط المُعنوَن عندما تكون لها نوع النمط المُعنوَن نفسه.
تمثيل JSON |
---|
{ "namedStyleType": enum ( |
الحقول | |
---|---|
namedStyleType |
نوع هذا النمط المُعنوَن. |
textStyle |
نمط النص لهذا النمط المُعنوَن. |
paragraphStyle |
نمط الفقرة لهذا النمط المسمى. |
أنماط الاسم المقترحة
تغيير مقترح على 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[] |
أرقام تعريف الحذف المقترحة. إذا كانت فارغة، لن يتم اقتراح أي عمليات حذف لهذه القائمة. |
خصائص القائمة
سمات list
التي تصف شكل وأسلوب الرموز النقطية التي تنتمي إلى الفقرات المرتبطة بالقائمة.
تمثيل JSON |
---|
{
"nestingLevels": [
{
object ( |
الحقول | |
---|---|
nestingLevels[] |
تصف خصائص الرموز النقطية على المستوى المرتبط. تحتوي القائمة على 9 مستويات كحد أقصى من التداخل مع المستوى 0 للدمج مع المستوى الأعلى والمستوى 8 للتداخل المقابل للمستوى الأكثر تداخلاً. يتم عرض مستويات التداخل تصاعديًا مع عرض أقل مستويات التداخل أولاً. |
مستوى التداخل
تحتوي على خصائص تصف شكل ومظهر التعداد النقطي للقائمة على مستوى معين من التداخل.
تمثيل JSON |
---|
{ "bulletAlignment": enum ( |
الحقول | |
---|---|
bulletAlignment |
محاذاة الرمز النقطي ضمن المساحة المخصّصة لعرض الرمز النقطي |
glyphFormat |
سلسلة التنسيق المستخدمة بواسطة الرموز النقطية في هذا المستوى من التداخل. يحتوي تنسيق الحرف الرسومي على عنصر نائب واحد أو أكثر، ويتم استبدال هذه العناصر النائبة بالقيم المناسبة بناءً على على سبيل المثال، يشير تنسيق الحرف الرسومي
ويمكن أن يحتوي تنسيق الحرف الرسومي على عناصر نائبة لمستوى التداخل الحالي بالإضافة إلى عناصر نائبة لمستويات التداخل الرئيسي. على سبيل المثال، يمكن أن تحتوي القائمة على تنسيق حرف رسومي
بالنسبة إلى مستويات التداخل التي يتم ترتيبها، تعتمد السلسلة التي تحل محل عنصر نائب بتنسيق حرف رسومي لفقرة معيّنة على ترتيب الفقرة داخل القائمة. |
indentFirstLine |
مقدار المسافة البادئة للسطر الأول من الفقرات عند هذا المستوى من التداخل. |
indentStart |
مقدار المسافة البادئة للفقرات في هذا المستوى من التداخل. يتم تطبيقها على الجانب الذي يتوافق مع بداية النص، استنادًا إلى اتجاه محتوى الفقرة. |
textStyle |
نمط نص الرموز النقطية في هذا المستوى من التداخل. |
startNumber |
عدد أول عنصر قائمة على مستوى التداخل هذا. يتم التعامل مع القيمة 0 كقيمة 1 للقوائم ذات الأحرف والأرقام وقوائم الأرقام الرومانية. بالنسبة إلى قيم كل من 0 و1، ستبدأ قوائم الأرقام المكونة من الأحرف والأرقام الرومانية بـ يتم تجاهل هذه القيمة لمستويات التداخل التي تشتمل على أحرف رسومية غير مرتَّبة. |
حقل الاتحاد glyph_kind . نوع الحرف الرسومي الذي تستخدمه الرموز النقطية. تحدِّد هذه السمة الرمز النقطي الذي يحل محل العناصر النائبة في glyph_format . يمكن أن تكون السمة "glyph_kind " واحدة فقط مما يلي: |
|
glyphType |
نوع الحرف الرسومي الذي تستخدمه الرموز النقطية عندما يتم ترتيب الفقرات في هذا المستوى من التداخل. يحدّد نوع الحرف الرسومي نوع الحرف الرسومي المستخدَم لاستبدال العناصر النائبة في |
glyphSymbol |
رمز حرف رسومي مخصص تستخدمه الرموز النقطية عندما تكون الفقرات في هذا المستوى من التداخل بدون ترتيب. يحل الرمز الرسومي محل العناصر النائبة في |
محاذاة نقطية
أنواع المحاذاة للرمز النقطي.
عمليات التعداد | |
---|---|
BULLET_ALIGNMENT_UNSPECIFIED |
لم يتم تحديد محاذاة الرمز النقطي. |
START |
تتم محاذاة الرمز النقطي مع بداية المساحة المخصّصة لعرض الرمز النقطي. محاذاة إلى اليسار لنص من اليسار إلى اليمين، مع محاذاة إلى اليمين بخلاف ذلك. |
CENTER |
تتم محاذاة الرمز النقطي مع وسط المساحة المخصّصة لعرض الرمز النقطي. |
END |
تتم محاذاة الرمز النقطي مع نهاية المساحة المخصّصة لعرض الرمز النقطي. تمت المحاذاة إلى اليمين لنص من اليسار إلى اليمين، أو مع المحاذاة إلى اليسار بخلاف ذلك. |
حرف GlyphType
أنواع الأحرف الرسومية التي تستخدمها الرموز النقطية عند ترتيب الفقرات في هذا المستوى من التداخل.
عمليات التعداد | |
---|---|
GLYPH_TYPE_UNSPECIFIED |
نوع الحرف الرسومي غير محدد أو غير متوافق. |
NONE |
سلسلة فارغة. |
DECIMAL |
رقم، مثل 1 أو 2 أو 3 |
ZERO_DECIMAL |
هو رقم يبدأ فيه الرقم المكوّن من رقم واحد بصفر، مثل 01 أو 02 أو 03 . لا تبدأ الأرقام التي تحتوي على أكثر من رقم واحد بصفر. |
UPPER_ALPHA |
حرف كبير، مثل A أو B أو C |
ALPHA |
حرف صغير، مثل a أو b أو c |
UPPER_ROMAN |
رقم روماني كبير، مثل I أو II أو III . |
ROMAN |
رقم روماني صغير، مثل i أو ii أو iii |
الخصائص المقترحة
تغيير مقترح على ListProperties
.
تمثيل JSON |
---|
{ "listProperties": { object ( |
الحقول | |
---|---|
listProperties |
|
listPropertiesSuggestionState |
قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح من خلال قاعدة |
ListPropertiesSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح من خلال قاعدة ListProperties
الأساسية. بالنسبة إلى أي حقل تم ضبطه على "صحيح"، يتم تطبيق قيمة جديدة مقترَحة.
تمثيل JSON |
---|
{
"nestingLevelsSuggestionStates": [
{
object ( |
الحقول | |
---|---|
nestingLevelsSuggestionStates[] |
قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح ضِمن يتم عرض حالات اقتراح مستوى التداخل بترتيب تصاعدي حسب مستوى التداخل مع عرض أقل حالات تداخل يتم عرضها أولاً. |
حالة اقتراح NestingLevel
قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح من خلال قاعدة NestingLevel
الأساسية. بالنسبة إلى أي حقل تم ضبطه على "صحيح"، يتم تطبيق قيمة جديدة مقترَحة.
تمثيل JSON |
---|
{
"bulletAlignmentSuggested": boolean,
"glyphTypeSuggested": boolean,
"glyphFormatSuggested": boolean,
"glyphSymbolSuggested": boolean,
"indentFirstLineSuggested": boolean,
"indentStartSuggested": boolean,
"textStyleSuggestionState": {
object ( |
الحقول | |
---|---|
bulletAlignmentSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
glyphTypeSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
glyphFormatSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
glyphSymbolSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
indentFirstLineSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
indentStartSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
textStyleSuggestionState |
قناع يشير إلى الحقول في |
startNumberSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
نطاقات مُعنوَنة
مجموعة من NamedRange
في المستند التي تشترك في اسم معيّن.
تمثيل JSON |
---|
{
"name": string,
"namedRanges": [
{
object ( |
الحقول | |
---|---|
name |
الاسم الذي تشترك فيه جميع |
namedRanges[] |
|
نطاق مُعنوَن
مجموعة من Range
لها رقم تعريف النطاق المُعنون نفسه.
تسمح النطاقات المُسمّاة للمطوّرين بربط أجزاء من المستند بتصنيف عشوائي من تحديد المستخدم حتى يمكن قراءة محتواها أو تعديله آليًا لاحقًا. يمكن أن يحتوي المستند على عدة نطاقات مُعنوَنة تحمل الاسم نفسه، ولكن لكل نطاق مُعنوَن رقم تعريف فريد.
يتم إنشاء نطاق مُعنوَن باستخدام Range
واحد، ويؤدي إدراج المحتوى داخل نطاق مُعنوَن إلى توسيع هذا النطاق بشكلٍ عام. ومع ذلك، يمكن أن تؤدي بعض التغييرات في المستند إلى تقسيم النطاق إلى نطاقات متعددة.
النطاقات المُعنونة ليست خاصة. يمكن لجميع التطبيقات والمتعاونين الذين لديهم حق الوصول إلى المستند رؤية النطاقات المُعنوَنة.
تمثيل JSON |
---|
{
"namedRangeId": string,
"name": string,
"ranges": [
{
object ( |
الحقول | |
---|---|
namedRangeId |
رقم تعريف النطاق المُعنون. |
name |
اسم النطاق المُعنون. |
ranges[] |
النطاقات التي تنتمي إلى هذا النطاق المُعنون. |
النطاق
لتحديد نطاق متجاورة من النص.
تمثيل JSON |
---|
{ "segmentId": string, "startIndex": integer, "endIndex": integer } |
الحقول | |
---|---|
segmentId |
رقم تعريف الرأس أو التذييل أو الحاشية السفلية التي يحتوي عليها هذا النطاق. ويشير رقم تعريف المقطع الفارغ إلى نص المستند. |
startIndex |
فهرس البدء المستند إلى الصفر لهذا النطاق، بوحدات رمز UTF-16. يجب توفير فهرس بدء في جميع الاستخدامات الحالية. هذا الحقل هو Int32Value لاستيعاب حالات الاستخدام المستقبلية للنطاقات المفتوحة. |
endIndex |
الفهرس النهائي المستند إلى صفر لهذا النطاق، حصريًا، بوحدات رمز UTF-16. يجب توفير فهرس نهائي في جميع الاستخدامات الحالية. هذا الحقل هو Int32Value لاستيعاب حالات الاستخدام المستقبلية للنطاقات المفتوحة. |
وضع عرض الاقتراحات
وضع عرض الاقتراحات المطبّق على المستند والذي يشير إلى كيفية تمثيل التغييرات المقترَحة. ويوفر خيارات لقراءة المستند مع تضمين جميع الاقتراحات أو قبولها أو رفضها.
عمليات التعداد | |
---|---|
DEFAULT_FOR_CURRENT_ACCESS |
يعتمد وضع المُقترَحةsViewMode على المستند المعروض على مستوى الوصول الحالي للمستخدِم. في حال كان المستخدم يمتلك إذن الوصول للعرض فقط، يتم تطبيق PREVIEW_WITHOUT_SUGGESTIONS . وفي حال عدم تنفيذ ذلك، يتم تطبيق السمة SUGGESTIONS_INLINE . هذا هو وضع عرض الاقتراحات التلقائي. |
SUGGESTIONS_INLINE |
يحتوي المستند المعروض على اقتراحات مضمَّنة. سيتم تمييز التغييرات المقترَحة عن المحتوى الأساسي داخل المستند. ستعرض طلبات استرداد مستند باستخدام هذا الوضع رسالة الخطأ 403 إذا لم يكن لدى المستخدم إذن بعرض التغييرات المقترحة. |
PREVIEW_SUGGESTIONS_ACCEPTED |
المستند الذي يتم عرضه هو معاينة مع قبول جميع التغييرات المقترَحة. ستعرض طلبات استرداد مستند باستخدام هذا الوضع رسالة الخطأ 403 إذا لم يكن لدى المستخدم إذن بعرض التغييرات المقترحة. |
PREVIEW_WITHOUT_SUGGESTIONS |
المستند المعروض هو معاينة يتم رفض جميع التغييرات المقترحة إذا كانت هناك أي اقتراحات في المستند. |
عنصر مضمّن
كائن يظهر مضمّنًا مع النص. يحتوي الكائن InlineObject على EmbeddedObject
، مثل صورة.
تمثيل JSON |
---|
{ "objectId": string, "inlineObjectProperties": { object ( |
الحقول | |
---|---|
objectId |
رقم تعريف هذا الكائن المضمّن. يمكن استخدامها لتعديل خصائص الكائن. |
inlineObjectProperties |
خصائص هذا الكائن المضمّن. |
suggestedInlineObjectPropertiesChanges |
التغييرات المقترَحة على خصائص العنصر المضمّن، استنادًا إلى رقم تعريف الاقتراح. |
suggestedInsertionId |
رقم تعريف الإدراج المقترَح. إذا كانت فارغة، لن يكون هذا إدراجًا مقترحًا. |
suggestedDeletionIds[] |
أرقام تعريف الحذف المقترحة. إذا كان الحقل فارغًا، لن يتم اقتراح عمليات حذف لهذا المحتوى. |
خصائص InlineObjectProperties
خصائص InlineObject
تمثيل JSON |
---|
{
"embeddedObject": {
object ( |
الحقول | |
---|---|
embeddedObject |
الكائن المضمّن في هذا الكائن المضمّن. |
inlineObject
عنصر مضمّن في المستند.
تمثيل JSON |
---|
{ "title": string, "description": string, "embeddedObjectBorder": { object ( |
الحقول | |
---|---|
title |
عنوان العنصر المضمَّن. يتم دمج كل من |
description |
وصف العنصر المضمَّن. يتم دمج كل من |
embeddedObjectBorder |
حد العنصر المضمّن. |
size |
الحجم المرئي للصورة بعد الاقتصاص |
marginTop |
الهامش العلوي من الكائن المضمن. |
marginBottom |
الهامش السفلي من الكائن المضمّن. |
marginRight |
الهامش الأيمن من الكائن المضمّن. |
marginLeft |
الهامش الأيسر من الكائن المضمّن. |
linkedContentReference |
مرجع إلى محتوى المصدر المرتبط الخارجي. على سبيل المثال، يحتوي الملف على مرجع إلى الرسم البياني المصدر في "جداول بيانات Google" عندما يكون الكائن المضمّن رسمًا بيانيًا مرتبطًا. في حال ترك هذه السياسة بدون ضبط، لن يتم ربط العنصر المضمَّن. |
حقل الاتحاد properties . الخصائص الخاصة بكل نوع كائن مضمّن. يمكن أن تكون السمة "properties " واحدة فقط مما يلي: |
|
embeddedDrawingProperties |
خصائص رسم مضمّن. |
imageProperties |
خصائص صورة معيّنة. |
inlineDrawingProperties
لا يحتوي هذا النوع على أي حقول.
يشير ذلك المصطلح إلى خصائص رسم مضمّن وتُستخدم للتمييز بين نوع الكائن. الرسم المضمن هو رسم يتم إنشاؤه وتعديله داخل مستند. يُرجى ملاحظة أن التفاصيل الشاملة غير متاحة.
خصائص الصورة
خصائص صورة معيّنة.
تمثيل 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 |
زاوية تدوير في اتجاه عقارب الساعة للصورة بوحدات الراديان. |
خصائص الاقتصاص
خصائص اقتصاص الصورة
يتم تمثيل مستطيل الاقتصاص باستخدام إزاحة كسرية من الحواف الأربعة للمحتوى الأصلي.
- إذا كانت الإزاحة في الفاصل (0، 1)، يتم وضع الحافة المقابلة لمستطيل الاقتصاص داخل المستطيل الإحاطة الأصلي للصورة.
- إذا كانت الإزاحة سالبة أو أكبر من 1، فسيتم وضع الحافة المقابلة لمستطيل الاقتصاص خارج مستطيل الحد الأصلي للصورة.
- إذا كانت جميع الإزاحة وزاوية التدوير 0، لا يتم اقتصاص الصورة.
تمثيل JSON |
---|
{ "offsetLeft": number, "offsetRight": number, "offsetTop": number, "offsetBottom": number, "angle": number } |
الحقول | |
---|---|
offsetLeft |
تحدد الإزاحة المسافة داخل الحافة اليسرى لمستطيل الاقتصاص من الحافة اليسرى للمحتوى الأصلي ككسر من عرض المحتوى الأصلي. |
offsetRight |
تحدد الإزاحة مدى طول الحافة اليمنى لمستطيل الاقتصاص من الحافة اليمنى للمحتوى الأصلي ككسر من عرض المحتوى الأصلي. |
offsetTop |
تحدد الإزاحة مدى طول الحافة العلوية لمستطيل الاقتصاص من الحافة العلوية للمحتوى الأصلي ككسر من ارتفاع المحتوى الأصلي. |
offsetBottom |
تحدد الإزاحة مدى بُعد الحافة السفلية لمستطيل الاقتصاص من الحافة السفلية للمحتوى الأصلي ككسر من ارتفاع المحتوى الأصلي. |
angle |
زاوية الدوران في اتجاه عقارب الساعة لمستطيل الاقتصاص حول مركزه، بوحدات الراديان. يتم تطبيق التناوب بعد عمليات الإزاحة. |
inlineObjectBorder
حدود حول EmbeddedObject
.
تمثيل JSON |
---|
{ "color": { object ( |
الحقول | |
---|---|
color |
لون الحدود |
width |
عرض الحد. |
dashStyle |
نمط الشرطة للحدود |
propertyState |
حالة الخاصية لخاصية الحدود. |
PropertyState
الحالات المحتملة للموقع.
عمليات التعداد | |
---|---|
RENDERED |
إذا كانت حالة الخاصية هي RENDERED، سيتوفر للعنصر الخاصية المقابلة عند عرضه في المستند. هذه هي القيمة الافتراضية. |
NOT_RENDERED |
إذا كانت حالة الخاصية NOT_RENDERED، لن يحصل العنصر على الخاصية المقابلة عند عرضه في المستند. |
مرجع المحتوى المرتبط
مرجع إلى محتوى المصدر المرتبط الخارجي.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد reference . المرجع الخاص بنوع المحتوى المرتبط. يمكن أن تكون السمة "reference " واحدة فقط مما يلي: |
|
sheetsChartReference |
مرجع إلى الرسم البياني المرتبط. |
مرجع الرسم البياني لجداول البيانات
مرجع إلى رسم بياني مرتبط مضمّن من "جداول بيانات Google".
تمثيل JSON |
---|
{ "spreadsheetId": string, "chartId": integer } |
الحقول | |
---|---|
spreadsheetId |
رقم تعريف جدول البيانات في "جداول بيانات Google" الذي يحتوي على الرسم البياني المصدر. |
chartId |
رقم تعريف الرسم البياني المحدد في جدول بيانات "جداول بيانات Google" المضمَّن. |
SuggestedInlineObjectProperties
تغيير مقترح على InlineObjectProperties
.
تمثيل JSON |
---|
{ "inlineObjectProperties": { object ( |
الحقول | |
---|---|
inlineObjectProperties |
|
inlineObjectPropertiesSuggestionState |
قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح من خلال قاعدة |
InlineObjectPropertiesSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح من خلال قاعدة InlineObjectProperties
الأساسية. بالنسبة إلى أي حقل تم ضبطه على "صحيح"، يتم تطبيق قيمة جديدة مقترَحة.
تمثيل JSON |
---|
{
"embeddedObjectSuggestionState": {
object ( |
الحقول | |
---|---|
embeddedObjectSuggestionState |
قناع يشير إلى الحقول في |
inlineObjectSuggestionState.
قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح من خلال قاعدة EmbeddedObject
الأساسية. بالنسبة إلى أي حقل تم ضبطه على "صحيح"، يتم تطبيق قيمة جديدة مقترَحة.
تمثيل JSON |
---|
{ "embeddedDrawingPropertiesSuggestionState": { object ( |
الحقول | |
---|---|
embeddedDrawingPropertiesSuggestionState |
قناع يشير إلى الحقول في |
imagePropertiesSuggestionState |
قناع يشير إلى الحقول في |
titleSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
descriptionSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
embeddedObjectBorderSuggestionState |
قناع يشير إلى الحقول في |
sizeSuggestionState |
قناع يشير إلى الحقول في |
marginLeftSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
marginRightSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
marginTopSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
marginBottomSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
linkedContentReferenceSuggestionState |
قناع يشير إلى الحقول في |
inlineDrawingPropertiesSuggestionState.
لا يحتوي هذا النوع على أي حقول.
قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح من خلال قاعدة EmbeddedDrawingProperties
الأساسية. بالنسبة إلى أي حقل تم ضبطه على "صحيح"، يتم تطبيق قيمة جديدة مقترَحة.
سمة ImagePropertiesSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح من خلال قاعدة ImageProperties
الأساسية. بالنسبة إلى أي حقل تم ضبطه على "صحيح"، يتم تطبيق قيمة جديدة مقترَحة.
تمثيل JSON |
---|
{
"contentUriSuggested": boolean,
"sourceUriSuggested": boolean,
"brightnessSuggested": boolean,
"contrastSuggested": boolean,
"transparencySuggested": boolean,
"cropPropertiesSuggestionState": {
object ( |
الحقول | |
---|---|
contentUriSuggested |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
sourceUriSuggested |
يشير إلى ما إذا كان هناك تغيير مقترَح على [sourceUri] [google.apps.docs.v1.inlineObject.source_uri]. |
brightnessSuggested |
يشير إلى ما إذا كان هناك تغيير مقترح في [السطوع] [google.apps.docs.v1.inlineObject.brightness]. |
contrastSuggested |
يشير إلى ما إذا كان هناك تغيير مقترَح على [contrast] [google.apps.docs.v1.inlineObject.contrast]. |
transparencySuggested |
يشير إلى ما إذا كان هناك تغيير مقترح في [transparency] [google.apps.docs.v1.inlineObject.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 |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
inlineObjectBorderSuggestionState
قناع يشير إلى الحقول التي تم تغييرها في هذا الاقتراح من خلال قاعدة EmbeddedObjectBorder
الأساسية. بالنسبة إلى أي حقل تم ضبطه على "صحيح"، يتم تطبيق قيمة جديدة مقترَحة.
تمثيل JSON |
---|
{ "colorSuggested": boolean, "widthSuggested": boolean, "dashStyleSuggested": boolean, "propertyStateSuggested": boolean } |
الحقول | |
---|---|
colorSuggested |
يشير إلى ما إذا كان هناك تغيير مقترَح لـ [color] [google.apps.docs.v1.inlineBorderObject.color]. |
widthSuggested |
يشير إلى ما إذا كان هناك تغيير مقترح في [width] [google.apps.docs.v1.inlineBorderObject.width]. |
dashStyleSuggested |
يشير إلى ما إذا كان هناك تغيير مقترح في [dashStyle] [google.apps.docs.v1.inlineBorderObject.dash_style]. |
propertyStateSuggested |
يشير إلى ما إذا كان هناك تغيير مقترَح على [propertyState] [google.apps.docs.v1.inlineBorderObject.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 |
العنصر الذي تم تحديد موضعه يظهر خلف النص. |
SuggestPositionedObjectProperties
تغيير مقترح على 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 |
يشير هذا الحقل إلى ما إذا كان هناك تغيير مقترَح على |
الطُرق |
|
---|---|
|
يتم تطبيق تعديل واحد أو أكثر على المستند. |
|
ينشئ مستندًا فارغًا باستخدام العنوان المحدّد في الطلب. |
|
يتم الحصول على أحدث نسخة من المستند المحدَّد. |