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

textRun

object ( TextRun )

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

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

autoText

object ( AutoText )

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

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

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

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

object ( ParagraphStyle )

Стиль абзаца

bullet

object ( Bullet )

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

Стиль абзаца

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

Если этот текст содержится в фигуре с родительским placeholder , то эти стили абзаца могут быть унаследованы от родительского элемента. Какие именно стили абзаца наследуются, зависит от уровня вложенности списков:

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

В этом сообщении унаследованные стили абзацев представлены как незаданные поля.

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), выравнивание по правому краю (RFT) — по левому краю.
CENTER Абзац выровнен по центру.
END Абзац выравнивается по концу строки. Для текста, написанного слева направо (LTR), выравнивание по левому краю (LTR) — по левому краю.
JUSTIFIED Данный абзац обоснован.

Текстовое направление

Текст с указаниями может быть плавно вставлен.

Перечисления
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

Идентификатор списка, к которому относится этот абзац.

nestingLevel

integer

Уровень вложенности этого абзаца в списке.

glyph

string

Отображаемый маркер списка для этого абзаца.

bulletStyle

object ( TextStyle )

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

Стиль текста

Представляет собой стиль, который можно применить к элементу TextRun.

Если этот текст содержится в фигуре с родительским placeholder , то эти стили текста могут быть унаследованы от родительского элемента. Какие именно стили текста наследуются, зависит от уровня вложенности списков:

  • Текст, расположенный в абзаце, не входящем в список, унаследует свой стиль от символа новой строки в абзаце на нулевом уровне вложенности списка внутри родительского заполнителя.
  • Текст, расположенный в абзаце, который находится внутри списка, унаследует свой стиль от символа новой строки в абзаце на соответствующем уровне вложенности списка внутри родительского заполнителя.

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

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 ("normal").
  • Если оба поля заданы, значение fontFamily должно совпадать со значением weightedFontFamily#fontFamily . В этом случае применяется семейство шрифтов и толщина шрифта, указанные weightedFontFamily . В противном случае возвращается ошибка 400 bad request.
  • Если параметр weightedFontFamily задан, а fontFamily — нет, применяется семейство шрифтов и толщина шрифта, указанные weightedFontFamily .
  • Если ни одно из полей не задано, семейство шрифтов и толщина текста наследуются от родительского элемента. Обратите внимание, что эти свойства не могут наследоваться отдельно друг от друга.

Если в запросе на обновление указаны значения как для weightedFontFamily , так и bold , сначала применяется weightedFontFamily , а затем bold .

Если weightedFontFamily#weight не задан, значение по умолчанию равно 400 .

Если параметр weightedFontFamily задан, то weightedFontFamily#fontFamily также должен быть задан с непустым значением. В противном случае возвращается ошибка 400 bad request.

OptionalColor

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

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

object ( OpaqueColor )

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

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

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

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

WeightedFontFamily

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

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

string

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

В качестве шрифта можно использовать любой шрифт из меню «Шрифт» в Slides или из Google Fonts . Если название шрифта не распознано, текст будет отображаться шрифтом Arial .

weight

integer

Отображаемая толщина текста. Это поле может принимать любое значение, кратное 100 , в диапазоне от 100 до 900 включительно. Этот диапазон соответствует числовым значениям, описанным в разделе 15.6 спецификации CSS 2.1, при этом нечисловые значения не допускаются. Толщина текста больше или равна 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 )

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