Text

TextContent

تمثّل هذه السمة المحتوى النصي العام. يجب أن يكون النص في شكل متوافق (مثل مربّع نص أو مستطيل) أو في خلية جدول في صفحة.

تمثيل JSON 
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
الحقول
textElements[]

object (TextElement)

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

lists

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

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

TextElement

يصف TextElement محتوى نطاق من الفهارس في المحتوى النصي لـ Shape أو TableCell.

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

  // Union field kind can be only one of the following:
  "paragraphMarker": {
    object (ParagraphMarker)
  },
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  }
  // End of list of possible types for union field kind.
}
الحقول
startIndex

integer

يشير إلى فهرس البدء الصفري لعنصر النص هذا، بوحدات رموز Unicode.

endIndex

integer

فهرس النهاية المستند إلى الصفر لعنصر النص هذا، باستثناء وحدات رمز Unicode.

حقل الدمج kind. نوع النص الذي يمثّله هذا العنصر kind يمكن أن تكون إحدى القيم التالية فقط:
paragraphMarker

object (ParagraphMarker)

علامة تمثّل بداية فقرة جديدة

يمثّل startIndex و endIndex في TextElement نطاق الفقرة. يُعدّ أي TextElement آخر يتضمّن نطاق فهرس مضمّنًا في نطاق هذه الفقرة جزءًا من هذه الفقرة. لن يتداخل نطاق فهارس فقرتَين منفصلتَين أبدًا.

textRun

object (TextRun)

يمثّل TextElement سلسلة من النص تتضمّن أحرفًا لها TextStyle نفسها.

سيكون النطاقان startIndex وendIndex الخاصان بـ TextRuns مضمّنين دائمًا بالكامل في نطاق الفهرس الخاص بعنصر TextElement واحد paragraphMarker. بعبارة أخرى، لن يمتد TextRun أبدًا على عدة فقرات.

autoText

object (AutoText)

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

ParagraphMarker

نوع TextElement يمثّل بداية فقرة جديدة.

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

object (ParagraphStyle)

نمط الفقرة

bullet

object (Bullet)

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

ParagraphStyle

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

إذا كان هذا النص مضمّنًا في شكل يتضمّن عنصرًا رئيسيًا placeholder، يمكن اكتساب أنماط الفقرات هذه من العنصر الرئيسي. تعتمد أنماط الفقرات التي يتمّ توريثها على مستوى التداخل في القوائم:

  • سيرث النص الذي لا يقع ضمن قائمة نمط الفقرة من الفقرة التي تقع في مستوى التضمين 0 للقائمة داخل العنصر النائب الرئيسي.
  • سيرث النص في فقرة ضمن قائمة نمط الفقرة من الفقرة الموجودة في مستوى التضمين المناسب للقائمة داخل العنصر النائب الرئيسي.

يتم تمثيل أنماط الفقرات الموروثة كحقول غير مضبوطة في هذه الرسالة.

تمثيل JSON 
{
  "lineSpacing": number,
  "alignment": enum (Alignment),
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "direction": enum (TextDirection),
  "spacingMode": enum (SpacingMode)
}
الحقول
lineSpacing

number

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

alignment

enum (Alignment)

تمثّل هذه السمة محاذاة النص لهذه الفقرة.

indentStart

object (Dimension)

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

indentEnd

object (Dimension)

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

spaceAbove

object (Dimension)

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

spaceBelow

object (Dimension)

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

indentFirstLine

object (Dimension)

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

direction

enum (TextDirection)

تمثّل هذه السمة اتجاه نص الفقرة. إذا لم يتم ضبطها، تكون القيمة التلقائية هي LEFT_TO_RIGHT لأنّ اتجاه النص لا يتم توريثه.

spacingMode

enum (SpacingMode)

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

محاذاة

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

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

TextDirection

يمكن أن يظهر نص الاتجاهات تدريجيًا.

عمليات التعداد
TEXT_DIRECTION_UNSPECIFIED يتم اكتساب اتجاه النص من العنصر الرئيسي.
LEFT_TO_RIGHT يتم عرض النص من اليسار إلى اليمين.
RIGHT_TO_LEFT يظهر النص من اليمين إلى اليسار.

SpacingMode

الأوضاع المختلفة للمسافة بين الفقرات

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

تعداد نقطي

تصف هذه السمة النقطة في الفقرة.

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

string

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

nestingLevel

integer

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

glyph

string

رمز التعداد النقطي المعروض لهذه الفقرة

bulletStyle

object (TextStyle)

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

TextStyle

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

إذا كان هذا النص مضمّنًا في شكل يتضمّن عنصرًا رئيسيًا placeholder، قد يتم اكتساب أنماط النص هذه من العنصر الرئيسي. تعتمد أنماط النصوص التي يتمّ توريثها على مستوى التداخل في القوائم:

  • سيرث جزء من النص في فقرة غير مدرَجة في قائمة نمط النص من حرف السطر الجديد في الفقرة عند مستوى التداخل 0 للقائمة داخل العنصر النائب الرئيسي.
  • سيرث جزء من النص في فقرة ضمن قائمة نمط النص من حرف السطر الجديد في الفقرة على مستوى التداخل المقابل للقائمة داخل العنصر النائب الرئيسي.

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

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

object (OptionalColor)

