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 表示段落的范围。索引范围包含在此段落范围内的其他 TextElement 均被视为此段落的一部分。两个单独段落的索引范围永远不会重叠。

textRun

object (TextRun)

表示某段文本的 TextElement，该段文本中的所有字符都具有相同的 TextStyle。

通过 startIndex 和 endIndex 的 TextRun 将始终完全包含在单个 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 之间（含 0 和 8）。

NestingLevel

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

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

object (TextStyle)

此嵌套级别的子弹样式。