Text

文字內容

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

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

object (TextElement)

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

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

這段文字中的項目符號清單 (依清單 ID 排序)。

文字元素

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

這個文字元素的從 0 開始的索引，以萬國碼 (Unicode) 代碼單位表示。

endIndex

integer

這個文字元素從 0 開始的索引 (不含萬國碼 (Unicode) 程式碼單元)。
聯集欄位 kind。這個元素代表的文字類型。 kind 只能是下列其中一個值：
paragraphMarker

object (ParagraphMarker)

代表新段落開頭的標記。

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

object (TextRun)

一個文字元素，代表執行中的所有字元都具有相同的 TextStyle。

TextRun 的 startIndex 和 endIndex 一律會包含在單一 paragraphMarker TextElement 的索引範圍中。也就是說，TextRun 一律不會橫跨多個段落。
autoText

object (AutoText)

TextText 代表文字中的一個位置，該位置以動態方式動態變更。

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 段落已對齊線條。針對由左至右的文字，靠左對齊，否則靠左對齊。
CENTER 段落置中。
END 段落已對齊線條。針對 LTR 文字，靠右對齊，否則靠左對齊。
JUSTIFIED 段落合理解釋。

文字方向

路線文字可以流入。

列舉
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)

此項目套用的段落專屬文字樣式。

文字樣式

代表可套用至 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 錯誤要求錯誤。

選填色彩

完全不透明或完全透明的顏色。

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 和 900 (包含) 之間 100 的多個值。這個範圍與 CSS 2.1 規格第 15.6 節所述的數值相同，不允許使用非數字值。系統會將大於或等於 700 的權重視為粗體，且小於 700 的權重則不會粗體。預設值為 400 (「一般」)。

執行文字

代表一段文字的 TextElement 種類，且全都具有相同的樣式。

JSON 表示法 
{
  "content": string,
  "style": {
    object (TextStyle)
  }
}
欄位
content

string

這項執行作業的文字。
style

object (TextStyle)

套用至這項執行作業的樣式。

自動文字

代表自動文字的 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))

以不同層級查看項目符號的巢狀結構對應圖。清單最多包含 9 個巢狀結構層級，因此此地圖鍵的值可能為 0 到 8 (含)。

巢狀層級

包含的屬性會以巢狀結構來表示清單項目巢狀結構的外觀與風格。

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

object (TextStyle)

此巢狀結構中的項目符號樣式。