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 en una página.

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

object (TextElement)

Contenido de texto desglosado en sus partes componentes, incluida la información de diseño. Esta propiedad es de solo lectura.

lists

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

Son las listas con viñetas que se incluyen en este texto, clasificadas por ID de lista.

TextElement

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

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

endIndex

integer

Índice final basado en cero de este elemento de texto, exclusivo, en unidades de código Unicode.

Campo de unión kind. Es el tipo de texto que representa este elemento. kind solo puede ser uno de los siguientes valores:
paragraphMarker

object (ParagraphMarker)

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

Los campos startIndex y endIndex de este TextElement representan el rango del párrafo. Se considera que otros TextElements con un rango de índice contenido dentro del rango de este párrafo forman parte de él. 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 estarán completamente incluidos en el rango de índice de un solo paragraphMarker TextElement. En otras palabras, un TextRun nunca abarcará varios párrafos.

autoText

object (AutoText)

Es un 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 comienzo de un nuevo párrafo.

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

object (ParagraphStyle)

Es el estilo del párrafo.

bullet

object (Bullet)

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

ParagraphStyle

Son los estilos que se aplican a un párrafo completo.

Si este texto se encuentra dentro de una forma con un placeholder principal, es posible que estos estilos de párrafo se hereden del elemento principal. 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 anidación 0 de la lista dentro del marcador de posición principal.
  • Un párrafo en una lista heredará su estilo del párrafo en el nivel de anidación correspondiente de la lista dentro del marcador de posición principal.

Los estilos de párrafo heredados se representan como campos no establecidos 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 las líneas, como porcentaje de lo normal, donde lo normal se representa como 100.0. Si no se configura, el valor se hereda 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 se configura, el valor se hereda del elemento superior.

indentEnd

object (Dimension)

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

spaceAbove

object (Dimension)

Cantidad de espacio adicional sobre el párrafo. Si no se configura, el valor se hereda del elemento superior.

spaceBelow

object (Dimension)

Cantidad de espacio adicional debajo del párrafo. Si no se configura, el valor se hereda del elemento superior.

indentFirstLine

object (Dimension)

Es la cantidad de sangría para el inicio de la primera línea del párrafo. Si no se configura, el valor se hereda del elemento superior.

direction

enum (TextDirection)

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

spacingMode

enum (SpacingMode)

Es el modo de espaciado del párrafo.

Alineación

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

Enums
ALIGNMENT_UNSPECIFIED La alineación del párrafo se hereda del elemento superior.
START El párrafo está alineado con el inicio de la línea. Alineado a la izquierda para texto LTR y a la derecha en otros casos.
CENTER El párrafo está centrado.
END El párrafo está alineado con el final de la línea. Alineado a la derecha para el texto LTR y alineado a la izquierda en otros casos.
JUSTIFIED El párrafo está justificado.

TextDirection

El texto de las instrucciones puede aparecer de forma gradual.

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

SpacingMode

Son los diferentes modos de espaciado entre párrafos.

Enums
SPACING_MODE_UNSPECIFIED El modo de espaciado se hereda del elemento principal.
NEVER_COLLAPSE El espaciado entre párrafos siempre se renderiza.
COLLAPSE_LISTS Se omite el espaciado entre párrafos 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

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

nestingLevel

integer

Es el nivel de anidación de este párrafo en la lista.

glyph

string

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

bulletStyle

object (TextStyle)

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

TextStyle

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

Si este texto se encuentra dentro de una forma con un placeholder principal, es posible que estos estilos de texto se hereden del elemento principal. Los estilos de texto que se heredan dependen del nivel de anidación de las listas:

  • Una ejecución de texto en un párrafo que no está en una lista heredará su estilo de texto del carácter de nueva línea en el párrafo en el nivel de anidación 0 de la lista dentro del marcador de posición principal.
  • Una ejecución de 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 anidación correspondiente de la lista dentro del marcador de posición principal.

Los estilos de texto heredados se representan como campos no establecidos en este mensaje. Si el texto se encuentra en una forma sin un marcador de posición principal, anular la configuración de estos campos restablecerá 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)

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

foregroundColor

object (OptionalColor)

Es el color del texto en sí. Si se establece, el color es opaco o transparente, según si se establece el campo opaqueColor 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

Es la familia de fuentes del texto.

La familia de fuentes puede ser cualquiera 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 lee, el valor de fontSize se especifica en puntos.

baselineOffset

enum (BaselineOffset)

Es el desplazamiento vertical del texto desde su posición normal.

El texto con desplazamientos de la línea de base SUPERSCRIPT o SUBSCRIPT se renderiza automáticamente con 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 letras pequeñas capitalizadas.

strikethrough

boolean

Indica si el texto está tachado o no.

underline

boolean

Indica si el texto está subrayado o no.

weightedFontFamily

object (WeightedFontFamily)

Familia de fuentes y grosor renderizado del texto.

Este campo es una extensión de fontFamily que tiene como objetivo admitir pesos de fuente explícitos sin interrumpir la compatibilidad con versiones anteriores. Por lo tanto, 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 escribe, 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 se establece weightedFontFamily, se aplica el valor de fontFamily con el peso 400 ("normal").
  • Si ambos campos están configurados, el valor de fontFamily debe coincidir con el de weightedFontFamily#fontFamily. De ser así, se aplicarán la familia y el peso de la fuente de weightedFontFamily. De lo contrario, se muestra un error 400 de solicitud incorrecta.
  • Si se establece weightedFontFamily y no se establece fontFamily, se aplican la familia y el peso de la fuente de weightedFontFamily.
  • Si no se configura ninguno de los campos, la familia y el peso de la fuente 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 no se establece weightedFontFamily#weight, el valor predeterminado es 400.

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

OptionalColor

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

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

object (OpaqueColor)

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

BaselineOffset

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

Enums
BASELINE_OFFSET_UNSPECIFIED El desplazamiento de la línea base del texto se hereda del elemento principal.
NONE El texto no tiene un desplazamiento vertical.
SUPERSCRIPT El texto se desplaza verticalmente hacia arriba (superíndice).
SUBSCRIPT El texto se desplaza verticalmente hacia abajo (subíndice).

WeightedFontFamily

Representa una familia y un grosor de fuente que se usan para aplicar estilo a un TextRun.

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

string

Es la familia de fuentes del texto.

La familia de fuentes puede ser cualquiera del menú Fuente en Presentaciones o de Google Fonts. Si no se reconoce el nombre de la fuente, el texto se renderiza 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 que se describen en la sección 15.6 de la especificación de CSS 2.1, en la que no se permiten valores no numéricos. Los pesos mayores o iguales que 700 se consideran negrita, y los pesos menores que 700 no se consideran negrita. El valor predeterminado es 400 ("normal").

TextRun

Es un tipo de TextElement que representa una ejecución de texto que tiene el mismo diseño.

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

string

Es el texto de esta ejecución.

style

object (TextStyle)

Es el diseño aplicado a este tramo.

AutoText

Es 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

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

style

object (TextStyle)

Es el diseño aplicado a este texto automático.

Tipo

Tipos de texto automático

Enums
TYPE_UNSPECIFIED Es un tipo de texto automático sin especificar.
SLIDE_NUMBER Es el tipo de texto automático que representa el número de diapositiva actual.

Lista

Un objeto List 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))

Es un mapa de los niveles de anidación a 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 de anidación determinado.

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

object (TextStyle)

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