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（“normal”）。
  • 如果同时设置这两个字段，则 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 和 900 之间（包括这两个数值）且为 100 的倍数的任意值。此范围对应于 CSS 2.1 规范第 15.6 节中所述的数值，不允许使用非数值。权重大于或等于 700 均以粗体显示，且粗细小于 700 非粗体。默认值为 400（“normal”）。

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)

此嵌套级别的子弹样式。