Text

TextContent

תוכן הטקסט הכללי. הטקסט צריך להיות בפורמט תואם (למשל תיבת טקסט או מלבן) או בתא בטבלה בדף.

ייצוג JSON 
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
שדות
textElements[]

object (TextElement)

התוכן של הטקסט מחולק לחלקים שמרכיבים אותו, כולל פרטי עיצוב. הנכס הזה הוא לקריאה בלבד.

lists

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

הרשימות עם התבליטים שכלולות בטקסט הזה, מקודדות לפי מזהה רשימה.

TextElement

TextElement מתאר את התוכן של טווח אינדקסים בתוכן הטקסט של צורה או 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 תמיד ייכללו באופן מלא בטווח האינדקס של 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 ברשימה שבתוך placeholder ברמת ההורה.
  • פסקה ברשימה תירש את סגנון הפסקה שלה מפסקה ברמת הסידור הפנימי המתאימה של הרשימה בתוך placeholder ברמת ההורה.

סגנונות פסקה שעברו בירושה מיוצגים כשדות לא מוגדרים בהודעה הזו.

ייצוג 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)

מצב הריווח בין הפסקה.

יישור

סוגי היישור של טקסט בפסקה.

טיפוסים בני מנייה (enum)
ALIGNMENT_UNSPECIFIED היישור בין הפסקאות עובר בירושה מתבנית ההורה.
START הפסקה מיושרת לתחילת השורה. יישור לשמאל לטקסט LTR, אחרת מיושר לימין.
CENTER הפסקה במרכז.
END הפסקה מיושרת לסוף השורה. יישור לימין לטקסט LTR, אחרת מיושר לשמאל.
JUSTIFIED הפסקה ישרה.

TextDirection

הטקסט של המסלול יכול לזרום.

טיפוסים בני מנייה (enum)
TEXT_DIRECTION_UNSPECIFIED כיוון הטקסט עובר בירושה מתבנית ההורה.
LEFT_TO_RIGHT הטקסט הולך משמאל לימין.
RIGHT_TO_LEFT הטקסט הולך מימין לשמאל.

SpacingMode

המצבים השונים של ריווח פסקאות.

טיפוסים בני מנייה (enum)
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 של הרשימה בתוך placeholder ברמת ההורה.
  • טקסט שפועל בפסקה שמופיעה ברשימה יקבל בירושה את סגנון הטקסט שלו מהתו של השורה החדשה בפסקה, ברמת הסידור הפנימי המתאימה ברשימה בתוך ה-placeholder המוגדר כהורה.

סגנונות טקסט שעברו בירושה מיוצגים כשדות לא מוגדרים בהודעה הזו. אם טקסט כלול בצורה ללא placeholder של הורה, ביטול ההגדרה של השדות האלה יחזיר את הסגנון לערך שתואם לברירות המחדל בעורך Slides.

ייצוג 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

משפחת הגופנים של הטקסט.

משפחת הגופנים יכולה להיות כל גופן בתפריט 'גופן' ב-Slides או מתוך 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

הדרכים שבהן ניתן להטות טקסט אנכית מהמיקום הרגיל שלו.

טיפוסים בני מנייה (enum)
BASELINE_OFFSET_UNSPECIFIED ההיסט הבסיסי של הטקסט עובר בירושה מתבנית ההורה.
NONE הטקסט לא קוזז אנכית.
SUPERSCRIPT הטקסט מיסט אנכי למעלה (כתב עילי).
SUBSCRIPT הטקסט מיסט אנכי למטה (כתב תחתי).

WeightedFontFamily

מייצג את משפחת הגופנים והמשקל שמשמשים לסגנון של TextRun.

ייצוג JSON 
{
  "fontFamily": string,
  "weight": integer
}
שדות
fontFamily

string

משפחת הגופנים של הטקסט.

משפחת הגופנים יכולה להיות כל גופן בתפריט 'גופן' ב-Slides או מתוך Google Fonts. אם שם הגופן לא מזוהה, הטקסט מעובד Arial

weight

integer

משקל הטקסט לאחר עיבוד. השדה הזה יכול להכיל כל ערך שהוא כפולה של 100 בין 100 וגם 900, כולל. הטווח הזה תואם לערכים המספריים שמתוארים במפרט של CSS 2.1, סעיף 15.6, שבו אסור להשתמש בערכים לא מספריים. משקלים גדולים מ- או שווה ל- 700 נחשבים למודגשים, והמשקל שלהם נמוך מ- 700 לא מודגשות. ערך ברירת המחדל הוא 400 ('רגיל').

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)

הסגנון שהוחל על הטקסט האוטומטי הזה.

סוג

סוגי הטקסטים האוטומטיים

טיפוסים בני מנייה (enum)
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)

סגנון של תבליט ברמת קינון זו.