Text

TextContent

Il contenuto testuale generale. Il testo deve trovarsi in una forma compatibile (ad es. casella di testo o rettangolo) o in una cella di una tabella in una pagina.

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

object (TextElement)

I contenuti di testo suddivisi nelle loro parti componenti, comprese le informazioni di stile. Questa proprietà è di sola lettura.

lists

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

Gli elenchi puntati contenuti in questo testo, identificati dall'ID elenco.

TextElement

Un TextElement descrive il contenuto di un intervallo di indici nel contenuto di testo di una forma o di una cella di tabella.

Rappresentazione JSON 
{
  "startIndex": integer,
  "endIndex": integer,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "paragraphMarker": {
    object (ParagraphMarker)
  },
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  }
  // End of mutually exclusive fields.
}
Campi
startIndex

integer

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

endIndex

integer

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

Il tipo di testo rappresentato da questo elemento. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
paragraphMarker

object (ParagraphMarker)

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

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

textRun

object (TextRun)

Un TextElement che rappresenta una sequenza di testo in cui tutti i caratteri hanno lo stesso TextStyle.

startIndex e endIndex di TextRun saranno sempre completamente contenuti nell'intervallo di indice di un singolo paragraphMarker TextElement. In altre parole, un TextRun non si estenderà mai su più paragrafi.

autoText

object (AutoText)

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

Fine dei campi che si escludono a vicenda.

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 principale placeholder, questi stili di paragrafo potrebbero essere ereditati dall'elemento principale. Gli stili di paragrafo ereditati dipendono dal livello di annidamento degli elenchi:

  • Un paragrafo non presente in un elenco erediterà lo stile dal paragrafo al livello di nidificazione 0 dell'elenco all'interno del segnaposto principale.
  • Un paragrafo in un elenco eredita lo stile dal paragrafo al livello di nidificazione corrispondente 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, espressa come percentuale del normale, dove il normale è rappresentato da 100.0. Se non è impostato, il valore viene ereditato dall'elemento principale.

alignment

enum (Alignment)

L'allineamento del testo per questo paragrafo.

indentStart

object (Dimension)

Il rientro del paragrafo sul lato che corrisponde all'inizio del testo, in base alla direzione del testo corrente. Se non è impostato, il valore viene ereditato dall'elemento principale.

indentEnd

object (Dimension)

Il rientro dell'importo per il paragrafo sul lato che corrisponde alla fine del testo, in base alla direzione del testo corrente. Se non è impostato, il valore viene ereditato dall'elemento principale.

spaceAbove

object (Dimension)

La quantità di spazio aggiuntivo sopra il paragrafo. Se non è impostato, il valore viene ereditato dall'elemento principale.

spaceBelow

object (Dimension)

La quantità di spazio aggiuntivo sotto il paragrafo. Se non è impostato, il valore viene ereditato dall'elemento principale.

indentFirstLine

object (Dimension)

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

direction

enum (TextDirection)

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

spacingMode

enum (SpacingMode)

La modalità di spaziatura per il paragrafo.

Allineamento

I tipi di allineamento del testo per un paragrafo.

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

TextDirection

Il testo delle indicazioni può essere inserito.

Enum
TEXT_DIRECTION_UNSPECIFIED La direzione del testo viene ereditata dall'elemento 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 dei paragrafi viene sempre visualizzata.
COLLAPSE_LISTS La spaziatura dei paragrafi viene ignorata 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 un TextRun.

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

  • Un blocco di testo in un paragrafo che non si trova in un elenco erediterà lo stile del testo dal carattere di nuova riga nel paragrafo al livello di nidificazione 0 dell'elenco all'interno del segnaposto principale.
  • Un blocco di testo in un paragrafo di un elenco erediterà lo stile del testo dal carattere di nuova riga nel paragrafo al livello di nidificazione corrispondente 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, la deselezione di questi campi ripristinerà lo stile 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 campo sia impostato.

foregroundColor

object (OptionalColor)

Il colore del testo stesso. Se impostato, il colore è opaco o trasparente, a seconda che il opaqueColor campo sia impostato.

