Text

TextContent

Es el contenido de texto general. El texto debe residir en una forma compatible (p. ej., un cuadro de texto o un rectángulo) o en una celda de tabla de una página.

Representación JSON
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
Campos
textElements[]

object (TextElement)

El contenido del texto desglosado en sus componentes, incluida la información de estilo. Esta propiedad es de solo lectura.

lists

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

Las listas con viñetas que contiene este texto, ordenadas por ID de lista

TextElement

Un TextElement describe el contenido de un rango de índices en el contenido de texto de un objeto Shape o TableCell.

Representación 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.
}
Campos
startIndex

integer

Es el índice de inicio basado en cero de este elemento de texto, en unidades de código Unicode.

endIndex

integer

Es el índice de finalización basado en cero de este elemento de texto, exclusivo, en unidades de código Unicode.

Campo de unión kind. El tipo de texto que representa este elemento. kind solo puede ser una de las siguientes opciones:
paragraphMarker

object (ParagraphMarker)

Es un marcador que representa el inicio de un nuevo párrafo.

El startIndex y endIndex de este TextElement representan el rango del párrafo. Otros TextElements con un rango de índice contenido dentro del rango de este párrafo se consideran parte de este párrafo. El rango de índices de dos párrafos separados nunca se superpondrá.

textRun

object (TextRun)

Un TextElement que representa una ejecución de texto en la que todos los caracteres de la ejecución tienen el mismo TextStyle.

El startIndex y endIndex de TextRuns siempre estarán completamente contenidos en el rango de índices de una única paragraphMarker TextElement En otras palabras, TextRun nunca abarcará varios párrafos.

autoText

object (AutoText)

TextElement que representa un punto en el texto que se reemplaza de forma dinámica por contenido que puede cambiar con el tiempo.

ParagraphMarker

Es un tipo de TextElement que representa el inicio de un nuevo párrafo.

Representación JSON
{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}
Campos
style

object (ParagraphStyle)

El estilo del párrafo

bullet

object (Bullet)

El punto de viñeta de este párrafo. Si no está presente, el párrafo no pertenece a una lista.

ParagraphStyle

Estilos que se aplican a un párrafo completo.

Si este texto está contenido en una forma con un placeholder superior, estos estilos de párrafo se pueden heredar del elemento superior. Los estilos de párrafo que se heredan dependen del nivel de anidación de las listas:

  • Un párrafo que no esté en una lista heredará su estilo de párrafo del párrafo en el nivel de anidamiento 0 de la lista dentro del marcador de posición superior.
  • Un párrafo en una lista heredará su estilo de párrafo del párrafo en su nivel de anidamiento correspondiente de la lista dentro del marcador de posición superior.

Los estilos de párrafo heredados se representan como campos sin configurar en este mensaje.

Representación 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)
}
Campos
lineSpacing

number

Es la cantidad de espacio entre líneas, como un porcentaje de lo normal, donde lo normal se representa como 100.0. Si no se establece, el valor se hereda del elemento superior.

alignment

enum (Alignment)

Es la alineación del texto de este párrafo.

indentStart

object (Dimension)

Es la cantidad de sangría del párrafo en el lado que corresponde al inicio del texto, según la dirección actual del texto. Si no se establece, el valor se hereda del elemento superior.

indentEnd

object (Dimension)

Es la cantidad de sangría del párrafo en el lado que corresponde al final del texto, según la dirección de texto actual. Si no se establece, el valor se hereda del elemento superior.

spaceAbove

object (Dimension)

Es la cantidad de espacio adicional sobre el párrafo. Si no la estableces, el valor se heredará del elemento superior.

spaceBelow

object (Dimension)

La cantidad de espacio adicional debajo del párrafo. Si no se establece, el valor se hereda del elemento superior.

indentFirstLine

object (Dimension)

Es la cantidad de sangría al comienzo de la primera línea del párrafo. Si no la estableces, el valor se heredará del elemento superior.

direction

enum (TextDirection)

Es la dirección del texto de este párrafo. Si no se establece, el valor predeterminado es LEFT_TO_RIGHT ya que la dirección del texto no se hereda.

spacingMode

enum (SpacingMode)

El modo de espaciado para el párrafo.

Alineación

Los tipos de alineación de texto para un párrafo.

