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

Начальный индекс этого текстового элемента, отсчитываемый от нуля, в единицах кода Юникода.

endIndex

integer

Конечный индекс этого текстового элемента, отсчитываемый от нуля, исключающий его в единицах кода Юникода.

kind поля Союза. Тип текста, который представляет этот элемент. kind может быть только одним из следующих:
paragraphMarker

object ( ParagraphMarker )

Маркер, обозначающий начало нового абзаца.

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

textRun

object ( TextRun )

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

startIndex и endIndex TextRuns всегда будут полностью содержаться в диапазоне индексов одного paragraphMarker TextElement. Другими словами, 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 Абзац оправдан.

Текстдиректион

Текст направлений может течь.

Перечисления
TEXT_DIRECTION_UNSPECIFIED Направление текста наследуется от родителя.
LEFT_TO_RIGHT Текст идет слева направо.
RIGHT_TO_LEFT Текст идет справа налево.

Режим интервала

Различные режимы интервалов между абзацами.

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

  • Текст, запущенный в абзаце, которого нет в списке, унаследует свой текстовый стиль от символа новой строки в абзаце на уровне вложенности 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 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

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

Семейством шрифтов может быть любой шрифт из меню «Шрифт» в Презентациях или из Google Fonts . Если имя шрифта неизвестно, текст отображается в Arial .

weight

integer

Визуализированный вес текста. Это поле может иметь любое значение, кратное 100 от 100 до 900 включительно. Этот диапазон соответствует числовым значениям, описанным в спецификации CSS 2.1, раздел 15.6 , нечисловые значения запрещены. Вес больше или равный 700 считается жирным, а вес меньше 700 — нет. Значение по умолчанию — 400 («нормальное»).

ТекстРан

Тип 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 )

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