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)

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