Enumeraciones
ALIGNMENT_UNSPECIFIED La alineación del párrafo se hereda del elemento superior.
START El párrafo se alinea con el inicio de la línea. Se alinea a la izquierda para el texto LTR y a la derecha para el resto de los casos.
CENTER El párrafo está centrado.
END El párrafo se alinea con el final de la línea. Se alinea a la derecha para el texto LTR y a la izquierda para el resto de los casos.
JUSTIFIED El párrafo está justificado.

TextDirection

El texto de las instrucciones puede fluir.

Enumeraciones
TEXT_DIRECTION_UNSPECIFIED La dirección del texto se hereda del elemento superior.
LEFT_TO_RIGHT El texto va de izquierda a derecha.
RIGHT_TO_LEFT El texto va de derecha a izquierda.

SpacingMode

Los diferentes modos de espaciado entre párrafos.

Enumeraciones
SPACING_MODE_UNSPECIFIED El modo de espaciado se hereda del elemento superior.
NEVER_COLLAPSE El espaciado de párrafo siempre está renderizado.
COLLAPSE_LISTS Se omite el espaciado de párrafo entre los elementos de la lista.

Viñeta

Describe la viñeta de un párrafo.

Representación JSON
{
  "listId": string,
  "nestingLevel": integer,
  "glyph": string,
  "bulletStyle": {
    object (TextStyle)
  }
}
Campos
listId

string

Es el ID de la lista a la que pertenece este párrafo.

nestingLevel

integer

Es el nivel de anidamiento de este párrafo en la lista.

glyph

string

El glifo de viñeta renderizado para este párrafo.

bulletStyle

object (TextStyle)

Es el estilo de texto específico de párrafo que se aplicó a esta viñeta.

TextStyle

Representa el diseño que se puede aplicar a un TextRun.

Si este texto está contenido en una forma con un elemento superior placeholder, es posible que estos estilos de texto se hereden del elemento superior. Los estilos de texto que se heredan dependen del nivel de anidación de las listas:

  • Un texto ejecutado en un párrafo que no está en una lista heredará su estilo de texto del carácter de línea nueva del párrafo con el nivel de anidamiento 0 de la lista dentro del marcador de posición superior.
  • Un texto en un párrafo que se encuentra en una lista heredará su estilo de texto del carácter de nueva línea en el párrafo en su nivel de anidamiento correspondiente de la lista dentro del marcador de posición superior.

Los estilos de texto heredados se representan como campos sin configurar en este mensaje. Si el texto se encuentra en una forma sin un marcador de posición superior, si no estableces estos campos, el estilo volverá a un valor que coincida con los valores predeterminados del editor de diapositivas.

Representación 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)
  }
}
Campos
backgroundColor

object (OptionalColor)

Es el color de fondo del texto. Si se establece, el color es opaco o transparente, dependiendo de si opaqueColor de ese campo.

foregroundColor

object (OptionalColor)

Es el color del texto en sí. Si se establece, el color es opaco o transparente, dependiendo de si opaqueColor de ese campo.

bold

boolean

Indica si el texto se renderiza en negrita o no.

italic

boolean

Indica si el texto está en cursiva o no.

fontFamily

string

Es la familia de fuentes del texto.

La familia de fuentes puede ser cualquier fuente del menú Fuente en Presentaciones o de Google Fonts. Si no se reconoce el nombre de la fuente, el texto se renderiza en Arial.

Algunas fuentes pueden afectar el grosor del texto. Si una solicitud de actualización especifica valores para fontFamily y bold, se usa el valor de bold establecido de forma explícita.

fontSize

object (Dimension)

Es el tamaño de la fuente del texto. Cuando se lea, el fontSize se especificará en puntos.

baselineOffset

enum (BaselineOffset)

Es el desplazamiento vertical del texto con respecto a su posición normal.

El texto con desplazamientos de referencia SUPERSCRIPT o SUBSCRIPT se renderiza automáticamente en un tamaño de fuente más pequeño, calculado en función del campo fontSize. El fontSize en sí no se ve afectado por los cambios en este campo.

smallCaps

boolean

Indica si el texto está en mayúsculas pequeñas o no.

strikethrough

boolean

Indica si el texto está tachado o no.

underline

boolean

Indica si el texto está subrayado o no.

weightedFontFamily

object (WeightedFontFamily)

La familia de fuentes y el grosor renderizado del texto.

