Text

TextContent

一般文本内容。文字必须位于页面上的兼容形状（例如文本框或矩形）或表格单元格中。

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

字段

字段
`textElements[]`	`object (TextElement)` 分解为各个组成部分的文本内容，包括样式设置信息。此属性为只读属性。
`lists`	`map (key: string, value: object ( List))` 此文本中包含的带项目符号的列表，按列表 ID 键控。

textElements[]

object (TextElement)

分解为各个组成部分的文本内容，包括样式设置信息。此属性为只读属性。

lists

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

此文本中包含的带项目符号的列表，按列表 ID 键控。

TextElement

TextElement 用于描述 Shape 或 TableCell 的文本内容中某个索引范围的内容。

JSON 表示法

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,

  // 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)` 表示新段落开头的标记。相应 TextElement 的 `startIndex` 和 `endIndex` 表示段落的范围。索引范围包含在此段落范围内的其他 TextElement 会被视为此段落的一部分。两个单独段落的索引范围永远不会重叠。
`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)` 相应段落的项目符号。如果不存在，则相应段落不属于列表。

style

object (ParagraphStyle)

段落的样式

bullet

object (Bullet)

相应段落的项目符号。如果不存在，则相应段落不属于列表。

ParagraphStyle

应用于整个段落的样式。

如果此文本包含在具有父 placeholder 的形状中，则这些段落样式可能会从父级继承。继承哪些段落样式取决于列表的嵌套级别：

不在列表中的段落将从父占位符内嵌套级别为 0 的列表中的段落继承其段落样式。
列表中的段落将从父占位符中列表的相应嵌套级别的段落继承其段落样式。

继承的段落样式在此消息中表示为未设置的字段。

JSON 表示法

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,
  "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`	段落与行尾对齐。对于从左到右的文本，则为右对齐；否则为左对齐。
`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 的列表中的段落换行符继承其文本样式。
段落中位于列表中的文本运行将从段落中位于父占位符内列表的相应嵌套级别的换行符继承其文本样式。

继承的文本样式在此消息中表示为未设置的字段。如果形状中包含文本，但没有父占位符，则取消设置这些字段会将样式恢复为与 Google 幻灯片编辑器中的默认值相匹配的值。

JSON 表示法

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)
  },
  "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 Fonts 中的任何字体。如果字体名称无法识别，则文本将以 `Arial` 呈现。某些字体可能会影响文本的粗细。如果更新请求同时为 `fontFamily` 和 `bold` 指定了值，则使用明确设置的 `bold` 值。
`fontSize`	`object (Dimension)` 文字的字体大小。读取时，`fontSize` 将以点为单位指定。
`link`	`object (Link)` 相应文本的超链接目标网址。如果未设置，则表示没有链接。链接不会从父文本继承。更改更新请求中的链接会导致范围的文字样式发生一些其他变化：设置链接时，文字前景色将设置为 `ThemeColorType.HYPERLINK`，文字将带有下划线。如果这些字段在同一请求中进行了修改，系统将使用这些值，而不是链接默认值。如果为与现有链接重叠的文本范围设置链接，系统也会更新现有链接，使其指向新网址。无法在换行符上设置链接。因此，如果对跨越段落边界的文本范围（例如 `"ABC\n123"`）设置链接，换行符将拆分为各自的文本运行。该链接将分别应用于换行符之前和之后的运行。移除链接后，相应范围的文字样式将更新为与前面的文字样式一致（如果前面的文字是另一个链接，则更新为默认文字样式），除非在同一请求中设置了不同的样式。
`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` 的值一致。如果为 true，则应用 `weightedFontFamily` 的字体系列和粗细。否则，系统会返回 400 错误请求错误。如果设置了 `weightedFontFamily` 但未设置 `fontFamily`，则应用 `weightedFontFamily` 的字体系列和粗细。如果这两个字段均未设置，则文本的字体系列和粗细会继承自父元素。请注意，这些属性无法单独相互继承。如果更新请求同时为 `weightedFontFamily` 和 `bold` 指定了值，则系统会先应用 `weightedFontFamily`，然后再应用 `bold`。如果未设置 `weightedFontFamily#weight`，则默认为 `400`。如果设置了 `weightedFontFamily`，则还必须设置 `weightedFontFamily#fontFamily`，且该值不得为空。否则，系统会返回 400 错误请求错误。

OptionalColor

一种可以完全不透明或完全透明的颜色。

JSON 表示法
{ "opaqueColor": { object (`OpaqueColor`) } }

字段

字段
`opaqueColor`	`object (OpaqueColor)` 如果设置，则将此颜色用作不透明颜色。如果未设置，则表示透明颜色。

opaqueColor

object (OpaqueColor)

如果设置，则将此颜色用作不透明颜色。如果未设置，则表示透明颜色。

BaselineOffset

文本可垂直偏移其正常位置的方式。

枚举
`BASELINE_OFFSET_UNSPECIFIED`	文本的基线偏移量继承自父级。
`NONE`	文字未垂直偏移。
`SUPERSCRIPT`	文字向上垂直偏移（上标）。
`SUBSCRIPT`	文字垂直向下偏移（下标）。

WeightedFontFamily

表示用于设置 TextRun 样式的字体系列和粗细。

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

字段

字段
`fontFamily`	`string` 文本的字体系列。字体系列可以是幻灯片“字体”菜单中的任何字体，也可以是 Google Fonts 中的任何字体。如果字体名称无法识别，则文本将以 `Arial` 呈现。
`weight`	`integer` 文本的呈现粗细。此字段可以具有介于 `100` 和 `900` 之间（含边界值）的任何 `100` 的倍数值。此范围对应于 CSS 2.1 规范第 15.6 节中描述的数值，不允许使用非数值。大于或等于 `700` 的字重被视为粗体，小于 `700` 的字重不被视为粗体。默认值为 `400`（“正常”）。

fontFamily

string

文本的字体系列。

字体系列可以是幻灯片“字体”菜单中的任何字体，也可以是 Google Fonts 中的任何字体。如果字体名称无法识别，则文本将以 Arial 呈现。

weight

integer

文本的呈现粗细。此字段可以具有介于 100 和 900 之间（含边界值）的任何 100 的倍数值。此范围对应于 CSS 2.1 规范第 15.6 节中描述的数值，不允许使用非数值。大于或等于 700 的字重被视为粗体，小于 700 的字重不被视为粗体。默认值为 400（“正常”）。

TextRun

一种 TextElement 类型，表示具有相同样式的文本运行。

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

字段

字段
`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

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（含 0 和 8）。

listId

string

列表的 ID。

nestingLevel

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

一个从嵌套级别到关联级别上项目符号属性的映射。列表最多有 9 个嵌套级别，因此此映射的键的可能值为 0 到 8（含 0 和 8）。

NestingLevel

包含描述指定嵌套级别的列表项目符号外观的属性。

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

字段

字段
`bulletStyle`	`object (TextStyle)` 相应嵌套级别的项目符号样式。

bulletStyle

object (TextStyle)

相应嵌套级别的项目符号样式。

Text 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

TextContent

TextElement

ParagraphMarker

ParagraphStyle

对齐

TextDirection

SpacingMode

子弹

TextStyle

OptionalColor

BaselineOffset

WeightedFontFamily

TextRun

AutoText

类型

列表

NestingLevel

Text