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

object (TextRun)

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

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

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

object (TextStyle)

此嵌套级别的子弹样式。