Text

ТекстКонтент

Общий текстовый контент. Текст должен иметь совместимую форму (например, текстовое поле или прямоугольник) или ячейку таблицы на странице.

Представление JSON
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
Поля
textElements[]

object ( TextElement )

Текстовое содержимое разбито на составные части, включая информацию о стиле. Это свойство доступно только для чтения.

lists

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

Маркированные списки, содержащиеся в этом тексте, с ключом по идентификатору списка.

ТекстЭлемент

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 представляют диапазон абзаца. Другие TextElements с диапазоном индексов, содержащимся внутри диапазона этого абзаца, считаются частью этого абзаца. Диапазон индексов двух отдельных абзацев никогда не будет пересекаться.

textRun

object ( TextRun )

TextElement, представляющий набор текста, в котором все символы в наборе имеют одинаковый TextStyle .

startIndex и endIndex TextRuns всегда будут полностью содержаться в диапазоне индексов одного paragraphMarker . Другими словами, TextRun никогда не будет занимать несколько абзацев.

autoText

object ( AutoText )

TextElement, представляющий место в тексте, которое динамически заменяется содержимым, которое может изменяться с течением времени.

Маркер абзаца

Тип TextElement, представляющий начало нового абзаца.

Представление JSON
{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}
Поля
style

object ( ParagraphStyle )

Стиль абзаца

bullet

object ( Bullet )

Пуля для этого абзаца. Если не присутствует, абзац не принадлежит к списку.

Стиль абзаца

Стили, которые применяются ко всему абзацу.

Если этот текст содержится в фигуре с родительским 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 )

К этому маркеру применен особый стиль текста абзаца.

стиль текста

Представляет стиль, который можно применить к 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

Семейство шрифтов текста.

Семейство шрифтов может быть любым шрифтом из меню «Шрифт» в Slides или из 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.

НеобязательныйЦвет

Цвет, который может быть либо полностью непрозрачным, либо полностью прозрачным.

Представление JSON
{
  "opaqueColor": {
    object (OpaqueColor)
  }
}
Поля
opaqueColor

object ( OpaqueColor )

Если установлено, это будет использоваться как непрозрачный цвет. Если не установлено, это представляет прозрачный цвет.

Базовое смещение

Способы вертикального смещения текста относительно его нормального положения.

перечисления
BASELINE_OFFSET_UNSPECIFIED Смещение базовой линии текста наследуется от родителя.
NONE Текст не смещен по вертикали.
SUPERSCRIPT Текст смещен по вертикали вверх (верхний индекс).
SUBSCRIPT Текст смещен по вертикали вниз (нижний индекс).

Семейство взвешенных шрифтов

Представляет семейство шрифтов и толщину, используемые для оформления TextRun.

Представление JSON
{
  "fontFamily": string,
  "weight": integer
}
Поля
fontFamily

string

Семейство шрифтов текста.

Семейство шрифтов может быть любым шрифтом из меню «Шрифт» в Slides или из 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 )

Стиль, примененный к этому прогону.

Авто текст

Тип TextElement, представляющий автоматический текст.

Представление JSON
{
  "type": enum (Type),
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Поля
type

enum ( Type )

Тип этого автотекста.

content

string

Визуализированное содержимое этого автотекста, если оно доступно.

style

object ( TextStyle )

Стиль, примененный к этому автотексту.

Тип

Типы автотекста

перечисления
TYPE_UNSPECIFIED Неопределенный тип автотекста.
SLIDE_NUMBER Введите автотекст, представляющий номер текущего слайда.

Список

Список описывает внешний вид маркеров, принадлежащих абзацам, связанным со списком. Абзац, являющийся частью списка, имеет неявную ссылку на идентификатор этого списка.

Представление JSON
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
Поля
listId

string

Идентификатор списка.

nestingLevel

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

Карта уровней вложенности со свойствами маркеров на соответствующем уровне. Список имеет не более девяти уровней вложенности, поэтому возможные значения ключей этой карты — от 0 до 8 включительно.

Уровень вложенности

Содержит свойства, описывающие внешний вид маркера списка на заданном уровне вложенности.

Представление JSON
{
  "bulletStyle": {
    object (TextStyle)
  }
}
Поля
bulletStyle

object ( TextStyle )

Стиль пули на этом уровне вложенности.