Text

TextContent

O conteúdo de texto geral. O texto precisa estar em uma forma compatível (por exemplo, caixa de texto ou retângulo) ou em uma célula de tabela em uma página.

Representação JSON 
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
Campos
textElements[]

object (TextElement)

O conteúdo do texto dividido em partes componentes, incluindo informações de estilo. Essa propriedade é somente leitura.

lists

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

As listas com marcadores contidas neste texto, identificadas pelo ID da lista.

TextElement

Um TextElement descreve o conteúdo de um intervalo de índices no conteúdo de texto de um Shape ou TableCell.

Representação 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

O índice inicial baseado em zero desse elemento de texto, em unidades de código Unicode.

endIndex

integer

O índice final baseado em zero deste elemento de texto, exclusivo, em unidades de código Unicode.

Campo de união kind. O tipo de texto que esse elemento representa. kind pode ser apenas um dos seguintes:
paragraphMarker

object (ParagraphMarker)

Um marcador que representa o início de um novo parágrafo.

O startIndex e o endIndex deste TextElement representam o intervalo do parágrafo. Outros TextElements com um intervalo de índice contido no intervalo deste parágrafo são considerados parte dele. O intervalo de índices de dois parágrafos separados nunca se sobrepõe.

textRun

object (TextRun)

Um TextElement que representa uma sequência de texto em que todos os caracteres têm o mesmo TextStyle.

Os startIndex e endIndex de TextRuns sempre estarão totalmente contidos no intervalo de índice de um único paragraphMarker TextElement. Em outras palavras, um TextRun nunca vai abranger vários parágrafos.

autoText

object (AutoText)

Um TextElement que representa um ponto no texto substituído dinamicamente por conteúdo que pode mudar com o tempo.

ParagraphMarker

Um tipo TextElement que representa o início de um novo parágrafo.

Representação JSON 
{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}
Campos
style

object (ParagraphStyle)

O estilo do parágrafo

bullet

object (Bullet)

A marca deste parágrafo. Se não estiver presente, o parágrafo não pertence a uma lista.

ParagraphStyle

Estilos que se aplicam a um parágrafo inteiro.

Se esse texto estiver contido em uma forma com um placeholder pai, esses estilos de parágrafo poderão ser herdados do elemento pai. Os estilos de parágrafo herdados dependem do nível de aninhamento das listas:

  • Um parágrafo que não está em uma lista herda o estilo do parágrafo no nível de aninhamento 0 da lista dentro do marcador de posição principal.
  • Um parágrafo em uma lista herda o estilo do parágrafo no nível de aninhamento correspondente da lista dentro do marcador de posição principal.

Os estilos de parágrafo herdados são representados como campos não definidos nesta mensagem.

Representação 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

A quantidade de espaço entre as linhas, como uma porcentagem do normal, em que o normal é representado como 100,0. Se não for definido, o valor será herdado do elemento pai.

alignment

enum (Alignment)

O alinhamento do texto para este parágrafo.

indentStart

object (Dimension)

O valor do recuo do parágrafo no lado que corresponde ao início do texto, com base na direção atual do texto. Se não for definido, o valor será herdado do elemento pai.

indentEnd

object (Dimension)

O recuo do parágrafo no lado que corresponde ao final do texto, com base na direção atual do texto. Se não for definido, o valor será herdado do elemento pai.

spaceAbove

object (Dimension)

A quantidade de espaço extra acima do parágrafo. Se não for definido, o valor será herdado do elemento pai.

spaceBelow

object (Dimension)

A quantidade de espaço extra abaixo do parágrafo. Se não for definido, o valor será herdado do elemento pai.

indentFirstLine

object (Dimension)

A quantidade de recuo para o início da primeira linha do parágrafo. Se não for definido, o valor será herdado do elemento pai.

direction

enum (TextDirection)

A direção do texto deste parágrafo. Se não estiver definido, o valor padrão será LEFT_TO_RIGHT porque a direção do texto não é herdada.

spacingMode

enum (SpacingMode)

O modo de espaçamento do parágrafo.

Alinhamento

Os tipos de alinhamento de texto para um parágrafo.

Tipos enumerados
ALIGNMENT_UNSPECIFIED O alinhamento do parágrafo é herdado do elemento pai.
START O parágrafo está alinhado ao início da linha. Alinhado à esquerda para texto LTR e à direita para outros casos.
CENTER O parágrafo está centralizado.
END O parágrafo é alinhado ao final da linha. Alinhado à direita para texto LTR e à esquerda para outros casos.
JUSTIFIED O parágrafo está justificado.

