Text

TextContent

I contenuti testuali generali. Il testo deve trovarsi in una forma compatibile (ad es. casella di testo o rettangolo) oppure nella cella di una tabella in una pagina.

Rappresentazione JSON
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
Campi
textElements[]

object (TextElement)

Contenuti del testo suddivisi nelle sue parti che lo compongono, incluse le informazioni sullo stile. Questa proprietà è di sola lettura.

lists

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

Gli elenchi puntati contenuti in questo testo, digitati per ID elenco.

TextElement

Un elemento TextElement descrive il contenuto di una serie di indici nel contenuto testuale di una cella Shape o TableCell.

Rappresentazione 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.
}
Campi
startIndex

integer

L'indice iniziale in base zero di questo elemento di testo, nelle unità di codice Unicode.

endIndex

integer

L'indice finale in base zero di questo elemento di testo, esclusivo, nelle unità di codice Unicode.

Campo unione kind. Il tipo di testo rappresentato da questo elemento. kind può essere solo uno dei seguenti:
paragraphMarker

object (ParagraphMarker)

Un indicatore che rappresenta l'inizio di un nuovo paragrafo.

La startIndex e endIndex di questo TextElement rappresentano l'intervallo del paragrafo. Gli altri elementi TextElement con un intervallo di indice contenuto all'interno dell'intervallo di questo paragrafo vengono considerati come parte di questo paragrafo. L'intervallo di indici di due paragrafi separati non si sovrappone mai.

textRun

object (TextRun)

Un TextElement che rappresenta un'esecuzione di testo in cui tutti i caratteri nella esecuzione hanno lo stesso TextStyle.

La startIndex e endIndex di TextRuns sarà sempre completamente contenuto nell'intervallo di indice di un singolo paragraphMarker TextElement. In altre parole, un TextRun non coprirà mai più paragrafi.

autoText

object (AutoText)

Un elemento TextElement che rappresenta un punto nel testo e che viene sostituito dinamicamente con contenuti che possono cambiare nel tempo.

ParagraphMarker

Un tipo TextElement che rappresenta l'inizio di un nuovo paragrafo.

Rappresentazione JSON
{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}
Campi
style

object (ParagraphStyle)

Lo stile del paragrafo

bullet

object (Bullet)

Il punto elenco per questo paragrafo. Se non è presente, il paragrafo non appartiene a un elenco.

ParagraphStyle

Stili che si applicano a un intero paragrafo.

Se questo testo è contenuto in una forma con un elemento padre placeholder, questi stili di paragrafo potrebbero essere ereditati dall'elemento principale. Gli stili di paragrafo ereditati dipendono dal livello di nidificazione degli elenchi:

  • Un paragrafo non incluso in un elenco erediterà lo stile di paragrafo dal paragrafo a livello di nidificazione 0 dell'elenco all'interno del segnaposto principale.
  • Un paragrafo in un elenco erediterà lo stile di paragrafo dal paragrafo al relativo livello di nidificazione dell'elenco all'interno del segnaposto principale.

Gli stili di paragrafo ereditati sono rappresentati come campi non impostati in questo messaggio.

Rappresentazione 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)
}
Campi
lineSpacing

number

La quantità di spazio tra le righe, in percentuale della normalità, dove normale è rappresentato da 100,0. Se non viene configurato, il valore viene ereditato dall'unità organizzativa principale.

alignment

enum (Alignment)

L'allineamento del testo di questo paragrafo.

indentStart

object (Dimension)

Il rientro del paragrafo sul lato corrispondente all'inizio del testo, in base alla direzione corrente del testo. Se non viene configurato, il valore viene ereditato dall'unità organizzativa principale.

indentEnd

object (Dimension)

Il rientro del paragrafo sul lato corrispondente alla fine del testo, in base alla direzione corrente del testo. Se non viene configurato, il valore viene ereditato dall'unità organizzativa principale.

spaceAbove

object (Dimension)

La quantità di spazio aggiuntivo sopra il paragrafo. Se non viene configurato, il valore viene ereditato dall'unità organizzativa principale.

spaceBelow

object (Dimension)

La quantità di spazio aggiuntivo sotto il paragrafo. Se non viene configurato, il valore viene ereditato dall'unità organizzativa principale.

indentFirstLine

object (Dimension)

La quantità di rientro per l'inizio della prima riga del paragrafo. Se non viene configurato, il valore viene ereditato dall'unità organizzativa principale.

direction

enum (TextDirection)

La direzione del testo di questo paragrafo. Se non viene configurato, il valore predefinito è LEFT_TO_RIGHT poiché la direzione del testo non viene ereditata.

spacingMode

enum (SpacingMode)

La modalità di spaziatura del paragrafo.

Allineamento

I tipi di allineamento del testo di un paragrafo.