Este campo es una extensión de fontFamily diseñada para admitir grosores de fuente explícitos sin romper la retrocompatibilidad. Así, cuando se lee el estilo de un rango de texto, el valor de weightedFontFamily#fontFamily siempre será igual al de fontFamily Sin embargo, cuando se escriben, si ambos campos se incluyen en la máscara de campo (ya sea de forma explícita o a través del comodín "*"), sus valores se concilian de la siguiente manera:

  • Si se establece fontFamily y no weightedFontFamily, el valor de fontFamily se aplica con el peso 400 ("normal").
  • Si se establecen ambos campos, el valor de fontFamily debe coincidir con el de weightedFontFamily#fontFamily. Si es así, la familia de fuentes y el grosor de weightedFontFamily de configuración. De lo contrario, se muestra un error de solicitud incorrecta 400.
  • Si weightedFontFamily está configurado y fontFamily la familia de fuentes y el grosor weightedFontFamily de configuración.
  • Si no se establece ninguno de los campos, la familia de fuentes y el grosor del texto se heredan del elemento superior. Ten en cuenta que estas propiedades no pueden heredarse por separado.

Si una solicitud de actualización especifica valores para weightedFontFamily y bold, primero se aplica weightedFontFamily y, luego, bold.

Si weightedFontFamily#weight no está establecido, el valor predeterminado es 400

Si se establece weightedFontFamily, weightedFontFamily#fontFamily también debe establecerse con un valor no vacío. De lo contrario, se muestra un error de solicitud incorrecta 400.

OptionalColor

Es un color que puede ser completamente opaco o completamente transparente.

Representación JSON
{
  "opaqueColor": {
    object (OpaqueColor)
  }
}
Campos
opaqueColor

object (OpaqueColor)

Si se establece, se usará como un color opaco. Si no se establece, representa un color transparente.

BaselineOffset

Son las formas en que el texto se puede desplazar verticalmente desde su posición normal.

Enumeraciones
BASELINE_OFFSET_UNSPECIFIED El desplazamiento de la línea base del texto se hereda del elemento superior.
NONE El texto no está desplazado verticalmente.
SUPERSCRIPT El texto se desplaza verticalmente hacia arriba (superíndice).
SUBSCRIPT El texto se desplaza verticalmente hacia abajo (subíndice).

WeightedFontFamily

Representa una familia de fuentes y un grosor utilizados para aplicar estilo a TextRun.

Representación JSON
{
  "fontFamily": string,
  "weight": integer
}
Campos
fontFamily

string

Es la familia de fuentes del texto.

La familia de fuentes puede ser cualquier fuente del menú Fuente de Presentaciones o de Google Fonts. Si no se reconoce el nombre de la fuente, el texto se renderiza en Arial

weight

integer

El grosor renderizado del texto. Este campo puede tener cualquier valor que sea un múltiplo de 100 entre 100 y 900 inclusive. Este rango corresponde a los valores numéricos descritos en la especificación de CSS 2.1. sección 15.6, con valores no numéricos no permitidos. Los grosores mayores o iguales a 700 se consideran en negrita, y los grosores menores que 700 no están en negrita. El valor predeterminado es 400 ("normal").

TextRun

Un tipo TextElement que representa una ejecución de texto con el mismo estilo.

Representación JSON
{
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Campos
content

string

Es el texto de esta ejecución.

style

object (TextStyle)

El estilo que se aplica a esta ejecución.

AutoText

Un tipo de TextElement que representa texto automático.

Representación JSON
{
  "type": enum (Type),
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Campos
type

enum (Type)

Es el tipo de este texto automático.

content

string

El contenido renderizado de este texto automático, si está disponible.

style

object (TextStyle)

El diseño aplicado a este texto automático.

Tipo

Los tipos de texto automático

Enumeraciones
TYPE_UNSPECIFIED Un tipo de autotext no especificado.
SLIDE_NUMBER Escribe el texto automático que representa el número de diapositiva actual.

Lista

Una lista describe el aspecto de las viñetas que pertenecen a los párrafos asociados con una lista. Un párrafo que forma parte de una lista tiene una referencia implícita al ID de esa lista.

Representación JSON
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
Campos
listId

string

Es el ID de la lista.

nestingLevel

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

Un mapa de niveles de anidación para las propiedades de las viñetas en el nivel asociado. Una lista tiene como máximo nueve niveles de anidación, por lo que los valores posibles para las claves de este mapa son del 0 al 8 inclusive.

NestingLevel

Contiene propiedades que describen el aspecto de una viñeta de lista en un nivel determinado de anidación.

Representación JSON
{
  "bulletStyle": {
    object (TextStyle)
  }
}
Campos
bulletStyle

object (TextStyle)

Es el estilo de una viñeta en este nivel de anidación.