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

這個文字元素的起始索引，以萬國碼碼元為單位。
endIndex

integer

此文字元素從零開始的結束索引，不含 Unicode 代碼單位。

聯集欄位 kind。這個元素代表的文字種類。 kind 只能是下列其中一個：
paragraphMarker

object (ParagraphMarker)

代表新段落開頭的標記。

這個 TextElement 的 startIndex 和 endIndex 代表段落的範圍。其他 TextElements 元素，如果索引範圍包含在本段落範圍內，則會視為本段落的一部分。兩個段落的索引範圍絕不會重疊。
textRun

object (TextRun)

TextElement 代表一連串文字，其中所有字元都具有相同的 TextStyle。

TextRun 的 startIndex 和 endIndex 一律會完全包含在單一 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，系統會以 400 的權重值 (「normal」) 套用 fontFamily 的值。
  • 如果同時設定這兩個欄位， 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)

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