REST Resource: documents

Risorsa: documento

Un documento di Documenti Google.

Rappresentazione JSON
{
  "documentId": string,
  "title": string,
  "tabs": [
    {
      object (Tab)
    }
  ],
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
Campi
documentId

string

Solo output. L'ID del documento.

title

string

Il titolo del documento.

tabs[]

object (Tab)

Schede che fanno parte di un documento.

Le schede possono contenere schede secondarie, una scheda nidificata in un'altra scheda. Le schede secondarie sono rappresentate dal campo Tab.childTabs.

revisionId

string

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 quella revisione. Viene compilato solo se l'utente dispone dell'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. L'ID revisione restituito è garantito come valido solo per 24 ore dopo la restituzione e non può essere condiviso tra utenti. Se l'ID revisione rimane invariato tra una chiamata e l'altra, il documento non è stato modificato. Al contrario, un ID modificato (per lo stesso documento e 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

enum (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 SUGGESTIONS_INLINE.

body

object (Body)

Solo output. Il corpo principale del documento.

Campo precedente: utilizza invece Document.tabs.documentTab.body, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se false o non viene configurato, questo campo contiene informazioni sulla prima scheda del documento.

headers

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

Solo output. Le intestazioni del documento, con chiave in base all'ID intestazione.

Campo precedente: utilizza invece Document.tabs.documentTab.headers, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se false o non viene configurato, questo campo contiene informazioni sulla prima scheda del documento.

footers

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

Solo output. I piè di pagina nel documento, indicizzati in base all'ID piè di pagina.

Campo precedente: utilizza invece Document.tabs.documentTab.footers, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se false o non viene configurato, questo campo contiene informazioni sulla prima scheda del documento.

footnotes

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

Solo output. Le note a piè di pagina nel documento, digitate dall'ID della nota a piè di pagina.

Campo precedente: utilizza invece Document.tabs.documentTab.footnotes, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se false o non viene configurato, questo campo contiene informazioni sulla prima scheda del documento.

documentStyle

object (DocumentStyle)

Solo output. Lo stile del documento.

Campo precedente: utilizza invece Document.tabs.documentTab.documentStyle, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se false o non viene configurato, questo campo contiene informazioni sulla prima scheda del documento.

suggestedDocumentStyleChanges

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

Solo output. Le modifiche suggerite allo stile del documento, digitate dall'ID suggerimento.

Campo precedente: utilizza invece Document.tabs.documentTab.suggestedDocumentStyleChanges, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se è false o non impostato, questo campo contiene informazioni sulla prima scheda del documento.

namedStyles

object (NamedStyles)

Solo output. Gli stili con nome del documento.

Campo precedente: utilizza invece Document.tabs.documentTab.namedStyles, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se è false o non impostato, questo campo contiene informazioni sulla prima scheda del documento.

suggestedNamedStylesChanges

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

Solo output. Le modifiche suggerite agli stili con nome del documento, digitati dall'ID suggerimento.

Campo precedente: utilizza invece Document.tabs.documentTab.suggestedNamedStylesChanges, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se false o non viene configurato, questo campo contiene informazioni sulla prima scheda del documento.

lists

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

Solo output. Gli elenchi nel documento, indicizzati in base all'ID elenco.

Campo precedente: utilizza invece Document.tabs.documentTab.lists, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se false o non impostato, questo campo contiene informazioni sulla prima scheda del documento.

namedRanges

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

Solo output. Gli intervalli denominati nel documento, indicizzati per nome.

Campo precedente: utilizza invece Document.tabs.documentTab.namedRanges, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se false o non viene configurato, questo campo contiene informazioni sulla prima scheda del documento.

inlineObjects

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

Solo output. Gli oggetti incorporati nel documento, codificati in base all'ID oggetto.

Campo precedente: utilizza invece Document.tabs.documentTab.inlineObjects, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se false o non viene configurato, questo campo contiene informazioni sulla prima scheda del documento.

positionedObjects

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

Solo output. Gli oggetti posizionati nel documento, indicizzati in base all'ID oggetto.

Campo precedente: utilizza invece Document.tabs.documentTab.positionedObjects, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se è false o non impostato, questo campo contiene informazioni sulla prima scheda del documento.

TAB

Una scheda in un documento.

Rappresentazione JSON
{
  "tabProperties": {
    object (TabProperties)
  },
  "childTabs": [
    {
      object (Tab)
    }
  ],

  // Union field content can be only one of the following:
  "documentTab": {
    object (DocumentTab)
  }
  // End of list of possible types for union field content.
}
Campi
tabProperties

object (TabProperties)

Le proprietà della scheda, come ID e titolo.

childTabs[]

object (Tab)

Le schede secondarie nidificate in questa scheda.

Campo unione content. I contenuti della scheda. content può essere solo uno dei seguenti:
documentTab

object (DocumentTab)

Una scheda con i contenuti del documento, come testo e immagini.

TabProperties

Proprietà di una scheda.

Rappresentazione JSON
{
  "tabId": string,
  "title": string,
  "parentTabId": string,
  "index": integer,
  "nestingLevel": integer
}
Campi
tabId

string

Solo output. L'ID della scheda. Questo campo non può essere modificato.

title

string

Il nome visibile all'utente della scheda.

parentTabId

string

(Facoltativo) L'ID della scheda principale. Vuoto quando la scheda corrente è a livello di radice, il che significa che non ha schede principali.

index

integer

L'indice in base zero della scheda all'interno dell'elemento principale.

nestingLevel

integer

Solo output. La profondità della scheda all'interno del documento. Le schede a livello di directory principale iniziano da 0.

DocumentTab

Una scheda con contenuti di documenti.

Rappresentazione JSON
{
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
Campi
body

object (Body)

Il corpo principale della scheda del documento.

headers

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

Le intestazioni nella scheda del documento, con chiave ID intestazione.

footers

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

I piè di pagina nella scheda del documento, indicizzati in base all'ID piè di pagina.

footnotes

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

Le note a piè di pagina nella scheda del documento, con chiave in base all'ID nota.

documentStyle

object (DocumentStyle)

Lo stile della scheda del documento.

suggestedDocumentStyleChanges

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

Le modifiche suggerite allo stile della scheda del documento, con chiave in base all'ID suggerimento.

namedStyles

object (NamedStyles)

Gli stili con nome della scheda del documento.

suggestedNamedStylesChanges

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

Le modifiche suggerite agli stili con nome della scheda del documento, digitate dall'ID suggerimento.

lists

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

Gli elenchi nella scheda del documento, indicizzati in base all'ID elenco.

namedRanges

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

Intervalli denominati nella scheda del documento, digitati per nome.

inlineObjects

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

Gli oggetti in linea nella scheda del documento, indicizzati in base all'ID oggetto.

positionedObjects

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

Gli oggetti posizionati nella scheda del documento, codificati per ID oggetto.

Corpo

Il corpo del documento.

In genere, il corpo include tutti i contenuti del documento, ad eccezione di headers, footers e footnotes.

Rappresentazione JSON
{
  "content": [
    {
      object (StructuralElement)
    }
  ]
}
Campi
content[]

object (StructuralElement)

I contenuti del corpo.

Gli indici dei contenuti del corpo iniziano da zero.

ElementoStrutturale

Un elemento StructuralElement descrive i contenuti che forniscono una struttura al documento.

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

  // Union field content can be only one of the following:
  "paragraph": {
    object (Paragraph)
  },
  "sectionBreak": {
    object (SectionBreak)
  },
  "table": {
    object (Table)
  },
  "tableOfContents": {
    object (TableOfContents)
  }
  // End of list of possible types for union field content.
}
Campi
startIndex

integer

L'indice di inizio basato su zero di questo elemento strutturale, in unità di codice UTF-16.

endIndex

integer

L'indice finale in base zero di questo elemento strutturale, esclusivo, nelle unità di codice UTF-16.

Campo unione content. Il contenuto dell'elemento strutturale. content può essere solo uno dei seguenti:
paragraph

object (Paragraph)

Un tipo di paragrafo di elemento strutturale.

sectionBreak

object (SectionBreak)

Un tipo di interruzione di sezione dell'elemento strutturale.

table

object (Table)

Un tipo di tabella di elemento strutturale.

tableOfContents

object (TableOfContents)

Un tipo di elemento strutturale del sommario.

Paragrafo

Un StructuralElement che rappresenta un paragrafo. Un paragrafo è un intervallo di contenuti terminati con un carattere di nuova riga.

Rappresentazione JSON
{
  "elements": [
    {
      object (ParagraphElement)
    }
  ],
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "suggestedParagraphStyleChanges": {
    string: {
      object (SuggestedParagraphStyle)
    },
    ...
  },
  "bullet": {
    object (Bullet)
  },
  "suggestedBulletChanges": {
    string: {
      object (SuggestedBullet)
    },
    ...
  },
  "positionedObjectIds": [
    string
  ],
  "suggestedPositionedObjectIds": {
    string: {
      object (ObjectReferences)
    },
    ...
  }
}
Campi
elements[]

object (ParagraphElement)

I contenuti del paragrafo, suddivisi nelle relative parti.

paragraphStyle

object (ParagraphStyle)

Lo stile di questo paragrafo.

suggestedParagraphStyleChanges

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

Lo stile di paragrafo suggerito viene modificato in questo paragrafo, con chiave in base all'ID suggerimento.

bullet

object (Bullet)

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

suggestedBulletChanges

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

Le modifiche suggerite al punto elenco di questo paragrafo.

positionedObjectIds[]

string

Gli ID degli oggetti posizionati collegati a questo paragrafo.

suggestedPositionedObjectIds

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

Gli ID degli oggetti posizionati che si consiglia di associare a questo paragrafo, digitati dall'ID suggerimento.

ParagraphElement

Un elemento ParagraphElement descrive i contenuti all'interno di un Paragraph.

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

  // Union field content can be only one of the following:
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  },
  "pageBreak": {
    object (PageBreak)
  },
  "columnBreak": {
    object (ColumnBreak)
  },
  "footnoteReference": {
    object (FootnoteReference)
  },
  "horizontalRule": {
    object (HorizontalRule)
  },
  "equation": {
    object (Equation)
  },
  "inlineObjectElement": {
    object (InlineObjectElement)
  },
  "person": {
    object (Person)
  },
  "richLink": {
    object (RichLink)
  }
  // End of list of possible types for union field content.
}
Campi
startIndex

integer

L'indice iniziale basato su zero di questo elemento paragrafo, in unità di codice UTF-16.

endIndex

integer

L'indice di fine di questo elemento paragrafo con base zero, esclusivo, in unità di codice UTF-16.

Campo unione content. I contenuti dell'elemento paragrafo. content può essere solo uno dei seguenti:
textRun

object (TextRun)

Un elemento paragrafo di paragrafo di testo.

autoText

object (AutoText)

Un elemento di paragrafo di testo automatico.

pageBreak

object (PageBreak)

Un elemento di paragrafo di interruzione di pagina.

columnBreak

object (ColumnBreak)

Un elemento di paragrafo con interruzione di colonna.

footnoteReference

object (FootnoteReference)

Un elemento di paragrafo di riferimento a nota a piè di pagina.

horizontalRule

object (HorizontalRule)

Un elemento di paragrafo con righello orizzontale.

equation

object (Equation)

Un elemento di paragrafo equazione.

inlineObjectElement

object (InlineObjectElement)

Un elemento paragrafo di oggetto in linea.

person

object (Person)

Un elemento paragrafo che rimanda a una persona o a un indirizzo email.

TextRun

Un ParagraphElement che rappresenta una serie di testo che ha lo stesso stile.

