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)

I contenuti del testo suddivisi nelle relative parti componenti, incluse le informazioni sugli stili. 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 Text descrive i contenuti di un intervallo di indici nei contenuti di testo di una forma o di una cella di tabella.

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 di questo elemento di testo basato su zero, in unità di codice Unicode.

endIndex

integer

L'indice di fine di questo elemento di testo, esclusivo, basato su zero in 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 Text con un intervallo di indici contenuto nell'intervallo di questo paragrafo sono considerati parte di questo paragrafo. L'intervallo di indici di due paragrafi separati non si sovrappone mai.

textRun

object (TextRun)

Un elemento TextElement che rappresenta una serie di caratteri in cui tutti i caratteri della serie hanno lo stesso TextStyle.

I valori startIndex e endIndex delle TextRun saranno sempre completamente contenuti nell'intervallo di indici di un singolo TextElement. In altre parole, un TextRun non si estende mai su più paragrafi.

autoText

object (AutoText)

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

ParagraphMarker

Un tipo di elemento di testo 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 principaleplaceholder, 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 linee, in percentuale rispetto al normale, dove il normale è rappresentato da 100,0. Se non viene configurato, il valore viene ereditato dall'unità organizzativa principale.

alignment

enum (Alignment)

L'allineamento del testo per 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)

La quantità di rientro del paragrafo sul lato che corrisponde alla fine del testo, in base all'attuale direzione 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 è impostato, il valore predefinito è LEFT_TO_RIGHT poiché l'orientamento del testo non viene ereditato.

spacingMode

enum (SpacingMode)

La modalità di spaziatura per il 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 da sinistra a destra, allineato a sinistra in caso contrario.
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 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 di 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 si trova 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.
  • Il 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 disattivi questi campi lo stile tornerà 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 predefinito è impostato.

foregroundColor

object (OptionalColor)

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

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 del menu Carattere in Presentazioni o di 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 sia per fontFamily sia per bold, viene utilizzato il valore bold impostato in modo esplicito.

fontSize

object (Dimension)

Le dimensioni del carattere del testo. Quando viene letto, il valore fontSize viene 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

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 progettata per supportare spessori dei caratteri espliciti senza compromettere la compatibilità con le versioni precedenti. Di conseguenza, quando leggi 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 di campo (esplicitamente o tramite il carattere jolly "*"), i relativi valori vengono riconciliati come segue:

  • Se fontFamily è impostato weightedFontFamily non è, il valore fontFamily viene applicata con la ponderazione 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 di richiesta non valida (400).
  • Se weightedFontFamily è impostato e fontFamily no, vengono applicati la famiglia di caratteri e lo spessore di 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, il valore predefinito 400.

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

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 non viene 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 Lo spazio di base del testo viene ereditato dall'elemento principale.
NONE Il testo non è offset verticalmente.
SUPERSCRIPT Il testo è spostato verso l'alto verticalmente (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 compreso tra 100 e 900, inclusi. Questo intervallo corrisponde ai valori numerici descritti nella sezione 15.6 della specifica CSS 2.1, 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 di elemento di testo 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 di 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 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 diapositiva corrente.

Elenco

Un elenco descrive l'aspetto dei numeri di paragrafo 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.