TextDirection

O texto das instruções pode aparecer.

Tipos enumerados
TEXT_DIRECTION_UNSPECIFIED A direção do texto é herdada do elemento pai.
LEFT_TO_RIGHT O texto vai da esquerda para a direita.
RIGHT_TO_LEFT O texto vai da direita para a esquerda.

SpacingMode

Os diferentes modos de espaçamento entre parágrafos.

Tipos enumerados
SPACING_MODE_UNSPECIFIED O modo de espaçamento é herdado do elemento pai.
NEVER_COLLAPSE O espaçamento entre parágrafos é sempre renderizado.
COLLAPSE_LISTS O espaçamento de parágrafo é ignorado entre os elementos da lista.

Marcador

Descreve o marcador de um parágrafo.

Representação JSON 
{
  "listId": string,
  "nestingLevel": integer,
  "glyph": string,
  "bulletStyle": {
    object (TextStyle)
  }
}
Campos
listId

string

O ID da lista a que este parágrafo pertence.

nestingLevel

integer

O nível de aninhamento deste parágrafo na lista.

glyph

string

O glifo de marcador renderizado para este parágrafo.

bulletStyle

object (TextStyle)

O estilo de texto específico do parágrafo aplicado a este marcador.

TextStyle

Representa o estilo que pode ser aplicado a um TextRun.

Se esse texto estiver contido em uma forma com um placeholder pai, esses estilos de texto poderão ser herdados do pai. Os estilos de texto herdados dependem do nível de aninhamento das listas:

  • Um trecho de texto em um parágrafo que não está em uma lista herda o estilo do caractere de nova linha no parágrafo no nível de aninhamento 0 da lista dentro do marcador de posição principal.
  • Uma execução de texto em um parágrafo que está em uma lista herda o estilo de texto do caractere de nova linha no parágrafo no nível de aninhamento correspondente da lista dentro do marcador de posição principal.

Os estilos de texto herdados são representados como campos não definidos nesta mensagem. Se o texto estiver em uma forma sem um marcador de posição principal, a remoção da definição desses campos vai reverter o estilo para um valor que corresponda aos padrões no editor de apresentações.

Representação 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)

A cor do plano de fundo do texto. Se definido, a cor será opaca ou transparente, dependendo da definição do campo opaqueColor nela.

foregroundColor

object (OptionalColor)

A cor do texto. Se definido, a cor será opaca ou transparente, dependendo da definição do campo opaqueColor nela.

bold

boolean

Indica se o texto é renderizado em negrito.

italic

boolean

Indica se o texto está em itálico ou não.

fontFamily

string

A família de fontes do texto.

A família de fontes pode ser qualquer opção do menu "Fonte" no Apresentações ou do Google Fonts. Se o nome da fonte não for reconhecido, o texto será renderizado em Arial.

Algumas fontes podem afetar a espessura do texto. Se uma solicitação de atualização especificar valores para fontFamily e bold, o valor de bold definido explicitamente será usado.

fontSize

object (Dimension)

O tamanho da fonte do texto. Quando lido, o fontSize será especificado em pontos.

baselineOffset

enum (BaselineOffset)

O deslocamento vertical do texto em relação à posição normal.

O texto com deslocamentos de linha de base SUPERSCRIPT ou SUBSCRIPT é renderizado automaticamente em um tamanho de fonte menor, calculado com base no campo fontSize. O fontSize não é afetado por mudanças nesse campo.

smallCaps

boolean

Se o texto está em letras maiúsculas pequenas ou não.

strikethrough

boolean

Indica se o texto está tachado ou não.

underline

boolean

Se o texto está sublinhado ou não.

weightedFontFamily

object (WeightedFontFamily)

A família de fontes e a espessura renderizada do texto.