Enum
ALIGNMENT_UNSPECIFIED L'allineamento del paragrafo viene ereditato da quello principale.
START Il paragrafo è allineato all'inizio della riga. Allineato a sinistra per il testo LTR, altrimenti allineato a destra.
CENTER Il paragrafo è centrato.
END Il paragrafo è allineato alla fine della riga. Allineato a destra per il testo LTR, allineamento a sinistra negli altri casi.
JUSTIFIED Il paragrafo è giustificato.

TextDirection

Il testo delle indicazioni stradali può scorrere.

Enum
TEXT_DIRECTION_UNSPECIFIED La direzione del testo viene ereditata da quella principale.
LEFT_TO_RIGHT Il testo va da sinistra a destra.
RIGHT_TO_LEFT Il testo va da destra a sinistra.

SpacingMode

Le diverse modalità per la spaziatura dei paragrafi.

Enum
SPACING_MODE_UNSPECIFIED La modalità di spaziatura viene ereditata dall'elemento principale.
NEVER_COLLAPSE La spaziatura del paragrafo viene sempre visualizzata.
COLLAPSE_LISTS La spaziatura del paragrafo viene saltata tra gli elementi dell'elenco.

Punto elenco

Descrive il punto elenco di un paragrafo.

Rappresentazione JSON
{
  "listId": string,
  "nestingLevel": integer,
  "glyph": string,
  "bulletStyle": {
    object (TextStyle)
  }
}
Campi
listId

string

L'ID dell'elenco a cui appartiene questo paragrafo.

nestingLevel

integer

Il livello di nidificazione di questo paragrafo nell'elenco.

glyph

string

Il glifo del punto elenco visualizzato per questo paragrafo.

bulletStyle

object (TextStyle)

Lo stile di testo specifico del paragrafo applicato a questo punto elenco.

TextStyle

Rappresenta lo stile che può essere applicato a TextRun.

Se questo testo è contenuto in una forma con un elemento padre placeholder, questi stili di testo potrebbero essere ereditati dall'elemento principale. Gli stili di testo ereditati dipendono dal livello di nidificazione degli elenchi:

  • Un testo eseguito in un paragrafo che non è in un elenco erediterà lo stile di testo dal carattere di nuova riga nel paragrafo al livello di nidificazione 0 dell'elenco all'interno del segnaposto principale.
  • Un testo eseguito in un paragrafo presente in un elenco erediterà lo stile di testo dal carattere di nuova riga del paragrafo al corrispondente livello di nidificazione dell'elenco all'interno del segnaposto principale.

Gli stili di testo ereditati sono rappresentati come campi non impostati in questo messaggio. Se il testo è contenuto in una forma senza un segnaposto principale, se annulli questi campi, lo stile verrà ripristinato a un valore corrispondente ai valori predefiniti nell'editor di Presentazioni.

Rappresentazione 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)
  }
}
Campi
backgroundColor

object (OptionalColor)

Il colore di sfondo del testo. Se impostato, il colore è opaco o trasparente, a seconda che il opaqueColor del set di dati.

foregroundColor

object (OptionalColor)

Il colore del testo stesso. Se impostato, il colore è opaco o trasparente, a seconda che il opaqueColor del set di dati.

bold

boolean

Indica se il testo viene visualizzato o meno in grassetto.

italic

boolean

Indica se il testo è in corsivo.

fontFamily

string

La famiglia di caratteri del testo.

La famiglia di caratteri può essere qualsiasi carattere presente nel menu Carattere in Presentazioni o Google Fonts. Se il nome del carattere non viene riconosciuto, il testo viene visualizzato Arial.

Alcuni caratteri possono influire sullo spessore del testo. Se una richiesta di aggiornamento specifica valori per entrambi fontFamily e bold, l'impostazione esplicita bold .

fontSize

object (Dimension)

La dimensione del carattere del testo. Quando viene letta, fontSize sarà specificato in punti.

baselineOffset

enum (BaselineOffset)

L'offset verticale del testo rispetto alla posizione normale.

Invia SMS con SUPERSCRIPT o SUBSCRIPT gli offset di base vengono visualizzati automaticamente con caratteri di dimensioni inferiori, calcolati in base fontSize . La fontSize non è interessata dalle modifiche in questo campo.

smallCaps

boolean

Indica se il testo è in minuscolo.

strikethrough

boolean

Indica se il testo è barrato o meno.

underline

boolean

Indica se il testo è sottolineato o meno.

weightedFontFamily

object (WeightedFontFamily)

La famiglia di caratteri e lo spessore visualizzato del testo.

