Text

{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}

object (TextElement)

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

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

القوائم النقطية المضمّنة في هذا النص، مرتبطة برقم تعريف القائمة.

{
  "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.
}

integer

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

integer

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

object (ParagraphMarker)

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

تشير رسالة الأشكال البيانية startIndex أو endIndex عنصر TextElement هذا يمثل نطاق الفقرة. يتم اعتبار العناصر النصية الأخرى التي لها نطاق فهرس داخل نطاق هذه الفقرة جزءًا من هذه الفقرة. لن يتداخل نطاق الفهارس المؤلفة من فقرتين منفصلتين أبدًا.

object (TextRun)

عنصر TextElement يمثل سلسلة من النصوص التي تتطابق فيها جميع الأحرف في مسار التشغيل TextStyle

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

object (AutoText)

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

{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}

object (ParagraphStyle)

نمط الفقرة

object (Bullet)

الرمز النقطي لهذه الفقرة. في حال عدم توفّر الفقرة، لا تنتمي الفقرة إلى قائمة.

{
  "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)
}

number

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

enum (Alignment)

محاذاة النص لهذه الفقرة.

object (Dimension)

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

object (Dimension)

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

object (Dimension)

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

object (Dimension)

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

object (Dimension)

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

enum (TextDirection)

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

enum (SpacingMode)

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

{
  "listId": string,
  "nestingLevel": integer,
  "glyph": string,
  "bulletStyle": {
    object (TextStyle)
  }
}

string

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

integer

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

string

الحرف الرسومي للرمز النقطي المعروض لهذه الفقرة.

object (TextStyle)

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

{
  "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)
  }
}

object (OptionalColor)

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

object (OptionalColor)

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

boolean

ما إذا كان النص يتم عرضه بالخط الغامق أم لا

boolean

ما إذا كان النص مائلاً أم لا

string

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

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

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

object (Dimension)

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

object (Link)

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

يؤدي تغيير الرابط في طلب التحديث إلى بعض التغييرات الأخرى في نمط النص للنطاق:

• عند ضبط رابط، سيتم ضبط لون واجهة النص على ThemeColorType.HYPERLINK وسيتم وضع خط تحت النص. إذا تم تعديل هذه الحقول في الطلب نفسه، سيتم استخدام هذه القيم بدلاً من الإعدادات التلقائية للروابط.
• سيؤدي ضبط رابط في نطاق نصي يتداخل مع رابط حالي إلى تعديل الرابط الحالي للإشارة إلى عنوان URL الجديد.
• لا يمكن ضبط الروابط على أحرف الأسطر الجديدة. ونتيجة لذلك، فإن تعيين رابط على نطاق نصي يتخطى حد الفقرة، مثل "ABC\n123"، ستفصل أحرف الأسطر الجديدة إلى نصوص تم إنشاؤها مسبقًا. سيتم تطبيق الرابط بشكل منفصل على عمليات التشغيل قبل السطر الجديد وبعده.
• وستؤدي إزالة رابط إلى تعديل نمط النص للنطاق لمطابقة نمط النص السابق (أو أنماط النص التلقائية إذا كان النص السابق رابطًا آخر) ما لم يتم ضبط أنماط مختلفة في الطلب نفسه.

enum (BaselineOffset)

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

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

boolean

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

boolean

ما إذا كان النص مشطوبًا أم لا

boolean

ما إذا كان النص مسطرًا أم لا

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 الخاصة بالطلب غير الصحيح.

{
  "opaqueColor": {
    object (OpaqueColor)
  }
}

object (OpaqueColor)

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

{
  "fontFamily": string,
  "weight": integer
}

string

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

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

integer

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

{
  "content": string,
  "style": {
    object (TextStyle)
  }
}

string

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

object (TextStyle)

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

{
  "type": enum (Type),
  "content": string,
  "style": {
    object (TextStyle)
  }
}

enum (Type)

نوع هذا النص التلقائي

string

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

object (TextStyle)

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

{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}

string

رقم تعريف القائمة.

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

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

{
  "bulletStyle": {
    object (TextStyle)
  }
}

object (TextStyle)

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