Rappresentazione JSON
{
  "content": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Campi
content

string

Il testo di questa esecuzione.

Tutti gli elementi non testuali nell'esecuzione vengono sostituiti con il carattere Unicode U+E907.

suggestedInsertionIds[]

string

Gli ID di inserimento suggeriti. Un TextRun può avere più ID inserzione se si tratta di una modifica suggerita nidificata. Se è vuoto, non si tratta di un'inserzione suggerita.

suggestedDeletionIds[]

string

Gli ID eliminazione suggeriti. Se viene lasciato vuoto, non sono previste eliminazioni suggerite di questi contenuti.

textStyle

object (TextStyle)

Lo stile del testo di questa esecuzione.

suggestedTextStyleChanges

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

Lo stile di testo suggerito viene modificato in questa esecuzione, specificato dall'ID suggerimento.

TextStyle

Rappresenta lo stile che può essere applicato al testo.

Gli stili di testo ereditati sono rappresentati come campi non impostati in questo messaggio. L'elemento principale di uno stile di testo dipende da dove viene definito lo stile di testo:

  • Lo Stile di testo del testo in un Paragraph eredita dal valore named style type corrispondente del paragrafo.
  • Lo stile di testo su un named style eredita dallo stile con nome normal text.
  • Lo stile di testo dello stile denominato normal text eredita dallo stile di testo predefinito nell'editor di documenti.
  • Lo stile di testo di un elemento Paragraph contenuto in una tabella potrebbe ereditare lo stile di testo dallo stile della tabella.

Se lo stile di testo non viene ereditato da un elemento principale, se annulli l'impostazione dei campi, lo stile verrà ripristinato a un valore corrispondente ai valori predefiniti dell'editor di documenti.

Rappresentazione JSON
{
  "bold": boolean,
  "italic": boolean,
  "underline": boolean,
  "strikethrough": boolean,
  "smallCaps": boolean,
  "backgroundColor": {
    object (OptionalColor)
  },
  "foregroundColor": {
    object (OptionalColor)
  },
  "fontSize": {
    object (Dimension)
  },
  "weightedFontFamily": {
    object (WeightedFontFamily)
  },
  "baselineOffset": enum (BaselineOffset),
  "link": {
    object (Link)
  }
}
Campi
bold

boolean

Indica se il testo viene visualizzato o meno in grassetto.

italic

boolean

Indica se il testo è in corsivo.

underline

boolean

Se il testo è sottolineato o meno.

strikethrough

boolean

Indica se il testo è barrato o meno.

smallCaps

boolean

Indica se il testo è in minuscolo.

backgroundColor

object (OptionalColor)

Il colore di sfondo del testo. Se impostato, il colore è un colore RGB o trasparente, a seconda del campo color.

foregroundColor

object (OptionalColor)

Il colore in primo piano del testo. Se impostato, il colore è RGB o trasparente, a seconda del campo color.

fontSize

object (Dimension)

La dimensione del carattere del testo.

weightedFontFamily

object (WeightedFontFamily)

La famiglia di caratteri e lo spessore visualizzato del testo.

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

Se il criterio weightedFontFamily#weight non viene configurato, il valore predefinito è 400.

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

baselineOffset

enum (BaselineOffset)

Lo scostamento verticale del testo rispetto alla posizione normale.

Il testo con offset di riferimento SUPERSCRIPT o SUBSCRIPT viene visualizzato automaticamente con caratteri di dimensioni inferiori, calcolati in base al campo fontSize. Le modifiche in questo campo non influiscono su fontSize.

OptionalColor

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

Rappresentazione JSON
{
  "color": {
    object (Color)
  }
}
Campi
color

object (Color)

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

Colore

Un colore a tinta unita.

Rappresentazione JSON
{
  "rgbColor": {
    object (RgbColor)
  }
}
Campi
rgbColor

object (RgbColor)

Il valore del colore RGB.

RgbColor

Un colore RGB.

Rappresentazione JSON
{
  "red": number,
  "green": number,
  "blue": number
}
Campi
red

number

Il componente rosso del colore, compreso tra 0,0 e 1,0.

green

number

Il componente verde del colore, da 0,0 a 1,0.

blue

number

Il componente blu del colore, compreso tra 0,0 e 1,0.

Dimensione

Un'intensità in una singola direzione nelle unità specificate.

Rappresentazione JSON
{
  "magnitude": number,
  "unit": enum (Unit)
}
Campi
magnitude

number

La grandezza.

unit

enum (Unit)

Le unità di grandezza.

Unità

Unità di misura.

Enum
UNIT_UNSPECIFIED Le unità sono sconosciute.
PT Un punto, 1/72 di pollice.

WeightedFontFamily

Rappresenta una famiglia di caratteri e lo spessore del testo.

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

string

La famiglia di caratteri del testo.

La famiglia di caratteri può essere qualsiasi carattere disponibile nel menu Caratteri in Documenti o in Google Fonts. Se il nome del carattere non è riconosciuto, il testo viene visualizzato in Arial.

weight

integer

Lo spessore del carattere. Questo campo può avere qualsiasi valore che sia un multiplo di 100 compreso tra 100 e 900. Questo intervallo corrisponde ai valori numerici descritti nella sezione 15.6 della specifica CSS 2.1, con i valori non numerici non consentiti.

Il valore predefinito è 400 ("normale").

Lo spessore del carattere costituisce solo un componente dello spessore del carattere visualizzato. Una combinazione del valore bold risolto di weight e dello stile di testo determina la ponderazione visualizzata, dopo aver tenuto conto dell'ereditarietà:

  • Se il testo è in grassetto e lo spessore è inferiore a 400, lo spessore visualizzato è 400.
  • Se il testo è in grassetto e la ponderazione è maggiore o uguale a 400 ma è inferiore a 700, la ponderazione visualizzata è 700.
  • Se il peso è maggiore o uguale a 700, il peso visualizzato è uguale al peso.
  • Se il testo non è in grassetto, lo spessore visualizzato è uguale a quello impostato.

BaselineOffset

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

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

SuggestedTextStyle

Una modifica suggerita a un TextStyle.

Rappresentazione JSON
{
  "textStyle": {
    object (TextStyle)
  },
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}
Campi
textStyle

object (TextStyle)

Un elemento TextStyle che include solo le modifiche apportate in questo suggerimento. Questa opzione può essere utilizzata insieme a textStyleSuggestionState per vedere quali campi sono stati modificati e i relativi nuovi valori.

textStyleSuggestionState

object (TextStyleSuggestionState)

Una maschera che indica quali campi della base TextStyle sono stati modificati in questo suggerimento.

TextStyleSuggestionState

Una maschera che indica quali campi della 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

boolean

Indica se è stata suggerita una modifica a bold.

italicSuggested

boolean

Indica se è stata suggerita una modifica a italic.

underlineSuggested

boolean

Indica se è stata suggerita una modifica a underline.

strikethroughSuggested

boolean

Indica se è stata suggerita una modifica a strikethrough.

smallCapsSuggested

boolean

Indica se è stata suggerita una modifica a smallCaps.

backgroundColorSuggested

boolean

Indica se è stata suggerita una modifica a backgroundColor.

foregroundColorSuggested

boolean

Indica se è stata suggerita una modifica a foregroundColor.

fontSizeSuggested

boolean

Indica se è stata suggerita una modifica a fontSize.

weightedFontFamilySuggested

boolean

Indica se è stata suggerita una modifica a weightedFontFamily.

baselineOffsetSuggested

boolean

Indica se è stata suggerita una modifica a baselineOffset.

AutoText

Un ParagraphElement che rappresenta un punto nel testo che viene sostituito dinamicamente con contenuti che possono cambiare nel tempo, come un numero di pagina.

Rappresentazione JSON
{
  "type": enum (Type),
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Campi
type

enum (Type)

Il tipo di questo testo automatico.

suggestedInsertionIds[]

string

Gli ID di inserzione suggeriti. Un AutoText può avere più ID inserimento se si tratta di una modifica suggerita nidificata. Se è vuoto, non si tratta di un'inserzione suggerita.

suggestedDeletionIds[]

string

Gli ID eliminazione suggeriti. Se è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

textStyle

object (TextStyle)

Lo stile di testo di questo testo automatico.

suggestedTextStyleChanges

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

Lo stile di testo suggerito diventa questo testo automatico, con chiave in base all'ID suggerimento.

Tipo

I tipi di testo automatico.

Enum
TYPE_UNSPECIFIED Un tipo di testo automatico non specificato.
PAGE_NUMBER Tipo di testo automatico che rappresenta il numero di pagina corrente.
PAGE_COUNT Digita il testo automatico che rappresenta il numero totale di pagine del documento.

PageBreak

Un elemento 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 (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Campi
suggestedInsertionIds[]

string

Gli ID di inserzione suggeriti. Un PageBreak può avere più ID inserzione se si tratta di una modifica suggerita nidificata. Se vuoto, questo non è un inserimento suggerito.

suggestedDeletionIds[]

string

Gli ID eliminazione suggeriti. Se è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

textStyle

object (TextStyle)

Lo stile del testo di questa interruzione di pagina.

Analogamente ai contenuti di testo, come le righe di testo e i riferimenti alle note a piè di pagina, lo stile di testo di un a capo può influire sul layout dei contenuti e sullo stile del testo inserito accanto.

suggestedTextStyleChanges

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

Lo stile di testo suggerito viene modificato in questa interruzione di pagina, contrassegnata dall'ID suggerimento.

ColumnBreak

Un ParagraphElement che rappresenta un'interruzione di colonna. Un'interruzione di colonna fa iniziare il testo successivo dalla parte superiore della colonna successiva.

Rappresentazione JSON
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Campi
suggestedInsertionIds[]

string

Gli ID di inserzione suggeriti. Un ColumnBreak può avere più ID inserzione se si tratta di una modifica suggerita nidificata. Se vuoto, questo non è un inserimento suggerito.

suggestedDeletionIds[]

string

Gli ID eliminazione suggeriti. Se viene lasciato vuoto, non sono previste eliminazioni suggerite di questi contenuti.

textStyle

object (TextStyle)

Lo stile del testo di questa interruzione colonna.

Analogamente ai contenuti di testo, come le righe di testo e i riferimenti alle note a piè di pagina, lo stile di testo di un a capo può influire sul layout dei contenuti e sullo stile del testo inserito accanto.

suggestedTextStyleChanges

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

Lo stile di testo suggerito diventa questo a capo di colonna, con chiave ID suggerimento.

FootnoteReference

Un ParagraphElement che rappresenta un riferimento a una nota a piè di pagina. Un riferimento a 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 (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Campi
footnoteId

string

L'ID della risorsa footnote che include i contenuti di questo riferimento a nota a piè di pagina.

footnoteNumber

string

Il numero visualizzato per questa nota a piè di pagina.

suggestedInsertionIds[]

string

Gli ID di inserimento suggeriti. Un FootnoteReference può avere più ID inserzione se si tratta di una modifica suggerita nidificata. Se vuoto, questo non è un inserimento suggerito.

suggestedDeletionIds[]

string

Gli ID eliminazione suggeriti. Se è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

textStyle

object (TextStyle)

Lo stile di testo di questa FootnoteReference.

suggestedTextStyleChanges

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

Lo stile del testo suggerito viene modificato in questo Piè di pagina, specificato dall'ID suggerimento.

HorizontalRule

Un ParagraphElement che rappresenta una linea orizzontale.

Rappresentazione JSON
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Campi
suggestedInsertionIds[]

string

Gli ID di inserimento suggeriti. Un HorizontalRule può avere più ID di inserimento se si tratta di una modifica suggerita nidificata. Se è vuoto, non si tratta di un'inserzione suggerita.

suggestedDeletionIds[]

string

Gli ID eliminazione suggeriti. Se viene lasciato vuoto, non sono previste eliminazioni suggerite di questi contenuti.

textStyle

object (TextStyle)

Lo stile del testo di questa regola orizzontale.

In modo simile 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.

suggestedTextStyleChanges

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

Lo stile di testo suggerito viene modificato in questa regola orizzontale, digitata dall'ID suggerimento.

Equazione

Un ParagraphElement che rappresenta un'equazione.

Rappresentazione JSON
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}
Campi
suggestedInsertionIds[]

string

Gli ID di inserimento suggeriti. Un Equation può avere più ID inserimento se si tratta di una modifica suggerita nidificata. Se è vuoto, non si tratta di un'inserzione suggerita.

suggestedDeletionIds[]

string

Gli ID di eliminazione suggeriti. Se è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

InlineObjectElement

Un elemento ParagraphElement che contiene un elemento InlineObject.

Rappresentazione JSON
{
  "inlineObjectId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Campi
inlineObjectId

string

L'ID del InlineObject contenuto in questo elemento.

suggestedInsertionIds[]

string

Gli ID di inserzione suggeriti. Un InlineObjectElement può avere più ID inserzione se si tratta di una modifica suggerita nidificata. Se è vuoto, non si tratta di un'inserzione suggerita.

suggestedDeletionIds[]

string

Gli ID eliminazione suggeriti. Se viene lasciato vuoto, non sono previste eliminazioni suggerite di questi contenuti.

textStyle

object (TextStyle)

Lo stile di testo di questo elemento InlineObject.

In modo simile ai contenuti testuali, come esecuzioni di testo e riferimenti a note a piè di pagina, lo stile del testo di un elemento di oggetto incorporato può influire sul layout dei contenuti e sullo stile del testo inserito accanto.

suggestedTextStyleChanges

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

Lo stile di testo suggerito diventa questo InlineObject, con chiave 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 (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "personProperties": {
    object (PersonProperties)
  }
}
Campi
personId

string

Solo output. L'ID univoco di questo collegamento.

suggestedInsertionIds[]

string

ID per i suggerimenti che inseriscono il link di questa persona nel documento. Un Person potrebbe avere più ID inserimento se si tratta di una modifica suggerita nidificata (ad esempio, un suggerimento all'interno di un suggerimento apportato da un altro utente). Se è vuoto, il link a questa persona non è un inserimento suggerito.

suggestedDeletionIds[]

string

ID dei suggerimenti che rimuovono il link a questa persona dal documento. Un Person potrebbe avere più ID eliminazione se, ad esempio, più utenti ne suggeriscono l'eliminazione. Se è vuoto, il link a questa persona non viene suggerito per l'eliminazione.

textStyle

object (TextStyle)

Lo stile del testo di questo Person.

suggestedTextStyleChanges

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

Lo stile di testo suggerito viene modificato in questo Person, specificato dall'ID suggerimento.

personProperties

object (PersonProperties)

Solo output. Le proprietà di questo Person. Questo campo è sempre presente.

PersonProperties

Proprietà specifiche di un Person collegato.

Rappresentazione JSON
{
  "name": string,
  "email": string
}
Campi
name

string

Solo output. Il nome della persona, se è visualizzato nel testo del link anziché l'indirizzo email della persona.

email

string

Solo output. L'indirizzo email collegato a Person. Questo campo è sempre presente.

RichLinkProperties

Proprietà specifiche di un RichLink.

Rappresentazione JSON
{
  "title": string,
  "uri": string,
  "mimeType": string
}
Campi
title

string

Solo output. Il titolo di RichLink come visualizzato nel link. Questo titolo corrisponde a quello della risorsa collegata al momento dell'inserimento o dell'ultimo aggiornamento del link. Questo campo è sempre presente.

uri

string

Solo output. L'URI di RichLink. Questo valore è sempre presente.

mimeType

string

Solo output. Il tipo MIME di RichLink, se presente (ad esempio, quando è un file su Drive).

ParagraphStyle

Stili che si applicano a un intero paragrafo.

Gli stili di paragrafo ereditati sono rappresentati come campi non impostati in questo messaggio. Lo stile principale di uno stile di paragrafo dipende da dove è definito:

  • Il parametro ParagraphStyle su un Paragraph eredita dal valore named style type corrispondente del paragrafo.
  • Il parametro ParagraphStyle su un named style eredita dallo stile denominato normal text.
  • Lo stile ParagraphStyle dello stile denominato normal text eredita lo stile di paragrafo predefinito nell'editor di Documenti.
  • Lo stile di paragrafo di un elemento Paragraph contenuto in una tabella può ereditare lo stile di paragrafo dallo stile della tabella.

Se lo stile di paragrafo non viene ereditato da un elemento principale, se annulli l'impostazione dei campi, lo stile verrà ripristinato a un valore corrispondente ai valori predefiniti dell'editor di documenti.

Rappresentazione JSON
{
  "headingId": string,
  "namedStyleType": enum (NamedStyleType),
  "alignment": enum (Alignment),
  "lineSpacing": number,
  "direction": enum (ContentDirection),
  "spacingMode": enum (SpacingMode),
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "borderBetween": {
    object (ParagraphBorder)
  },
  "borderTop": {
    object (ParagraphBorder)
  },
  "borderBottom": {
    object (ParagraphBorder)
  },
  "borderLeft": {
    object (ParagraphBorder)
  },
  "borderRight": {
    object (ParagraphBorder)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "tabStops": [
    {
      object (TabStop)
    }
  ],
  "keepLinesTogether": boolean,
  "keepWithNext": boolean,
  "avoidWidowAndOrphan": boolean,
  "shading": {
    object (Shading)
  },
  "pageBreakBefore": boolean
}
Campi
headingId

string

L'ID intestazione del paragrafo. Se è vuoto, questo paragrafo non è un'intestazione.

Questa proprietà è di sola lettura.

namedStyleType

enum (NamedStyleType)

Il tipo di stile denominato del paragrafo.

Poiché l'aggiornamento del tipo di stile denominato influisce sulle altre proprietà di ParagraphStyle, il tipo di stile denominato viene applicato prima dell'aggiornamento delle altre proprietà.

alignment

enum (Alignment)

L'allineamento del testo di questo paragrafo.

lineSpacing

number

La quantità di spazio tra le linee, in percentuale rispetto al normale, dove il normale è rappresentato da 100,0. Se non è impostato, il valore viene ereditato dall'elemento principale.

direction

enum (ContentDirection)

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

spacingMode

enum (SpacingMode)

La modalità di spaziatura per il paragrafo.

spaceAbove

object (Dimension)

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

spaceBelow

object (Dimension)

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

borderBetween

object (ParagraphBorder)

Il bordo tra questo paragrafo e i paragrafi precedenti e successivi. Se non viene configurato, il valore viene ereditato dall'unità organizzativa principale.

Il bordo intermedio viene visualizzato quando il paragrafo adiacente ha le stesse proprietà di bordo e rientro.

Impossibile aggiornare parzialmente i bordi del paragrafo. Quando modifichi il bordo di un paragrafo, è necessario specificare il nuovo bordo.

borderTop

object (ParagraphBorder)

Il bordo nella parte superiore di questo paragrafo. Se non viene configurato, il valore viene ereditato dall'unità organizzativa principale.

Il bordo superiore viene visualizzato quando il paragrafo precedente ha proprietà di bordo e rientro diverse.

I bordi dei paragrafi non possono essere aggiornati parzialmente. Quando modifichi il bordo di un paragrafo, il nuovo bordo deve essere specificato nella sua interezza.

borderBottom

object (ParagraphBorder)

Il bordo in fondo a questo paragrafo. Se non viene configurato, il valore viene ereditato dall'unità organizzativa principale.

Il bordo inferiore viene visualizzato quando il paragrafo sottostante ha proprietà di bordo e rientro diverse.

I bordi dei paragrafi non possono essere aggiornati parzialmente. Quando modifichi il bordo di un paragrafo, il nuovo bordo deve essere specificato nella sua interezza.

borderLeft

object (ParagraphBorder)

Il bordo a sinistra di questo paragrafo. Se non viene configurato, il valore viene ereditato dall'unità organizzativa principale.

I bordi dei paragrafi non possono essere aggiornati parzialmente. Quando modifichi il bordo di un paragrafo, il nuovo bordo deve essere specificato nella sua interezza.

borderRight

object (ParagraphBorder)

Il bordo a destra di questo paragrafo. Se non viene configurato, il valore viene ereditato dall'unità organizzativa principale.

I bordi dei paragrafi non possono essere aggiornati parzialmente. Quando modifichi il bordo di un paragrafo, è necessario specificare il nuovo bordo.

indentFirstLine

object (Dimension)

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

indentStart

object (Dimension)

La quantità di rientro del paragrafo sul lato corrispondente all'inizio del testo, in base alla direzione del paragrafo corrente. Se non è impostato, il valore viene ereditato dall'elemento principale.

indentEnd

object (Dimension)

La quantità di rientro del paragrafo sul lato che corrisponde alla fine del testo, in base all'attuale direzione del paragrafo. Se non viene configurato, il valore viene ereditato dall'unità organizzativa principale.

tabStops[]

object (TabStop)

Un elenco delle tabulazioni per questo paragrafo. L'elenco delle tabulazioni non viene ereditato.

Questa proprietà è di sola lettura.

keepLinesTogether

boolean

Indica se tutte le righe del paragrafo devono essere disposte sulla stessa pagina o colonna, se possibile. Se non è impostato, il valore viene ereditato dall'elemento principale.

keepWithNext

boolean

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'unità organizzativa principale.

avoidWidowAndOrphan

boolean

Se evitare le vedove e gli orfani per il paragrafo. Se non viene configurato, il valore viene ereditato dall'unità organizzativa principale.

shading

object (Shading)

L'ombreggiatura del paragrafo. Se non è impostato, il valore viene ereditato dall'elemento principale.

pageBreakBefore

boolean

Indica se il paragrafo corrente deve iniziare sempre all'inizio di una pagina. Se non è impostato, il valore viene ereditato dall'elemento principale.

Il tentativo di aggiornare pageBreakBefore per i paragrafi in regioni non supportate, tra cui Table, Header, Footer e Footnote, può comportare uno stato del documento non valido che restituisce un errore di richiesta non valida (400).

NamedStyleType

I tipi di stili denominati.

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 da quello principale.
START Il paragrafo è allineato all'inizio della riga. Allineato a sinistra per il testo LTR, altrimenti allineato a destra.
CENTER Il paragrafo è centrato.
END Il paragrafo è allineato alla fine della riga. Allineato a destra per il testo LTR, allineamento a sinistra negli altri casi.
JUSTIFIED Il paragrafo è giustificato.

ContentDirection

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.

SpacingMode

Le diverse modalità per la spaziatura dei paragrafi.

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

ParagraphBorder

Un bordo attorno a un paragrafo.

Rappresentazione JSON
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "padding": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}
Campi
color

object (OptionalColor)

Il colore del bordo.

width

object (Dimension)

La larghezza del bordo.

padding

object (Dimension)

La spaziatura interna del bordo.

dashStyle

enum (DashStyle)

Lo stile del tratto del bordo.

DashStyle

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 di "Office Open XML File Formats - Fundamentals and Markup Language Reference", parte 1 di ECMA-376 4th edition.

Enum
DASH_STYLE_UNSPECIFIED Stile dei trattini non specificato.
SOLID Linea continua. Corrisponde al valore "solid" di ECMA-376 ST_PresetLineDashVal. Questo è lo stile di trattini predefinito.
DOT Linea tratteggiata. Corrisponde al valore "dot" di ECMA-376 ST_PresetLineDashVal.
DASH Linea tratteggiata. Corrisponde al valore "dash" di ECMA-376 ST_PresetLineDashVal.

TabStop

Una tabulazione all'interno di un paragrafo.

Rappresentazione JSON
{
  "offset": {
    object (Dimension)
  },
  "alignment": enum (TabStopAlignment)
}
Campi
offset

object (Dimension)

L'offset tra questa tabulazione e il margine iniziale.

alignment

enum (TabStopAlignment)

L'allineamento di questo a capo. Se non viene impostato, il valore predefinito è START.

TabStopAlignment

L'allineamento della tabulazione.

Enum
TAB_STOP_ALIGNMENT_UNSPECIFIED L'allineamento della tabulazione non è specificato.
START L'interruzione di tabulazione è allineata all'inizio della riga. Questa è l'impostazione predefinita.
CENTER La tabulazione è allineata al centro della riga.
END La tabulazione è allineata alla fine della riga.

Ombreggiatura

L'ombreggiatura di un paragrafo.

Rappresentazione JSON
{
  "backgroundColor": {
    object (OptionalColor)
  }
}
Campi
backgroundColor

object (OptionalColor)

Il colore di sfondo dell'ombreggiatura del paragrafo.

SuggestedParagraphStyle

Una modifica suggerita a un ParagraphStyle.

Rappresentazione JSON
{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}
Campi
paragraphStyle

object (ParagraphStyle)

Un elemento ParagraphStyle che include solo le modifiche apportate in questo suggerimento. Questa opzione può essere utilizzata insieme a paragraphStyleSuggestionState per vedere quali campi sono stati modificati e i relativi nuovi valori.

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

Una maschera che indica quali campi nella base ParagraphStyle sono stati modificati in questo suggerimento.

ParagraphStyleSuggestionState

Una maschera che indica quali campi della 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 (ShadingSuggestionState)
  },
  "pageBreakBeforeSuggested": boolean
}
Campi
headingIdSuggested

boolean

Indica se è stata suggerita una modifica a headingId.

namedStyleTypeSuggested

boolean

Indica se è stata suggerita una modifica a namedStyleType.

alignmentSuggested

boolean

Indica se è stata suggerita una modifica a alignment.

lineSpacingSuggested

boolean

Indica se è stata suggerita una modifica a lineSpacing.

directionSuggested

boolean

Indica se è stata suggerita una modifica a direction.

spacingModeSuggested

boolean

Indica se è stata suggerita una modifica a spacingMode.

spaceAboveSuggested

boolean

Indica se è stata suggerita una modifica a spaceAbove.

spaceBelowSuggested

boolean

Indica se è stata suggerita una modifica a spaceBelow.

borderBetweenSuggested

boolean

Indica se è stata suggerita una modifica a borderBetween.

borderTopSuggested

boolean

Indica se è stata suggerita una modifica a borderTop.

borderBottomSuggested

boolean

Indica se è stata suggerita una modifica a borderBottom.

borderLeftSuggested

boolean

Indica se è stata suggerita una modifica a borderLeft.

borderRightSuggested

boolean

Indica se è stata suggerita una modifica a borderRight.

indentFirstLineSuggested

boolean

Indica se è stata suggerita una modifica a indentFirstLine.

indentStartSuggested

boolean

Indica se è stata suggerita una modifica a indentStart.

indentEndSuggested

boolean

Indica se è stata suggerita una modifica a indentEnd.

keepLinesTogetherSuggested

boolean

Indica se è stata suggerita una modifica a keepLinesTogether.

keepWithNextSuggested

boolean

Indica se è stata suggerita una modifica a keepWithNext.

avoidWidowAndOrphanSuggested

boolean

Indica se è stata suggerita una modifica a avoidWidowAndOrphan.

shadingSuggestionState

object (ShadingSuggestionState)

Una maschera che indica quali campi in shading sono stati modificati in questo suggerimento.

pageBreakBeforeSuggested

boolean

Indica se è stata suggerita una modifica a pageBreakBefore.

ShadingSuggestionState

Una maschera che indica quali campi nella tabella Shading di base sono stati modificati in questa modifica suggerita. Per ogni campo impostato su true, è disponibile un nuovo valore suggerito.

Rappresentazione JSON
{
  "backgroundColorSuggested": boolean
}
Campi
backgroundColorSuggested

boolean

Indica se è stata suggerita una modifica a Shading.

Punto elenco

Descrive l'elenco puntato di un paragrafo.

Rappresentazione JSON
{
  "listId": string,
  "nestingLevel": integer,
  "textStyle": {
    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.

textStyle

object (TextStyle)

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

SuggestedBullet

Una modifica suggerita a un Bullet.

Rappresentazione JSON
{
  "bullet": {
    object (Bullet)
  },
  "bulletSuggestionState": {
    object (BulletSuggestionState)
  }
}
Campi
bullet

object (Bullet)

Un Bullet che include solo le modifiche apportate in questo suggerimento. Questo comando può essere utilizzato insieme a bulletSuggestionState per vedere quali campi sono stati modificati e i relativi nuovi valori.

bulletSuggestionState

object (BulletSuggestionState)

Una maschera che indica quali campi della base Bullet sono stati modificati in questo suggerimento.

BulletSuggestionState

Una maschera che indica quali campi nella 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 (TextStyleSuggestionState)
  }
}
Campi
listIdSuggested

boolean

Indica se è stata suggerita una modifica a listId.

nestingLevelSuggested

boolean

Indica se è stata suggerita una modifica al nestingLevel.

textStyleSuggestionState

object (TextStyleSuggestionState)

Una maschera che indica quali campi in text style sono stati modificati in questo suggerimento.

ObjectReferences

Una raccolta di ID oggetto.

Rappresentazione JSON
{
  "objectIds": [
    string
  ]
}
Campi
objectIds[]

string

Gli ID oggetto.

SectionBreak

Un StructuralElement che rappresenta un'interruzione di sezione. Una sezione è un intervallo di contenuti che hanno gli stessi SectionStyle. Un'interruzione di sezione rappresenta l'inizio di una nuova sezione e lo stile viene applicato alla sezione successiva all'interruzione.

Il corpo del documento inizia sempre con un a capo di sezione.

Rappresentazione JSON
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "sectionStyle": {
    object (SectionStyle)
  }
}
Campi
suggestedInsertionIds[]

string

Gli ID di inserzione suggeriti. Un SectionBreak può avere più ID inserimento se si tratta di una modifica suggerita nidificata. Se è vuoto, non si tratta di un'inserzione suggerita.

suggestedDeletionIds[]

string

Gli ID eliminazione suggeriti. Se viene lasciato vuoto, non sono previste eliminazioni suggerite di questi contenuti.

sectionStyle

object (SectionStyle)

Lo stile della sezione dopo questo a capo.

SectionStyle

Lo stile applicato a una sezione.

Rappresentazione JSON
{
  "columnProperties": [
    {
      object (SectionColumnProperties)
    }
  ],
  "columnSeparatorStyle": enum (ColumnSeparatorStyle),
  "contentDirection": enum (ContentDirection),
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "sectionType": enum (SectionType),
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "flipPageOrientation": boolean
}
Campi
columnProperties[]

object (SectionColumnProperties)

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 da avere al massimo tre colonne.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se questa proprietà non viene impostata, verrà generato un errore di richiesta non valida (400).

columnSeparatorStyle

enum (ColumnSeparatorStyle)

Lo stile dei separatori di colonna.

Questo stile può essere impostato anche se la sezione contiene una sola colonna.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se questa proprietà non viene impostata, viene generato un errore di richiesta non valida (400).

contentDirection

enum (ContentDirection)

L'orientamento dei contenuti di questa sezione. Se non viene impostato, il valore predefinito è LEFT_TO_RIGHT.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se questa proprietà non viene impostata, viene generato un errore di richiesta non valida (400).

marginTop

object (Dimension)

Il margine superiore della pagina della sezione. Se non viene impostato, il valore predefinito è marginTop di DocumentStyle.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli questa proprietà, viene generato un errore di richiesta non valido 400.

marginBottom

object (Dimension)

Il margine inferiore della pagina della sezione. Se non viene impostato, il valore predefinito è marginBottom di DocumentStyle.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli questa proprietà, viene generato un errore di richiesta non valido 400.

marginRight

object (Dimension)

Il margine destro della pagina della sezione. Se non viene impostato, il valore predefinito è marginRight di DocumentStyle. L'aggiornamento del margine destro comporta il ridimensionamento delle colonne in questa sezione. Poiché il margine influisce sulla larghezza della colonna, viene applicato prima delle proprietà della colonna.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli questa proprietà, viene generato un errore di richiesta non valido 400.

marginLeft

object (Dimension)

Il margine sinistro della sezione. Se non viene configurato, il valore predefinito è marginLeft in DocumentStyle. L'aggiornamento del margine sinistro comporta il ridimensionamento delle colonne di questa sezione. Poiché il margine influisce sulla larghezza della colonna, viene applicato prima delle proprietà della colonna.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se questa proprietà non viene impostata, viene generato un errore di richiesta non valida (400).

marginHeader

object (Dimension)

Il margine dell'intestazione della sezione. Se non viene configurato, il valore predefinito è marginHeader in DocumentStyle. Se viene aggiornata, il valore useCustomHeaderFooterMargins è impostato su true in DocumentStyle. Il valore di useCustomHeaderFooterMargins in DocumentStyle indica se per questa sezione viene rispettato un margine di intestazione.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se questa proprietà non viene impostata, viene generato un errore di richiesta non valida (400).

sectionType

enum (SectionType)

Solo output. Il tipo di sezione.

defaultHeaderId

string

L'ID dell'intestazione predefinita. Se non viene configurato, il valore eredita dal precedente elemento SectionStyle SectionBreak's. Se il valore non viene impostato nella prima Interruzione di sezione, viene ereditato dall'elemento defaultHeaderId di DocumentStyle.

Questa proprietà è di sola lettura.

firstPageHeaderId

string

L'ID dell'intestazione utilizzato solo per la prima pagina della sezione. Se useFirstPageHeaderFooter è true, questo valore viene utilizzato per l'intestazione nella prima pagina della sezione. Se è falso, l'intestazione della prima pagina della sezione utilizza defaultHeaderId. Se non viene impostato, il valore viene ereditato dal valore SectionBreak's SectionStyle precedente. Se il valore non è impostato nella prima interruzione di sezione, viene ereditato da firstPageHeaderId di DocumentStyle.

Questa proprietà è di sola lettura.

evenPageHeaderId

string

L'ID dell'intestazione utilizzato solo per le pagine pari. Se il valore di useEvenPageHeaderFooter di DocumentStyle è true, questo valore viene utilizzato per le intestazioni nelle pagine pari della sezione. Se è false, le intestazioni nelle pagine pari utilizzano defaultHeaderId. Se non viene impostato, il valore viene ereditato dal valore SectionBreak's SectionStyle precedente. Se il valore non è impostato nella prima interruzione di sezione, viene ereditato da evenPageHeaderId di DocumentStyle.

Questa proprietà è di sola lettura.

pageNumberStart

integer

Il numero di pagina da cui iniziare a conteggiare il numero di pagine per questa sezione. Se non è impostato, la numerazione delle pagine continua dalla sezione precedente. Se il valore non è impostato nel primo SectionBreak, fai riferimento a pageNumberStart di DocumentStyle.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli questa proprietà, viene generato un errore di richiesta non valido 400.

flipPageOrientation

boolean

(Facoltativo) Indica se capovolgere le dimensioni di pageSize di DocumentStyle per questa sezione, il che consente di cambiare l'orientamento della pagina tra verticale e orizzontale. Se non viene configurato, il valore eredita dall'elemento flipPageOrientation di DocumentStyle.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli questa proprietà, viene generato un errore di richiesta non valido 400.

SectionColumnProperties

Proprietà che si applicano alla colonna di una sezione.

Rappresentazione JSON
{
  "width": {
    object (Dimension)
  },
  "paddingEnd": {
    object (Dimension)
  }
}
Campi
width

object (Dimension)

Solo output. La larghezza della colonna.

paddingEnd

object (Dimension)

La spaziatura interna alla fine della colonna.

ColumnSeparatorStyle

Lo stile dei separatori di colonna tra le colonne.

Enum
COLUMN_SEPARATOR_STYLE_UNSPECIFIED Uno stile di separatore di colonna non specificato.
NONE Nessuna riga di separazione tra le colonne.
BETWEEN_EACH_COLUMN Mostra una linea di separazione tra ogni colonna.

SectionType

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 subito 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 (TableRow)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableStyle": {
    object (TableStyle)
  }
}
Campi
rows

