Text

TextContent

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

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

object (TextElement)

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

lists

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

As listas com marcadores contidas nesse texto, codificadas por ID da lista.

TextElement

Um TextElement descreve o conteúdo de um intervalo de índices no conteúdo de texto de um Shape ou um 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 de início baseado em zero desse elemento de texto, 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 esse 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.

A startIndex e 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 na execução têm a mesma TextStyle:

A startIndex e endIndex de TextRuns sempre estarão totalmente contidos no intervalo do í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 que é 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)

O marcador deste parágrafo. Se ausente, 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 pai placeholder, esses estilos de parágrafo poderão ser herdados do pai. Os estilos de parágrafo que são herdados dependem do nível de aninhamento das listas:

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

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 normal é representado como 100,0. Se não for definido, o valor será herdado do pai.

alignment

enum (Alignment)

O alinhamento do texto deste 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 pai.

indentEnd

object (Dimension)

O valor do 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 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 recuo 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 do parágrafo.

Alinhamento

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

Enums
ALIGNMENT_UNSPECIFIED O alinhamento do parágrafo é herdado do pai.
START O parágrafo é alinhado ao início da linha. Alinhado à esquerda para texto LTR. Caso contrário, alinhado à direita.
CENTER O parágrafo é centralizado.
END O parágrafo é alinhado ao fim da linha. Alinhado à direita para texto LTR. Caso contrário, alinhado à esquerda.
JUSTIFIED O parágrafo é justificado.

TextDirection

O texto das instruções pode fluir.

Enums
TEXT_DIRECTION_UNSPECIFIED A direção do texto é herdada do principal.
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 de parágrafos.

Enums
SPACING_MODE_UNSPECIFIED O modo de espaçamento é herdado do pai.
NEVER_COLLAPSE O espaçamento entre parágrafos é sempre renderizado.
COLLAPSE_LISTS O espaçamento do 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 deste parágrafo.

bulletStyle

object (TextStyle)

O estilo de texto específico de parágrafo aplicado ao marcador.

TextStyle

Representa o estilo que pode ser aplicado a um TextRun.

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

  • Um texto executado em um parágrafo que não esteja em uma lista herdará o estilo de texto do caractere de nova linha no nível de aninhamento 0 da lista dentro do marcador de posição pai.
  • Um texto executado em um parágrafo que esteja em uma lista vai herdar 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 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 principal, desmarcar esses campos reverterá o estilo para um valor correspondente aos padrões no editor das 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 de fundo do texto. Se definida, a cor será opaca ou transparente, dependendo se a opaqueColor está definido.

foregroundColor

object (OptionalColor)

A cor do próprio texto. Se definida, a cor será opaca ou transparente, dependendo se a opaqueColor está definido.

bold

boolean

Se o texto está ou não renderizado em negrito.

italic

boolean

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 fonte do menu "Fontes" do Apresentações Google ou do Fontes do Google. Se o nome da fonte não for reconhecido, o texto será renderizado Arial:

Algumas fontes podem afetar o peso do texto. Se uma solicitação de atualização especificar valores para ambos fontFamily e bold, o padrão bold é 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.

Enviar mensagem de texto com SUPERSCRIPT ou SUBSCRIPT os deslocamentos de linha de base são renderizados automaticamente em um tamanho de fonte menor, calculado com base no fontSize . A fontSize em si não é afetado pelas alterações nesse campo.

smallCaps

boolean

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

strikethrough

boolean

Se o texto está riscado 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.

Este campo é uma extensão do fontFamily destinado a oferecer suporte a espessuras de fontes explícitas 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 escrever, se ambos os campos forem incluídos na máscara de campo (explicitamente ou por meio do caractere curinga "*"), os valores são reconciliados da seguinte maneira:

  • Se fontFamily está definido e weightedFontFamily não for, o valor de fontFamily é aplicado com peso 400 ("normal").
  • Se ambos os campos forem definidos, o valor do fontFamily precisa corresponder ao de weightedFontFamily#fontFamily. Nesse caso, a família de fontes e o peso weightedFontFamily é aplicada. Caso contrário, será retornado um erro 400 de solicitação inválida.
  • Se weightedFontFamily está definido e fontFamily não é, a família de fontes e o peso do weightedFontFamily é aplicada.
  • Se nenhum campo for definido, a família de fontes e o peso do texto serão herdados do pai. É importante ressaltar que essas propriedades não podem ser herdadas separadamente umas das outras.

Se uma solicitação de atualização especificar valores para ambos weightedFontFamily e bold, os weightedFontFamily é aplicada primeiro e depois bold.

Se weightedFontFamily#weight não estiver definido, o padrão é 400.

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

OptionalColor

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 definido, representa uma cor transparente.

BaselineOffset

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

Enums
BASELINE_OFFSET_UNSPECIFIED O deslocamento do valor de referência do texto é herdado do pai.
NONE O texto não é deslocado verticalmente.
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 usada para definir o estilo de 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 Google ou do Fontes do Google. Se o nome da fonte não for reconhecido, o texto será renderizado Arial:

weight

integer

A espessura renderizada do texto. Este campo pode ter qualquer valor múltiplo de 100 entre 100 e 900. 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 consideradas em negrito, e pesos menores que 700 não estão em negrito. O valor padrão é 400 ("normal").

TextRun

Um tipo TextElement que representa uma sequência 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 esta 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 deste texto automático.

content

string

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

style

object (TextStyle)

O estilo aplicado ao 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.

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, de modo que os valores possíveis para as chaves deste 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 nesse nível de aninhamento.