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 il comportamento della 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 significa 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 impostato, 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 impostato, 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 impostato, 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, con chiave in base all'ID nota.

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 impostato, 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, con chiave in base all'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 viene configurato, questo campo contiene informazioni sulla prima scheda del documento.

namedStyles

object (NamedStyles)

Solo output. Gli stili denominati 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 denominati del documento, con chiave in base all'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 impostato, 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 impostato, questo campo contiene informazioni sulla prima scheda del documento.

inlineObjects

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

Solo output. Gli oggetti in linea nel documento, indicizzati 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, codificati per 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, ad esempio 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 della cartella principale.

nestingLevel

integer

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

DocumentTab

Una scheda con i contenuti del documento.

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 denominati della scheda del documento.

suggestedNamedStylesChanges

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

Le modifiche suggerite agli stili denominati della scheda del documento, con chiave in base all'ID suggerimento.

lists

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

Elenchi nella scheda del documento, separati per ID elenco.

namedRanges

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

Gli intervalli denominati nella scheda del documento, indicizzati per nome.

inlineObjects

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

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

positionedObjects

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

Gli oggetti posizionati nella scheda del documento, con chiave in base all'ID oggetto.

Corpo

Il corpo del documento.

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

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

object (StructuralElement)

I contenuti del corpo.

Gli indici per i contenuti del corpo iniziano da zero.

StructuralElement

Un elemento StructuralElement descrive i contenuti che forniscono la 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 di fine di questo elemento strutturale basato su zero, esclusivo, in unità di codice UTF-16.

Campo unione content. I contenuti 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 terminato 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 componenti.

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 suggeriti da associare a questo paragrafo, indicizzati in base all'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 a 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 testo paragrafo automatico.

pageBreak

object (PageBreak)

Un elemento di paragrafo di interruzione di pagina.

columnBreak

object (ColumnBreak)

Un elemento paragrafo di interruzione di colonna.

footnoteReference

object (FootnoteReference)

Un elemento 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 di testo nell'esecuzione vengono sostituiti con il carattere Unicode U+E907.

suggestedInsertionIds[]

string

Gli ID di inserimento suggeriti. Un TextRun 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 questa esecuzione.

suggestedTextStyleChanges

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

Lo stile di testo suggerito viene modificato in base a questa esecuzione, con chiave in base all'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. Lo stile principale di uno stile di testo dipende da dove è definito:

  • Lo stile di testo di un Paragraph eredita lo stile 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 normal text eredita lo stile di testo predefinito nell'editor di Documenti.
  • Lo stile di testo di un elemento Paragraph contenuto in una tabella può ereditare lo stile di testo dallo stile della tabella.

Se lo stile di testo non viene ereditato da un elemento principale, la disattivazione dei campi ripristinerà lo stile a un valore corrispondente a quello predefinito nell'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 in grassetto o meno.

italic

boolean

Indica se il testo è in corsivo o meno.

underline

boolean

Se il testo è sottolineato o meno.

strikethrough

boolean

Indica se il testo è barrato o meno.

smallCaps

boolean

Indica se il testo è scritto in lettere maiuscole piccole.

backgroundColor

object (OptionalColor)

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

foregroundColor

object (OptionalColor)

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

fontSize

object (Dimension)

Le dimensioni 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 weightedFontFamily#weight non è impostato, 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)

L'offset 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 il criterio non viene configurato, 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, da 0,0 a 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 misura dell'intensità.

Unità

Unità di misura.

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

WeightedFontFamily

Rappresenta una famiglia di caratteri e il peso 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 del menu Carattere in Documenti o di Google Fonts. Se il nome del carattere non viene 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 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 di weight e del valore bold risolto dello stile di testo determina lo spessore visualizzato, dopo aver tenuto conto dell'eredità:

  • Se il testo è in grassetto e lo spessore è inferiore a 400, lo spessore visualizzato è 400.
  • Se il testo è in grassetto e lo spessore è maggiore o uguale a 400, ma minore di 700, lo spessore visualizzato è 700.
  • Se la ponderazione è maggiore o uguale a 700, il peso visualizzato è uguale alla ponderazione.
  • Se il testo non è in grassetto, lo spessore visualizzato sarà uguale a quello visualizzato.

BaselineOffset

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