integer

Numero di righe nella tabella.

columns

integer

Numero di colonne nella tabella.

Poiché una tabella non è rettangolare, alcune righe possono avere un numero diverso di celle.

tableRows[]

object (TableRow)

I contenuti e lo stile di ogni riga.

suggestedInsertionIds[]

string

Gli ID di inserimento suggeriti. Un Table può avere più ID inserimento se si tratta di una modifica suggerita nidificata. Se vuoto, questo non è un inserimento suggerito.

suggestedDeletionIds[]

string

Gli ID eliminazione suggeriti. Se è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

tableStyle

object (TableStyle)

Lo stile della tabella.

TableRow

I contenuti e lo stile di una riga in un Table.

Rappresentazione JSON
{
  "startIndex": integer,
  "endIndex": integer,
  "tableCells": [
    {
      object (TableCell)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "suggestedTableRowStyleChanges": {
    string: {
      object (SuggestedTableRowStyle)
    },
    ...
  }
}
Campi
startIndex

integer

L'indice iniziale in base zero di questa riga, in unità di codice UTF-16.

endIndex

integer

L'indice di fine di questa riga, esclusivo, basato su zero in unità di codice UTF-16.

tableCells[]

object (TableCell)

Contenuti e stile di ogni cella di questa riga.

Una tabella può non essere rettangolare, quindi alcune righe potrebbero avere un numero di celle diverso rispetto alle altre righe della stessa tabella.

suggestedInsertionIds[]

string

Gli ID di inserimento suggeriti. Un TableRow può avere più ID inserimento se si tratta di una modifica suggerita nidificata. Se è vuoto, non si tratta di un'inserzione suggerita.

suggestedDeletionIds[]

string

Gli ID di eliminazione suggeriti. Se è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

tableRowStyle

object (TableRowStyle)

Lo stile della riga della tabella.

suggestedTableRowStyleChanges

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

Lo stile suggerito viene modificato in questa riga, in base all'ID suggerimento.

TableCell

I contenuti e lo stile di una cella in un Table.

Rappresentazione JSON
{
  "startIndex": integer,
  "endIndex": integer,
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "suggestedTableCellStyleChanges": {
    string: {
      object (SuggestedTableCellStyle)
    },
    ...
  }
}
Campi
startIndex

integer

L'indice iniziale in base zero di questa cella, in unità di codice UTF-16.

endIndex

integer

L'indice finale in base zero di questa cella, escluso, nelle unità di codice UTF-16.

content[]

object (StructuralElement)

I contenuti della cella.

tableCellStyle

object (TableCellStyle)

Lo stile della cella.

suggestedInsertionIds[]

string

Gli ID di inserzione suggeriti. Un TableCell può avere più ID inserimento se si tratta di una modifica suggerita nidificata. Se vuoto, questo non è un inserimento suggerito.

suggestedDeletionIds[]

string

Gli ID eliminazione suggeriti. Se è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

suggestedTableCellStyleChanges

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

Le modifiche suggerite allo stile della cella della tabella, con chiave in base all'ID suggerimento.

TableCellStyle

Lo stile di un TableCell.

Gli stili delle celle della tabella ereditati sono rappresentati come campi non impostati in questo messaggio. Uno stile di cella della tabella può ereditare dallo stile della tabella.

Rappresentazione JSON
{
  "rowSpan": integer,
  "columnSpan": integer,
  "backgroundColor": {
    object (OptionalColor)
  },
  "borderLeft": {
    object (TableCellBorder)
  },
  "borderRight": {
    object (TableCellBorder)
  },
  "borderTop": {
    object (TableCellBorder)
  },
  "borderBottom": {
    object (TableCellBorder)
  },
  "paddingLeft": {
    object (Dimension)
  },
  "paddingRight": {
    object (Dimension)
  },
  "paddingTop": {
    object (Dimension)
  },
  "paddingBottom": {
    object (Dimension)
  },
  "contentAlignment": enum (ContentAlignment)
}
Campi
rowSpan

integer

L'intervallo di righe della cella.

Questa proprietà è di sola lettura.

columnSpan

integer

L'intervallo di colonne della cella.

Questa proprietà è di sola lettura.

backgroundColor

object (OptionalColor)

Il colore di sfondo della cella.

borderLeft

object (TableCellBorder)

Il bordo sinistro della cella.

borderRight

object (TableCellBorder)

Il bordo destro della cella.

borderTop

object (TableCellBorder)

Bordo superiore della cella.

borderBottom

object (TableCellBorder)

Bordo inferiore della cella.

paddingLeft

object (Dimension)

La spaziatura interna a sinistra della cella.

paddingRight

object (Dimension)

La spaziatura interna destra della cella.

paddingTop

object (Dimension)

Spaziatura interna superiore della cella.

paddingBottom

object (Dimension)

La spaziatura interna inferiore della cella.

contentAlignment

enum (ContentAlignment)

L'allineamento dei contenuti nella cella della tabella. L'allineamento predefinito corrisponde a quello delle celle di tabelle appena create nell'editor di Documenti.

TableCellBorder

Un bordo intorno a una cella di tabella.

I bordi delle celle della tabella non possono essere trasparenti. Per nascondere il bordo di una cella della tabella, imposta la larghezza su 0.

Rappresentazione JSON
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}
Campi
color

object (OptionalColor)

Il colore del bordo.

Questo colore non può essere trasparente.

width

object (Dimension)

La larghezza del bordo.

dashStyle

enum (DashStyle)

Lo stile del trattino del bordo.

ContentAlignment

I tipi di allineamento dei contenuti.

Ricavato da un sottoinsieme dei valori di "ST_TextAnchoringType" tipo semplice nella sezione 20.1.10.59 di "Office Open XML FileFormats - Fundamentals and Markup Language Reference", parte 1 di ECMA-376 4th edition.

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 contenitore 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".

SuggestedTableCellStyle

Una modifica suggerita a un TableCellStyle.

Rappresentazione JSON
{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "tableCellStyleSuggestionState": {
    object (TableCellStyleSuggestionState)
  }
}
Campi
tableCellStyle

object (TableCellStyle)

Un elemento TableCellStyle che include solo le modifiche apportate in questo suggerimento. Questo comando può essere utilizzato insieme a tableCellStyleSuggestionState per vedere quali campi sono stati modificati e i relativi nuovi valori.

tableCellStyleSuggestionState

object (TableCellStyleSuggestionState)

Una maschera che indica quali campi della base TableCellStyle sono stati modificati in questo suggerimento.

TableCellStyleSuggestionState

Una maschera che indica quali campi della 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

boolean

Indica se è stata suggerita una modifica a rowSpan.

columnSpanSuggested

boolean

Indica se è stata suggerita una modifica a columnSpan.

backgroundColorSuggested

boolean

Indica se è stata suggerita una modifica a backgroundColor.

borderLeftSuggested

boolean

Indica se è stata suggerita una modifica a borderLeft.

borderRightSuggested

boolean

Indica se è stata suggerita una modifica a borderRight.

borderTopSuggested

boolean

Indica se è stata suggerita una modifica a borderTop.

borderBottomSuggested

boolean

Indica se è stata suggerita una modifica a borderBottom.

paddingLeftSuggested

boolean

Indica se è stata suggerita una modifica a paddingLeft.

paddingRightSuggested

boolean

Indica se è stata suggerita una modifica a paddingRight.

paddingTopSuggested

boolean

Indica se è stata suggerita una modifica a paddingTop.

paddingBottomSuggested

boolean

Indica se è stata suggerita una modifica a paddingBottom.

contentAlignmentSuggested

boolean

Indica se è stata suggerita una modifica a contentAlignment.

TableRowStyle

Stili che si applicano a una riga della tabella.

Rappresentazione JSON
{
  "minRowHeight": {
    object (Dimension)
  },
  "tableHeader": boolean,
  "preventOverflow": boolean
}
Campi
minRowHeight

object (Dimension)

L'altezza minima della riga. La riga verrà visualizzata nell'editor di Documenti a un'altezza uguale o superiore a questo valore per mostrare tutti i contenuti delle celle della riga.

tableHeader

boolean

Indica se la riga è l'intestazione di una tabella.

preventOverflow

boolean

Indica se la riga non può superare i limiti della pagina o delle colonne.

SuggestedTableRowStyle

Una modifica suggerita a un TableRowStyle.

Rappresentazione JSON
{
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "tableRowStyleSuggestionState": {
    object (TableRowStyleSuggestionState)
  }
}
Campi
tableRowStyle

object (TableRowStyle)

Un TableRowStyle che include solo le modifiche apportate in questo suggerimento. Questo comando può essere utilizzato insieme a tableRowStyleSuggestionState per vedere quali campi sono stati modificati e i relativi nuovi valori.

tableRowStyleSuggestionState

object (TableRowStyleSuggestionState)

Una maschera che indica quali campi della base TableRowStyle sono stati modificati in questo suggerimento.

TableRowStyleSuggestionState

Una maschera che indica quali campi nella 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

boolean

Indica se è stata suggerita una modifica a minRowHeight.

TableStyle

Stili applicabili a una tabella.

Rappresentazione JSON
{
  "tableColumnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
Campi
tableColumnProperties[]

object (TableColumnProperties)

Le proprietà di ogni colonna.

Tieni presente che in Documenti le tabelle contengono righe e le righe contengono celle, in modo simile all'HTML. Pertanto, le proprietà di una riga sono disponibili in tableRowStyle della riga.

TableColumnProperties

Le proprietà di una colonna in una tabella.

Rappresentazione JSON
{
  "widthType": enum (WidthType),
  "width": {
    object (Dimension)
  }
}
Campi
widthType

enum (WidthType)

Il tipo di larghezza della colonna.

width

object (Dimension)

La larghezza della colonna. Imposta quando widthType della colonna è FIXED_WIDTH.

WidthType

Il tipo di larghezza della colonna.

Enum
WIDTH_TYPE_UNSPECIFIED Il tipo di larghezza della colonna non è specificato.
EVENLY_DISTRIBUTED

La larghezza della colonna è distribuita uniformemente tra le altre colonne distribuite uniformemente.

La larghezza della colonna viene determinata automaticamente e avrà una porzione uguale della larghezza rimanente per la tabella dopo aver considerato tutte le colonne con larghezze specificate.

FIXED_WIDTH Una larghezza colonna fissa. La proprietà [width][google.apps.docs.v1.TableColumnProperties.width] contiene la larghezza della colonna.

TableOfContents

Un StructuralElement che rappresenta un sommario.

Rappresentazione JSON
{
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}
Campi
content[]

object (StructuralElement)

I contenuti del sommario.

suggestedInsertionIds[]

string

Gli ID di inserzione suggeriti. Un TableOfContents può avere più ID inserzione se si tratta di una modifica suggerita nidificata. Se è vuoto, non si tratta di un'inserzione suggerita.

suggestedDeletionIds[]

string

Gli ID eliminazione suggeriti. Se viene lasciato vuoto, non sono previste eliminazioni suggerite di questi contenuti.

Piè di pagina

Una nota a piè di pagina di un documento.

Rappresentazione JSON
{
  "footnoteId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}
Campi
footnoteId

string

L'ID della nota a piè di pagina.

content[]

object (StructuralElement)

I contenuti della nota a piè di pagina.

Gli indici dei contenuti di una nota a piè di pagina iniziano da zero.

DocumentStyle

Lo stile del documento.

Rappresentazione JSON
{
  "background": {
    object (Background)
  },
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "useEvenPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "pageSize": {
    object (Size)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "useCustomHeaderFooterMargins": boolean,
  "flipPageOrientation": boolean
}
Campi
background

object (Background)

Lo sfondo del documento. I documenti non possono avere un colore di sfondo trasparente.

defaultHeaderId

string

L'ID dell'intestazione predefinita. Se non viene impostato, non è presente un'intestazione predefinita.

Questa proprietà è di sola lettura.

evenPageHeaderId

string

L'ID dell'intestazione utilizzata solo per le pagine pari. Il valore useEvenPageHeaderFooter determina se utilizzare defaultHeaderId o questo valore per l'intestazione nelle pagine pari. Se non è impostato, non è presente l'intestazione della pagina pari.

Questa proprietà è di sola lettura.

firstPageHeaderId

string

L'ID dell'intestazione utilizzato solo per la prima pagina. Se il criterio non viene configurato, non esiste un'intestazione univoca per la prima pagina. Il valore di useFirstPageHeaderFooter determina se utilizzare defaultHeaderId o questo valore per l'intestazione della prima pagina. Se non viene configurato, non viene visualizzata l'intestazione della prima pagina.

Questa proprietà è di sola lettura.

pageNumberStart

integer

Il numero di pagina da cui iniziare a conteggiare il numero di pagine.

marginTop

object (Dimension)

Il margine superiore della pagina.

L'aggiornamento del margine superiore pagina nello stile del documento consente di cancellare il margine superiore della pagina in tutti gli stili di sezione.

marginBottom

object (Dimension)

Margine inferiore della pagina.

L'aggiornamento del margine inferiore della pagina nello stile del documento comporta la cancellazione di quello in tutti gli stili di sezione.

marginRight

object (Dimension)

Il margine della pagina destro.

L'aggiornamento del margine destro della pagina nello stile del documento ne cancella il valore in tutti gli stili di sezione. Inoltre, le colonne potrebbero essere ridimensionate in tutte le sezioni.

marginLeft

object (Dimension)

Il margine sinistro della pagina.

L'aggiornamento del margine sinistro della pagina nello stile del documento ne cancella il valore in tutti gli stili di sezione. Inoltre, potrebbe causare il ridimensionamento delle colonne in tutte le sezioni.

pageSize

object (Size)

Le dimensioni di una pagina nel documento.

marginHeader

object (Dimension)

La quantità di spazio tra la parte superiore della pagina e i contenuti dell'intestazione.

flipPageOrientation

boolean

(Facoltativo) Indica se invertire le dimensioni dell'elemento pageSize per modificare l'orientamento della pagina tra verticale e orizzontale.

Sfondo

Rappresenta lo sfondo di un documento.

Rappresentazione JSON
{
  "color": {
    object (OptionalColor)
  }
}
Campi
color

object (OptionalColor)

Il colore di sfondo.

Dimensioni

Una larghezza e un'altezza.

Rappresentazione JSON
{
  "height": {
    object (Dimension)
  },
  "width": {
    object (Dimension)
  }
}
Campi
height

object (Dimension)

L'altezza dell'oggetto.

width

object (Dimension)

La larghezza dell'oggetto.

SuggestedDocumentStyle

Una modifica suggerita al DocumentStyle.

Rappresentazione JSON
{
  "documentStyle": {
    object (DocumentStyle)
  },
  "documentStyleSuggestionState": {
    object (DocumentStyleSuggestionState)
  }
}
Campi
documentStyle

object (DocumentStyle)

Un DocumentStyle che include solo le modifiche apportate in questo suggerimento. Questa opzione può essere utilizzata insieme a documentStyleSuggestionState per vedere quali campi sono stati modificati e i relativi nuovi valori.

documentStyleSuggestionState

object (DocumentStyleSuggestionState)

Una maschera che indica quali campi della base DocumentStyle sono stati modificati in questo suggerimento.

DocumentStyleSuggestionState

Una maschera che indica quali campi nella base DocumentStyle sono stati modificati in questo suggerimento. Per ogni campo impostato su true, viene suggerito un nuovo valore.

Rappresentazione JSON
{
  "backgroundSuggestionState": {
    object (BackgroundSuggestionState)
  },
  "defaultHeaderIdSuggested": boolean,
  "defaultFooterIdSuggested": boolean,
  "evenPageHeaderIdSuggested": boolean,
  "evenPageFooterIdSuggested": boolean,
  "firstPageHeaderIdSuggested": boolean,
  "firstPageFooterIdSuggested": boolean,
  "useFirstPageHeaderFooterSuggested": boolean,
  "useEvenPageHeaderFooterSuggested": boolean,
  "pageNumberStartSuggested": boolean,
  "marginTopSuggested": boolean,
  "marginBottomSuggested": boolean,
  "marginRightSuggested": boolean,
  "marginLeftSuggested": boolean,
  "pageSizeSuggestionState": {
    object (SizeSuggestionState)
  },
  "marginHeaderSuggested": boolean,
  "marginFooterSuggested": boolean,
  "useCustomHeaderFooterMarginsSuggested": boolean,
  "flipPageOrientationSuggested": boolean
}
Campi
backgroundSuggestionState

object (BackgroundSuggestionState)

Una maschera che indica quali campi di background sono stati modificati in questo suggerimento.

defaultHeaderIdSuggested

boolean

Indica se è stata suggerita una modifica a defaultHeaderId.

evenPageHeaderIdSuggested

boolean

Indica se è stata suggerita una modifica a evenPageHeaderId.

firstPageHeaderIdSuggested

boolean

Indica se è stata suggerita una modifica a firstPageHeaderId.

pageNumberStartSuggested

boolean

Indica se è stata suggerita una modifica a pageNumberStart.

marginTopSuggested

boolean

Indica se è stata suggerita una modifica a marginTop.

marginBottomSuggested

boolean

Indica se è stata suggerita una modifica a marginBottom.

marginRightSuggested

boolean

Indica se è stata suggerita una modifica a marginRight.

marginLeftSuggested

boolean

Indica se è stata suggerita una modifica a marginLeft.

pageSizeSuggestionState

object (SizeSuggestionState)

Una maschera che indica quali campi in [size] [google.apps.docs.v1.DocumentStyle.size] sono state modificate in questo suggerimento.

marginHeaderSuggested

boolean

Indica se è stata suggerita una modifica a marginHeader.

flipPageOrientationSuggested

boolean

(Facoltativo) Indica se è stata suggerita una modifica a flipPageOrientation.

BackgroundSuggestionState

Una maschera che indica quali campi nella base Background sono stati modificati in questo suggerimento. Per qualsiasi campo impostato su true, viene suggerito un nuovo valore per Backgound.

Rappresentazione JSON
{
  "backgroundColorSuggested": boolean
}
Campi
backgroundColorSuggested

boolean

Indica se il colore di sfondo corrente è stato modificato in questo suggerimento.

SizeSuggestionState

Una maschera che indica quali campi della 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

boolean

Indica se è stata suggerita una modifica a height.

widthSuggested

boolean

Indica se è stata suggerita una modifica a width.

NamedStyles

Gli stili con nome. I paragrafi nel documento possono ereditare i relativi TextStyle e ParagraphStyle da questi stili con nome.

Rappresentazione JSON
{
  "styles": [
    {
      object (NamedStyle)
    }
  ]
}
Campi
styles[]

object (NamedStyle)

Gli stili con nome.

Esiste una voce per ciascuno dei possibili named style types.

NamedStyle

Uno stile denominato. I paragrafi del documento possono ereditare TextStyle e ParagraphStyle da questo stile denominato se hanno lo stesso tipo di stile denominato.

Rappresentazione JSON
{
  "namedStyleType": enum (NamedStyleType),
  "textStyle": {
    object (TextStyle)
  },
  "paragraphStyle": {
    object (ParagraphStyle)
  }
}
Campi
namedStyleType

enum (NamedStyleType)

Il tipo di questo stile con nome.

textStyle

object (TextStyle)

Lo stile del testo di questo stile con nome.

paragraphStyle

object (ParagraphStyle)

Lo stile del paragrafo di questo stile con nome.

SuggestedNamedStyles

Una modifica suggerita per NamedStyles.

Rappresentazione JSON
{
  "namedStyles": {
    object (NamedStyles)
  },
  "namedStylesSuggestionState": {
    object (NamedStylesSuggestionState)
  }
}
Campi
namedStyles

object (NamedStyles)

Un NamedStyles che include solo le modifiche apportate in questo suggerimento. Questo comando può essere utilizzato insieme a namedStylesSuggestionState per vedere quali campi sono stati modificati e i relativi nuovi valori.

namedStylesSuggestionState

object (NamedStylesSuggestionState)

Una maschera che indica quali campi nella base NamedStyles sono stati modificati in questo suggerimento.

NamedStylesSuggestionState

Lo stato del suggerimento di un messaggio NamedStyles.

Rappresentazione JSON
{
  "stylesSuggestionStates": [
    {
      object (NamedStyleSuggestionState)
    }
  ]
}
Campi
stylesSuggestionStates[]

object (NamedStyleSuggestionState)

Una maschera che indica quali campi nel campo NamedStyle corrispondente in styles sono stati modificati in questo suggerimento.

L'ordine di questi stati dei suggerimenti di stile con nome corrisponde all'ordine dello stile con nome corrispondente all'interno del suggerimento named styles.

NamedStyleSuggestionState

Uno stato di suggerimento di un messaggio NamedStyle.

Rappresentazione JSON
{
  "namedStyleType": enum (NamedStyleType),
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}
Campi
namedStyleType

enum (NamedStyleType)

Il tipo di stile denominato a cui corrisponde questo stato del suggerimento.

Questo campo viene fornito per agevolare la ricerca di corrispondenze tra NamedStyleSuggestionState e NamedStyle corrispondente.

textStyleSuggestionState

object (TextStyleSuggestionState)

Una maschera che indica quali campi in text style sono stati modificati in questo suggerimento.

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

Una maschera che indica quali campi di paragraph style sono stati modificati in questo suggerimento.

Elenco

Un elenco rappresenta gli attributi dell'elenco per un gruppo di paragrafi che appartengono allo stesso elenco. Un paragrafo che fa parte di un elenco fa riferimento all'ID dell'elenco nel relativo bullet.

Rappresentazione JSON
{
  "listProperties": {
    object (ListProperties)
  },
  "suggestedListPropertiesChanges": {
    string: {
      object (SuggestedListProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
Campi
listProperties

object (ListProperties)

Le proprietà dell'elenco.

suggestedListPropertiesChanges

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

Le modifiche suggerite alle proprietà dell'elenco, digitate in base all'ID suggerimento.

suggestedInsertionId

string

L'ID di inserzione suggerito. Se vuoto, questo non è un inserimento suggerito.

suggestedDeletionIds[]

string

Gli ID di eliminazione suggeriti. Se è vuoto, significa che non sono presenti eliminazioni suggerite di questo elenco.

ListProperties

Le proprietà di un list che descrivono l'aspetto dei numeri di elenco appartenenti ai paragrafi associati a un elenco.

Rappresentazione JSON
{
  "nestingLevels": [
    {
      object (NestingLevel)
    }
  ]
}
Campi
nestingLevels[]

object (NestingLevel)

Descrive le proprietà dei punti elenco al livello associato.

Un elenco ha al massimo 9 livelli di nidificazione, con il livello 0 che corrisponde al livello più alto e il livello 8 che corrisponde al livello più nidificato. I livelli di nidificazione vengono restituiti in ordine crescente, con il livello meno nidificato restituito per primo.

NestingLevel

Contiene proprietà che descrivono l'aspetto di un punto elenco di un elenco a un determinato livello di nidificazione.

Rappresentazione JSON
{
  "bulletAlignment": enum (BulletAlignment),
  "glyphFormat": string,
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "textStyle": {
    object (TextStyle)
  },
  "startNumber": integer,

  // Union field glyph_kind can be only one of the following:
  "glyphType": enum (GlyphType),
  "glyphSymbol": string
  // End of list of possible types for union field glyph_kind.
}
Campi
bulletAlignment

enum (BulletAlignment)

L'allineamento del punto elenco all'interno dello spazio assegnato per il rendering del punto elenco.

glyphFormat

string

La stringa di formato utilizzata dai numeri di elenco a questo livello di nidificazione.

Il formato del glifo contiene uno o più segnaposto, che vengono sostituiti con i valori appropriati a seconda di glyphType o glyphSymbol. I segnaposto seguono lo schema %[nestingLevel]. Inoltre, i segnaposto possono avere prefissi e suffissi. Pertanto, il formato glifo segue il pattern <prefix>%[nestingLevel]<suffix>. Tieni presente che il prefisso e il suffisso sono facoltativi e possono essere stringhe arbitrarie.

Ad esempio, il formato del glifo %0. indica che il glifo visualizzato sostituirà il segnaposto con il glifo corrispondente per il livello di nidificazione 0 seguito da un punto come suffisso. Di conseguenza, un elenco con tipo di glifo UPPER_ALPHA e formato di glifi %0. a livello di nidificazione 0 restituirà un elenco con glifi visualizzati.

A.

B.

C.

Il formato glifo può contenere segnaposto per il livello di annidamento corrente e segnaposto per i livelli di annidamento principali. Ad esempio, un elenco può avere un formato glifo %0. a livello di nidificazione 0 e un formato glifo %0.%1. a livello di nidificazione 1. Se entrambi i livelli di nidificazione hanno DECIMAL tipi di glifi, verrà visualizzato un elenco con glifi visualizzati

1.

2.

2.1.

2.2.

3.

Per i livelli di nidificazione in ordine, la stringa che sostituisce un segnaposto nel formato glifo per un determinato paragrafo dipende dall'ordine del paragrafo nell'elenco.

indentFirstLine

object (Dimension)

La quantità di rientro per la prima riga dei paragrafi a questo livello di nidificazione.

indentStart

object (Dimension)

La quantità di rientro per i paragrafi a questo livello di nidificazione. Applicato al lato che corrisponde all'inizio del testo, in base alla direzione del contenuto del paragrafo.

textStyle

object (TextStyle)

Lo stile di testo dei punti elenco a questo livello di nidificazione.

startNumber

integer

Il numero del primo elemento dell'elenco a questo livello di nidificazione.

Un valore pari a 0 viene considerato pari a 1 per gli elenchi di lettere e di numeri romani. Per i valori sia 0 che 1, gli elenchi con lettere e i numeri romani iniziano rispettivamente con a e i.

Questo valore viene ignorato per i livelli di nidificazione con glifi non ordinati.

Campo unione glyph_kind. Il tipo di glifo usato dai punti elenco. Questo definisce il carattere di elenco puntato che sostituisce i segnaposto in glyph_format. glyph_kind può essere solo uno dei seguenti:
glyphType

enum (GlyphType)

Il tipo di glifo utilizzato dai numeri quando i paragrafi a questo livello di nidificazione sono ordinati.

Il tipo di glifo determina il tipo di glifo utilizzato per sostituire i segnaposto all'interno di glyphFormat quando i paragrafi a questo livello di nidificazione sono ordinati. Ad esempio, se il livello di nidificazione è 0, glyphFormat è %0. e il tipo di glifo è DECIMAL, il glifo sottoposto a rendering sostituirà il segnaposto %0 nel formato glifo con un numero corrispondente all'ordine degli elementi dell'elenco nell'elenco.

glyphSymbol

string

Un simbolo personalizzato del glifo utilizzato dai punti elenco quando i paragrafi in questo livello di nidificazione non sono in ordine.

Il simbolo del glifo sostituisce i segnaposto all'interno di glyphFormat. Ad esempio, se il glyphSymbol è il cerchio pieno corrispondente al punto di codice Unicode U+25cf e glyphFormat è %0, il glifo visualizzato sarà il cerchio pieno.

BulletAlignment

I tipi di allineamento per un punto elenco.

Enum
BULLET_ALIGNMENT_UNSPECIFIED L'allineamento dei punti elenco non è specificato.
START Il punto elenco è allineato all'inizio dello spazio allocato per il rendering del punto elenco. 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 elenco.
END Il punto elenco è allineato alla fine dello spazio assegnato per il rendering del punto elenco. Allineato a destra per il testo LTR, allineamento a sinistra negli altri casi.

GlyphType

I tipi di glifi utilizzati dai punti elenco quando vengono ordinati i paragrafi a questo livello di nidificazione.

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 a una sola cifra sono preceduti dal prefisso zero, ad esempio 01, 02 o 03. I numeri con più di una cifra non sono preceduti dal prefisso dello zero.
UPPER_ALPHA Una lettera maiuscola, ad esempio A, B o C.
ALPHA Una lettera minuscola, ad esempio a, b o c.
UPPER_ROMAN Un numero romano maiuscolo, ad esempio I, II o III.
ROMAN Un numero romano minuscolo, ad esempio i, ii o iii.

SuggestedListProperties

Una modifica suggerita a ListProperties.

Rappresentazione JSON
{
  "listProperties": {
    object (ListProperties)
  },
  "listPropertiesSuggestionState": {
    object (ListPropertiesSuggestionState)
  }
}
Campi
listProperties

object (ListProperties)

Un ListProperties che include solo le modifiche apportate in questo suggerimento. Questo comando può essere utilizzato insieme a listPropertiesSuggestionState per vedere quali campi sono stati modificati e i relativi nuovi valori.

listPropertiesSuggestionState

object (ListPropertiesSuggestionState)

Una maschera che indica quali campi nella base ListProperties sono stati modificati in questo suggerimento.

ListPropertiesSuggestionState

Una maschera che indica quali campi nella base ListProperties sono stati modificati in questo suggerimento. Per ogni campo impostato su true, viene suggerito un nuovo valore.

Rappresentazione JSON
{
  "nestingLevelsSuggestionStates": [
    {
      object (NestingLevelSuggestionState)
    }
  ]
}
Campi
nestingLevelsSuggestionStates[]

object (NestingLevelSuggestionState)

Una maschera che indica quali campi nel campo NestingLevel corrispondente in nestingLevels sono stati modificati in questo suggerimento.

Gli stati di suggerimento dei livelli di nidificazione vengono restituiti in ordine crescente del livello di nidificazione, con quello meno nidificato restituito per primo.

NestingLevelSuggestionState

Una maschera che indica quali campi nella 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 (TextStyleSuggestionState)
  },
  "startNumberSuggested": boolean
}
Campi
bulletAlignmentSuggested

boolean

Indica se è stata suggerita una modifica a bulletAlignment.

glyphTypeSuggested

boolean

Indica se è stata suggerita una modifica a glyphType.

glyphFormatSuggested

boolean

Indica se è stata suggerita una modifica a glyphFormat.

glyphSymbolSuggested

boolean

Indica se è stata suggerita una modifica a glyphSymbol.

indentFirstLineSuggested

boolean

Indica se è stata suggerita una modifica a indentFirstLine.

indentStartSuggested

boolean

Indica se è stata suggerita una modifica a indentStart.

textStyleSuggestionState

object (TextStyleSuggestionState)

Una maschera che indica quali campi di text style sono stati modificati in questo suggerimento.

startNumberSuggested

boolean

Indica se è stata suggerita una modifica a startNumber.

NamedRanges

Una raccolta di tutti i NamedRange nel documento che condividono un determinato nome.

Rappresentazione JSON
{
  "name": string,
  "namedRanges": [
    {
      object (NamedRange)
    }
  ]
}
Campi
name

string

Il nome che condividono tutti i named ranges.

namedRanges[]

object (NamedRange)

Gli elementi NamedRange che condividono lo stesso nome.

NamedRange

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 Range e i contenuti inseriti all'interno di un intervallo denominato generalmente lo espandono. Tuttavia, alcune modifiche al documento possono causare la suddivisione dell'intervallo in più intervalli.

Gli intervalli denominati non sono privati. Tutte le applicazioni e i collaboratori che hanno accesso al documento possono visualizzare gli intervalli con nome.

Rappresentazione JSON
{
  "namedRangeId": string,
  "name": string,
  "ranges": [
    {
      object (Range)
    }
  ]
}
Campi
namedRangeId

string

L'ID dell'intervallo denominato.

name

string

Il nome dell'intervallo denominato.

ranges[]

object (Range)

Gli intervalli che appartengono a questo intervallo denominato.

Intervallo

Specifica un intervallo di testo contiguo.

Rappresentazione JSON
{
  "segmentId": string,
  "startIndex": integer,
  "endIndex": integer,
  "tabId": string
}
Campi
segmentId

string

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

integer

L'indice iniziale su base zero di questo intervallo, in unità di codice UTF-16.

In tutti gli utilizzi attuali, è necessario fornire un indice iniziale. Questo campo è un valore Int32Value per supportare casi d'uso futuri con intervalli aperti.

endIndex

integer

L'indice finale in base zero di questo intervallo, escluso, nelle unità di codice UTF-16.

In tutti gli utilizzi attuali, è necessario fornire un indice finale. Questo campo è un valore Int32 per adattarsi a casi d'uso futuri con intervalli aperti.

tabId

string

La scheda che contiene questo intervallo. Se omesso, la richiesta si applica alla prima scheda.

In un documento contenente una singola scheda:

  • Se fornito, deve corrispondere all'ID della tabulazione singolare.

  • Se omesso, la richiesta si applica alla scheda singola.

In un documento contenente più schede:

  • Se fornita, la richiesta si applica alla scheda specificata.

  • Se omesso, la richiesta si applica alla prima scheda del documento.

InlineObject

Un oggetto visualizzato in linea con il testo. Un oggetto InlineObject contiene un elemento EmbeddedObject come un'immagine.

Rappresentazione JSON
{
  "objectId": string,
  "inlineObjectProperties": {
    object (InlineObjectProperties)
  },
  "suggestedInlineObjectPropertiesChanges": {
    string: {
      object (SuggestedInlineObjectProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
Campi
objectId

string

L'ID di questo oggetto in linea. Può essere utilizzato per aggiornare le proprietà di un oggetto.

inlineObjectProperties

object (InlineObjectProperties)

Le proprietà di questo oggetto in linea.

suggestedInlineObjectPropertiesChanges

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

Le modifiche suggerite alle proprietà degli oggetti in linea, con chiave in base all'ID suggerimento.

suggestedInsertionId

string

L'ID inserzione suggerito. Se vuoto, questo non è un inserimento suggerito.

suggestedDeletionIds[]

string

Gli ID eliminazione suggeriti. Se viene lasciato vuoto, non sono previste eliminazioni suggerite di questi contenuti.

InlineObjectProperties

Proprietà di un InlineObject.

Rappresentazione JSON
{
  "embeddedObject": {
    object (EmbeddedObject)
  }
}
Campi
embeddedObject

object (EmbeddedObject)

L'oggetto incorporato di questo oggetto in linea.

EmbeddedObject

Un oggetto incorporato nel documento.

Rappresentazione JSON
{
  "title": string,
  "description": string,
  "embeddedObjectBorder": {
    object (EmbeddedObjectBorder)
  },
  "size": {
    object (Size)
  },
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "linkedContentReference": {
    object (LinkedContentReference)
  },

  // Union field properties can be only one of the following:
  "embeddedDrawingProperties": {
    object (EmbeddedDrawingProperties)
  },
  "imageProperties": {
    object (ImageProperties)
  }
  // End of list of possible types for union field properties.
}
Campi
title

string

Il titolo dell'oggetto incorporato. title e description sono entrambi combinati per visualizzare il testo alternativo.

description

string

La descrizione dell'oggetto incorporato. title e description vengono combinati per visualizzare il testo alternativo.

embeddedObjectBorder

object (EmbeddedObjectBorder)

Il bordo dell'oggetto incorporato.

size

object (Size)

Le dimensioni visibili dell'immagine dopo il ritaglio.

marginTop

object (Dimension)

Il margine superiore dell'oggetto incorporato.

marginBottom

object (Dimension)

Margine inferiore dell'oggetto incorporato.

marginRight

object (Dimension)

Margine destro dell'oggetto incorporato.

marginLeft

object (Dimension)

Margine sinistro dell'oggetto incorporato.

linkedContentReference

object (LinkedContentReference)

Un riferimento ai contenuti di origine esterna collegata. Ad esempio, contiene un riferimento al grafico di Fogli Google di origine quando l'oggetto incorporato è un grafico collegato.

Se non è impostato, l'oggetto incorporato non è collegato.

Campo unione properties. Le proprietà specifiche per ogni tipo di oggetto incorporato. properties può essere solo uno dei seguenti:
embeddedDrawingProperties

object (EmbeddedDrawingProperties)

Proprietà di un disegno incorporato.

imageProperties

object (ImageProperties)

Le proprietà di un'immagine.

EmbeddedDrawingProperties

Questo tipo non contiene campi.

Le proprietà di un disegno incorporato e utilizzate per distinguere 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 (CropProperties)
  },
  "angle": number
}
Campi
contentUri

string

Un URI dell'immagine con una durata predefinita di 30 minuti. Questo URI è contrassegnato con l'account del richiedente. Chiunque disponga dell'URI accede effettivamente all'immagine come richiedente originale. L'accesso all'immagine potrebbe andare perso se le impostazioni di condivisione del documento cambiano.

sourceUri

string

L'URI di origine è quello utilizzato per inserire l'immagine. L'URI di origine può essere vuoto.

brightness

number

L'effetto di luminosità dell'immagine. Il valore deve essere compreso nell'intervallo [-1,0, 1,0], dove 0 indica nessun effetto.

contrast

number

L'effetto di contrasto dell'immagine. Il valore deve essere compreso nell'intervallo [-1,0; 1,0], dove 0 indica nessun effetto.

transparency

number

L'effetto di trasparenza dell'immagine. Il valore deve essere compreso nell'intervallo [0,0, 1,0], dove 0 indica nessun effetto e 1 indica trasparente.

cropProperties

object (CropProperties)

Le proprietà di ritaglio dell'immagine.

angle

number

L'angolo di rotazione in senso orario dell'immagine, espresso in radianti.

CropProperties

Le proprietà di ritaglio di un'immagine.

Il rettangolo di ritaglio è rappresentato utilizzando offset frazionari rispetto ai quattro bordi dei contenuti originali.

  • Se l'offset è 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 lato corrispondente del rettangolo di ritaglio è posizionato all'esterno del rettangolo delimitante 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

number

L'offset specifica quanto si trova all'interno del bordo sinistro del rettangolo di ritaglio dal bordo sinistro del contenuto originale, come frazione della larghezza del contenuto originale.

offsetRight

number

L'offset specifica la distanza interna del bordo destro del rettangolo di ritaglio dal bordo destro dei contenuti originali come frazione della larghezza dei contenuti originali.

offsetTop

number

L'offset specifica quanto dista il bordo superiore del rettangolo di ritaglio dal bordo superiore del contenuto originale come frazione dell'altezza del contenuto originale.

offsetBottom

number

L'offset specifica la distanza interna del bordo inferiore del rettangolo di ritaglio dal bordo inferiore dei contenuti originali come frazione dell'altezza dei contenuti originali.

angle

number

L'angolo di rotazione in senso orario del rettangolo di ritaglio attorno al suo centro, espresso in radianti. La rotazione viene applicata dopo gli offset.

EmbeddedObjectBorder

Un bordo attorno a un elemento EmbeddedObject.

Rappresentazione JSON
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle),
  "propertyState": enum (PropertyState)
}
Campi
color

object (OptionalColor)

Il colore del bordo.

width

object (Dimension)

La larghezza del bordo.

dashStyle

enum (DashStyle)

Lo stile del tratto del bordo.

propertyState

enum (PropertyState)

Lo stato della proprietà border.

PropertyState

Gli stati possibili 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.

LinkedContentReference

Un riferimento ai contenuti della fonte esterna collegata.

Rappresentazione JSON
{

  // Union field reference can be only one of the following:
  "sheetsChartReference": {
    object (SheetsChartReference)
  }
  // End of list of possible types for union field reference.
}
Campi
Campo unione reference. Il riferimento specifico al tipo di contenuti collegati. reference può essere solo uno dei seguenti:
sheetsChartReference

object (SheetsChartReference)

Un riferimento al grafico collegato.

SheetsChartReference

Un riferimento a un grafico collegato incorporato da Fogli Google.

Rappresentazione JSON
{
  "spreadsheetId": string,
  "chartId": integer
}
Campi
spreadsheetId

string

L'ID del foglio di lavoro di Fogli Google che contiene il grafico di origine.

chartId

integer

L'ID del grafico specifico nel foglio di lavoro di Fogli Google incorporato.

SuggestedInlineObjectProperties

Una modifica suggerita per InlineObjectProperties.

Rappresentazione JSON
{
  "inlineObjectProperties": {
    object (InlineObjectProperties)
  },
  "inlineObjectPropertiesSuggestionState": {
    object (InlineObjectPropertiesSuggestionState)
  }
}
Campi
inlineObjectProperties

object (InlineObjectProperties)

Un InlineObjectProperties che include solo le modifiche apportate in questo suggerimento. Questa opzione può essere utilizzata insieme a inlineObjectPropertiesSuggestionState per vedere quali campi sono stati modificati e i relativi nuovi valori.

inlineObjectPropertiesSuggestionState

object (InlineObjectPropertiesSuggestionState)

Una maschera che indica quali campi della base InlineObjectProperties sono stati modificati in questo suggerimento.

InlineObjectPropertiesSuggestionState

Una maschera che indica quali campi nella base InlineObjectProperties sono stati modificati in questo suggerimento. Per ogni campo impostato su true, viene suggerito un nuovo valore.

Rappresentazione JSON
{
  "embeddedObjectSuggestionState": {
    object (EmbeddedObjectSuggestionState)
  }
}
Campi
embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

Una maschera che indica quali campi in embeddedObject sono stati modificati in questo suggerimento.

EmbeddedObjectSuggestionState

Una maschera che indica quali campi nella base EmbeddedObject sono stati modificati in questo suggerimento. Per ogni campo impostato su true, viene suggerito un nuovo valore.

Rappresentazione JSON
{
  "embeddedDrawingPropertiesSuggestionState": {
    object (EmbeddedDrawingPropertiesSuggestionState)
  },
  "imagePropertiesSuggestionState": {
    object (ImagePropertiesSuggestionState)
  },
  "titleSuggested": boolean,
  "descriptionSuggested": boolean,
  "embeddedObjectBorderSuggestionState": {
    object (EmbeddedObjectBorderSuggestionState)
  },
  "sizeSuggestionState": {
    object (SizeSuggestionState)
  },
  "marginLeftSuggested": boolean,
  "marginRightSuggested": boolean,
  "marginTopSuggested": boolean,
  "marginBottomSuggested": boolean,
  "linkedContentReferenceSuggestionState": {
    object (LinkedContentReferenceSuggestionState)
  }
}
Campi
embeddedDrawingPropertiesSuggestionState

object (EmbeddedDrawingPropertiesSuggestionState)

Una maschera che indica quali campi in embeddedDrawingProperties sono stati modificati in questo suggerimento.

imagePropertiesSuggestionState

object (ImagePropertiesSuggestionState)

Una maschera che indica quali campi di imageProperties sono stati modificati in questo suggerimento.

titleSuggested

boolean

Indica se è stata suggerita una modifica a title.

descriptionSuggested

boolean

Indica se è stata suggerita una modifica a description.

embeddedObjectBorderSuggestionState

object (EmbeddedObjectBorderSuggestionState)

Una maschera che indica quali campi in embeddedObjectBorder sono stati modificati in questo suggerimento.

sizeSuggestionState

object (SizeSuggestionState)

Una maschera che indica quali campi in size sono stati modificati in questo suggerimento.

marginLeftSuggested

boolean

Indica se è stata suggerita una modifica a marginLeft.

marginRightSuggested

boolean

Indica se è stata suggerita una modifica a marginRight.

marginTopSuggested

boolean

Indica se è stata suggerita una modifica a marginTop.

marginBottomSuggested

boolean

Indica se è stata suggerita una modifica a marginBottom.

linkedContentReferenceSuggestionState

object (LinkedContentReferenceSuggestionState)

Una maschera che indica quali campi di linkedContentReference sono stati modificati in questo suggerimento.

EmbeddedDrawingPropertiesSuggestionState

Questo tipo non contiene campi.

Una maschera che indica quali campi nella base EmbeddedDrawingProperties sono stati modificati in questo suggerimento. Per ogni campo impostato su true, viene suggerito un nuovo valore.

ImagePropertiesSuggestionState

Una maschera che indica quali campi nella 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 (CropPropertiesSuggestionState)
  },
  "angleSuggested": boolean
}
Campi
contentUriSuggested

boolean

Indica se è stata suggerita una modifica a contentUri.

sourceUriSuggested

boolean

Indica se è stata suggerita una modifica a [sourceUri] [google.apps.docs.v1.EmbeddedObject.source_uri].

brightnessSuggested

boolean

Indica se è stata suggerita una modifica a [luminosità] [google.apps.docs.v1.EmbeddedObject.brightness].

contrastSuggested

boolean

Indica se è stata suggerita una modifica a [contrast] [google.apps.docs.v1.EmbeddedObject.contrast].

transparencySuggested

boolean

Indica se è stata suggerita una modifica a [trasparenza] [google.apps.docs.v1.EmbeddedObject.transparency].

cropPropertiesSuggestionState

object (CropPropertiesSuggestionState)

Una maschera che indica quali campi in cropProperties sono stati modificati in questo suggerimento.

angleSuggested

boolean

Indica se è stata suggerita una modifica a [angolo] [google.apps.docs.v1.EmbeddedObject.angle].

CropPropertiesSuggestionState

Una maschera che indica quali campi della 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

boolean

Indica se è stata suggerita una modifica a offsetLeft.

offsetRightSuggested

boolean

Indica se è stata suggerita una modifica a offsetRight.

offsetTopSuggested

boolean

Indica se è stata suggerita una modifica a offsetTop.

offsetBottomSuggested

boolean

Indica se è stata suggerita una modifica a offsetBottom.

angleSuggested

boolean

Indica se è stata suggerita una modifica a angle.

EmbeddedObjectBorderSuggestionState

Una maschera che indica quali campi nella 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

boolean

Indica se è stata suggerita una modifica in [color] [google.apps.docs.v1.EmbeddedBorderObject.color].

widthSuggested

boolean

Indica se è stata suggerita una modifica a [width] [google.apps.docs.v1.EmbeddedBorderObject.width].

dashStyleSuggested

boolean

Indica se è stata suggerita una modifica a [dashStyle] [google.apps.docs.v1.EmbeddedBorderObject.dash_style].

propertyStateSuggested

boolean

Indica se è stata suggerita una modifica a [propertyState] [google.apps.docs.v1.EmbeddedBorderObject.property_state].

LinkedContentReferenceSuggestionState

Una maschera che indica quali campi nella base LinkedContentReference sono stati modificati in questo suggerimento. Per ogni campo impostato su true, è disponibile un nuovo valore suggerito.

Rappresentazione JSON
{
  "sheetsChartReferenceSuggestionState": {
    object (SheetsChartReferenceSuggestionState)
  }
}
Campi
sheetsChartReferenceSuggestionState

object (SheetsChartReferenceSuggestionState)

Una maschera che indica quali campi in sheetsChartReference sono stati modificati in questo suggerimento.

SheetsChartReferenceSuggestionState

Una maschera che indica quali campi nella 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

boolean

Indica se è stata suggerita una modifica a spreadsheetId.

chartIdSuggested

boolean

Indica se è stata suggerita una modifica a chartId.

PositionedObject

Un oggetto collegato a un Paragraph e posizionato in base all'inizio del paragrafo. Un PositionedObject contiene un EmbeddedObject, ad esempio un'immagine.

Rappresentazione JSON
{
  "objectId": string,
  "positionedObjectProperties": {
    object (PositionedObjectProperties)
  },
  "suggestedPositionedObjectPropertiesChanges": {
    string: {
      object (SuggestedPositionedObjectProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
Campi
objectId

string

L'ID di questo oggetto posizionato.

positionedObjectProperties

object (PositionedObjectProperties)

Le proprietà di questo oggetto posizionato.

suggestedPositionedObjectPropertiesChanges

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

Le modifiche suggerite alle proprietà dell'oggetto posizionato, espresse in base all'ID suggerimento.

suggestedInsertionId

string

L'ID inserzione suggerito. Se è vuoto, non si tratta di un'inserzione suggerita.

suggestedDeletionIds[]

string

Gli ID di eliminazione suggeriti. Se viene lasciato vuoto, non sono previste eliminazioni suggerite di questi contenuti.

PositionedObjectProperties

Proprietà di un PositionedObject.

Rappresentazione JSON
{
  "positioning": {
    object (PositionedObjectPositioning)
  },
  "embeddedObject": {
    object (EmbeddedObject)
  }
}
Campi
positioning

object (PositionedObjectPositioning)

Il posizionamento di questo oggetto posizionato rispetto al nuovo riga del Paragraph che fa riferimento a questo oggetto posizionato.

embeddedObject

object (EmbeddedObject)

L'oggetto incorporato di questo oggetto posizionato.

PositionedObjectPositioning

Il posizionamento di un PositionedObject. L'oggetto posizionato è posizionato rispetto all'inizio del Paragraph a cui è associato.

Rappresentazione JSON
{
  "layout": enum (PositionedObjectLayout),
  "leftOffset": {
    object (Dimension)
  },
  "topOffset": {
    object (Dimension)
  }
}
Campi
layout

enum (PositionedObjectLayout)

Il layout di questo oggetto posizionato.

leftOffset

object (Dimension)

L'offset del bordo sinistro dell'oggetto posizionato rispetto all'inizio del Paragraph a cui è collegato. Il posizionamento esatto dell'oggetto può dipendere da altri contenuti del documento e dallo stile del documento stesso.

topOffset

object (Dimension)

L'offset del bordo superiore dell'oggetto posizionato rispetto all'inizio del Paragraph a cui è associato. Il posizionamento esatto dell'oggetto può dipendere da altri contenuti del documento e dallo stile del documento.

PositionedObjectLayout

I layout possibili di [PositionedObject][google.aps.docs.v1.PositionedObject].

Enum
POSITIONED_OBJECT_LAYOUT_UNSPECIFIED Il layout non è specificato.
WRAP_TEXT Il testo viene a capo intorno all'oggetto posizionato.
BREAK_LEFT Interrompe il testo in modo che l'oggetto posizionato si trovi a sinistra e il testo sia a destra.
BREAK_RIGHT Interrompe il testo in modo che l'oggetto posizionato si trovi a destra e il testo sia 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.

SuggestedPositionedObjectProperties

Una modifica suggerita per PositionedObjectProperties.

Rappresentazione JSON
{
  "positionedObjectProperties": {
    object (PositionedObjectProperties)
  },
  "positionedObjectPropertiesSuggestionState": {
    object (PositionedObjectPropertiesSuggestionState)
  }
}
Campi
positionedObjectProperties

object (PositionedObjectProperties)

Un PositionedObjectProperties che include solo le modifiche apportate in questo suggerimento. Questa opzione può essere utilizzata insieme a positionedObjectPropertiesSuggestionState per vedere quali campi sono stati modificati e i relativi nuovi valori.

positionedObjectPropertiesSuggestionState

object (PositionedObjectPropertiesSuggestionState)

Una maschera che indica quali campi nella base PositionedObjectProperties sono stati modificati in questo suggerimento.

PositionedObjectPropertiesSuggestionState

Una maschera che indica quali campi della base PositionedObjectProperties sono stati modificati in questo suggerimento. Per ogni campo impostato su true, viene suggerito un nuovo valore.

Rappresentazione JSON
{
  "positioningSuggestionState": {
    object (PositionedObjectPositioningSuggestionState)
  },
  "embeddedObjectSuggestionState": {
    object (EmbeddedObjectSuggestionState)
  }
}
Campi
positioningSuggestionState

object (PositionedObjectPositioningSuggestionState)

Una maschera che indica quali campi di positioning sono stati modificati in questo suggerimento.

embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

Una maschera che indica quali campi in embeddedObject sono stati modificati in questo suggerimento.

PositionedObjectPositioningSuggestionState

Una maschera che indica quali campi nella base PositionedObjectPositioning sono stati modificati in questo suggerimento. Per ogni campo impostato su true, è disponibile un nuovo valore suggerito.

Rappresentazione JSON
{
  "layoutSuggested": boolean,
  "leftOffsetSuggested": boolean,
  "topOffsetSuggested": boolean
}
Campi
layoutSuggested

boolean

Indica se è stata suggerita una modifica a layout.

leftOffsetSuggested

boolean

Indica se è stata suggerita una modifica a leftOffset.

topOffsetSuggested

boolean

Indica se è stata suggerita una modifica a topOffset.

SuggestionsViewMode

La modalità di visualizzazione dei suggerimenti applicata al documento e che indica come vengono rappresentate le modifiche suggerite. che offre opzioni per la lettura del documento con tutti i suggerimenti incorporati, 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 ha solo accesso in visualizzazione, viene applicato PREVIEW_WITHOUT_SUGGESTIONS. In caso contrario, viene applicato SUGGESTIONS_INLINE. Questa è la modalità di visualizzazione predefinita dei suggerimenti.
SUGGESTIONS_INLINE

Il documento restituito contiene suggerimenti in linea. Le modifiche suggerite saranno diverse dai contenuti di base all'interno del documento.

Le richieste di recupero di 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 con tutte le modifiche suggerite accettate.

Le richieste di recupero di 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 in cui tutte le modifiche suggerite vengono rifiutate se ci sono suggerimenti nel documento.

Metodi

batchUpdate

Applica uno o più aggiornamenti al documento.

create

Crea un documento vuoto utilizzando il titolo indicato nella richiesta.

get

Recupera l'ultima versione del documento specificato.