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 של TextRun תמיד ייכללו באופן מלא בטווח האינדקס של 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 של הרשימה בתוך 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 הפסקה מיושרת לתחילת השורה. מיושר לשמאל בטקסט משמאל לימין, מיושר לימין בכל מקרה אחר.
CENTER הפסקה מיושרת למרכז.
END הפסקה מיושרת לסוף השורה. מיושר לימין לטקסט משמאל לימין, מיושר לשמאל בכל מקרה אחר.
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 ראשי, ביטול ההגדרה של השדות האלה יחזיר את הסגנון לערך שתואם לברירות המחדל בכלי לעריכת מצגות.

ייצוג ב-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 ("normal").
  • אם שני השדות מוגדרים, הערך של 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 (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)

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

סוג

סוגים של טקסט אוטומטי

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

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