Questo campo è un'estensione di fontFamily pensato per supportare spessori di carattere espliciti senza interrompere la compatibilità con le versioni precedenti. Di conseguenza, durante la lettura dello stile di un intervallo di testo, il valore di weightedFontFamily#fontFamily sarà sempre uguale a quello di fontFamily. Tuttavia, durante la scrittura, se entrambi i campi sono inclusi nella maschera dei campi (in modo esplicito o tramite il carattere jolly "*"), i suoi valori vengono riconciliati come segue:

  • Se fontFamily è impostato e weightedFontFamily non è, il valore fontFamily viene applicata con la ponderazione 400 ("normale").
  • Se entrambi i campi sono impostati, il valore fontFamily deve corrispondere a quello di weightedFontFamily#fontFamily. Se sì, la famiglia e lo spessore weightedFontFamily . In caso contrario, viene restituito un errore 400 di richiesta errata.
  • Se weightedFontFamily è impostato e fontFamily non è, la famiglia di caratteri e lo spessore weightedFontFamily .
  • Se nessuno dei campi è impostato, la famiglia di caratteri e lo spessore del testo vengono ereditati dall'elemento principale. Tieni presente che queste proprietà non possono ereditare separatamente l'una dall'altra.

Se una richiesta di aggiornamento specifica valori per entrambi weightedFontFamily e bold, weightedFontFamily viene applicato per primo e poi bold.

Se weightedFontFamily#weight non è impostato, per impostazione predefinita 400.

Se weightedFontFamily è impostato, allora weightedFontFamily#fontFamily anche devono essere impostati con un valore non vuoto. In caso contrario, viene restituito un errore 400 di richiesta errata.

OptionalColor

Un colore che può essere completamente opaco o completamente trasparente.

Rappresentazione JSON
{
  "opaqueColor": {
    object (OpaqueColor)
  }
}
Campi
opaqueColor

object (OpaqueColor)

Se impostato, verrà utilizzato come colore opaco. Se il criterio non viene configurato, rappresenta un colore trasparente.

BaselineOffset

I modi in cui il testo può essere spostato verticalmente rispetto alla sua posizione normale.

Enum
BASELINE_OFFSET_UNSPECIFIED L'offset della base di riferimento del testo viene ereditato dall'elemento principale.
NONE Il testo non è spostato verticalmente.
SUPERSCRIPT Il testo è sfalsato verticalmente verso l'alto (apice).
SUBSCRIPT Il testo è sfalsato verticalmente verso il basso (pedice).

WeightedFontFamily

Rappresenta una famiglia di caratteri e lo spessore utilizzati per applicare lo stile a TextRun.

Rappresentazione JSON
{
  "fontFamily": string,
  "weight": integer
}
Campi
fontFamily

string

La famiglia di caratteri del testo.

La famiglia di caratteri può essere qualsiasi carattere presente nel menu Carattere in Presentazioni o Google Fonts. Se il nome del carattere non viene riconosciuto, il testo viene visualizzato Arial.

weight

integer

Lo spessore visualizzato del testo. Questo campo può avere qualsiasi valore che sia un multiplo di 100 tra 100 e 900, inclusi. Questo intervallo corrisponde ai valori numerici descritti nella Specifica CSS 2.1. sezione 15.6, in cui non sono consentiti valori non numerici. Pesi maggiori o uguali a 700 sono considerati in grassetto e le ponderazioni 700 non sono in grassetto. Il valore predefinito è 400 ("normale").

TextRun

Un tipo TextElement che rappresenta una serie di testo con lo stesso stile.

Rappresentazione JSON
{
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Campi
content

string

Il testo di questa esecuzione.

style

object (TextStyle)

Lo stile applicato a questa esecuzione.

AutoText

Un tipo TextElement che rappresenta testo automatico.

Rappresentazione JSON
{
  "type": enum (Type),
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Campi
type

enum (Type)

Il tipo di questo testo automatico.

content

string

I contenuti visualizzati di questo testo automatico, se disponibili.

style

object (TextStyle)

Lo stile applicato a questo testo automatico.

Tipo

I tipi di testo automatico

Enum
TYPE_UNSPECIFIED Un tipo di testo automatico non specificato.
SLIDE_NUMBER Digita il testo automatico che rappresenta il numero della slide corrente.

Elenco

Un elenco descrive l'aspetto dei punti elenco appartenenti ai paragrafi associati a un elenco. Un paragrafo che fa parte di un elenco ha un riferimento implicito all'ID di quell'elenco.

Rappresentazione JSON
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
Campi
listId

string

L'ID dell'elenco.

nestingLevel

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

Mappa dei livelli di nidificazione alle proprietà dei punti elenco al livello associato. Un elenco ha al massimo nove livelli di nidificazione, quindi i valori possibili per le chiavi di questa mappa sono compresi tra 0 e 8 inclusi.

NestingLevel

Contiene proprietà che descrivono l'aspetto di un elenco puntato in un determinato livello di nidificazione.

Rappresentazione JSON
{
  "bulletStyle": {
    object (TextStyle)
  }
}
Campi
bulletStyle

object (TextStyle)

Lo stile di un punto elenco a questo livello di nidificazione.