Text

TextContent

一般文字內容。文字須位於相容的形狀 (例如文字方塊或矩形) 中，或是頁面中的表格儲存格。

JSON 表示法 
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
欄位
textElements[]

object (TextElement)

文字內容可細分為元件部分，包括樣式資訊。這個屬性處於唯讀狀態。

lists

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

這段文字中包含的項目符號清單，並以清單 ID 做為索引鍵。

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 代表段落的範圍。其他含有索引範圍的 TextElements 也包含在這個段落的範圍中，因此也視為這個段落的一部分。兩個不同段落的索引範圍永遠不會重疊。

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 巢狀結構的段落樣式。
  • 清單中的段落會沿用父預留位置中清單的對應巢狀結構層級的段落樣式。

在這封郵件中，沿用的段落樣式會以未設定的欄位表示。

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)

段落的間距模式。

對齊

段落的文字對齊類型。

列舉
ALIGNMENT_UNSPECIFIED 段落對齊方式會從父項沿用。
START 段落會與線條開頭對齊。讓 LTR 文字靠左對齊，否則靠右對齊。
CENTER 段落置中。
END 段落會與線條結尾對齊。靠右對齊 (使用 LTR 文字)，否則靠左對齊。
JUSTIFIED 此段落已左右對齊。

TextDirection

路線文字可以流入。

列舉
TEXT_DIRECTION_UNSPECIFIED 文字方向會從父項沿用。
LEFT_TO_RIGHT 文字從左到右。
RIGHT_TO_LEFT 文字從右到左。

SpacingMode

段落間距的各種模式。

列舉
SPACING_MODE_UNSPECIFIED 間距模式會從父項沿用。
NEVER_COLLAPSE 一律顯示段落間距。
COLLAPSE_LISTS 清單元素之間會略過段落間距。

項目符號

說明段落的項目符號。

JSON 表示法 
{
  "listId": string,
  "nestingLevel": integer,
  "glyph": string,
  "bulletStyle": {
    object (TextStyle)
  }
}
欄位
listId

string

此段落所屬清單的 ID。

nestingLevel

integer

這個段落在清單中的巢狀結構層級。

glyph

string

這個段落的項目符號字符。

bulletStyle

object (TextStyle)

段落專屬文字樣式已套用至這個項目符號。

TextStyle

代表可套用至 TextRun 的樣式。

如果這段文字包含在含有父項的形狀中 placeholder，那麼這些文字樣式可能會從父項沿用。系統會根據清單的巢狀層級，繼承哪些文字樣式：

  • 如果文字是在非清單中列出的段落，該段落就會從父項預留位置內 0 巢狀結構中的段落沿用新行字元的文字樣式。
  • 清單中列出的段落文字，會沿用段落中新行字元的文字樣式，該字元位於父項預留位置中對應的巢狀層級。

在這則訊息中，沿用的文字樣式會以未設定的欄位表示。如果文字的圖案包含父項預留位置，則取消設定這些欄位後，樣式就會還原為與簡報編輯器中預設值相符的值。

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

文字的字型系列。

字型系列可以是 Google 簡報中「字型」選單的任何字型，或是 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

文字可以與正常位置垂直偏移的方式。

列舉
BASELINE_OFFSET_UNSPECIFIED 文字的基準偏移值會從父項沿用。
NONE 文字未垂直偏移。
SUPERSCRIPT 文字會垂直向上偏移 (上標)。
SUBSCRIPT 文字會垂直向下偏移 (下標)。

WeightedFontFamily

代表用於設定 TextRun 樣式的字型系列和粗細。

JSON 表示法 
{
  "fontFamily": string,
  "weight": integer
}
欄位
fontFamily

string

文字的字型系列。

字型系列可以是 Google 簡報中「字型」選單中的任何字型， 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)

套用至這段自動文字的樣式。

類型

自動文字類型

列舉
TYPE_UNSPECIFIED 未指定的自動文字類型。
SLIDE_NUMBER 輸入代表目前投影片號碼的自動文字。

清單

清單會針對與清單相關聯的段落，說明項目符號的外觀和風格。屬於清單的段落會明確參照該清單的 ID。

JSON 表示法 
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
欄位
listId

string

清單的 ID。

nestingLevel

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

對應層級項目符號屬性的巢狀圖。清單最多有九層巢狀結構，因此這張對應對應的鍵可能值是 0 到 8 (含)。

NestingLevel

包含的屬性可說明特定巢狀結構層級清單項目符號的外觀和風格。

JSON 表示法 
{
  "bulletStyle": {
    object (TextStyle)
  }
}
欄位
bulletStyle

object (TextStyle)

這種巢狀結構層級的項目符號樣式，