Esse campo é uma extensão de fontFamily e foi criado para oferecer suporte a pesos de fontes explícitos sem prejudicar a compatibilidade com versões anteriores. Assim, ao ler o estilo de um intervalo de texto, o valor de weightedFontFamily#fontFamily sempre será igual ao de fontFamily. No entanto, ao gravar, se os dois campos forem incluídos na máscara de campo (de forma explícita ou usando o caractere curinga "*"), os valores serão reconciliados da seguinte maneira:

  • Se fontFamily estiver definido e weightedFontFamily não, o valor de fontFamily será aplicado com a ponderação 400 ("normal").
  • Se os dois campos forem definidos, o valor de fontFamily precisará corresponder ao de weightedFontFamily#fontFamily. Em caso afirmativo, a família e a espessura da fonte de weightedFontFamily serão aplicadas. Caso contrário, um erro 400 de solicitação incorreta será retornado.
  • Se weightedFontFamily estiver definido e fontFamily não, a família e a espessura da fonte de weightedFontFamily serão aplicadas.
  • Se nenhum dos campos for definido, a família e o peso da fonte do texto serão herdados do elemento pai. Essas propriedades não podem ser herdadas separadamente.

Se uma solicitação de atualização especificar valores para weightedFontFamily e bold, weightedFontFamily será aplicado primeiro e depois bold.

Se weightedFontFamily#weight não for definido, o padrão será 400.

Se weightedFontFamily for definido, weightedFontFamily#fontFamily também precisará ser definido com um valor não vazio. Caso contrário, um erro 400 de solicitação incorreta será retornado.

OptionalColor

Uma cor que pode ser totalmente opaca ou totalmente transparente.

Representação JSON 
{
  "opaqueColor": {
    object (OpaqueColor)
  }
}
Campos
opaqueColor

object (OpaqueColor)

Se definido, será usado como uma cor opaca. Se não for definido, isso vai representar uma cor transparente.

BaselineOffset

As maneiras pelas quais o texto pode ser deslocado verticalmente da posição normal.

Tipos enumerados
BASELINE_OFFSET_UNSPECIFIED O deslocamento da linha de base do texto é herdado do elemento pai.
NONE O texto não tem um deslocamento vertical.
SUPERSCRIPT O texto é deslocado verticalmente para cima (sobrescrito).
SUBSCRIPT O texto é deslocado verticalmente para baixo (subscrito).

WeightedFontFamily

Representa uma família de fontes e uma espessura usadas para estilizar uma TextRun.

Representação JSON 
{
  "fontFamily": string,
  "weight": integer
}
Campos
fontFamily

string

A família de fontes do texto.

A família de fontes pode ser qualquer opção do menu "Fonte" no Apresentações ou do Google Fonts. Se o nome da fonte não for reconhecido, o texto será renderizado em Arial.

weight

integer

A espessura renderizada do texto. Esse campo pode ter qualquer valor que seja um múltiplo de 100 entre 100 e 900, incluindo esses dois valores. Esse intervalo corresponde aos valores numéricos descritos na seção 15.6 da especificação CSS 2.1, com valores não numéricos proibidos. Pesos maiores ou iguais a 700 são considerados em negrito, e pesos menores que 700 não são em negrito. O valor padrão é 400 ("normal").

TextRun

Um tipo TextElement que representa uma execução de texto com o mesmo estilo.

Representação JSON 
{
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Campos
content

string

O texto desta execução.

style

object (TextStyle)

O estilo aplicado a essa execução.

AutoText

Um tipo TextElement que representa texto automático.

Representação JSON 
{
  "type": enum (Type),
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Campos
type

enum (Type)

O tipo do texto automático.

content

string

O conteúdo renderizado desse texto automático, se disponível.

style

object (TextStyle)

O estilo aplicado a esse texto automático.

Tipo

Os tipos de texto automático

Tipos enumerados
TYPE_UNSPECIFIED Um tipo de texto automático não especificado.
SLIDE_NUMBER Tipo de texto automático que representa o número do slide atual.

Lista

Uma lista descreve a aparência dos marcadores pertencentes a parágrafos associados a uma lista. Um parágrafo que faz parte de uma lista tem uma referência implícita ao ID dela.

Representação JSON 
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
Campos
listId

string

O ID da lista.

nestingLevel

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

Um mapa de níveis de aninhamento para as propriedades de marcadores no nível associado. Uma lista tem no máximo nove níveis de aninhamento. Portanto, os valores possíveis para as chaves desse mapa são de 0 a 8, inclusive.

NestingLevel

Contém propriedades que descrevem a aparência de um marcador de lista em um determinado nível de aninhamento.

Representação JSON 
{
  "bulletStyle": {
    object (TextStyle)
  }
}
Campos
bulletStyle

object (TextStyle)

O estilo de um marcador neste nível de aninhamento.