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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "paragraphMarker": {
    object (ParagraphMarker)
  },
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  }
  // End of mutually exclusive fields.
}
الحقول
startIndex

integer

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

endIndex

integer

الفهرس النهائي لعنصر النص هذا، وهو فهرس حصري ويبدأ من الصفر، بوحدات رموز يونيكود.

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

object (ParagraphMarker)

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

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

textRun

object (TextRun)

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

سيكون كل من startIndex و endIndex من TextRuns مضمّنًا بالكامل في نطاق الفهرس الخاص بعنصر paragraphMarker TextElement واحد. بعبارة أخرى، لن يمتد 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: طلب غير صالح".

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)

نمط التعداد النقطي في مستوى التضمين هذا.