Enum
BASELINE_OFFSET_UNSPECIFIED Lo spazio di base del testo viene ereditato dall'elemento principale.
NONE Il testo non è offset verticalmente.
SUPERSCRIPT Il testo è 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 TextStyle che include solo le modifiche apportate in questo suggerimento. Questo comando può essere utilizzato insieme a textStyleSuggestionState per vedere quali campi sono stati modificati e i relativi nuovi valori.

textStyleSuggestionState

object (TextStyleSuggestionState)

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

TextStyleSuggestionState

Una maschera che indica quali campi nella 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 del testo sostituito dinamicamente con contenuti che possono cambiare nel tempo, ad esempio 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 inserimento suggeriti. Un AutoText 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 è 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 viene modificato in questo testo automatico, specificato dall'ID suggerimento.

Tipo

I tipi di testo automatico.

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

PageBreak

Un elemento ParagraphElement che rappresenta un'interruzione di pagina. Un'interruzione di pagina fa in modo che il testo successivo inizi 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, 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 a capo.

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

suggestedTextStyleChanges

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

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

ColumnBreak

Un ParagraphElement che rappresenta un'interruzione di colonna. Un a capo di colonna fa in modo che il testo successivo inizi nella parte superiore della colonna successiva.

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

string

Gli ID di inserimento 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 è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

textStyle

object (TextStyle)

Lo stile di testo di questo a capo di colonna.

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

suggestedTextStyleChanges

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

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

FootnoteReference

Un ParagraphElement che rappresenta un riferimento a 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 del footnote che contiene i contenuti di questo riferimento a nota a piè di pagina.

footnoteNumber

string

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

suggestedInsertionIds[]

string

Gli ID di inserzione suggeriti. Un FootnoteReference 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 è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

textStyle

object (TextStyle)

Lo stile del testo di questa nota a piè di pagina.

suggestedTextStyleChanges

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

Lo stile di testo suggerito diventa questo FootnoteReference, con chiave 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 inserzione suggeriti. Un HorizontalRule 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 è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

textStyle

object (TextStyle)

Lo stile del testo di questa HorizontalRule.

Analogamente ai contenuti di testo, come le righe di testo e i riferimenti alle note a piè di pagina, lo stile di testo di una linea 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 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 è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

InlineObjectElement

Un ParagraphElement che contiene un InlineObject.

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

string

L'ID del InlineObject contenuto da questo elemento.

suggestedInsertionIds[]

string

Gli ID di inserzione suggeriti. Un InlineObjectElement 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 elemento InlineObject.

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 elemento oggetto in linea 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 ID suggerimento.

Persona

Una persona o un indirizzo email menzionato 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 link.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

ID per i suggerimenti che rimuovono il link a questa persona dal documento. Un Person potrebbe avere più ID eliminazione se, ad esempio, più utenti suggeriscono di eliminarlo. 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 diventa Person, con chiave in base all'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 viene visualizzato nel testo del link anziché l'indirizzo email della persona.

email

string

Solo output. L'indirizzo email collegato a questo 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 del RichLink visualizzato nel link. Questo titolo corrisponde al titolo 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 del RichLink, se presente (ad esempio, se si tratta di 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:

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

Se lo stile di paragrafo non eredita da un file 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 dell'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 per questo paragrafo.

lineSpacing

number

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

direction

enum (ContentDirection)

La direzione del testo di questo paragrafo. Se non è impostato, il valore predefinito è LEFT_TO_RIGHT poiché l'orientamento del paragrafo non viene ereditato.

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 è impostato, il valore viene ereditato dall'elemento principale.

Il bordo tra 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, il nuovo bordo deve essere specificato nella sua interezza.

borderTop

object (ParagraphBorder)

Il bordo nella parte superiore di questo paragrafo. Se non è impostato, il valore viene ereditato dall'elemento 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.

Impossibile aggiornare parzialmente i bordi del paragrafo. 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 è impostato, il valore viene ereditato dall'elemento principale.

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

borderRight

object (ParagraphBorder)

Il bordo a destra di questo paragrafo. Se non è impostato, il valore viene ereditato dall'elemento principale.

Impossibile aggiornare parzialmente i bordi del paragrafo. Quando modifichi il bordo di un paragrafo, il nuovo bordo deve essere specificato nella sua interezza.