bold

boolean

Indica se il testo viene visualizzato in grassetto.

italic

boolean

Indica se il testo è in corsivo o meno.

fontFamily

string

La famiglia di caratteri del testo.

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

Alcuni caratteri possono influire sul peso del testo. Se una richiesta di aggiornamento specifica valori sia per fontFamily che per bold, viene utilizzato il valore bold impostato in modo esplicito.

fontSize

object (Dimension)

Le dimensioni del carattere del testo. Una volta letto, il fontSize verrà specificato in punti.

baselineOffset

enum (BaselineOffset)

Lo scostamento verticale del testo dalla sua posizione normale.

Il testo con offset della linea di base SUPERSCRIPT o SUBSCRIPT viene visualizzato automaticamente con una dimensione del carattere più piccola, calcolata in base al campo fontSize. Il fontSize stesso non è interessato dalle modifiche apportate a questo campo.

smallCaps

boolean

Se il testo è scritto in maiuscoletto.

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 di rendering del testo.

Questo campo è un'estensione di fontFamily pensata per supportare pesi del carattere espliciti senza compromettere la compatibilità con le versioni precedenti. Pertanto, quando si legge lo 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 del campo (in modo esplicito o tramite il carattere jolly "*"), i relativi valori vengono riconciliati nel seguente modo:

  • Se fontFamily è impostato e weightedFontFamily non lo è, il valore di fontFamily viene applicato con peso 400 ("normale").
  • Se entrambi i campi sono impostati, il valore di fontFamily deve corrispondere a quello di weightedFontFamily#fontFamily. In questo caso, vengono applicati la famiglia di caratteri e lo spessore di weightedFontFamily. In caso contrario, viene restituito un errore 400 Bad Request.
  • Se weightedFontFamily è impostato e fontFamily non lo è, vengono applicati la famiglia e lo spessore del carattere di weightedFontFamily.
  • Se nessuno dei due campi è impostato, la famiglia e il peso del carattere del testo vengono ereditati dall'elemento principale. Tieni presente che queste proprietà non possono essere ereditate separatamente l'una dall'altra.

Se una richiesta di aggiornamento specifica valori sia per weightedFontFamily che per bold, viene applicato prima weightedFontFamily e poi bold.

Se weightedFontFamily#weight non è impostato, il valore predefinito è 400.

Se weightedFontFamily è impostato, anche weightedFontFamily#fontFamily deve essere impostato con un valore non vuoto. In caso contrario, viene restituito un errore 400 Bad Request.

OptionalColor

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

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

object (OpaqueColor)

Se impostato, questo valore verrà utilizzato come colore opaco. Se non è impostato, 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 linea di base del testo viene ereditato dall'elemento principale.
NONE Il testo non è spostato verticalmente.
SUPERSCRIPT Il testo viene spostato verticalmente verso l'alto (apice).
SUBSCRIPT Il testo è spostato verticalmente verso il basso (pedice).

WeightedFontFamily

Rappresenta una famiglia di caratteri e uno spessore utilizzati per lo stile di un TextRun.

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

string

La famiglia di caratteri del testo.

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

weight

integer

Il peso visualizzato del testo. Questo campo può contenere qualsiasi valore multiplo di 100 compreso tra 100 e 900 inclusi. Questo intervallo corrisponde ai valori numerici descritti nella specifica CSS 2.1, sezione 15.6, con valori non numerici non consentiti. I pesi maggiori o uguali a 700 sono considerati in grassetto, mentre i pesi inferiori a 700 non sono in grassetto. Il valore predefinito è 400 ("normale").

TextRun

Un tipo TextElement che rappresenta una sequenza 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 il 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 sottoposti a rendering 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 a paragrafi associati a un elenco. Un paragrafo che fa parte di un elenco ha un riferimento implicito all'ID dell'elenco.

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

string

L'ID della lista.

nestingLevel

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

Una mappa dei livelli di rientro 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 da 0 a 8 inclusi.

NestingLevel

Contiene proprietà che descrivono l'aspetto di un punto elenco a 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.