لون خلفية النص في حال ضبط هذا الحقل، يكون اللون إما معتمًا أو شفافًا، وذلك حسب ما إذا تم ضبط الحقل opaqueColor فيه.

foregroundColor

object (OptionalColor)

لون النص نفسه في حال ضبط هذا الحقل، يكون اللون إما معتمًا أو شفافًا، وذلك حسب ما إذا تم ضبط الحقل opaqueColor فيه.

bold

boolean

تحدّد هذه السمة ما إذا كان النص معروضًا بخط غامق أم لا.

italic

boolean

تُستخدَم لتحديد ما إذا كان النص مائلاً أم لا.

fontFamily

string

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

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

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

fontSize

object (Dimension)

حجم خط النص عند قراءة fontSize ، سيتم تحديدها بالنقاط.

baselineOffset

enum (BaselineOffset)

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

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

smallCaps

boolean

تُستخدَم لتحديد ما إذا كان النص مكتوبًا بأحرف كبيرة صغيرة أم لا.

strikethrough

boolean

تُستخدَم لتحديد ما إذا كان النص مشطوبًا أم لا.

underline

boolean

تحديد ما إذا كان النص تحته خط أم لا

weightedFontFamily

object (WeightedFontFamily)

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

هذا الحقل هو امتداد للحقل fontFamily، وهو مصمّم لإتاحة استخدام أوزان خطوط صريحة بدون إيقاف التوافق مع الإصدارات السابقة. وبالتالي، عند قراءة نمط نطاق من النص، ستكون قيمة weightedFontFamily#fontFamily مساوية دائمًا لقيمة fontFamily. ومع ذلك، عند الكتابة، إذا تم تضمين كلا الحقلين في قناع الحقل (إما بشكل صريح أو من خلال حرف البدل "*")، يتم التوفيق بين قيمهما على النحو التالي:

  • في حال ضبط fontFamily وعدم ضبط weightedFontFamily، يتم تطبيق قيمة fontFamily مع الوزن 400 ("عادي").
  • في حال ضبط الحقلين، يجب أن تتطابق قيمة fontFamily مع قيمة weightedFontFamily#fontFamily. وفي هذه الحالة، يتم تطبيق عائلة الخط ووزنه على weightedFontFamily. وفي حال عدم توفّرها، سيتم عرض رسالة الخطأ "400: طلب غير صالح".
  • في حال ضبط weightedFontFamily وعدم ضبط fontFamily ، يتم تطبيق عائلة الخط وعرضه في weightedFontFamily.
  • إذا لم يتم ضبط أي من الحقلين، سيتم اكتساب مجموعة الخطوط ووزن النص من العنصر الأصل. يُرجى العِلم أنّه لا يمكن أن ترث هذه الخصائص بشكل منفصل عن بعضها البعض.

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

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

في حال ضبط weightedFontFamily، يجب أيضًا ضبط weightedFontFamily#fontFamily بقيمة غير فارغة. وفي حال عدم توفّرها، سيتم عرض رسالة الخطأ 400 Bad Request.

OptionalColor

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

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

object (OpaqueColor)

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

BaselineOffset

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

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

WeightedFontFamily

تمثّل هذه السمة مجموعة خطوط وعرض خط مستخدَمَين لتنسيق TextRun.

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

string

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

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

weight

integer

تمثّل هذه السمة كثافة النص المعروض. يمكن أن يتضمّن هذا الحقل أي قيمة من مضاعفات 100 بين 100 و 900، بما في ذلك القيمتان. يتوافق هذا النطاق مع القيم الرقمية الموضّحة في مواصفات CSS 2.1، القسم 15.6، مع عدم السماح بالقيم غير الرقمية. يتم اعتبار الأوزان الأكبر من أو تساوي 700 نصًا غامقًا، ولا يتم اعتبار الأوزان الأقل من 700 نصًا غامقًا. القيمة التلقائية هي 400 ("normal").

TextRun

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

تمثيل JSON 
{
  "content": string,
  "style": {
    object (TextStyle)
  }
}
الحقول
content

string

تمثّل هذه السمة نص عملية التشغيل.

style

object (TextStyle)

النمط المطبَّق على هذا النص

AutoText

نوع TextElement يمثّل النص التلقائي

تمثيل JSON 
{
  "type": enum (Type),
  "content": string,
  "style": {
    object (TextStyle)
  }
}
الحقول
type

enum (Type)

تمثّل هذه السمة نوع النص التلقائي.

content

string

المحتوى المعروض لهذا النص التلقائي، إذا كان متاحًا

style

object (TextStyle)

النمط المطبَّق على هذا النص التلقائي

النوع

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

عمليات التعداد
TYPE_UNSPECIFIED نوع نص تلقائي غير محدّد
SLIDE_NUMBER اكتب نصًا تلقائيًا يمثّل رقم الشريحة الحالية.

قائمة

تصف القائمة شكل ومظهر الرموز النقطية التابعة للفقرات المرتبطة بقائمة. تحتوي الفقرة التي تشكّل جزءًا من قائمة على إشارة ضمنية إلى رقم تعريف تلك القائمة.

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

string

معرّف القائمة

nestingLevel

map (key: integer, value: object ( NestingLevel))

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

NestingLevel

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

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

object (TextStyle)

تمثّل هذه السمة نمط نقطة التعداد في مستوى التداخل هذا.