Text

Contenido de texto

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

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

object (TextElement)

El contenido del texto desglosado por partes, incluida la información de estilo. Esta propiedad es de solo lectura.

lists

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

Las listas con viñetas incluidas en este texto en las que se usa el ID de lista.

TextElement

Un TextElement describe el contenido de un rango de índices en el contenido de texto de una 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

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 de las unidades de código Unicode.

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

object (ParagraphMarker)

Un marcador que representa el comienzo de un nuevo párrafo.

Los elementos startIndex y endIndex de este TextElement representan el rango del párrafo. Otros elementos TextText con un rango de índice dentro del rango de este párrafo se consideran parte de este. 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.

Los elementos startIndex y endIndex de TextRuns siempre se contendrán completamente en el rango de índice de un solo elemento paragraphMarker Text. 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 párrafo nuevo.

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

object (ParagraphStyle)

El estilo del párrafo

bullet

object (Bullet)

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

  • Los párrafos que no estén en una lista heredarán su estilo del párrafo del nivel 0 de la lista dentro del marcador de posición superior.
  • Un párrafo de una lista heredará su estilo de párrafo del párrafo en el 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 las líneas, como un porcentaje de la normal, donde la normal 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 lateral que corresponde al inicio del texto, según la dirección del texto actual. Si no la estableces, el valor se heredará del elemento superior.

indentEnd

object (Dimension)

La sangría del importe en el párrafo que corresponde al final del texto, según la dirección del texto actual. 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 del 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 no se hereda la dirección del texto.

spacingMode

enum (SpacingMode)

Es el modo de espaciado para un párrafo.

Alineación

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

Enumeradores
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 hacia la izquierda para texto de izquierda a derecha, alineado hacia la derecha.
CENTER El párrafo está centrado.
END El párrafo se alinea con el final de la línea. Alineado a la derecha para texto de izquierda a derecha, a la izquierda, en caso contrario.
JUSTIFIED El párrafo se justifica.

Dirección del texto

El texto de las instrucciones sobre cómo llegar puede fluir.

Enumeradores
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.

Modo spacing

Los diferentes modos para el espaciado de párrafos.

Enumeradores
SPACING_MODE_UNSPECIFIED El modo de espaciado se hereda del elemento superior.
NEVER_COLLAPSE El espaciado de párrafo siempre se renderiza.
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

El nivel de anidamiento de este párrafo en la lista.

glyph

string

El glifo de viñetas renderizado de este párrafo.

bulletStyle

object (TextStyle)

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

TextStyle

Representa el estilo que se puede aplicar a un TextRun.

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

  • Un texto que se ejecute en un párrafo que no esté en una lista heredará su estilo de texto del carácter de nueva línea del párrafo en el nivel 0 de anidamiento de la lista dentro del marcador de posición principal.
  • Un texto que se ejecute en un párrafo que esté en una lista heredará su estilo de texto del carácter de nueva línea en el párrafo en el 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 principal, la anulación de estos campos revertirá el estilo a un valor que coincida con los valores predeterminados en el 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)

El color de fondo del texto Si se establece, el color es opaco o transparente, según si se establece el campo opaqueColor.

foregroundColor

object (OptionalColor)

El color del texto en sí Si se establece, el color es opaco o transparente, según si se establece el campo opaqueColor.

bold

boolean

Indica si el texto se renderiza en negrita.

italic

boolean

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ú Font en Presentaciones o desde Google Fonts. Si no se reconoce el nombre de la fuente, se renderiza el texto 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 bold establecido de forma explícita.

fontSize

object (Dimension)

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

baselineOffset

enum (BaselineOffset)

Desplazamiento vertical del texto desde su posición normal.

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

smallCaps

boolean

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

strikethrough

boolean

Indica si el texto ha sido tachado o no.

underline

boolean

Indica si el texto está subrayado o no.

weightedFontFamily

object (WeightedFontFamily)

Es la familia de fuentes y el peso renderizado del texto.

Este campo es una extensión de fontFamily diseñada para admitir tamaños de fuente explícitos sin afectar la retrocompatibilidad. Por lo tanto, cuando se lea el estilo de un rango de texto, el valor de weightedFontFamily#fontFamily siempre será igual al de fontFamily. Sin embargo, cuando se escriben ambos campos si se incluyen en la máscara de campo (ya sea de forma explícita o mediante el comodín "*"), sus valores se concilian de la siguiente manera:

  • Si se establece fontFamily y no se establece weightedFontFamily, se aplica el valor de fontFamily con el peso 400 ("normal").
  • Si se configuran ambos campos, el valor de fontFamily debe coincidir con el de weightedFontFamily#fontFamily. Si es así, se aplican la familia de fuentes y el grosor de weightedFontFamily. De lo contrario, se muestra un error 400 de solicitud incorrecta.
  • Si se establece weightedFontFamily y no se configura fontFamily, se aplican la familia de fuentes y el grosor de weightedFontFamily.
  • Si no se establece ninguno de los campos, la familia de fuentes y el grosor del texto heredan del elemento superior. Tenga en cuenta que estas propiedades no se pueden heredar de forma independiente.

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

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

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

Color opcional

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 color opaco. Si no se establece, representa un color transparente.

Compensación de referencia

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

Enumeradores
BASELINE_OFFSET_UNSPECIFIED El desplazamiento de referencia del texto se hereda del elemento superior.
NONE El texto no está desplazado verticalmente.
SUPERSCRIPT El texto está desplazado verticalmente (superíndice).
SUBSCRIPT El texto se desplaza verticalmente hacia abajo (subíndice).

Fuente de la familia con ponderación

Representa una familia de fuentes y el peso que se usa para diseñar un elemento 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ú Font en Presentaciones o desde Google Fonts. Si no se reconoce el nombre de la fuente, se renderiza el texto en Arial.

weight

integer

Es el peso 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. Los pesos superiores o iguales a 700 se consideran en negrita, y los pesos menores que 700 no lo son. El valor predeterminado es 400 ("normal").

Ejecución de texto

Un tipo TextElement que representa una secuencia 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 aplicado a esta ejecución.

Texto automático

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

Tipos de texto automático

Enumeradores
TYPE_UNSPECIFIED Tipo de texto automático sin especificar.
SLIDE_NUMBER Escribe el texto automático que representa el número de la diapositiva actual.

Cómo mostrar en lista

Una lista describe el aspecto de las viñetas que pertenecen a los párrafos asociados con una lista. Los párrafos que forman parte de una lista tienen 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))

Mapa de niveles anidados con las propiedades de las viñetas en el nivel asociado. Una lista tiene, como máximo, nueve niveles de anidamiento, por lo que los valores posibles para las claves de este mapa son de 0 a 8, inclusive.

Nivel de anidación

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 bala en este nivel de anidación