indentFirstLine

object (Dimension)

L'entità del rientro per la prima riga del paragrafo. Se non è impostato, il valore viene ereditato dall'elemento 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 corrispondente alla fine del testo, in base alla direzione del paragrafo corrente. Se non è impostato, il valore viene ereditato dall'elemento 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, se possibile, tutte le righe del paragrafo devono essere disposte nella stessa pagina o colonna. Se non è impostato, il valore viene ereditato dall'elemento principale.

keepWithNext

boolean

Indica se, se possibile, almeno una parte di questo paragrafo deve essere disposta nella stessa pagina o colonna del paragrafo successivo. 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 è impostato, il valore viene ereditato dall'elemento 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 dall'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ò causare uno stato del documento non valido che restituisce un errore 400 di richiesta errata.

NamedStyleType

I tipi di stili con nome.

Enum
NAMED_STYLE_TYPE_UNSPECIFIED Il tipo di stile denominato non è specificato.
NORMAL_TEXT Testo normale.
TITLE Titolo.
SUBTITLE Sottotitolo.
HEADING_1 Intestazione 1.
HEADING_2 Intestazione 2.
HEADING_3 Intestazione 3.
HEADING_4 Intestazione 4.
HEADING_5 Intestazione 5.
HEADING_6 Intestazione 6.

Allineamento

I tipi di allineamento del testo per un paragrafo.

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

ContentDirection

Le direzioni stradali dei contenuti.

Enum
CONTENT_DIRECTION_UNSPECIFIED La direzione dei contenuti 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 lo spazio tra i paragrafi.

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

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 trattino 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 del trattino non specificato.
SOLID Linea continua. Corrisponde al valore ECMA-376 ST_PresetLineDashVal "solido". Questo è lo stile dei trattini predefinito.
DOT Linea tratteggiata. Corrisponde al valore "dot" di ST_PresetLineDashVal ECMA-376.
DASH Linea tratteggiata. Corrisponde al valore "dash" di ECMA-376 ST_PresetLineDashVal.

TabStop

Un rientro di tabulazione all'interno di un paragrafo.

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

object (Dimension)

Lo spazio tra questo a capo 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 delle tabulazioni non è specificato.
START L'interruzione di tabulazione è allineata all'inizio della riga. Questa è l'impostazione predefinita.
CENTER La tabulazione è allineata al centro della linea.
END La tabulazione è allineata alla fine della linea.

Ombreggiatura

L'ombreggiatura di un paragrafo.

