Text

{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}

object (TextElement)

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

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

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

{
  "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.
}

integer

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

integer

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

object (ParagraphMarker)

代表新段落開頭的標記。

startIndex 和 endIndex 代表段落的範圍。其他含有索引範圍的 TextElements 也包含在這個段落的範圍中，因此也視為這個段落的一部分。兩個不同段落的索引範圍永遠不會重疊。

object (TextRun)

TextElement 代表文字隨機執行，其中所有字元皆具有相同 TextStyle。

startIndex 和 endIndex TextRuns 的索引範圍一律會完全包含在單一 paragraphMarker TextElement。換句話說，TextRun 絕不會橫跨多個段落。

object (AutoText)

TextElement 代表文字內容中的一個位置，這些位置會隨著時間動態取代內容。

{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}

object (ParagraphStyle)

段落的樣式

object (Bullet)

此段落的條目。如果沒有，表示段落不屬於任一清單。

{
  "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)
}

number

以正常百分比表示兩行之間的空間大小，一般以 100.0 表示。如未設定，則會沿用父項的值。

enum (Alignment)

這個段落的文字對齊方式。

object (Dimension)

根據目前文字方向，右側段落中與文字開頭對應的縮排金額。如未設定，則會沿用父項的值。

object (Dimension)

根據目前文字方向，右側段落中與文字結尾對應的縮排金額。如未設定，則會沿用父項的值。

object (Dimension)

段落上方的額外空間大小。如未設定，則會沿用父項的值。

object (Dimension)

段落下方的額外空間大小。如未設定，則會沿用父項的值。

object (Dimension)

段落首行開頭的縮排量。如未設定，則會沿用父項的值。

enum (TextDirection)

這個段落的文字方向。如未設定，值會預設為 LEFT_TO_RIGHT 因為未沿用文字方向

enum (SpacingMode)

段落的間距模式。

{
  "listId": string,
  "nestingLevel": integer,
  "glyph": string,
  "bulletStyle": {
    object (TextStyle)
  }
}

string

此段落所屬清單的 ID。

integer

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

string

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

object (TextStyle)

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

{
  "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)
  }
}

object (OptionalColor)

文字的背景顏色。設定後，顏色就會是不透明或透明，具體取決於 opaqueColor 欄位已設定完畢。

object (OptionalColor)

文字本身的顏色。設定後，顏色就會是不透明或透明，具體取決於 opaqueColor 欄位已設定完畢。

boolean

文字是否以粗體顯示。

boolean

是否將文字設為斜體。

string

文字的字型系列。

字型系列可以是 Google 簡報中「字型」選單的任何字型，或是 Google Fonts。如果系統無法辨識字型名稱，則文字會顯示 Arial。

部分字型可能會影響文字的粗細。如果更新要求指定 fontFamily 和 bold，明確設定的 bold 值。

object (Dimension)

文字的字型大小。讀取時 fontSize 會以點表示

object (Link)

文字的超連結目的地。如未設定，則不會顯示連結。連結並非沿用自父項文字。

變更更新要求中的連結會導致範圍的文字樣式發生其他變化：

• 設定連結時，文字前景顏色會設為 ThemeColorType.HYPERLINK 文字也會加上底線如果在同一個要求中修改這些欄位，系統就會採用這些值，而非連結預設值。
• 如果設定的文字範圍與現有連結重疊，現有連結也會更新為指向新網址。
• 無法設定換行字元的連結。因此，只要在文字範圍上設定橫跨段落邊界的連結，例如 "ABC\n123"，會將新行字元分割至各自的文字執行。連結會分別套用至新行前後的執行作業。
• 移除連結會更新範圍的文字樣式，以符合前述文字的樣式 (如果前面的文字是另一個連結，則使用預設文字樣式)，除非在同一個要求中設定不同樣式。

enum (BaselineOffset)

文字與一般位置的垂直偏移。

使用以下應用程式傳送簡訊： SUPERSCRIPT 或 SUBSCRIPT 基準位移會自動以較小的字型顯示，計算依據為 fontSize ] 欄位。 fontSize 不會受到這個欄位變更的影響

boolean

是否以小型大寫字母表示文字。

boolean

文字是否加上刪除線。

boolean

文字是否加上底線。

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 錯誤的要求錯誤。

{
  "opaqueColor": {
    object (OpaqueColor)
  }
}

object (OpaqueColor)

設定後，就會以不透明顏色表示。如未設定，則代表透明顏色。

{
  "fontFamily": string,
  "weight": integer
}

string

文字的字型系列。

字型系列可以是 Google 簡報中「字型」選單中的任何字型， Google Fonts。如果系統無法辨識字型名稱，則文字會顯示 Arial。

integer

轉譯的文字權重。這個欄位的倍數可以是 100 介於 100 和 900 (含頭尾)。此範圍與 CSS 2.1 規格中所述的數值、 第 15.6 節，禁止使用非數值。權重大於或等於 700 視為粗體，而權重小於 700 不是粗體預設值為 400 (「一般」)。

{
  "content": string,
  "style": {
    object (TextStyle)
  }
}

string

此執行作業的文字。

object (TextStyle)

套用至此執行作業的樣式。

{
  "type": enum (Type),
  "content": string,
  "style": {
    object (TextStyle)
  }
}

enum (Type)

這段自動文字的類型。

string

這段自動文字的顯示內容 (如有)。

object (TextStyle)

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

{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}

string

清單的 ID。

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

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

{
  "bulletStyle": {
    object (TextStyle)
  }
}

object (TextStyle)

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