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

האינדקס הסופי של רכיב הטקסט הזה, לא כולל, ביחידות קוד של Unicode.

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

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