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 em uma página.

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

object (TextElement)

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

lists

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

As listas com marcadores contidas neste texto, codificadas por ID de lista.

TextElement

Um TextElement descreve o conteúdo de um intervalo de índices no conteúdo de texto de uma forma ou célula de tabela.

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 com base em zero desse elemento de texto, em unidades de código Unicode.

endIndex

integer

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

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

object (ParagraphMarker)

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

Os startIndex e endIndex desse 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:

O startIndex e o endIndex de TextRuns vão estar sempre 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 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 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 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 estiver em uma lista vai herdar o estilo do parágrafo no nível 0 de aninhamento da lista dentro do marcador de posição pai.
  • Um parágrafo de uma lista herdará seu estilo do parágrafo em seu 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 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 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 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)

O recuo no 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 elemento 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 está centralizado.
END O parágrafo é alinhado ao final 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 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 de parágrafos.

Enums
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 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 para este 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 placeholder principal, esses estilos de texto poderão ser herdados do principal. Quais estilos de texto 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.
  • 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 pai.

Os estilos de texto herdados são representados como campos não definidos nesta mensagem. Se o texto estiver contido em uma forma sem um marcador de posição pai, a reversão do estilo para um valor correspondente aos padrões no editor de slides vai acontecer se esses campos forem desativados.

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

Indica se o texto é renderizado em negrito ou não.

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 de Fontes do Google. 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 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.

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 . O fontSize não é afetado por mudanças 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 o peso renderizado do texto.

Esse campo é uma extensão de fontFamily para oferecer suporte a pesos de fonte explícitos sem comprometer a compatibilidade com versões anteriores. Portanto, ao ler o estilo de um intervalo de texto, o valor de weightedFontFamily#fontFamily será sempre 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 estiverem definidos, o valor de fontFamily precisa corresponder ao de weightedFontFamily#fontFamily. Nesse caso, a família de fontes e o peso weightedFontFamily é aplicada. Caso contrário, um erro 400 de solicitação inválida será retornado.
  • 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 for definido, o padrão será 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, será usado como uma cor opaca. Se não definido, representa uma cor transparente.

BaselineOffset

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

Enums
BASELINE_OFFSET_UNSPECIFIED O deslocamento da linha de base do texto é herdado do elemento 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 um peso usados 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 Google ou de Fontes do Google. Se o nome da fonte não for reconhecido, o texto será renderizado Arial:

weight

integer

O peso renderizado 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 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 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 aninhados 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.