Text

TextContent

El contenido general de texto. El texto debe encontrarse en una forma compatible (p.ej., cuadro de texto o rectángulo) o una celda de tabla en 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 se incluyen en este texto, codificadas por el ID de lista.

TextElement

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 final 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)

Marcador que representa el comienzo 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 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

Un tipo TextElement que representa el comienzo 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)

Es la 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 elemento superior placeholder, es posible que estos estilos de párrafo se hereden del elemento superior. Los estilos de párrafo que se heredan dependen del nivel de anidamiento de las listas:

  • Un párrafo que no esté en una lista heredará su estilo de párrafo del párrafo con el nivel de anidamiento 0 de la lista dentro del marcador de posición superior.
  • Un párrafo en una lista hereda 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

La cantidad de espacio entre líneas, como un porcentaje de normal, donde la normalidad se representa como 100.0. Si no la estableces, el valor se heredará del elemento superior.

alignment

enum (Alignment)

Es la alineación del texto para 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 la estableces, el valor se heredará del elemento superior.

indentEnd

object (Dimension)

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

spaceAbove

object (Dimension)

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 la estableces, el valor se heredará 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. Alineado a la izquierda para el texto LTR; de lo contrario, alineado a la derecha.
CENTER El párrafo está centrado.
END El párrafo está alineado al final de la línea. Alineado a la derecha para el texto de izquierda a derecha; de lo contrario, alineado a la izquierda
JUSTIFIED El párrafo está justificado.

TextDirection

El texto de las indicaciones 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

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

nestingLevel

integer

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 estilo que se puede aplicar a 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 anidamiento 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 ejecutado en un párrafo que está en una lista heredará su estilo de texto del carácter de línea nueva del 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 está contenido en una forma sin un marcador de posición superior, al desconfigurar estos campos se revertirá el estilo a un valor que coincida con los valores predeterminados del editor de Presentaciones.

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 que haya en él.

foregroundColor

object (OptionalColor)

El color del texto. Si se establece, el color es opaco o transparente, dependiendo de si opaqueColor que haya en él.

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

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

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

fontSize

object (Dimension)

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

baselineOffset

enum (BaselineOffset)

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

Texto con SUPERSCRIPT o SUBSCRIPT los desplazamientos de referencia se representan automáticamente en un tamaño de fuente más pequeño, que se calcula según el fontSize . El fontSize no se ve afectada por los cambios en este campo.

smallCaps

boolean

Indica si el texto está en mayúsculas 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 del fontFamily está diseñada para admitir pesos de fuente explícitos sin afectar la retrocompatibilidad. Por eso, al leer el estilo de un rango de texto, el valor de weightedFontFamily#fontFamily siempre será igual al de fontFamily Sin embargo, al escribir, si ambos campos están incluidos 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 fontFamily está configurado y weightedFontFamily no es, el valor de fontFamily se aplica con peso 400 (“normal”).
  • Si ambos campos están configurados, 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 400 de solicitud incorrecta.
  • 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 se pueden heredar por separado unas de otras.

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

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

Si weightedFontFamily y, luego, weightedFontFamily#fontFamily también se debe establecer con un valor que no esté vacío. De lo contrario, se muestra un error 400 de solicitud incorrecta.

OptionalColor

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

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

object (OpaqueColor)

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

BaselineOffset

Maneras en las que el texto se puede desplazar verticalmente de su posición normal.

Enumeraciones
BASELINE_OFFSET_UNSPECIFIED El desplazamiento del modelo de referencia 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

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 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. Pesos superiores o iguales a 700 se consideran en negrita y los pesos 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 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 estilo 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 la 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

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 de 0 a 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)

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