- Risorsa: documento
- Corpo
- StructuralElement
- Paragrafo
- ParagraphElement
- TextRun
- TestoStile
- OptionalColor
- Colore
- RgbColor
- Dimensione
- Unità
- AverageFontFont
- Offset linea di riferimento
- Collega
- SuggestedTextStyle
- TextStyleSuggestionState
- Testo automatico
- Digitare
- Interruzione di pagina
- ColumnBreak (Interruzione colonna)
- FootnoteReference
- HorizontalRules
- Equazione
- InlineObjectElement
- Persona
- PersonProprietà
- RichLink
- RichLinkProperties
- ParagraphStyle
- NamedStyleType
- Allineamento
- ContentDirection
- Spaziatura
- ParagraphBorder
- Stile cruscotto
- TabStop
- TabStopAllineament
- Ombreggiatura
- SuggeritoParagraphStyle
- ParagraphStyleSuggestionState
- ShadingSuggestionState
- Elenco puntato
- Suggestedbullet
- BulletSuggestionState
- ObjectReferences
- Interruzione di sezione
- SezioneStile
- ProprietàColonnaSezione
- ColumnSeparatorStyle
- TipoSezione
- Tabella
- TableRow
- TableCell
- TableCellStyle
- TableCellBorder
- Allineamento dei contenuti
- TableCellStyle suggerito
- TableCellStyleSuggestionState
- TableRowStyle
- SuggeritoTableRowStyle
- TableRowStyleSuggestionState
- TableStyle
- TableColumnProperties
- Tipo di larghezza
- TableOfContents
- Intestazione
- Piè di pagina
- Nota a piè di pagina
- DocumentStyle
- Informazioni preliminari
- Dimensioni
- suggestedDocumentStyle
- DocumentStyleSuggestionState
- BackgroundSuggestionState
- SizeSuggestionState
- NamedStyles
- NamedStyle
- StiliNamedStyles suggeriti
- NamedStylesSuggestionState
- NamedStyleSuggestionState
- Elenco
- ListProperties
- Livello di nidificazione
- Allineamento puntato
- Tipo Glyph
- SuggestedListProperties
- ListPropertiesSuggestionState
- Stato del suggerimentoLivello di nidificazione
- NamedRanges
- NamedRange
- Intervallo
- Modalità di visualizzazione Suggerimenti
- InlineObject
- InlineObjectProperties
- Incorporato
- IncorporatoDrawingProprietà
- ImageProprietà
- CropProprietà
- IncorporatoObjectBorder
- StatoProprietà
- LinkedContentReference
- FogliGraficoRiferimento
- SuggestInlineObjectProperties
- InlineObjectPropertiesSuggestionState
- EmbeddedObjectSuggestionState
- stato IncorporatoDrawingPropertiesSuggestion
- ImagePropertiesSuggestionState
- CropPropertiesSuggestionState
- EmbeddedObjectBorderSuggestionState
- LinkedContentReferenceSuggestionState
- FogliChartReferenceSuggestionState
- PositionedObject
- PositionedObjectProperties
- PositionedObjectPositioning
- PositionedObjectLayout
- SuggestedPositionedObjectProperties
- PositionedObjectPropertiesSuggestionState
- PositionedObjectPositioningSuggestionState
- Metodi
Risorsa: documento
Un documento Google.
Rappresentazione JSON |
---|
{ "documentId": string, "title": string, "body": { object ( |
Campi | |
---|---|
documentId |
Solo output. L'ID del documento. |
title |
Il titolo del documento. |
body |
Solo output. Il corpo principale del documento. |
headers |
Solo output. Le intestazioni del documento, digitate in base all'ID intestazione. |
footers |
Solo output. I piè di pagina del documento, digitati in base all'ID del piè di pagina. |
footnotes |
Solo output. Le note a piè di pagina nel documento, digitate in base all'ID nota a piè di pagina. |
documentStyle |
Solo output. Lo stile del documento. |
suggestedDocumentStyleChanges |
Solo output. Le modifiche suggerite allo stile del documento, specificate per ID suggerimento. |
namedStyles |
Solo output. Gli stili con nome del documento. |
suggestedNamedStylesChanges |
Solo output. Le modifiche suggerite agli stili con nome del documento, inseriti in base all'ID suggerimento. |
lists |
Solo output. Gli elenchi nel documento, digitati in base all'ID elenco. |
namedRanges |
Solo output. Gli intervalli denominati nel documento, codificati per nome. |
revisionId |
Solo output. L'ID revisione del documento. Può essere utilizzato nelle richieste di aggiornamento per specificare a quale revisione di un documento applicare gli aggiornamenti e come dovrebbe comportarsi la richiesta se il documento è stato modificato dopo la revisione. Compilato solo se l'utente ha accesso in modifica al documento. L'ID revisione non è un numero sequenziale, ma una stringa opaca. Il formato dell'ID revisione potrebbe cambiare nel tempo. È garantito che un ID revisione restituito sia valido solo per 24 ore dopo essere stato restituito e non può essere condiviso tra gli utenti. Se l'ID revisione rimane invariato tra una chiamata e l'altra, significa che il documento non è stato modificato. Viceversa, un ID modificato (per lo stesso documento e lo stesso utente) di solito indica che il documento è stato aggiornato. Tuttavia, un ID modificato può essere dovuto anche a fattori interni, come le modifiche al formato dell'ID. |
suggestionsViewMode |
Solo output. La modalità di visualizzazione dei suggerimenti applicata al documento. Nota: quando modifichi un documento, le modifiche devono essere basate su un documento con |
inlineObjects |
Solo output. Gli oggetti in linea nel documento, digitati in base all'ID oggetto. |
positionedObjects |
Solo output. Gli oggetti posizionati nel documento, digitati in base all'ID oggetto. |
Body
Il corpo del documento.
Il corpo di solito contiene i contenuti completi del documento, ad eccezione di headers
, footers
e footnotes
.
Rappresentazione JSON |
---|
{
"content": [
{
object ( |
Campi | |
---|---|
content[] |
I contenuti del corpo. Gli indici dei contenuti del corpo del testo iniziano da zero. |
ElementoStructuralElement
Uno StructuralElement descrive i contenuti che conferiscono struttura al documento.
Rappresentazione JSON |
---|
{ "startIndex": integer, "endIndex": integer, // Union field |
Campi | |
---|---|
startIndex |
L'indice iniziale in base zero di questo elemento strutturale, in unità di codice UTF-16. |
endIndex |
L'indice finale in base zero di questo elemento strutturale, esclusivo, in unità di codice UTF-16. |
Campo di unione content . Il contenuto dell'elemento strutturale. content può essere solo uno dei seguenti: |
|
paragraph |
Un tipo di paragrafo di elemento strutturale. |
sectionBreak |
Un tipo di interruzione di sezione di elemento strutturale. |
table |
Un tipo di tabella di elemento strutturale. |
tableOfContents |
Un tipo di sommario di elemento strutturale. |
Paragrafo
Un StructuralElement
che rappresenta un paragrafo. Un paragrafo è un intervallo di contenuti che termina con un carattere di nuova riga.
Rappresentazione JSON |
---|
{ "elements": [ { object ( |
Campi | |
---|---|
elements[] |
Il contenuto del paragrafo, suddiviso nelle sue parti. |
paragraphStyle |
Lo stile di questo paragrafo. |
suggestedParagraphStyleChanges |
Lo stile di paragrafo suggerito cambia in questo paragrafo, inserito in base all'ID suggerimento. |
bullet |
Il punto elenco per questo paragrafo. Se non è presente, il paragrafo non appartiene a un elenco. |
suggestedBulletChanges |
Le modifiche suggerite al punto elenco di questo paragrafo. |
positionedObjectIds[] |
Gli ID degli oggetti posizionati collegati a questo paragrafo. |
suggestedPositionedObjectIds |
Gli ID degli oggetti posizionati che si suggerisce di associare a questo paragrafo, digitati in base all'ID suggerimento. |
ElementoParagrafo
Un ParagraphElement descrive i contenuti all'interno di un elemento Paragraph
.
Rappresentazione JSON |
---|
{ "startIndex": integer, "endIndex": integer, // Union field |
Campi | |
---|---|
startIndex |
L'indice iniziale in base zero di questo elemento paragrafo, in unità di codice UTF-16. |
endIndex |
L'indice di fine zero-base di questo elemento paragrafo, esclusivo, in unità di codice UTF-16. |
Campo di unione content . Il contenuto dell'elemento paragrafo. content può essere solo uno dei seguenti: |
|
textRun |
Un elemento paragrafo con esecuzione di testo. |
autoText |
Un elemento paragrafo con testo automatico. |
pageBreak |
Un elemento paragrafo di interruzione di pagina. |
columnBreak |
Un elemento paragrafo di interruzione di colonna. |
footnoteReference |
Un elemento di paragrafo di riferimento a piè di pagina. |
horizontalRule |
Un elemento paragrafo orizzontale con una riga. |
equation |
Un elemento paragrafo di un'equazione. |
inlineObjectElement |
Elemento paragrafo oggetto in linea. |
person |
Un elemento paragrafo che rimanda a una persona o a un indirizzo email. |
richLink |
Un elemento paragrafo che rimanda a una risorsa Google (ad esempio un file su Google Drive, un video di YouTube o un evento nel calendario). |
Esecuzione testo
Un elemento ParagraphElement
che rappresenta una serie di testi tutti con lo stesso stile.
Rappresentazione JSON |
---|
{ "content": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
Campi | |
---|---|
content |
Il testo di questa esecuzione. Tutti gli elementi non testuali nell'esecuzione vengono sostituiti con il carattere Unicode U+E907. |
suggestedInsertionIds[] |
Gli ID di inserimento suggeriti. Un elemento |
suggestedDeletionIds[] |
Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti. |
textStyle |
Lo stile di testo di questa esecuzione. |
suggestedTextStyleChanges |
Lo stile di testo suggerito cambia in questa esecuzione, inserito in base all'ID suggerimento. |
Stile testo
Rappresenta lo stile che può essere applicato al testo.
In questo messaggio gli stili di testo ereditati sono rappresentati come campi non impostati. L'elemento principale di uno stile di testo dipende da dove è definito lo stile di testo:
- Il valore TextStyle del testo in un elemento
Paragraph
eredita il valorenamed style type
corrispondente al paragrafo. - L'elemento TextStyle in un
named style
eredita dallo stile denominatonormal text
. - Lo stile TextStyle dello stile denominato
normal text
eredita dallo stile di testo predefinito nell'editor di documenti. - L'elemento TextStyle in un elemento
Paragraph
all'interno di una tabella può ereditare il suo stile di testo dallo stile della tabella.
Se lo stile di testo non eredita da un elemento principale, se annulli l'impostazione dei campi, lo stile verrà ripristinato su un valore corrispondente ai valori predefiniti nell'editor di documenti.
Rappresentazione JSON |
---|
{ "bold": boolean, "italic": boolean, "underline": boolean, "strikethrough": boolean, "smallCaps": boolean, "backgroundColor": { object ( |
Campi | |
---|---|
bold |
Indica se il testo viene visualizzato in grassetto. |
italic |
Indica se il testo è in corsivo o meno. |
underline |
Indica se il testo è sottolineato. |
strikethrough |
Indica se il testo è barrato o meno. |
smallCaps |
Indica se il testo è scritto con lettere maiuscole o meno. |
backgroundColor |
Il colore di sfondo del testo. Se impostato, il colore è un colore RGB o trasparente, a seconda del campo |
foregroundColor |
Il colore di primo piano del testo. Se impostato, il colore è un colore RGB o trasparente, a seconda del campo |
fontSize |
Le dimensioni del carattere del testo. |
weightedFontFamily |
La famiglia di caratteri e lo spessore visualizzato del testo. Se una richiesta di aggiornamento specifica valori sia per Se Se viene impostato |
baselineOffset |
Lo scostamento verticale del testo rispetto alla posizione normale. Il testo con offset della base di riferimento |
link |
La destinazione del link ipertestuale del testo. Se il criterio non viene configurato, non esiste alcun link. I link non vengono ereditati dal testo principale. La modifica del link in una richiesta di aggiornamento causa altre modifiche allo stile di testo dell'intervallo:
|
Colore Facoltativo
Un colore che può essere completamente opaco o completamente trasparente.
Rappresentazione JSON |
---|
{
"color": {
object ( |
Campi | |
---|---|
color |
Se impostato, verrà utilizzato come colore opaco. Se il criterio non viene configurato, rappresenta un colore trasparente. |
Colore
Un colore a tinta unita.
Rappresentazione JSON |
---|
{
"rgbColor": {
object ( |
Campi | |
---|---|
rgbColor |
Il valore del colore RGB. |
Colore RGB
Un colore RGB.
Rappresentazione JSON |
---|
{ "red": number, "green": number, "blue": number } |
Campi | |
---|---|
red |
Il componente rosso del colore, da 0,0 a 1,0. |
green |
La componente verde del colore, da 0,0 a 1,0. |
blue |
Il componente blu del colore, da 0,0 a 1,0. |
Dimensione
Una grandezza in un'unica direzione nelle unità specificate.
Rappresentazione JSON |
---|
{
"magnitude": number,
"unit": enum ( |
Campi | |
---|---|
magnitude |
L'entità. |
unit |
Le unità per la grandezza. |
Unità
Unità di misura.
Enum | |
---|---|
UNIT_UNSPECIFIED |
Le unità sono sconosciute. |
PT |
Un punto, 1/72 di pollice. |
Famiglia caratteri ponderati
Rappresenta una famiglia di caratteri e lo spessore del testo.
Rappresentazione JSON |
---|
{ "fontFamily": string, "weight": integer } |
Campi | |
---|---|
fontFamily |
La famiglia di caratteri del testo. La famiglia di caratteri può essere qualsiasi carattere presente nel menu Carattere in Documenti o in Google Fonts. Se il nome del carattere non viene riconosciuto, il testo viene visualizzato in |
weight |
Lo spessore del carattere. Questo campo può avere qualsiasi valore che sia un multiplo di Il valore predefinito è Lo spessore del carattere è solo un componente dello spessore del carattere visualizzato. Una combinazione del
|
Offset linea di riferimento
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 padre. |
NONE |
Il testo non è sfalsato verticalmente. |
SUPERSCRIPT |
Il testo è spostato verticalmente verso l'alto (apice). |
SUBSCRIPT |
Il testo è spostato verticalmente verso il basso (pedice). |
Collegamento
Un riferimento a un'altra parte di un documento o a una risorsa URL esterna.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione destination . La destinazione del link. destination può essere solo uno dei seguenti: |
|
url |
Un URL esterno. |
bookmarkId |
L'ID di un segnalibro nel documento. |
headingId |
L'ID di un'intestazione in questo documento. |
StileTesto suggerito
Una modifica suggerita a TextStyle
.
Rappresentazione JSON |
---|
{ "textStyle": { object ( |
Campi | |
---|---|
textStyle |
Un |
textStyleSuggestionState |
Una maschera che indica quali campi sulla base |
Stato Suggerimento stileTesto
Una maschera che indica quali campi sulla base TextStyle
sono stati modificati in questo suggerimento. Per ogni campo impostato su true viene suggerito un nuovo valore.
Rappresentazione JSON |
---|
{ "boldSuggested": boolean, "italicSuggested": boolean, "underlineSuggested": boolean, "strikethroughSuggested": boolean, "smallCapsSuggested": boolean, "backgroundColorSuggested": boolean, "foregroundColorSuggested": boolean, "fontSizeSuggested": boolean, "weightedFontFamilySuggested": boolean, "baselineOffsetSuggested": boolean, "linkSuggested": boolean } |
Campi | |
---|---|
boldSuggested |
Indica se è stata suggerita una modifica a |
italicSuggested |
Indica se è stata suggerita una modifica a |
underlineSuggested |
Indica se è stata suggerita una modifica a |
strikethroughSuggested |
Indica se è stata suggerita una modifica a |
smallCapsSuggested |
Indica se è stata suggerita una modifica a |
backgroundColorSuggested |
Indica se è stata suggerita una modifica a |
foregroundColorSuggested |
Indica se è stata suggerita una modifica a |
fontSizeSuggested |
Indica se è stata suggerita una modifica a |
weightedFontFamilySuggested |
Indica se è stata suggerita una modifica a |
baselineOffsetSuggested |
Indica se è stata suggerita una modifica a |
linkSuggested |
Indica se è stata suggerita una modifica a |
Testo automatico
Un ParagraphElement
che rappresenta una parte del testo che viene sostituita dinamicamente con contenuti che possono cambiare nel tempo, ad esempio un numero di pagina.
Rappresentazione JSON |
---|
{ "type": enum ( |
Campi | |
---|---|
type |
Il tipo di questo testo automatico. |
suggestedInsertionIds[] |
Gli ID di inserimento suggeriti. Un elemento |
suggestedDeletionIds[] |
Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti. |
textStyle |
Lo stile di testo di questo testo automatico. |
suggestedTextStyleChanges |
Lo stile di testo suggerito viene modificato in questo testo automatico, inserito in base all'ID suggerimento. |
Tipo
I tipi di testo automatico.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Un tipo di testo automatico non specificato. |
PAGE_NUMBER |
Digita il testo automatico che rappresenta il numero di pagina corrente. |
PAGE_COUNT |
Digita il testo automatico che rappresenta il numero totale di pagine nel documento. |
Interruzione di pagina
Un ParagraphElement
che rappresenta un'interruzione di pagina. Un'interruzione di pagina fa iniziare il testo successivo nella parte superiore della pagina successiva.
Rappresentazione JSON |
---|
{ "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
Campi | |
---|---|
suggestedInsertionIds[] |
Gli ID di inserimento suggeriti. Un elemento |
suggestedDeletionIds[] |
Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti. |
textStyle |
Lo stile di testo di questa interruzione di pagina. Analogamente ai contenuti di testo, come le esecuzioni di testo e i riferimenti a nota a piè di pagina, lo stile del testo di un'interruzione di pagina può influire sul layout dei contenuti e sullo stile del testo inserito accanto. |
suggestedTextStyleChanges |
Lo stile di testo suggerito passa all'interruzione di pagina, inserito in base all'ID suggerimento. |
Interruzione colonna
Un ParagraphElement
che rappresenta un'interruzione di colonna. Un'interruzione di colonna fa iniziare il testo successivo nella parte superiore della colonna successiva.
Rappresentazione JSON |
---|
{ "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
Campi | |
---|---|
suggestedInsertionIds[] |
Gli ID di inserimento suggeriti. Un elemento |
suggestedDeletionIds[] |
Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti. |
textStyle |
Lo stile di testo di questa ColumnBreak. Analogamente ai contenuti di testo, come le esecuzioni di testo e i riferimenti a note a piè di pagina, lo stile del testo di un'interruzione di colonna può influire sul layout dei contenuti e sullo stile del testo inserito accanto a quest'ultimo. |
suggestedTextStyleChanges |
Lo stile di testo suggerito viene modificato in ColumnBreak, inserito in base all'ID suggerimento. |
Riferimento nota a piè di pagina
Un ParagraphElement
che rappresenta un riferimento a una nota a piè di pagina. Un riferimento a una nota a piè di pagina è il contenuto in linea visualizzato con un numero e viene utilizzato per identificare la nota a piè di pagina.
Rappresentazione JSON |
---|
{ "footnoteId": string, "footnoteNumber": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
Campi | |
---|---|
footnoteId |
L'ID dell'elemento |
footnoteNumber |
Il numero visualizzato di questa nota a piè di pagina. |
suggestedInsertionIds[] |
Gli ID di inserimento suggeriti. Un elemento |
suggestedDeletionIds[] |
Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti. |
textStyle |
Lo stile di testo di questa nota a piè di pagina. |
suggestedTextStyleChanges |
Lo stile di testo suggerito passa a questo riferimento a piè di pagina, inserito in base all'ID suggerimento. |
Regola orizzontale
ParagraphElement
che rappresenta una linea orizzontale.
Rappresentazione JSON |
---|
{ "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
Campi | |
---|---|
suggestedInsertionIds[] |
Gli ID di inserimento suggeriti. Un |
suggestedDeletionIds[] |
Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti. |
textStyle |
Lo stile di testo di questa HorizontalRules. Analogamente ai contenuti testuali, come esecuzioni di testo e riferimenti a note a piè di pagina, lo stile del testo di una regola orizzontale può influire sul layout dei contenuti e sullo stile del testo inserito accanto a quest'ultimo. |
suggestedTextStyleChanges |
Lo stile di testo suggerito viene modificato nel valore HorizontalRules, inserito in base all'ID suggerimento. |
Equazione
Un ParagraphElement
che rappresenta un'equazione.
Rappresentazione JSON |
---|
{ "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ] } |
Campi | |
---|---|
suggestedInsertionIds[] |
Gli ID di inserimento suggeriti. Un elemento |
suggestedDeletionIds[] |
Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti. |
InlineObjectElement
Un elemento ParagraphElement
che contiene un elemento InlineObject
.
Rappresentazione JSON |
---|
{ "inlineObjectId": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
Campi | |
---|---|
inlineObjectId |
L'ID dell'elemento |
suggestedInsertionIds[] |
Gli ID di inserimento suggeriti. Un elemento |
suggestedDeletionIds[] |
Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti. |
textStyle |
Lo stile di testo di questo elemento InlineObjectElement. Analogamente ai contenuti testuali, come le esecuzioni di testo e i riferimenti a nota a piè di pagina, lo stile del testo di un elemento incorporato in un oggetto può influire sul layout dei contenuti e sullo stile del testo inserito accanto a quest'ultimo. |
suggestedTextStyleChanges |
Lo stile di testo suggerito viene modificato in questo InlineObject, inserito in base all'ID suggerimento. |
Persona
Una persona o un indirizzo email menzionati in un documento. Queste menzioni si comportano come un singolo elemento immutabile contenente il nome o l'indirizzo email della persona.
Rappresentazione JSON |
---|
{ "personId": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
Campi | |
---|---|
personId |
Solo output. L'ID univoco di questo collegamento. |
suggestedInsertionIds[] |
ID dei suggerimenti che inseriscono il link di questa persona nel documento. Un |
suggestedDeletionIds[] |
ID dei suggerimenti che rimuovono il link di questa persona dal documento. Un |
textStyle |
Lo stile di testo di questo |
suggestedTextStyleChanges |
Lo stile di testo suggerito cambia in questo |
personProperties |
Solo output. Le proprietà di |
Proprietà Persona
Proprietà specifiche di un elemento Person
collegato.
Rappresentazione JSON |
---|
{ "name": string, "email": string } |
Campi | |
---|---|
name |
Solo output. Il nome della persona se viene visualizzato nel testo del link anziché nell'indirizzo email della persona. |
email |
Solo output. L'indirizzo email collegato a questo |
Link Rich
Un link a una risorsa Google (ad esempio un file su Drive, un video di YouTube o un evento di Calendar).
Rappresentazione JSON |
---|
{ "richLinkId": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
Campi | |
---|---|
richLinkId |
Solo output. L'ID di questo link. |
suggestedInsertionIds[] |
ID dei suggerimenti che inseriscono questo link nel documento. Un |
suggestedDeletionIds[] |
ID dei suggerimenti che rimuovono questo link dal documento. Un |
textStyle |
Lo stile di testo di questo |
suggestedTextStyleChanges |
Lo stile di testo suggerito cambia in questo |
richLinkProperties |
Solo output. Le proprietà di |
Proprietà RichLink
Proprietà specifiche di un RichLink
.
Rappresentazione JSON |
---|
{ "title": string, "uri": string, "mimeType": string } |
Campi | |
---|---|
title |
Solo output. Il titolo dell'elemento |
uri |
Solo output. L'URI di |
mimeType |
Solo output. Il tipo MIME di |
StileParagrafo
Stili che si applicano a un intero paragrafo.
Gli stili paragrafo ereditati sono rappresentati come campi non impostati in questo messaggio. L'elemento principale di uno stile di paragrafo dipende da dove viene definito lo stile di paragrafo:
- L'elemento ParagraphStyle in un
Paragraph
eredita dal corrispondente elementonamed style type
del paragrafo. - L'elemento ParagraphStyle in un
named style
eredita dallo stile denominatonormal text
. - Lo stile ParagraphStyle dello stile denominato
normal text
eredita dallo stile di paragrafo predefinito nell'editor di documenti. - L'elemento ParagraphStyle in un elemento
Paragraph
contenuto in una tabella può ereditare lo stile di paragrafo dallo stile della tabella.
Se lo stile di paragrafo non eredita da un elemento principale, se annulli l'impostazione dei campi, lo stile verrà ripristinato su un valore corrispondente ai valori predefiniti nell'editor di documenti.
Rappresentazione JSON |
---|
{ "headingId": string, "namedStyleType": enum ( |
Campi | |
---|---|
headingId |
L'ID intestazione del paragrafo. Se vuoto, questo paragrafo non è un titolo. Questa proprietà è di sola lettura. |
namedStyleType |
Il tipo di stile denominato del paragrafo. Poiché l'aggiornamento del tipo di stile denominato influisce su altre proprietà di ParagraphStyle, il tipo di stile denominato viene applicato prima dell'aggiornamento delle altre proprietà. |
alignment |
L'allineamento del testo per questo paragrafo. |
lineSpacing |
La quantità di spazio tra le righe, come percentuale del normale, dove normale è rappresentato come 100,0. Se non viene configurato, il valore viene ereditato dall'elemento padre. |
direction |
La direzione del testo di questo paragrafo. Se non viene configurato, il valore predefinito è |
spacingMode |
La modalità spaziatura per il paragrafo. |
spaceAbove |
La quantità di spazio aggiuntivo sopra il paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento padre. |
spaceBelow |
La quantità di spazio aggiuntivo sotto il paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento padre. |
borderBetween |
Il bordo tra questo paragrafo e i paragrafi successivo e precedente. Se non viene configurato, il valore viene ereditato dall'elemento padre. Il bordo tra il bordo viene visualizzato quando il paragrafo adiacente ha le stesse proprietà di bordo e rientro. I bordi del paragrafo non possono essere aggiornati parzialmente. Quando modifichi il bordo di un paragrafo, il nuovo bordo deve essere specificato completamente. |
borderTop |
Il bordo nella parte superiore di questo paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento padre. Il bordo superiore viene visualizzato quando il paragrafo precedente ha proprietà di bordo e rientro diverse. I bordi del paragrafo non possono essere aggiornati parzialmente. Quando modifichi il bordo di un paragrafo, il nuovo bordo deve essere specificato completamente. |
borderBottom |
Il bordo alla fine di questo paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento padre. Il bordo inferiore viene visualizzato quando il paragrafo seguente ha proprietà di bordo e rientro diverse. I bordi del paragrafo non possono essere aggiornati parzialmente. Quando modifichi il bordo di un paragrafo, il nuovo bordo deve essere specificato completamente. |
borderLeft |
Il bordo a sinistra di questo paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento padre. I bordi del paragrafo non possono essere aggiornati parzialmente. Quando modifichi il bordo di un paragrafo, il nuovo bordo deve essere specificato completamente. |
borderRight |
Il bordo a destra di questo paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento padre. I bordi del paragrafo non possono essere aggiornati parzialmente. Quando modifichi il bordo di un paragrafo, il nuovo bordo deve essere specificato completamente. |
indentFirstLine |
L'entità del rientro per la prima riga del paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento padre. |
indentStart |
La quantità di rientro per il paragrafo sul lato corrispondente all'inizio del testo, in base alla direzione del paragrafo corrente. Se non viene configurato, il valore viene ereditato dall'elemento padre. |
indentEnd |
La quantità di rientro per il paragrafo sul lato corrispondente alla fine del testo, in base alla direzione corrente del paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento padre. |
tabStops[] |
Un elenco delle tabulazioni per questo paragrafo. L'elenco delle tabulazioni non viene ereditato. Questa proprietà è di sola lettura. |
keepLinesTogether |
Indica se tutte le righe del paragrafo devono essere disposte sulla stessa pagina o colonna, se possibile. Se non viene configurato, il valore viene ereditato dall'elemento padre. |
keepWithNext |
Indica se almeno una parte di questo paragrafo deve essere posizionata nella stessa pagina o colonna del paragrafo successivo, se possibile. Se non viene configurato, il valore viene ereditato dall'elemento padre. |
avoidWidowAndOrphan |
Indica se evitare vedove e orfani nel paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento padre. |
shading |
L'ombreggiatura del paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento padre. |
pageBreakBefore |
Indica se il paragrafo corrente deve iniziare sempre all'inizio di una pagina. Se non viene configurato, il valore viene ereditato dall'elemento padre. Il tentativo di aggiornare |
NamedStyleType
I tipi di stili con nome.
Enum | |
---|---|
NAMED_STYLE_TYPE_UNSPECIFIED |
Il tipo di stile denominato non è specificato. |
NORMAL_TEXT |
Testo normale. |
TITLE |
Titolo. |
SUBTITLE |
Sottotitolo. |
HEADING_1 |
Intestazione 1. |
HEADING_2 |
Intestazione 2. |
HEADING_3 |
Intestazione 3. |
HEADING_4 |
Intestazione 4. |
HEADING_5 |
Intestazione 5. |
HEADING_6 |
Intestazione 6. |
Allineamento
I tipi di allineamento del testo di un paragrafo.
Enum | |
---|---|
ALIGNMENT_UNSPECIFIED |
L'allineamento del paragrafo viene ereditato dall'elemento padre. |
START |
Il paragrafo è allineato all'inizio della linea. Allineato a sinistra per il testo LTR, altrimenti allineato a destra. |
CENTER |
Il paragrafo è centrato. |
END |
Il paragrafo è allineato alla fine della linea. Allineato a destra per il testo LTR, altrimenti allineato a sinistra. |
JUSTIFIED |
Il paragrafo è giustificato. |
Direzione dei contenuti
I contenuti delle indicazioni stradali possono essere inseriti.
Enum | |
---|---|
CONTENT_DIRECTION_UNSPECIFIED |
La direzione del contenuto non è specificata. |
LEFT_TO_RIGHT |
I contenuti vanno da sinistra a destra. |
RIGHT_TO_LEFT |
I contenuti vanno da destra a sinistra. |
Modalità spaziatura
Le diverse modalità per la spaziatura dei paragrafi.
Enum | |
---|---|
SPACING_MODE_UNSPECIFIED |
La modalità di spaziatura viene ereditata dall'elemento padre. |
NEVER_COLLAPSE |
La spaziatura del paragrafo viene sempre visualizzata. |
COLLAPSE_LISTS |
La spaziatura dei paragrafi viene ignorata tra gli elementi dell'elenco. |
Bordo paragrafo
Un bordo intorno a un paragrafo.
Rappresentazione JSON |
---|
{ "color": { object ( |
Campi | |
---|---|
color |
Il colore del bordo. |
width |
La larghezza del bordo. |
padding |
La spaziatura interna del bordo. |
dashStyle |
Lo stile del trattino del bordo. |
Stile trattino
I tipi di trattini con cui è possibile eseguire il rendering della geometria lineare. Questi valori si basano sul tipo semplice "ST_PresetLineDashVal" descritto nella sezione 20.1.10.48 del documento "Office Open XML File Models - Fundamentals and Markup Language Reference", parte 1 della quarta edizione di ECMA-376.
Enum | |
---|---|
DASH_STYLE_UNSPECIFIED |
Stile del trattino non specificato. |
SOLID |
Linea continua. Corrisponde al valore "solid" di ECMA-376 ST_PresetLineDashVal. Questo è lo stile di trattino predefinito. |
DOT |
Linea punteggiata. Corrisponde al valore "dot" di ECMA-376 ST_PresetLineDashVal. |
DASH |
Linea tratteggiata. Corrisponde al valore "dash" di ECMA-376 ST_PresetLineDashVal. |
Interruzione Tab
Una tabulazione all'interno di un paragrafo.
Rappresentazione JSON |
---|
{ "offset": { object ( |
Campi | |
---|---|
offset |
L'offset tra questa tabulazione e il margine iniziale. |
alignment |
L'allineamento di questa tabulazione. Se non viene configurato, il valore predefinito è |
Allineamento TabStop
L'allineamento della tabulazione.
Enum | |
---|---|
TAB_STOP_ALIGNMENT_UNSPECIFIED |
L'allineamento della tabulazione non è specificato. |
START |
La tabulazione è allineata all'inizio della linea. Questa è l'impostazione predefinita. |
CENTER |
La tabulazione è allineata al centro della linea. |
END |
La tabulazione è allineata alla fine della linea. |
Ombreggiatura
L'ombreggiatura di un paragrafo.
Rappresentazione JSON |
---|
{
"backgroundColor": {
object ( |
Campi | |
---|---|
backgroundColor |
Il colore di sfondo dell'ombreggiatura di questo paragrafo. |
StileParagraphStyle suggerito
Una modifica suggerita a ParagraphStyle
.
Rappresentazione JSON |
---|
{ "paragraphStyle": { object ( |
Campi | |
---|---|
paragraphStyle |
Un |
paragraphStyleSuggestionState |
Una maschera che indica quali campi sulla base |
Stato Suggerimento stile paragrafo
Una maschera che indica quali campi sulla base ParagraphStyle
sono stati modificati in questo suggerimento. Per ogni campo impostato su true viene suggerito un nuovo valore.
Rappresentazione JSON |
---|
{
"headingIdSuggested": boolean,
"namedStyleTypeSuggested": boolean,
"alignmentSuggested": boolean,
"lineSpacingSuggested": boolean,
"directionSuggested": boolean,
"spacingModeSuggested": boolean,
"spaceAboveSuggested": boolean,
"spaceBelowSuggested": boolean,
"borderBetweenSuggested": boolean,
"borderTopSuggested": boolean,
"borderBottomSuggested": boolean,
"borderLeftSuggested": boolean,
"borderRightSuggested": boolean,
"indentFirstLineSuggested": boolean,
"indentStartSuggested": boolean,
"indentEndSuggested": boolean,
"keepLinesTogetherSuggested": boolean,
"keepWithNextSuggested": boolean,
"avoidWidowAndOrphanSuggested": boolean,
"shadingSuggestionState": {
object ( |
Campi | |
---|---|
headingIdSuggested |
Indica se è stata suggerita una modifica a |
namedStyleTypeSuggested |
Indica se è stata suggerita una modifica a |
alignmentSuggested |
Indica se è stata suggerita una modifica a |
lineSpacingSuggested |
Indica se è stata suggerita una modifica a |
directionSuggested |
Indica se è stata suggerita una modifica a |
spacingModeSuggested |
Indica se è stata suggerita una modifica a |
spaceAboveSuggested |
Indica se è stata suggerita una modifica a |
spaceBelowSuggested |
Indica se è stata suggerita una modifica a |
borderBetweenSuggested |
Indica se è stata suggerita una modifica a |
borderTopSuggested |
Indica se è stata suggerita una modifica a |
borderBottomSuggested |
Indica se è stata suggerita una modifica a |
borderLeftSuggested |
Indica se è stata suggerita una modifica a |
borderRightSuggested |
Indica se è stata suggerita una modifica a |
indentFirstLineSuggested |
Indica se è stata suggerita una modifica a |
indentStartSuggested |
Indica se è stata suggerita una modifica a |
indentEndSuggested |
Indica se è stata suggerita una modifica a |
keepLinesTogetherSuggested |
Indica se è stata suggerita una modifica a |
keepWithNextSuggested |
Indica se è stata suggerita una modifica a |
avoidWidowAndOrphanSuggested |
Indica se è stata suggerita una modifica a |
shadingSuggestionState |
Una maschera che indica quali campi in |
pageBreakBeforeSuggested |
Indica se è stata suggerita una modifica a |
Stato ShadingSuggestion
Una maschera che indica quali campi sulla base Shading
sono stati modificati in questa modifica suggerita. Per ogni campo impostato su true viene suggerito un nuovo valore.
Rappresentazione JSON |
---|
{ "backgroundColorSuggested": boolean } |
Campi | |
---|---|
backgroundColorSuggested |
Indica se è stata suggerita una modifica a |
Bullet
Descrive il punto elenco di un paragrafo.
Rappresentazione JSON |
---|
{
"listId": string,
"nestingLevel": integer,
"textStyle": {
object ( |
Campi | |
---|---|
listId |
L'ID dell'elenco a cui appartiene questo paragrafo. |
nestingLevel |
Il livello di annidamento di questo paragrafo nell'elenco. |
textStyle |
Lo stile di testo specifico del paragrafo applicato al punto elenco. |
Punto elenco suggerito
Una modifica suggerita a Bullet
.
Rappresentazione JSON |
---|
{ "bullet": { object ( |
Campi | |
---|---|
bullet |
Un |
bulletSuggestionState |
Una maschera che indica quali campi sulla base |
Stato bulletSuggestion
Una maschera che indica quali campi sulla base Bullet
sono stati modificati in questo suggerimento. Per ogni campo impostato su true viene suggerito un nuovo valore.
Rappresentazione JSON |
---|
{
"listIdSuggested": boolean,
"nestingLevelSuggested": boolean,
"textStyleSuggestionState": {
object ( |
Campi | |
---|---|
listIdSuggested |
Indica se è stata suggerita una modifica a |
nestingLevelSuggested |
Indica se è stata suggerita una modifica a |
textStyleSuggestionState |
Una maschera che indica quali campi in |
Riferimenti oggetto
Una raccolta di ID oggetto.
Rappresentazione JSON |
---|
{ "objectIds": [ string ] } |
Campi | |
---|---|
objectIds[] |
Gli ID oggetto. |
Interruzione di sezione
Un StructuralElement
che rappresenta un'interruzione di sezione. Una sezione è un intervallo di contenuti che hanno lo stesso SectionStyle
. Un'interruzione di sezione rappresenta l'inizio di una nuova sezione e lo stile della sezione viene applicato alla sezione dopo l'interruzione.
Il corpo del documento inizia sempre con un'interruzione di sezione.
Rappresentazione JSON |
---|
{
"suggestedInsertionIds": [
string
],
"suggestedDeletionIds": [
string
],
"sectionStyle": {
object ( |
Campi | |
---|---|
suggestedInsertionIds[] |
Gli ID di inserimento suggeriti. Un elemento |
suggestedDeletionIds[] |
Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti. |
sectionStyle |
Lo stile della sezione dopo questa interruzione di sezione. |
Stile Sezione
Lo stile da applicare a una sezione.
Rappresentazione JSON |
---|
{ "columnProperties": [ { object ( |
Campi | |
---|---|
columnProperties[] |
Le proprietà delle colonne della sezione. Se vuota, la sezione contiene una colonna con le proprietà predefinite nell'editor di documenti. Una sezione può essere aggiornata in modo che non abbia più di tre colonne. Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli l'impostazione di questa proprietà, verrà visualizzato un errore di richiesta (400) non valido. |
columnSeparatorStyle |
Lo stile dei separatori di colonna. Questo stile può essere impostato anche se è presente una sola colonna nella sezione. Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli l'impostazione di questa proprietà, viene visualizzato l'errore 400 di richiesta errata. |
contentDirection |
La direzione dei contenuti in questa sezione. Se non viene configurato, il valore predefinito è Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli l'impostazione di questa proprietà, viene visualizzato l'errore 400 di richiesta errata. |
marginTop |
Il margine superiore della pagina della sezione. Se non viene configurato, il valore predefinito di DocumentStyle è Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli l'impostazione di questa proprietà, viene visualizzato l'errore 400 di richiesta errata. |
marginBottom |
Il margine inferiore della pagina della sezione. Se non viene configurato, il valore predefinito di DocumentStyle è Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli l'impostazione di questa proprietà, viene visualizzato l'errore 400 di richiesta errata. |
marginRight |
Il margine di pagina destro della sezione. Se non viene configurato, il valore predefinito di DocumentStyle è Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli l'impostazione di questa proprietà, viene visualizzato l'errore 400 di richiesta errata. |
marginLeft |
Il margine di pagina sinistro della sezione. Se non viene configurato, il valore predefinito di DocumentStyle è Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli l'impostazione di questa proprietà, viene visualizzato l'errore 400 di richiesta errata. |
marginHeader |
Il margine dell'intestazione della sezione. Se non viene configurato, il valore predefinito di DocumentStyle è Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli l'impostazione di questa proprietà, viene visualizzato l'errore 400 di richiesta errata. |
marginFooter |
Il margine del piè di pagina della sezione. Se non viene configurato, il valore predefinito di DocumentStyle è Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli l'impostazione di questa proprietà, viene visualizzato l'errore 400 di richiesta errata. |
sectionType |
Solo output. Il tipo di sezione. |
defaultHeaderId |
L'ID dell'intestazione predefinita. Se non viene configurato, il valore eredita dal precedente SectionStyle Questa proprietà è di sola lettura. |
defaultFooterId |
L'ID del piè di pagina predefinito. Se non viene configurato, il valore eredita dal precedente SectionStyle Questa proprietà è di sola lettura. |
firstPageHeaderId |
L'ID dell'intestazione utilizzato solo per la prima pagina della sezione. Se Questa proprietà è di sola lettura. |
firstPageFooterId |
L'ID del piè di pagina utilizzato solo per la prima pagina della sezione. Se Questa proprietà è di sola lettura. |
evenPageHeaderId |
L'ID dell'intestazione utilizzato solo per le pagine pari. Se il valore di Questa proprietà è di sola lettura. |
evenPageFooterId |
L'ID del piè di pagina utilizzato solo per le pagine pari. Se il valore di Questa proprietà è di sola lettura. |
useFirstPageHeaderFooter |
Indica se utilizzare gli ID intestazione / piè di pagina della prima pagina per la prima pagina della sezione. Se non viene configurato, eredita il criterio Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli l'impostazione di questa proprietà, viene visualizzato l'errore 400 di richiesta errata. |
pageNumberStart |
Il numero di pagina da cui iniziare a conteggiare il numero di pagine per questa sezione. Se il criterio non viene configurato, la numerazione di pagina continua dalla sezione precedente. Se il valore non è impostato nel primo Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli l'impostazione di questa proprietà, viene visualizzato l'errore 400 di richiesta errata. |
flipPageOrientation |
Campo facoltativo. Indica se invertire le dimensioni dell'elemento Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli l'impostazione di questa proprietà, viene visualizzato l'errore 400 di richiesta errata. |
ProprietàSezioneColonna
Proprietà che si applicano alla colonna di una sezione.
Rappresentazione JSON |
---|
{ "width": { object ( |
Campi | |
---|---|
width |
Solo output. La larghezza della colonna. |
paddingEnd |
Spaziatura interna alla fine della colonna. |
StileSeparatoreColonna
Lo stile dei separatori di colonna tra le colonne.
Enum | |
---|---|
COLUMN_SEPARATOR_STYLE_UNSPECIFIED |
Uno stile di separatore di colonna non specificato. |
NONE |
Nessuna linea di separazione tra le colonne. |
BETWEEN_EACH_COLUMN |
Visualizza una linea separatore di colonna tra ciascuna colonna. |
TipoSezione
Rappresenta il posizionamento dell'inizio della sezione corrente rispetto alla sezione precedente.
Enum | |
---|---|
SECTION_TYPE_UNSPECIFIED |
Il tipo di sezione non è specificato. |
CONTINUOUS |
La sezione inizia immediatamente dopo l'ultimo paragrafo della sezione precedente. |
NEXT_PAGE |
La sezione inizia nella pagina successiva. |
Tabella
Un StructuralElement
che rappresenta una tabella.
Rappresentazione JSON |
---|
{ "rows": integer, "columns": integer, "tableRows": [ { object ( |
Campi | |
---|---|
rows |
Numero di righe nella tabella. |
columns |
Numero di colonne nella tabella. Poiché una tabella può essere non rettangolare, alcune righe potrebbero avere un numero diverso di celle. |
tableRows[] |
I contenuti e lo stile di ogni riga. |
suggestedInsertionIds[] |
Gli ID di inserimento suggeriti. Un elemento |
suggestedDeletionIds[] |
Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti. |
tableStyle |
Lo stile della tabella. |
RigaTabella
I contenuti e lo stile di una riga in un Table
.
Rappresentazione JSON |
---|
{ "startIndex": integer, "endIndex": integer, "tableCells": [ { object ( |
Campi | |
---|---|
startIndex |
L'indice iniziale in base zero di questa riga, in unità di codice UTF-16. |
endIndex |
L'indice finale in base zero di questa riga, esclusivo, in unità di codice UTF-16. |
tableCells[] |
I contenuti e lo stile di ogni cella di questa riga. Poiché una tabella può essere non rettangolare, alcune righe possono avere un numero di celle diverso rispetto ad altre righe della stessa tabella. |
suggestedInsertionIds[] |
Gli ID di inserimento suggeriti. Un elemento |
suggestedDeletionIds[] |
Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti. |
tableRowStyle |
Lo stile della riga della tabella. |
suggestedTableRowStyleChanges |
Lo stile suggerito viene modificato in questa riga, inserito in base all'ID suggerimento. |
Cella tabella
I contenuti e lo stile di una cella in un Table
.
Rappresentazione JSON |
---|
{ "startIndex": integer, "endIndex": integer, "content": [ { object ( |
Campi | |
---|---|
startIndex |
L'indice iniziale in base zero di questa cella, in unità di codice UTF-16. |
endIndex |
L'indice finale in base zero di questa cella, esclusivo, in unità di codice UTF-16. |
content[] |
Il contenuto della cella. |
tableCellStyle |
Lo stile della cella. |
suggestedInsertionIds[] |
Gli ID di inserimento suggeriti. Un elemento |
suggestedDeletionIds[] |
Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti. |
suggestedTableCellStyleChanges |
Le modifiche suggerite allo stile della cella della tabella, specificate per ID suggerimento. |
StileCellTabella
Lo stile di un TableCell
.
In questo messaggio gli stili di celle di tabella ereditati sono rappresentati come campi non impostati. Uno stile di cella della tabella può ereditare dallo stile della tabella.
Rappresentazione JSON |
---|
{ "rowSpan": integer, "columnSpan": integer, "backgroundColor": { object ( |
Campi | |
---|---|
rowSpan |
L'intervallo di riga della cella. Questa proprietà è di sola lettura. |
columnSpan |
L'intervallo di colonna della cella. Questa proprietà è di sola lettura. |
backgroundColor |
Il colore di sfondo della cella. |
borderLeft |
Il bordo sinistro della cella. |
borderRight |
Il bordo destro della cella. |
borderTop |
Il bordo superiore della cella. |
borderBottom |
Il bordo inferiore della cella. |
paddingLeft |
Spaziatura interna sinistra della cella. |
paddingRight |
La spaziatura interna destra della cella. |
paddingTop |
Spaziatura interna superiore della cella. |
paddingBottom |
Spaziatura interna inferiore della cella. |
contentAlignment |
L'allineamento dei contenuti nella cella della tabella. L'allineamento predefinito corrisponde all'allineamento delle celle di tabella appena create nell'editor di documenti. |
BordoCellTabella
Un bordo intorno a una cella di una tabella.
I bordi delle celle della tabella non possono essere trasparenti. Per nascondere il bordo di una cella di una tabella, imposta la larghezza su 0.
Rappresentazione JSON |
---|
{ "color": { object ( |
Campi | |
---|---|
color |
Il colore del bordo. Questo colore non può essere trasparente. |
width |
La larghezza del bordo. |
dashStyle |
Lo stile del trattino del bordo. |
Allineamento dei contenuti
I tipi di allineamento dei contenuti.
Ricavato da un sottoinsieme di valori del tipo semplice "ST_TextAnchoringType" nella sezione 20.1.10.59 del documento "Office Open XML File Models - Fundamentals and Markup Language Reference", parte 1 della quarta edizione di ECMA-376.
Enum | |
---|---|
CONTENT_ALIGNMENT_UNSPECIFIED |
Un allineamento dei contenuti non specificato. L'allineamento dei contenuti viene ereditato dall'elemento principale, se esistente. |
CONTENT_ALIGNMENT_UNSUPPORTED |
Allineamento dei contenuti non supportato. |
TOP |
Un allineamento che allinea i contenuti alla parte superiore del titolare dei contenuti. Corrisponde a ECMA-376 ST_TextAnchoringType "t". |
MIDDLE |
Un allineamento che allinea i contenuti al centro del contenitore dei contenuti. Corrisponde a ECMA-376 ST_TextAnchoringType "ctr". |
BOTTOM |
Un allineamento che allinea i contenuti alla parte inferiore del contenitore dei contenuti. Corrisponde a ECMA-376 ST_TextAnchoringType "b". |
StileTabellaTabella suggerito
Una modifica suggerita a TableCellStyle
.
Rappresentazione JSON |
---|
{ "tableCellStyle": { object ( |
Campi | |
---|---|
tableCellStyle |
Un |
tableCellStyleSuggestionState |
Una maschera che indica quali campi sulla base |
Stato Suggerimento tabellaCellStyle
Una maschera che indica quali campi sulla base TableCellStyle
sono stati modificati in questo suggerimento. Per ogni campo impostato su true viene suggerito un nuovo valore.
Rappresentazione JSON |
---|
{ "rowSpanSuggested": boolean, "columnSpanSuggested": boolean, "backgroundColorSuggested": boolean, "borderLeftSuggested": boolean, "borderRightSuggested": boolean, "borderTopSuggested": boolean, "borderBottomSuggested": boolean, "paddingLeftSuggested": boolean, "paddingRightSuggested": boolean, "paddingTopSuggested": boolean, "paddingBottomSuggested": boolean, "contentAlignmentSuggested": boolean } |
Campi | |
---|---|
rowSpanSuggested |
Indica se è stata suggerita una modifica a |
columnSpanSuggested |
Indica se è stata suggerita una modifica a |
backgroundColorSuggested |
Indica se è stata suggerita una modifica a |
borderLeftSuggested |
Indica se è stata suggerita una modifica a |
borderRightSuggested |
Indica se è stata suggerita una modifica a |
borderTopSuggested |
Indica se è stata suggerita una modifica a |
borderBottomSuggested |
Indica se è stata suggerita una modifica a |
paddingLeftSuggested |
Indica se è stata suggerita una modifica a |
paddingRightSuggested |
Indica se è stata suggerita una modifica a |
paddingTopSuggested |
Indica se è stata suggerita una modifica a |
paddingBottomSuggested |
Indica se è stata suggerita una modifica a |
contentAlignmentSuggested |
Indica se è stata suggerita una modifica a |
StileTabellaTabella
Stili che si applicano a una riga della tabella.
Rappresentazione JSON |
---|
{
"minRowHeight": {
object ( |
Campi | |
---|---|
minRowHeight |
L'altezza minima della riga. La riga verrà visualizzata nell'editor di documenti a un'altezza uguale o superiore a questo valore, in modo da mostrare tutti i contenuti delle celle della riga. |
tableHeader |
Indica se la riga è un'intestazione di tabella. |
preventOverflow |
Indica se l'overflow della riga non può superare i limiti della pagina o della colonna. |
StileTableRowStyle suggerito
Una modifica suggerita a TableRowStyle
.
Rappresentazione JSON |
---|
{ "tableRowStyle": { object ( |
Campi | |
---|---|
tableRowStyle |
Un |
tableRowStyleSuggestionState |
Una maschera che indica quali campi sulla base |
Stato Suggerimento TableRowStyle
Una maschera che indica quali campi sulla base TableRowStyle
sono stati modificati in questo suggerimento. Per ogni campo impostato su true viene suggerito un nuovo valore.
Rappresentazione JSON |
---|
{ "minRowHeightSuggested": boolean } |
Campi | |
---|---|
minRowHeightSuggested |
Indica se è stata suggerita una modifica a |
Stile tabella
Stili che si applicano a una tabella.
Rappresentazione JSON |
---|
{
"tableColumnProperties": [
{
object ( |
Campi | |
---|---|
tableColumnProperties[] |
Le proprietà di ogni colonna. Tieni presente che in Documenti le tabelle contengono righe e righe contenenti celle, in modo simile all'HTML. Pertanto, le proprietà di una riga sono disponibili nel relativo valore |
ProprietàTabellaColonna
Le proprietà di una colonna in una tabella.
Rappresentazione JSON |
---|
{ "widthType": enum ( |
Campi | |
---|---|
widthType |
Il tipo di larghezza della colonna. |
width |
La larghezza della colonna. Impostato quando |
Tipo di larghezza
Il tipo di larghezza della colonna.
Enum | |
---|---|
WIDTH_TYPE_UNSPECIFIED |
Il tipo di larghezza della colonna non è specificato. |
EVENLY_DISTRIBUTED |
La larghezza delle colonne è distribuita uniformemente tra le altre colonne distribuite in modo uniforme. La larghezza della colonna viene determinata automaticamente e avrà una parte uguale della larghezza rimanente per la tabella dopo aver preso in considerazione tutte le colonne con larghezze specificate. |
FIXED_WIDTH |
Una colonna con larghezza fissa. La proprietà [width][google.apps.docs.v1.TableColumnProperties.width contiene la larghezza della colonna. |
Sommario
Un StructuralElement
che rappresenta un sommario.
Rappresentazione JSON |
---|
{
"content": [
{
object ( |
Campi | |
---|---|
content[] |
Il contenuto del sommario. |
suggestedInsertionIds[] |
Gli ID di inserimento suggeriti. Un |
suggestedDeletionIds[] |
Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti. |
Titolo
L'intestazione di un documento.
Rappresentazione JSON |
---|
{
"headerId": string,
"content": [
{
object ( |
Campi | |
---|---|
headerId |
L'ID dell'intestazione. |
content[] |
I contenuti dell'intestazione. Gli indici dei contenuti di un'intestazione iniziano da zero. |
Piè di pagina
Una nota a piè di pagina di un documento.
Rappresentazione JSON |
---|
{
"footnoteId": string,
"content": [
{
object ( |
Campi | |
---|---|
footnoteId |
L'ID della nota a piè di pagina. |
content[] |
I contenuti della nota a piè di pagina. Gli indici dei contenuti di una nota a piè di pagina iniziano da zero. |
StileDocumento
Lo stile del documento.
Rappresentazione JSON |
---|
{ "background": { object ( |
Campi | |
---|---|
background |
Lo sfondo del documento. I documenti non possono avere un colore di sfondo trasparente. |
defaultHeaderId |
L'ID dell'intestazione predefinita. Se non viene impostato, non esiste un'intestazione predefinita. Questa proprietà è di sola lettura. |
defaultFooterId |
L'ID del piè di pagina predefinito. Se non viene configurato, non esiste un piè di pagina predefinito. Questa proprietà è di sola lettura. |
evenPageHeaderId |
L'ID dell'intestazione utilizzato solo per le pagine pari. Il valore di Questa proprietà è di sola lettura. |
evenPageFooterId |
L'ID del piè di pagina utilizzato solo per le pagine pari. Il valore di Questa proprietà è di sola lettura. |
firstPageHeaderId |
L'ID dell'intestazione utilizzato solo per la prima pagina. Se non viene impostato, non esiste un'intestazione univoca per la prima pagina. Il valore di Questa proprietà è di sola lettura. |
firstPageFooterId |
L'ID del piè di pagina utilizzato solo per la prima pagina. Se non viene impostato, non esiste un piè di pagina univoco per la prima pagina. Il valore di Questa proprietà è di sola lettura. |
useFirstPageHeaderFooter |
Indica se utilizzare gli ID intestazione / piè di pagina della prima pagina per la prima pagina. |
useEvenPageHeaderFooter |
Indica se utilizzare gli ID intestazione / piè di pagina delle pagine pari per le pagine pari. |
pageNumberStart |
Il numero di pagina da cui iniziare il conteggio del numero di pagine. |
marginTop |
Margine della pagina superiore. L'aggiornamento del margine superiore della pagina nello stile del documento cancellerà il margine superiore della pagina in tutti gli stili di sezione. |
marginBottom |
Margine inferiore della pagina. L'aggiornamento del margine inferiore della pagina nello stile del documento cancellerà il margine inferiore della pagina in tutti gli stili di sezione. |
marginRight |
Margine di pagina destro. L'aggiornamento del margine di pagina destro nello stile del documento cancellerà il margine di pagina destro in tutti gli stili di sezione. Potrebbe anche causare il ridimensionamento delle colonne in tutte le sezioni. |
marginLeft |
Il margine della pagina sinistro. L'aggiornamento del margine di pagina sinistro nello stile del documento lo cancella in tutti gli stili di sezione. Potrebbe anche causare il ridimensionamento delle colonne in tutte le sezioni. |
pageSize |
Le dimensioni di una pagina nel documento. |
marginHeader |
La quantità di spazio tra la parte superiore della pagina e i contenuti dell'intestazione. |
marginFooter |
La quantità di spazio tra la parte inferiore della pagina e i contenuti del piè di pagina. |
useCustomHeaderFooterMargins |
Indica se DocumentStyle Questa proprietà è di sola lettura. |
flipPageOrientation |
Campo facoltativo. Indica se invertire le dimensioni di |
Informazioni preliminari
Rappresenta lo sfondo di un documento.
Rappresentazione JSON |
---|
{
"color": {
object ( |
Campi | |
---|---|
color |
Il colore dello sfondo. |
Dimensioni
Una larghezza e un'altezza.
Rappresentazione JSON |
---|
{ "height": { object ( |
Campi | |
---|---|
height |
L'altezza dell'oggetto. |
width |
La larghezza dell'oggetto. |
StileDocumento suggerito
Una modifica suggerita per DocumentStyle
.
Rappresentazione JSON |
---|
{ "documentStyle": { object ( |
Campi | |
---|---|
documentStyle |
Un |
documentStyleSuggestionState |
Una maschera che indica quali campi sulla base |
Stato Suggerimento stileDocumento
Una maschera che indica quali campi sulla base DocumentStyle
sono stati modificati in questo suggerimento. Per ogni campo impostato su true viene suggerito un nuovo valore.
Rappresentazione JSON |
---|
{ "backgroundSuggestionState": { object ( |
Campi | |
---|---|
backgroundSuggestionState |
Una maschera che indica quali campi in |
defaultHeaderIdSuggested |
Indica se è stata suggerita una modifica a |
defaultFooterIdSuggested |
Indica se è stata suggerita una modifica a |
evenPageHeaderIdSuggested |
Indica se è stata suggerita una modifica a |
evenPageFooterIdSuggested |
Indica se è stata suggerita una modifica a |
firstPageHeaderIdSuggested |
Indica se è stata suggerita una modifica a |
firstPageFooterIdSuggested |
Indica se è stata suggerita una modifica a |
useFirstPageHeaderFooterSuggested |
Indica se è stata suggerita una modifica a |
useEvenPageHeaderFooterSuggested |
Indica se è stata suggerita una modifica a |
pageNumberStartSuggested |
Indica se è stata suggerita una modifica a |
marginTopSuggested |
Indica se è stata suggerita una modifica a |
marginBottomSuggested |
Indica se è stata suggerita una modifica a |
marginRightSuggested |
Indica se è stata suggerita una modifica a |
marginLeftSuggested |
Indica se è stata suggerita una modifica a |
pageSizeSuggestionState |
Una maschera che indica quali campi in [size] [google.apps.docs.v1.DocumentStyle.size] sono stati modificati in questo suggerimento. |
marginHeaderSuggested |
Indica se è stata suggerita una modifica a |
marginFooterSuggested |
Indica se è stata suggerita una modifica a |
useCustomHeaderFooterMarginsSuggested |
Indica se è stata suggerita una modifica a |
flipPageOrientationSuggested |
Campo facoltativo. Indica se è stata suggerita una modifica a |
Stato Suggerimento sullo sfondo
Una maschera che indica quali campi sulla base Background
sono stati modificati in questo suggerimento. Per qualsiasi campo impostato su true, Backgound
ha un nuovo valore suggerito.
Rappresentazione JSON |
---|
{ "backgroundColorSuggested": boolean } |
Campi | |
---|---|
backgroundColorSuggested |
Indica se il colore di sfondo corrente è stato modificato in questo suggerimento. |
Stato del suggerimento dimensioni
Una maschera che indica quali campi sulla base Size
sono stati modificati in questo suggerimento. Per qualsiasi campo impostato su true, Size
ha un nuovo valore suggerito.
Rappresentazione JSON |
---|
{ "heightSuggested": boolean, "widthSuggested": boolean } |
Campi | |
---|---|
heightSuggested |
Indica se è stata suggerita una modifica a |
widthSuggested |
Indica se è stata suggerita una modifica a |
Stili NamedStyle
Gli stili con nome. I paragrafi nel documento possono ereditare i valori TextStyle
e ParagraphStyle
dagli stili con nome.
Rappresentazione JSON |
---|
{
"styles": [
{
object ( |
Campi | |
---|---|
styles[] |
Gli stili con nome. È presente una voce per ciascuno dei possibili |
Stile Named
Uno stile con nome. I paragrafi nel documento possono ereditare i valori TextStyle
e ParagraphStyle
da questo stile con nome se hanno lo stesso tipo di stile denominato.
Rappresentazione JSON |
---|
{ "namedStyleType": enum ( |
Campi | |
---|---|
namedStyleType |
Il tipo di stile con nome. |
textStyle |
Lo stile di testo di questo stile con nome. |
paragraphStyle |
Lo stile di paragrafo di questo stile con nome. |
StiliNamedSuggeriti
Una modifica suggerita per NamedStyles
.
Rappresentazione JSON |
---|
{ "namedStyles": { object ( |
Campi | |
---|---|
namedStyles |
Un |
namedStylesSuggestionState |
Una maschera che indica quali campi sulla base |
NamedStylesSuggestionState
Lo stato del suggerimento di un messaggio NamedStyles
.
Rappresentazione JSON |
---|
{
"stylesSuggestionStates": [
{
object ( |
Campi | |
---|---|
stylesSuggestionStates[] |
Una maschera che indica quali campi del L'ordine di questi stati del suggerimento di stile con nome corrisponde all'ordine dello stile con nome corrispondente all'interno del suggerimento |
Stato NamedStyleSuggestion
Uno stato di suggerimento di un messaggio NamedStyle
.
Rappresentazione JSON |
---|
{ "namedStyleType": enum ( |
Campi | |
---|---|
namedStyleType |
Il tipo di stile denominato a cui corrisponde lo stato del suggerimento. Questo campo viene fornito per semplificare la corrispondenza tra NamedStyleSuggestionState e |
textStyleSuggestionState |
Una maschera che indica quali campi in |
paragraphStyleSuggestionState |
Una maschera che indica quali campi in |
Elenco
Un elenco rappresenta gli attributi di un gruppo di paragrafi che appartengono tutti allo stesso elenco. Un paragrafo che fa parte di un elenco contiene un riferimento all'ID dell'elenco nel relativo bullet
.
Rappresentazione JSON |
---|
{ "listProperties": { object ( |
Campi | |
---|---|
listProperties |
Le proprietà dell'elenco. |
suggestedListPropertiesChanges |
Le modifiche suggerite alle proprietà dell'elenco, specificate per ID suggerimento. |
suggestedInsertionId |
L'ID inserimento suggerito. Se vuoto, non è un inserimento suggerito. |
suggestedDeletionIds[] |
Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questo elenco. |
Proprietà-Elenco
Le proprietà di un elemento list
che descrivono l'aspetto dei punti elenco appartenenti ai paragrafi associati a un elenco.
Rappresentazione JSON |
---|
{
"nestingLevels": [
{
object ( |
Campi | |
---|---|
nestingLevels[] |
Descrive le proprietà dei punti elenco al livello associato. Un elenco ha al massimo 9 livelli di nidificazione, con il livello di annidamento 0 corrispondente al livello più alto e il livello di nidificazione 8 corrispondente a quello più nidificato. I livelli nidificati vengono restituiti in ordine crescente e vengono restituiti prima quelli meno nidificati. |
Livello di nidificazione
Contiene proprietà che descrivono l'aspetto di un punto elenco a un determinato livello di nidificazione.
Rappresentazione JSON |
---|
{ "bulletAlignment": enum ( |
Campi | |
---|---|
bulletAlignment |
L'allineamento del punto elenco all'interno dello spazio assegnato per il rendering del punto elenco. |
glyphFormat |
La stringa di formato utilizzata dai punti elenco a questo livello di nidificazione. Il formato glyph contiene uno o più segnaposto che vengono sostituiti con i valori appropriati a seconda di Ad esempio, il formato
Il formato glyph può contenere segnaposto per il livello di nidificazione corrente e per i livelli di annidamento padre. Ad esempio, un elenco può avere un formato glifo
Per i livelli nidificati che vengono ordinati, la stringa che sostituisce un segnaposto nel formato glifo per un determinato paragrafo dipende dall'ordine del paragrafo nell'elenco. |
indentFirstLine |
La quantità di rientro per la prima riga dei paragrafi a questo livello di nidificazione. |
indentStart |
La quantità di rientro per i paragrafi a questo livello di nidificazione. Applicata al lato corrispondente all'inizio del testo, in base alla direzione dei contenuti del paragrafo. |
textStyle |
Lo stile di testo dei punti elenco a questo livello di nidificazione. |
startNumber |
Il numero del primo elemento dell'elenco a questo livello di annidamento. Il valore 0 viene considerato come un valore pari a 1 per gli elenchi con lettere e gli elenchi di numeri romani. Per i valori sia 0 che 1, gli elenchi di numeri romani e lettere inizieranno rispettivamente con Questo valore viene ignorato per i livelli nidificati con glifi non ordinati. |
Campo di unione glyph_kind . Il tipo di glifo usato dai punti elenco. In questo modo viene definito il glifo del punto elenco che sostituisce i segnaposto in glyph_format . glyph_kind può essere solo uno dei seguenti: |
|
glyphType |
Il tipo di glifo utilizzato dai punti elenco quando vengono ordinati i paragrafi a questo livello di nidificazione. Il tipo di glifo determina il tipo di glifo utilizzato per sostituire i segnaposto all'interno di |
glyphSymbol |
Un simbolo glifo personalizzato utilizzato dai punti elenco quando i paragrafi a questo livello di annidamento non sono ordinati. Il simbolo del glifo sostituisce i segnaposto all'interno del |
Allineamento elenco puntato
I tipi di allineamento di un punto elenco.
Enum | |
---|---|
BULLET_ALIGNMENT_UNSPECIFIED |
L'allineamento del punto elenco non è specificato. |
START |
Il punto elenco è allineato all'inizio dello spazio assegnato per il rendering del punto. Allineato a sinistra per il testo LTR, altrimenti allineato a destra. |
CENTER |
Il punto elenco è allineato al centro dello spazio assegnato per il rendering del punto. |
END |
Il punto elenco è allineato alla fine dello spazio assegnato per il rendering del punto. Allineato a destra per il testo LTR, altrimenti allineato a sinistra. |
Tipo glifo
I tipi di glifi utilizzati dai punti elenco quando vengono ordinati i paragrafi a questo livello di annidamento.
Enum | |
---|---|
GLYPH_TYPE_UNSPECIFIED |
Il tipo di glifo non è specificato o non è supportato. |
NONE |
Una stringa vuota. |
DECIMAL |
Un numero, ad esempio 1 , 2 o 3 . |
ZERO_DECIMAL |
Un numero in cui i numeri di una sola cifra sono preceduti da uno zero, ad esempio 01 , 02 o 03 . I numeri con più di una cifra non hanno il prefisso zero. |
UPPER_ALPHA |
Una lettera maiuscola, come A , B o C . |
ALPHA |
Una lettera minuscola, come a , b o c . |
UPPER_ROMAN |
Un numero romano maiuscolo, ad esempio I , II o III . |
ROMAN |
Un numero romano minuscolo, come i , ii o iii . |
ProprietàElenco suggerite
Una modifica suggerita per ListProperties
.
Rappresentazione JSON |
---|
{ "listProperties": { object ( |
Campi | |
---|---|
listProperties |
Un |
listPropertiesSuggestionState |
Una maschera che indica quali campi sulla base |
Stato ElencoProprietàSuggerimento
Una maschera che indica quali campi sulla base ListProperties
sono stati modificati in questo suggerimento. Per ogni campo impostato su true viene suggerito un nuovo valore.
Rappresentazione JSON |
---|
{
"nestingLevelsSuggestionStates": [
{
object ( |
Campi | |
---|---|
nestingLevelsSuggestionStates[] |
Una maschera che indica quali campi del Gli stati di suggerimento del livello di annidamento vengono restituiti in ordine crescente del livello di annidamento e vengono restituiti per primi quelli con il livello meno nidificato. |
Stato NestingLevelSuggestionState
Una maschera che indica quali campi sulla base NestingLevel
sono stati modificati in questo suggerimento. Per ogni campo impostato su true viene suggerito un nuovo valore.
Rappresentazione JSON |
---|
{
"bulletAlignmentSuggested": boolean,
"glyphTypeSuggested": boolean,
"glyphFormatSuggested": boolean,
"glyphSymbolSuggested": boolean,
"indentFirstLineSuggested": boolean,
"indentStartSuggested": boolean,
"textStyleSuggestionState": {
object ( |
Campi | |
---|---|
bulletAlignmentSuggested |
Indica se è stata suggerita una modifica a |
glyphTypeSuggested |
Indica se è stata suggerita una modifica a |
glyphFormatSuggested |
Indica se è stata suggerita una modifica a |
glyphSymbolSuggested |
Indica se è stata suggerita una modifica a |
indentFirstLineSuggested |
Indica se è stata suggerita una modifica a |
indentStartSuggested |
Indica se è stata suggerita una modifica a |
textStyleSuggestionState |
Una maschera che indica quali campi in |
startNumberSuggested |
Indica se è stata suggerita una modifica a |
Intervalli NamedRanges
Una raccolta di tutti gli elementi NamedRange
nel documento che condividono un determinato nome.
Rappresentazione JSON |
---|
{
"name": string,
"namedRanges": [
{
object ( |
Campi | |
---|---|
name |
Il nome condiviso da tutti i |
namedRanges[] |
I valori |
Intervallo Nome
Una raccolta di Range
con lo stesso ID intervallo denominato.
Gli intervalli denominati consentono agli sviluppatori di associare parti di un documento a un'etichetta arbitraria definita dall'utente, in modo che i relativi contenuti possano essere letti o modificati in modo programmatico in un secondo momento. Un documento può contenere più intervalli denominati con lo stesso nome, ma ogni intervallo denominato ha un ID univoco.
Un intervallo denominato viene creato con un singolo elemento Range
e i contenuti inseriti all'interno di un intervallo denominato generalmente espandono questo intervallo. Tuttavia, alcune modifiche al documento possono causare la suddivisione dell'intervallo in più intervalli.
Gli intervalli denominati non sono privati. Tutti i collaboratori e le applicazioni che hanno accesso al documento possono visualizzare gli intervalli denominati.
Rappresentazione JSON |
---|
{
"namedRangeId": string,
"name": string,
"ranges": [
{
object ( |
Campi | |
---|---|
namedRangeId |
L'ID dell'intervallo denominato. |
name |
Il nome dell'intervallo denominato. |
ranges[] |
Gli intervalli che appartengono a questo intervallo denominato. |
Intervallo
Specifica un intervallo di testo contiguo.
Rappresentazione JSON |
---|
{ "segmentId": string, "startIndex": integer, "endIndex": integer } |
Campi | |
---|---|
segmentId |
L'ID dell'intestazione, del piè di pagina o della nota a piè di pagina in cui è contenuto l'intervallo. Un ID segmento vuoto indica il corpo del documento. |
startIndex |
L'indice iniziale in base zero di questo intervallo, in unità di codice UTF-16. È necessario fornire un indice iniziale in tutti gli utilizzi correnti. Questo campo è un valore Int32Value per supportare casi d'uso futuri con intervalli aperti. |
endIndex |
L'indice finale in base zero di questo intervallo, esclusivo, in unità di codice UTF-16. In tutti gli utilizzi correnti è necessario fornire un indice finale. Questo campo è un valore Int32Value per supportare casi d'uso futuri con intervalli aperti. |
Modalità di visualizzazione dei suggerimenti
La modalità di visualizzazione dei suggerimenti applicata al documento che indica come vengono rappresentate le modifiche suggerite. Fornisce opzioni per la lettura del documento con tutti i suggerimenti in linea, accettati o rifiutati.
Enum | |
---|---|
DEFAULT_FOR_CURRENT_ACCESS |
Il valore SuggestionsViewMode applicato al documento restituito dipende dal livello di accesso corrente dell'utente. Se l'utente dispone solo dell'accesso in visualizzazione, viene applicato il criterio PREVIEW_WITHOUT_SUGGESTIONS . In caso contrario, viene applicato il criterio SUGGESTIONS_INLINE . Questa è la modalità di visualizzazione dei suggerimenti predefinita. |
SUGGESTIONS_INLINE |
Il documento restituito contiene suggerimenti incorporati. Le modifiche suggerite verranno differenziate dai contenuti di base all'interno del documento. Le richieste per recuperare un documento utilizzando questa modalità restituiranno un errore 403 se l'utente non dispone dell'autorizzazione per visualizzare le modifiche suggerite. |
PREVIEW_SUGGESTIONS_ACCEPTED |
Il documento restituito è un'anteprima in cui sono state accettate tutte le modifiche suggerite. Le richieste per recuperare un documento utilizzando questa modalità restituiranno un errore 403 se l'utente non dispone dell'autorizzazione per visualizzare le modifiche suggerite. |
PREVIEW_WITHOUT_SUGGESTIONS |
Il documento restituito è un'anteprima con tutte le modifiche suggerite rifiutate, se il documento contiene suggerimenti. |
InlineObject
Oggetto visualizzato in linea con il testo. Un InlineObject contiene un elemento EmbeddedObject
, ad esempio un'immagine.
Rappresentazione JSON |
---|
{ "objectId": string, "inlineObjectProperties": { object ( |
Campi | |
---|---|
objectId |
L'ID di questo oggetto in linea. Può essere utilizzato per aggiornare le proprietà di un oggetto. |
inlineObjectProperties |
Le proprietà dell'oggetto in linea. |
suggestedInlineObjectPropertiesChanges |
Le modifiche suggerite alle proprietà degli oggetti in linea, specificate in base all'ID suggerimento. |
suggestedInsertionId |
L'ID inserimento suggerito. Se vuoto, non è un inserimento suggerito. |
suggestedDeletionIds[] |
Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti. |
ProprietàInlineObjectProperties
Proprietà di un elemento InlineObject
.
Rappresentazione JSON |
---|
{
"embeddedObject": {
object ( |
Campi | |
---|---|
embeddedObject |
L'oggetto incorporato di questo oggetto in linea. |
Oggetto incorporato
Un oggetto incorporato nel documento.
Rappresentazione JSON |
---|
{ "title": string, "description": string, "embeddedObjectBorder": { object ( |
Campi | |
---|---|
title |
Il titolo dell'oggetto incorporato. |
description |
La descrizione dell'oggetto incorporato. |
embeddedObjectBorder |
Il bordo dell'oggetto incorporato. |
size |
Le dimensioni visibili dell'immagine dopo il ritaglio. |
marginTop |
Il margine superiore dell'oggetto incorporato. |
marginBottom |
Il margine inferiore dell'oggetto incorporato. |
marginRight |
Il margine destro dell'oggetto incorporato. |
marginLeft |
Il margine sinistro dell'oggetto incorporato. |
linkedContentReference |
Un riferimento ai contenuti della fonte esterna collegata. Ad esempio, contiene un riferimento al grafico di Fogli Google di origine quando l'oggetto incorporato è un grafico collegato. Se il criterio non viene configurato, l'oggetto incorporato non è collegato. |
Campo di unione properties . Le proprietà specifiche di ogni tipo di oggetto incorporato. properties può essere solo uno dei seguenti: |
|
embeddedDrawingProperties |
Le proprietà di un disegno incorporato. |
imageProperties |
Le proprietà di un'immagine. |
ProprietàDisegnoIncorporato
Questo tipo non ha campi.
Le proprietà di un disegno incorporato, utilizzate per differenziare il tipo di oggetto. Un disegno incorporato è un disegno creato e modificato all'interno di un documento. Tieni presente che i dettagli completi non sono supportati.
ImageProperties
Le proprietà di un'immagine.
Rappresentazione JSON |
---|
{
"contentUri": string,
"sourceUri": string,
"brightness": number,
"contrast": number,
"transparency": number,
"cropProperties": {
object ( |
Campi | |
---|---|
contentUri |
Un URI dell'immagine con una durata predefinita di 30 minuti. Questo URI è contrassegnato con l'account del richiedente. Chiunque abbia l'URI accede in modo efficace all'immagine come richiedente originale. Se le impostazioni di condivisione del documento cambiano, potresti perdere l'accesso all'immagine. |
sourceUri |
L'URI di origine è l'URI utilizzato per inserire l'immagine. L'URI di origine può essere vuoto. |
brightness |
L'effetto di luminosità dell'immagine. Il valore deve essere compreso nell'intervallo [-1,0, 1,0], dove 0 significa nessun effetto. |
contrast |
L'effetto di contrasto dell'immagine. Il valore deve essere compreso nell'intervallo [-1,0, 1,0], dove 0 significa nessun effetto. |
transparency |
L'effetto di trasparenza dell'immagine. Il valore deve essere compreso nell'intervallo [0,0, 1,0], dove 0 significa nessun effetto e 1 significa trasparente. |
cropProperties |
Le proprietà di ritaglio dell'immagine. |
angle |
L'angolo di rotazione in senso orario dell'immagine, espresso in radianti. |
Proprietà ritaglio
Le proprietà di ritaglio di un'immagine.
Il rettangolo di ritaglio viene rappresentato utilizzando offset frazionari dai quattro bordi del contenuto originale.
- Se l'offset è compreso nell'intervallo (0, 1), il bordo corrispondente del rettangolo di ritaglio viene posizionato all'interno del rettangolo di delimitazione originale dell'immagine.
- Se l'offset è negativo o maggiore di 1, il bordo corrispondente del rettangolo di ritaglio viene posizionato al di fuori del rettangolo di delimitazione originale dell'immagine.
- Se tutti gli offset e l'angolo di rotazione sono pari a 0, l'immagine non viene ritagliata.
Rappresentazione JSON |
---|
{ "offsetLeft": number, "offsetRight": number, "offsetTop": number, "offsetBottom": number, "angle": number } |
Campi | |
---|---|
offsetLeft |
L'offset specifica quanto si estende verso l'interno il bordo sinistro del rettangolo di ritaglio dal bordo sinistro del contenuto originale come frazione della larghezza di questi ultimi. |
offsetRight |
L'offset specifica quanto si estende verso l'interno il bordo destro del rettangolo di ritaglio dal bordo destro del contenuto originale come frazione della larghezza di questi ultimi. |
offsetTop |
L'offset specifica quanto si estende verso l'interno il bordo superiore del rettangolo di ritaglio dal bordo superiore dei contenuti originali sotto forma di frazione dell'altezza di questi ultimi. |
offsetBottom |
L'offset specifica quanto si estende verso l'interno il bordo inferiore del rettangolo di ritaglio dal bordo inferiore dei contenuti originali sotto forma di frazione dell'altezza di questi ultimi. |
angle |
L'angolo di rotazione in senso orario del rettangolo di ritaglio attorno al centro, espresso in radianti. La rotazione viene applicata dopo gli offset. |
IncorporatoOggettoBorder
Un bordo intorno a un EmbeddedObject
.
Rappresentazione JSON |
---|
{ "color": { object ( |
Campi | |
---|---|
color |
Il colore del bordo. |
width |
La larghezza del bordo. |
dashStyle |
Lo stile del trattino del bordo. |
propertyState |
Lo stato della proprietà di confine. |
Stato della proprietà
I possibili stati di una proprietà.
Enum | |
---|---|
RENDERED |
Se lo stato di una proprietà è RENDERED, l'elemento ha la proprietà corrispondente quando viene visualizzato nel documento. Questo è il valore predefinito. |
NOT_RENDERED |
Se lo stato di una proprietà è NOT_RENDERED, l'elemento non ha la proprietà corrispondente quando viene visualizzato nel documento. |
RiferimentoContenutolink
Un riferimento ai contenuti della fonte esterna collegata.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione reference . Il riferimento specifico al tipo di contenuti collegati. reference può essere solo uno dei seguenti: |
|
sheetsChartReference |
Un riferimento al grafico collegato. |
RiferimentoGrafico Fogli
Un riferimento a un grafico collegato incorporato da Fogli Google.
Rappresentazione JSON |
---|
{ "spreadsheetId": string, "chartId": integer } |
Campi | |
---|---|
spreadsheetId |
L'ID del foglio di lavoro di Fogli Google che contiene il grafico di origine. |
chartId |
L'ID del grafico specifico nel foglio di lavoro di Fogli Google incorporato. |
ProprietàOggettoInline Suggerite
Una modifica suggerita per InlineObjectProperties
.
Rappresentazione JSON |
---|
{ "inlineObjectProperties": { object ( |
Campi | |
---|---|
inlineObjectProperties |
Un elemento |
inlineObjectPropertiesSuggestionState |
Una maschera che indica quali campi sulla base |
StatoInlineObjectPropertiesSuggestionState
Una maschera che indica quali campi sulla base InlineObjectProperties
sono stati modificati in questo suggerimento. Per ogni campo impostato su true viene suggerito un nuovo valore.
Rappresentazione JSON |
---|
{
"embeddedObjectSuggestionState": {
object ( |
Campi | |
---|---|
embeddedObjectSuggestionState |
Una maschera che indica quali campi in |
StaticObjectSuggestionState
Una maschera che indica quali campi sulla base EmbeddedObject
sono stati modificati in questo suggerimento. Per ogni campo impostato su true viene suggerito un nuovo valore.
Rappresentazione JSON |
---|
{ "embeddedDrawingPropertiesSuggestionState": { object ( |
Campi | |
---|---|
embeddedDrawingPropertiesSuggestionState |
Una maschera che indica quali campi in |
imagePropertiesSuggestionState |
Una maschera che indica quali campi in |
titleSuggested |
Indica se è stata suggerita una modifica a |
descriptionSuggested |
Indica se è stata suggerita una modifica a |
embeddedObjectBorderSuggestionState |
Una maschera che indica quali campi in |
sizeSuggestionState |
Una maschera che indica quali campi in |
marginLeftSuggested |
Indica se è stata suggerita una modifica a |
marginRightSuggested |
Indica se è stata suggerita una modifica a |
marginTopSuggested |
Indica se è stata suggerita una modifica a |
marginBottomSuggested |
Indica se è stata suggerita una modifica a |
linkedContentReferenceSuggestionState |
Una maschera che indica quali campi in |
Stato Suggerimento relativo al disegno incorporato
Questo tipo non ha campi.
Una maschera che indica quali campi sulla base EmbeddedDrawingProperties
sono stati modificati in questo suggerimento. Per ogni campo impostato su true viene suggerito un nuovo valore.
Stato Suggerimento Proprietà Immagini
Una maschera che indica quali campi sulla base ImageProperties
sono stati modificati in questo suggerimento. Per ogni campo impostato su true viene suggerito un nuovo valore.
Rappresentazione JSON |
---|
{
"contentUriSuggested": boolean,
"sourceUriSuggested": boolean,
"brightnessSuggested": boolean,
"contrastSuggested": boolean,
"transparencySuggested": boolean,
"cropPropertiesSuggestionState": {
object ( |
Campi | |
---|---|
contentUriSuggested |
Indica se è stata suggerita una modifica a |
sourceUriSuggested |
Indica se è stata suggerita una modifica a [sourceUri] [google.apps.docs.v1.EmbeddedObject.source_uri]. |
brightnessSuggested |
Indica se è stata suggerita una modifica a [luminosità] [google.apps.docs.v1.EmbeddedObject.brightness]. |
contrastSuggested |
Indica se è stata suggerita una modifica a [contrasto] [google.apps.docs.v1.EmbeddedObject.contrast]. |
transparencySuggested |
Indica se è stata suggerita una modifica a [trasparenza] [google.apps.docs.v1.EmbeddedObject.transparency]. |
cropPropertiesSuggestionState |
Una maschera che indica quali campi in |
angleSuggested |
Indica se è stata suggerita una modifica a [angle] [google.apps.docs.v1.embeddedObject.angle]. |
Stato CropPropertiesSuggestion
Una maschera che indica quali campi sulla base CropProperties
sono stati modificati in questo suggerimento. Per ogni campo impostato su true viene suggerito un nuovo valore.
Rappresentazione JSON |
---|
{ "offsetLeftSuggested": boolean, "offsetRightSuggested": boolean, "offsetTopSuggested": boolean, "offsetBottomSuggested": boolean, "angleSuggested": boolean } |
Campi | |
---|---|
offsetLeftSuggested |
Indica se è stata suggerita una modifica a |
offsetRightSuggested |
Indica se è stata suggerita una modifica a |
offsetTopSuggested |
Indica se è stata suggerita una modifica a |
offsetBottomSuggested |
Indica se è stata suggerita una modifica a |
angleSuggested |
Indica se è stata suggerita una modifica a |
StaticObjectBorderSuggestionState
Una maschera che indica quali campi sulla base EmbeddedObjectBorder
sono stati modificati in questo suggerimento. Per ogni campo impostato su true viene suggerito un nuovo valore.
Rappresentazione JSON |
---|
{ "colorSuggested": boolean, "widthSuggested": boolean, "dashStyleSuggested": boolean, "propertyStateSuggested": boolean } |
Campi | |
---|---|
colorSuggested |
Indica se è stata suggerita una modifica a [color] [google.apps.docs.v1.EmbedBorderObject.color]. |
widthSuggested |
Indica se è stata suggerita una modifica a [larghezza] [google.apps.docs.v1.EmbeddedBorderObject.width]. |
dashStyleSuggested |
Indica se è stata suggerita una modifica a [dashStyle] [google.apps.docs.v1.EmbeddedBorderObject.dash_style]. |
propertyStateSuggested |
Indica se è stata suggerita una modifica a [propertyState] [google.apps.docs.v1.embeddedBorderObject.property_state]. |
Stato LinkedContentReferenceSuggestion
Una maschera che indica quali campi sulla base LinkedContentReference
sono stati modificati in questo suggerimento. Per ogni campo impostato su true viene suggerito un nuovo valore.
Rappresentazione JSON |
---|
{
"sheetsChartReferenceSuggestionState": {
object ( |
Campi | |
---|---|
sheetsChartReferenceSuggestionState |
Una maschera che indica quali campi in |
Stato FogliChartReferenceSuggestion
Una maschera che indica quali campi sulla base SheetsChartReference
sono stati modificati in questo suggerimento. Per ogni campo impostato su true viene suggerito un nuovo valore.
Rappresentazione JSON |
---|
{ "spreadsheetIdSuggested": boolean, "chartIdSuggested": boolean } |
Campi | |
---|---|
spreadsheetIdSuggested |
Indica se è stata suggerita una modifica a |
chartIdSuggested |
Indica se è stata suggerita una modifica a |
Oggetto posizionato
Un oggetto collegato a un Paragraph
e posizionato rispetto all'inizio del paragrafo. Un oggetto Posizionato contiene un elemento EmbeddedObject
, ad esempio un'immagine.
Rappresentazione JSON |
---|
{ "objectId": string, "positionedObjectProperties": { object ( |
Campi | |
---|---|
objectId |
L'ID dell'oggetto posizionato. |
positionedObjectProperties |
Le proprietà dell'oggetto posizionato. |
suggestedPositionedObjectPropertiesChanges |
Le modifiche suggerite alle proprietà dell'oggetto posizionato, specificate per ID suggerimento. |
suggestedInsertionId |
L'ID inserimento suggerito. Se vuoto, non è un inserimento suggerito. |
suggestedDeletionIds[] |
Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti. |
Proprietà oggetto posizionato
Proprietà di una proprietà PositionedObject
.
Rappresentazione JSON |
---|
{ "positioning": { object ( |
Campi | |
---|---|
positioning |
Il posizionamento dell'oggetto posizionato rispetto alla nuova riga dell'elemento |
embeddedObject |
L'oggetto incorporato dell'oggetto posizionato. |
Posizionamento oggetto posizionato
Il posizionamento di un elemento PositionedObject
. L'oggetto posizionato viene posizionato rispetto all'inizio del Paragraph
a cui è vincolato il tethering.
Rappresentazione JSON |
---|
{ "layout": enum ( |
Campi | |
---|---|
layout |
Il layout dell'oggetto posizionato. |
leftOffset |
L'offset del bordo sinistro dell'oggetto posizionato rispetto all'inizio dell'elemento |
topOffset |
L'offset del bordo superiore dell'oggetto posizionato rispetto all'inizio dell'elemento |
Layout oggetto posizionato
I possibili layout di un [PositionedObject][google.aps.docs.v1.PositionedObject].
Enum | |
---|---|
POSITIONED_OBJECT_LAYOUT_UNSPECIFIED |
Il layout non è specificato. |
WRAP_TEXT |
Il testo viene spostato intorno all'oggetto posizionato. |
BREAK_LEFT |
Interrompe il testo in modo che l'oggetto posizionato si trovi a sinistra e il testo a destra. |
BREAK_RIGHT |
Interrompe il testo in modo che l'oggetto posizionato si trovi a destra e il testo a sinistra. |
BREAK_LEFT_RIGHT |
Interrompe il testo in modo che non ci sia testo a sinistra o a destra dell'oggetto posizionato. |
IN_FRONT_OF_TEXT |
L'oggetto posizionato si trova davanti al testo. |
BEHIND_TEXT |
L'oggetto posizionato si trova dietro il testo. |
Proprietà oggetti posizionate suggerite
Una modifica suggerita per PositionedObjectProperties
.
Rappresentazione JSON |
---|
{ "positionedObjectProperties": { object ( |
Campi | |
---|---|
positionedObjectProperties |
Un |
positionedObjectPropertiesSuggestionState |
Una maschera che indica quali campi sulla base |
PosizionatoOggettoProprietàSuggestionState
Una maschera che indica quali campi sulla base PositionedObjectProperties
sono stati modificati in questo suggerimento. Per ogni campo impostato su true viene suggerito un nuovo valore.
Rappresentazione JSON |
---|
{ "positioningSuggestionState": { object ( |
Campi | |
---|---|
positioningSuggestionState |
Una maschera che indica quali campi in |
embeddedObjectSuggestionState |
Una maschera che indica quali campi in |
Stato posizione dell'oggettoPositioningSuggestion
Una maschera che indica quali campi sulla base PositionedObjectPositioning
sono stati modificati in questo suggerimento. Per ogni campo impostato su true viene suggerito un nuovo valore.
Rappresentazione JSON |
---|
{ "layoutSuggested": boolean, "leftOffsetSuggested": boolean, "topOffsetSuggested": boolean } |
Campi | |
---|---|
layoutSuggested |
Indica se è stata suggerita una modifica a |
leftOffsetSuggested |
Indica se è stata suggerita una modifica a |
topOffsetSuggested |
Indica se è stata suggerita una modifica a |
Metodi |
|
---|---|
|
Applica uno o più aggiornamenti al documento. |
|
Crea un documento vuoto utilizzando il titolo specificato nella richiesta. |
|
Restituisce la versione più recente del documento specificato. |