Rappresentazione JSON
{
  "backgroundColor": {
    object (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 ParagraphStyle che include solo le modifiche apportate in questo suggerimento. Questo comando può essere utilizzato insieme a paragraphStyleSuggestionState per vedere quali campi sono stati modificati e i relativi nuovi valori.

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

Una maschera che indica quali campi della 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, è disponibile un nuovo valore suggerito.

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, viene suggerito un nuovo valore.

Rappresentazione JSON
{
  "backgroundColorSuggested": boolean
}
Campi
backgroundColorSuggested

boolean

Indica se è stata suggerita una modifica a Shading.

Punto elenco

Descrive il punto elenco 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 elemento 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 della base Bullet sono stati modificati in questo suggerimento. Per ogni campo impostato su true, è disponibile un nuovo valore suggerito.

Rappresentazione JSON
{
  "listIdSuggested": boolean,
  "nestingLevelSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}
Campi
listIdSuggested

boolean

Indica se è stata suggerita una modifica al listId.

nestingLevelSuggested

boolean

Indica se è stata suggerita una modifica a nestingLevel.

textStyleSuggestionState

object (TextStyleSuggestionState)

Una maschera che indica quali campi di 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 indica l'inizio di una nuova sezione e lo stile della sezione si applica 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 inserimento suggeriti. Un SectionBreak 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 è vuoto, significa che non sono state suggerite eliminazioni 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 che non abbia più di 3 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 annulli questa proprietà, viene generato un errore di richiesta non valido 400.

contentDirection

enum (ContentDirection)

L'orientamento dei contenuti di questa sezione. Se non viene configurato, 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 configurato, il valore predefinito è marginTop in DocumentStyle.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se questa proprietà non viene impostata, viene generato un errore di richiesta non valida (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 questa proprietà non viene impostata, viene generato un errore di richiesta non valida (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 questa proprietà non viene impostata, viene generato un errore di richiesta non valida (400).

marginLeft

object (Dimension)

Il margine sinistro della pagina della sezione. Se non viene impostato, il valore predefinito è marginLeft di 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 impostato, il valore viene ereditato dal valore SectionBreak's SectionStyle precedente. Se il valore non è impostato nella prima interruzione di sezione, viene ereditato da 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 della 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 delle 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 il conteggio del numero di pagine per questa sezione. Se il criterio non viene configurato, la numerazione di pagina continua dalla sezione precedente. Se il valore non è impostato nel primo 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 è impostato, il valore eredita da flipPageOrientation di DocumentStyle.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se questa proprietà non viene impostata, viene generato un errore di richiesta non valida (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 immediatamente dopo l'ultimo paragrafo della sezione precedente.
NEXT_PAGE La sezione inizia nella pagina successiva.

Tabella

Un StructuralElement che rappresenta una tabella.

Rappresentazione JSON
{
  "rows": integer,
  "columns": integer,
  "tableRows": [
    {
      object (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 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 è 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 di inizio di questa riga basato su zero, 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.

È possibile che una tabella non sia rettangolare, pertanto alcune righe potrebbero avere un numero di celle diverso rispetto ad altre righe della stessa tabella.

suggestedInsertionIds[]

string

Gli ID di inserzione suggeriti. Un TableRow 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 è 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 di inizio di questa cella basato su zero, in unità di codice UTF-16.

endIndex

integer

L'indice di fine di questa cella, esclusivo, basato su zero in 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, 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.

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)

Il bordo superiore della cella.

borderBottom

object (TableCellBorder)

Il 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)

Il riempimento 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 all'allineamento delle celle della tabella appena create nell'editor di Documenti.

TableCellBorder

Un bordo intorno a una cella della tabella.

I bordi delle celle della tabella non possono essere trasparenti. Per nascondere il bordo di una cella della tabella, imposta la relativa 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 tratto del bordo.

ContentAlignment

I tipi di allineamento dei contenuti.

Derivato da un sottoinsieme di valori del tipo semplice "ST_TextAnchoringType" nella sezione 20.1.10.59 di "Office Open XML File Formats - 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 Un 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 TableCellStyle.

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

object (TableCellStyle)

Un TableCellStyle che include solo le modifiche apportate in questo suggerimento. Questa opzione può essere utilizzata 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, è disponibile un nuovo valore suggerito.

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 con un'altezza uguale o superiore a questo valore per mostrare tutti i contenuti delle celle della riga.

tableHeader

boolean

Indica se la riga è un'intestazione della tabella.

preventOverflow

boolean

Indica se la riga non può superare i limiti di pagina o colonna.

SuggestedTableRowStyle

Una modifica suggerita a 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, è disponibile un nuovo valore suggerito.

Rappresentazione JSON
{
  "minRowHeightSuggested": boolean
}
Campi
minRowHeightSuggested

boolean

Indica se è stata suggerita una modifica a minRowHeight.

TableStyle

Stili applicati 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 a 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. Impostato quando il valore 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 rimarrà una porzione uguale della larghezza per la tabella dopo aver tenuto conto di tutte le colonne con larghezze specificate.

FIXED_WIDTH Una larghezza di 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 inserimento suggeriti. Un TableOfContents 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 è vuoto, significa che non sono state suggerite eliminazioni 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 di useEvenPageHeaderFooter determina se utilizzare defaultHeaderId o questo valore per l'intestazione nelle pagine pari. Se non viene configurato, l'intestazione di pagina uniforme non viene visualizzata.

Questa proprietà è di sola lettura.

firstPageHeaderId

string

L'ID dell'intestazione utilizzato solo per la prima pagina. Se non è impostato, 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 della pagina nello stile del documento ne cancella il valore in tutti gli stili di sezione.

marginBottom

object (Dimension)

Margine inferiore della pagina.

L'aggiornamento del margine inferiore della pagina nello stile del documento ne cancella il valore 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, potrebbe causare il ridimensionamento delle colonne in tutte le sezioni.

marginLeft

object (Dimension)

Il margine sinistro della pagina.

L'aggiornamento del margine sinistro della pagina nello stile del documento cancella il margine sinistro della pagina 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 del 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 elemento DocumentStyle che include solo le modifiche apportate in questo suggerimento. Questo comando può essere utilizzato insieme a documentStyleSuggestionState per vedere quali campi sono stati modificati e i relativi nuovi valori.

documentStyleSuggestionState

object (DocumentStyleSuggestionState)

Una maschera che indica quali campi nella 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, è disponibile un nuovo valore suggerito.

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 in 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 dei campi in [size] [google.apps.docs.v1.DocumentStyle.size] sono stati modificati 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 della base Background sono stati modificati in questo suggerimento. Per qualsiasi campo impostato su true, Backgound ha un nuovo valore suggerito.

Rappresentazione JSON
{
  "backgroundColorSuggested": boolean
}
Campi
backgroundColorSuggested

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 di paragrafo di questo stile denominato.

SuggestedNamedStyles

Una modifica suggerita al NamedStyles.

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

object (NamedStyles)

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

namedStylesSuggestionState

object (NamedStylesSuggestionState)

Una maschera che indica quali campi della 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 del suggerimento di stile denominato corrisponde all'ordine dello stile denominato corrispondente all'interno del suggerimento named styles.

NamedStyleSuggestionState

Uno stato del 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 comodità per abbinare NamedStyleSuggestionState al relativo NamedStyle.

textStyleSuggestionState

object (TextStyleSuggestionState)

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

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

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

Elenco

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

Rappresentazione JSON
{
  "listProperties": {
    object (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, con chiave in base all'ID suggerimento.

suggestedInsertionId

string

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

suggestedDeletionIds[]

string

Gli ID 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 punti 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 il pattern %[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 sottoposto a rendering 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 del glifo può contenere segnaposto per il livello di nidificazione corrente e per i livelli di nidificazione principali. Ad esempio, un elenco può avere un formato di glifo %0. a livello di nidificazione 0 e un formato di 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 ordinati, la stringa che sostituisce un segnaposto nel formato dei glifi per un determinato paragrafo dipende dall'ordine del paragrafo all'interno dell'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 dei contenuti del paragrafo.

textStyle

object (TextStyle)

Lo stile del 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 0 e 1, gli elenchi di lettere e numeri romani inizieranno rispettivamente da a e i.

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

Campo unione glyph_kind. Il tipo di glifo utilizzato 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 di glifo personalizzato utilizzato dai numeri quando i paragrafi a questo livello di nidificazione non sono ordinati.

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 da sinistra a destra, 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 da sinistra a destra, allineato a sinistra in caso contrario.

GlyphType

I tipi di glifi utilizzati dai numeri quando i paragrafi a questo livello di nidificazione sono ordinati.

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 le cifre singole sono precedute da uno zero, ad esempio 01, 02 o 03. I numeri con più di una cifra non hanno un prefisso 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 della base ListProperties sono stati modificati in questo suggerimento.

ListPropertiesSuggestionState

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

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

object (NestingLevelSuggestionState)

Una maschera che indica quali campi di NestingLevel in nestingLevels corrispondenti sono stati modificati in questo suggerimento.

Gli stati del suggerimento per il livello di nidificazione vengono restituiti in ordine crescente del livello di nidificazione, con il livello 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, è disponibile un nuovo valore suggerito.

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 in 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 con nome 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 un secondo momento tramite programmazione. 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 visualizzarne gli intervalli denominati.

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 è incluso questo intervallo. Un ID segmento vuoto indica il corpo del documento.

startIndex

integer

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

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

endIndex

integer

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

In tutti gli utilizzi attuali, è necessario fornire un indice finale. Questo campo è un valore Int32Value per supportare 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 specificato, 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 InlineObject contiene un EmbeddedObject, ad esempio 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 di 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.

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)

Il margine inferiore dell'oggetto incorporato.

marginRight

object (Dimension)

Il margine destro dell'oggetto incorporato.

marginLeft

object (Dimension)

Il margine sinistro dell'oggetto incorporato.

linkedContentReference

object (LinkedContentReference)

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

Se non viene configurato, 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)

Le 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 abbia l'URI accede all'immagine come richiedente originale. Se le impostazioni di condivisione del documento cambiano, l'accesso all'immagine potrebbe andare perso.

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 è posizionato all'interno del rettangolo delimitante 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 la distanza interna del bordo sinistro del rettangolo di ritaglio dal bordo sinistro dei contenuti originali come frazione della larghezza dei contenuti originali.

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 la distanza interna del bordo superiore del rettangolo di ritaglio dal bordo superiore dei contenuti originali sotto forma di frazione dell'altezza dei contenuti originali.

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 trattino del bordo.

propertyState

enum (PropertyState)

Lo stato della proprietà del bordo.

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 di origine 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 a InlineObjectProperties.

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

object (InlineObjectProperties)

Un InlineObjectProperties che include solo le modifiche apportate in questo suggerimento. Questo comando può essere utilizzato 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 della 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 di embeddedObject sono stati modificati in questo suggerimento.

EmbeddedObjectSuggestionState

Una maschera che indica quali campi della 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 in 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 in linkedContentReference sono stati modificati in questo suggerimento.

EmbeddedDrawingPropertiesSuggestionState

Questo tipo non contiene campi.

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

ImagePropertiesSuggestionState

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

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 [brightness] [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 [transparency] [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 nella base CropProperties sono stati modificati in questo suggerimento. Per ogni campo impostato su true, è disponibile un nuovo valore suggerito.

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 della base EmbeddedObjectBorder sono stati modificati in questo suggerimento. Per ogni campo impostato su true, è disponibile un nuovo valore suggerito.

Rappresentazione JSON
{
  "colorSuggested": boolean,
  "widthSuggested": boolean,
  "dashStyleSuggested": boolean,
  "propertyStateSuggested": boolean
}
Campi
colorSuggested

boolean

Indica se è stata suggerita una modifica a [colore] [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 in [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 della 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 della base SheetsChartReference sono stati modificati in questo suggerimento. Per ogni campo impostato su true, è disponibile un nuovo valore suggerito.

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à degli oggetti posizionati, con chiave in base all'ID suggerimento.

suggestedInsertionId

string

L'ID inserzione suggerito. 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.

PositionedObjectProperties

Proprietà di un PositionedObject.

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

object (PositionedObjectPositioning)

Il posizionamento dell'oggetto posizionato rispetto alla nuova riga di Paragraph che fa riferimento all'oggetto posizionato.

embeddedObject

object (EmbeddedObject)

L'oggetto incorporato di questo oggetto posizionato.

PositionedObjectPositioning

Il posizionamento di un PositionedObject. L'oggetto posizionato viene posizionato in base all'inizio del Paragraph a cui è agganciato.

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.

topOffset

object (Dimension)

L'offset del bordo superiore 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.

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 sia a sinistra e il testo a destra.
BREAK_RIGHT Interrompe il testo in modo che l'oggetto posizionato sia a destra e il testo a sinistra.
BREAK_LEFT_RIGHT Interrompe il testo in modo che non ci sia testo a sinistra o a destra dell'oggetto posizionato.
IN_FRONT_OF_TEXT L'oggetto posizionato si trova davanti al testo.
BEHIND_TEXT L'oggetto posizionato si trova dietro il testo.

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. Questo comando può essere utilizzato 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 nella base PositionedObjectProperties sono stati modificati in questo suggerimento. Per ogni campo impostato su true, è disponibile un nuovo valore suggerito.

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

object (PositionedObjectPositioningSuggestionState)

Una maschera che indica quali campi in 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 della 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 La modalità di visualizzazione dei suggerimenti applicata al documento restituito dipende dal livello di accesso corrente dell'utente. Se l'utente dispone solo dell'accesso in visualizzazione, viene applicato PREVIEW_WITHOUT_SUGGESTIONS. In caso contrario, viene applicato SUGGESTIONS_INLINE. Questa è la modalità di visualizzazione dei suggerimenti predefinita.
SUGGESTIONS_INLINE

Il documento restituito contiene suggerimenti incorporati. Le modifiche suggerite saranno differenziate 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 con tutte le modifiche suggerite rifiutate, se presenti.

Metodi

batchUpdate

Applica uno o più aggiornamenti al documento.

create

Crea un documento vuoto utilizzando il titolo specificato nella richiesta.

get

Recupera la versione più recente del documento specificato.