Text

Conteúdo de texto

O conteúdo geral do texto. O texto deve residir em uma forma compatível (por exemplo, caixa de texto ou retângulo) ou 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 do componente, incluindo as informações de estilo. Esta propriedade é somente leitura.

lists

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

As listas com marcadores contidas neste texto, codificadas pelo código 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 deste elemento de texto baseado em zero, em unidades de código Unicode.

endIndex

integer

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

Campo de união kind. O tipo de texto que este elemento representa. kind pode ser apenas uma das seguintes opções:
paragraphMarker

object (ParagraphMarker)

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

O startIndex e endIndex desse TextElement representam o intervalo do parágrafo. Os outros TextElements com um intervalo de índice contido dentro desse intervalo são considerados parte do parágrafo. 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 na execução têm o mesmo TextStyle.

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

autoText

object (AutoText)

Um TextElement que representa um ponto no texto que é substituído dinamicamente por um conteúdo que pode mudar ao longo do tempo.

Marcador do parágrafo

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)

O marcador para este 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 placeholder pai, esses estilos de parágrafo poderão ser herdados do 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 de parágrafo do parágrafo em 0 nível de aninhamento da lista dentro do marcador de espaço pai.
  • Um parágrafo em uma lista herda o estilo de parágrafo do parágrafo em seu nível de aninhamento correspondente da lista dentro do marcador de espaç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 pai.

alignment

enum (Alignment)

O alinhamento do texto para este parágrafo.

indentStart

object (Dimension)

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

indentEnd

object (Dimension)

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

spaceAbove

object (Dimension)

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

spaceBelow

object (Dimension)

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

indentFirstLine

object (Dimension)

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

direction

enum (TextDirection)

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

spacingMode

enum (SpacingMode)

O modo de espaçamento para o parágrafo.

Alinhamento

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

Enums
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, alinhado à direita caso contrário.
CENTER O parágrafo está centralizado.
END O parágrafo está alinhado ao final da linha. Alinhado à direita para texto LTR, alinhado à esquerda caso contrário.
JUSTIFIED O parágrafo é justificado.

Direção do texto

O texto de rotas pode fluir.

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

Modo de espaçamento

Os diferentes modos de espaçamento de parágrafo.

Enums
SPACING_MODE_UNSPECIFIED O modo de espaçamento é herdado do principal.
NEVER_COLLAPSE O espaçamento entre parágrafos é sempre processado.
COLLAPSE_LISTS O espaçamento entre parágrafos é 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 à qual este parágrafo pertence.

nestingLevel

integer

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

glyph

string

O símbolo do 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 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 texto executado em um parágrafo que não esteja em uma lista herdará seu estilo de texto do caractere de nova linha no parágrafo no nível de aninhamento da lista dentro do marcador de espaço pai.
  • Um texto executado em um parágrafo que esteja em uma lista herdará seu estilo de texto do caractere de nova linha no parágrafo em seu nível de aninhamento correspondente da lista dentro do marcador de espaço pai.

Os estilos de texto herdados são representados como campos não definidos nesta mensagem. Se houver texto em uma forma sem um marcador de posição principal, a não definição desses campos reverterá o estilo para um valor que corresponda aos padrões do editor do 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 definida, a cor será opaca ou transparente, dependendo se o campo opaqueColor estiver definido.

foregroundColor

object (OptionalColor)

A cor do texto. Se definida, a cor será opaca ou transparente, dependendo se o campo opaqueColor estiver definido.

bold

boolean

Indica se o texto é renderizado como negrito.

italic

boolean

Se o texto está ou não em itálico.

fontFamily

string

A família de fontes do texto.

A família de fontes pode ser qualquer fonte do menu "Fontes" do 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 o tamanho do texto. Se uma solicitação de atualização especificar valores para fontFamily e bold, o valor bold definido explicitamente será usado.

fontSize

object (Dimension)

O tamanho da fonte do texto. Quando lida, a fontSize é especificada em pontos.

baselineOffset

enum (BaselineOffset)

O deslocamento vertical do texto a partir da 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 próprio fontSize não é afetado por mudanças nesse campo.

smallCaps

boolean

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

strikethrough

boolean

Se o texto é tachado ou não.

underline

boolean

Se o texto está sublinhado ou não.

weightedFontFamily

object (WeightedFontFamily)

A família de fontes e a ponderação renderizada do texto.

Esse campo é uma extensão de fontFamily que é compatível com pesos de fonte 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, se os dois campos forem incluídos na máscara de campo (explicitamente ou por meio do 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 o peso 400 ("normal").
  • Se ambos os campos estiverem definidos, o valor de fontFamily precisará corresponder ao valor de weightedFontFamily#fontFamily. Nesse caso, a família de fontes e o peso de weightedFontFamily são aplicados. Caso contrário, será retornado um erro 400 de solicitação inválida.
  • Se weightedFontFamily estiver definido e fontFamily não, a família de fontes e a ponderação de weightedFontFamily serão aplicadas.
  • Se nenhum campo for definido, a família de fontes e o peso do texto serão herdados do pai. Essas propriedades não podem ser herdadas separadamente.

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

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

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

Cor opcional

Uma cor que pode ser totalmente opaca ou totalmente transparente.

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

object (OpaqueColor)

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

Deslocamento base

Maneiras em que o texto pode ser deslocado verticalmente da posição normal.

Enums
BASELINE_OFFSET_UNSPECIFIED O deslocamento do valor de referência do texto é herdado do pai.
NONE O texto não está deslocado verticalmente.
SUPERSCRIPT O texto está deslocado verticalmente para cima (sobrescrito).
SUBSCRIPT O texto está deslocado verticalmente para baixo (subscrito).

Família de fontes ponderadas

Representa uma família de fontes e o peso usado para estilizar um 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 fonte do menu "Fontes" do 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, inclusive. Esse intervalo corresponde aos valores numéricos descritos na Especificação CSS 2.1, seção 15.6, com valores não numéricos não permitidos. 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").

Execução de texto

Um tipo TextElement que representa um conjunto de textos com o mesmo estilo.

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

string

O texto dessa execução.

style

object (TextStyle)

O estilo aplicado a essa execução.

Texto automático

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 deste 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

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

Listar

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

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 das propriedades dos marcadores no nível associado. Uma lista tem no máximo nove níveis de aninhamento, portanto, os possíveis valores para as chaves desse mapa são de 0 a 8, inclusive.

Nível de transição

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 nesse nível de aninhamento.