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 all'interno di un'altra scheda. Le schede secondarie sono rappresentate dal campo Tab.child_tabs.

revisionId

string

Solo output. L'ID revisione del documento. Può essere utilizzato nelle richieste di aggiornamento per specificare a quale revisione di un documento applicare gli aggiornamenti e come dovrebbe comportarsi la richiesta se il documento è stato modificato dopo quella revisione. Compilato solo se l'utente ha accesso in modifica al documento.

L'ID revisione non è un numero sequenziale, ma una stringa opaca. Il formato dell'ID revisione potrebbe cambiare nel tempo. Un ID revisione restituito è garantito di essere valido solo per 24 ore dalla restituzione e non può essere condiviso tra gli utenti. Se l'ID revisione è rimasto invariato tra una chiamata e l'altra, il documento non è cambiato. 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.document_tab.body, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se false o non viene configurato, questo campo contiene informazioni sulla prima scheda del documento.

headers

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

Solo output. Le intestazioni nel documento, digitate dall'ID intestazione.

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

footers

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

Solo output. I piè di pagina nel documento, digitati dall'ID piè di pagina.

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

footnotes

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

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

Campo precedente: utilizza invece Document.tabs.document_tab.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.document_tab.document_style, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se false o non viene configurato, questo campo contiene informazioni sulla prima scheda del documento.

suggestedDocumentStyleChanges

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

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

Campo precedente: utilizza invece Document.tabs.document_tab.suggested_document_style_changes, 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 con nome del documento.

Campo precedente: utilizza invece Document.tabs.document_tab.named_styles, 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.

suggestedNamedStylesChanges

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

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

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

lists

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

Solo output. Elenchi nel documento, digitati per ID elenco.

Campo precedente: utilizza invece Document.tabs.document_tab.lists, 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.

namedRanges

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

Solo output. Intervalli denominati nel documento, digitati per nome.

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

inlineObjects

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

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

Campo precedente: utilizza invece Document.tabs.document_tab.inline_objects, 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.document_tab.positioned_objects, 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.

TAB

Una scheda in un documento.

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

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

object (TabProperties)

Le proprietà della scheda, come ID e titolo.

childTabs[]

object (Tab)

Le schede secondarie nidificate all'interno di questa scheda.

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

object (DocumentTab)

Una scheda con contenuti di documenti, 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 è una scheda di livello principale, il che significa che non ha nessuna scheda padre.

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 directory principale iniziano da 0.

DocumentTab

Una scheda con contenuti di documenti.

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

object (Body)

Il corpo principale della scheda del documento.

headers

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

Le intestazioni nella scheda del documento, digitate dall'ID intestazione.

footers

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

I piè di pagina nella scheda del documento, separati dall'ID del piè di pagina.

footnotes

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

Le note a piè di pagina nella scheda del documento, digitate dall'ID della nota a piè di pagina.

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, contrassegnate dall'ID suggerimento.

namedStyles

object (NamedStyles)

Gli stili con nome della scheda del documento.

suggestedNamedStylesChanges

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

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

lists

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

Elenchi nella scheda del documento, codificati per ID elenco.

namedRanges

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

Intervalli denominati nella scheda del documento, digitati per nome.

inlineObjects

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

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

positionedObjects

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

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

Corpo

Il corpo del documento.

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

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

object (StructuralElement)

I contenuti del corpo.

Gli indici dei contenuti del corpo iniziano da zero.

StructuralElement

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

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

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

integer

L'indice iniziale su base zero di questo elemento strutturale, nelle unità di codice UTF-16.

endIndex

integer

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

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

object (Paragraph)

Un tipo di paragrafo di elemento strutturale.

sectionBreak

object (SectionBreak)

Un tipo di interruzione di sezione di un elemento strutturale.

table

object (Table)

Un tipo di tabella di elemento strutturale.

tableOfContents

object (TableOfContents)

Un tipo di sommario di un elemento strutturale.

Paragrafo

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

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

object (ParagraphElement)

I contenuti del paragrafo, suddivisi nelle sue parti che lo compongono.

paragraphStyle

object (ParagraphStyle)

Lo stile di questo paragrafo.

suggestedParagraphStyleChanges

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

Lo stile del paragrafo suggerito viene modificato in questo paragrafo, specificato dall'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 di questo paragrafo.

positionedObjectIds[]

string

Gli ID degli oggetti posizionati collegati in tethering a questo paragrafo.

suggestedPositionedObjectIds

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

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

ParagraphElement

Un ParagraphElement descrive i contenuti all'interno di un elemento 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 in base zero di questo elemento paragrafo, nelle unità di codice UTF-16.

endIndex

integer

L'indice finale a base zero di questo elemento paragrafo, escluso, nelle 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 text run paragraph.

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 di paragrafo con interruzione di colonna.

footnoteReference

object (FootnoteReference)

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

horizontalRule

object (HorizontalRule)

Un elemento di paragrafo con riga orizzontale.

equation

object (Equation)

Un elemento di paragrafo equazione.

inlineObjectElement

object (InlineObjectElement)

Un elemento di paragrafo di un oggetto incorporato.

person

object (Person)

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

TextRun

Un ParagraphElement che rappresenta un run of text che ha tutti lo stesso stile.

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

string

Il testo di questa esecuzione.

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

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

Lo stile del testo di questa esecuzione.

suggestedTextStyleChanges

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

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

Stile testo

Rappresenta lo stile che può essere applicato al testo.

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

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

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

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

boolean

Indica se il testo viene visualizzato o meno in grassetto.

italic

boolean

Indica se il testo è in corsivo.

underline

boolean

Indica se il testo è sottolineato o meno.

strikethrough

boolean

Indica se il testo è barrato o meno.

smallCaps

boolean

Indica se il testo è in minuscolo.

backgroundColor

object (OptionalColor)

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

foregroundColor

object (OptionalColor)

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

fontSize

object (Dimension)

La dimensione del carattere del testo.

weightedFontFamily

object (WeightedFontFamily)

La famiglia di caratteri e lo spessore visualizzato del testo.

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

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

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

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, compreso tra 0,0 e 1,0.

green

number

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

blue

number

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

Dimensione

Una grandezza in un'unica direzione nelle unità specificate.

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

number

La grandezza.

unit

enum (Unit)

Le unità di grandezza.

Unità

Unità di misura.

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

WeightedFontFamily

Rappresenta una famiglia di caratteri e lo spessore del testo.

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

string

La famiglia di caratteri del testo.

La famiglia di caratteri può essere qualsiasi carattere disponibile nel menu Caratteri in Documenti o in Google Fonts. Se il nome del carattere non 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 inclusi. 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 del valore bold risolto di weight e dello stile di testo determina la ponderazione visualizzata, dopo aver tenuto conto dell'ereditarietà:

  • Se il testo è in grassetto e la ponderazione è inferiore a 400, la ponderazione visualizzata è 400.
  • Se il testo è in grassetto e la ponderazione è maggiore o uguale a 400 ma è inferiore a 700, la ponderazione visualizzata è 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 L'offset della base di riferimento del testo viene ereditato dall'elemento principale.
NONE Il testo non è spostato verticalmente.
SUPERSCRIPT Il testo è sfalsato verticalmente verso l'alto (apice).
SUBSCRIPT Il testo è sfalsato verticalmente verso il basso (pedice).

SuggestedTextStyle

Una modifica suggerita a TextStyle.

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

object (TextStyle)

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

textStyleSuggestionState

object (TextStyleSuggestionState)

Una maschera che indica quali campi 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 nel testo che viene sostituito dinamicamente con contenuti che possono cambiare nel tempo, come un numero di pagina.

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

enum (Type)

Il tipo di questo testo automatico.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

Lo stile del 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 Tipo di testo automatico che rappresenta il numero di pagina corrente.
PAGE_COUNT Tipo di testo automatico che rappresenta il numero totale di pagine nel documento.

PageBreak

Un elemento ParagraphElement che rappresenta un'interruzione di pagina. Un'interruzione di pagina fa iniziare il testo successivo nella parte superiore della pagina successiva.

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

string

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

Lo stile del testo di questa interruzione di pagina.

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 viene modificato in questa interruzione di pagina, contrassegnata dall'ID suggerimento.

ColumnBreak

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

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

string

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

Lo stile del testo di questa interruzione colonna.

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 una nota a piè di pagina. Un riferimento a nota a piè di pagina è il contenuto in linea visualizzato con un numero e viene utilizzato per identificare la nota a piè di pagina.

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

string

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

footnoteNumber

string

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

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Gli ID di eliminazione suggeriti. Se viene lasciato vuoto, non sono previste eliminazioni suggerite 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 del testo suggerito viene modificato in questo piè di pagina, specificato dall'ID suggerimento.

HorizontalRule

Un ParagraphElement che rappresenta una linea orizzontale.

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

string

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

Lo stile del testo di questa regola orizzontale.

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

suggestedTextStyleChanges

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

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

Equazione

Un ParagraphElement che rappresenta un'equazione.

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

string

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

suggestedDeletionIds[]

string

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

InlineObjectElement

Un elemento ParagraphElement che contiene un elemento InlineObject.

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

string

L'ID del InlineObject contenuto in questo elemento.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

Lo stile del testo di questo InlineObjectElement.

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

suggestedTextStyleChanges

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

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

Persona

Una persona o un indirizzo email menzionati in un documento. Queste menzioni si comportano come un singolo elemento immutabile contenente il nome o l'indirizzo email della persona.

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

string

Solo output. L'ID univoco di questo collegamento.

suggestedInsertionIds[]

string

ID per i suggerimenti che inseriscono il link di questa persona nel documento. Un Person potrebbe avere più ID inserimento se si tratta di una modifica suggerita nidificata (ad esempio, un suggerimento all'interno di un suggerimento apportato da un altro utente). Se vuoto, il link di 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 elemento: Person.

suggestedTextStyleChanges

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

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

personProperties

object (PersonProperties)

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

PersonProperties

Proprietà specifiche di un Person collegato.

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

string

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

email

string

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

RichLinkProperties

Proprietà specifiche di un RichLink.

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

string

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

uri

string

Solo output. L'URI di RichLink. È sempre presente.

mimeType

string

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

Stile paragrafo

Stili che si applicano a un intero paragrafo.

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

  • Il parametro ParagraphStyle su un Paragraph eredita dal valore named style type corrispondente del paragrafo.
  • Il parametro ParagraphStyle su un named style eredita dallo stile denominato normal text.
  • Il ParagraphStyle dello stile denominato normal text eredita dallo stile di paragrafo predefinito nell'editor di documenti.
  • ParagraphStyle su 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 intestazione del paragrafo. Se è vuoto, questo paragrafo non è un'intestazione.

Questa proprietà è di sola lettura.

namedStyleType

enum (NamedStyleType)

Il tipo di stile denominato del paragrafo.

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

alignment

enum (Alignment)

L'allineamento del testo di questo paragrafo.

lineSpacing

number

La quantità di spazio tra le 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 viene configurato, il valore predefinito è LEFT_TO_RIGHT, poiché la direzione del paragrafo non viene ereditata.

spacingMode

enum (SpacingMode)

La modalità di spaziatura del paragrafo.

spaceAbove

object (Dimension)

La quantità di spazio aggiuntivo sopra il paragrafo. Se non viene configurato, il valore viene ereditato dall'unità organizzativa principale.

spaceBelow

object (Dimension)

La quantità di spazio aggiuntivo sotto il paragrafo. Se non viene configurato, il valore viene ereditato dall'unità organizzativa principale.

borderBetween

object (ParagraphBorder)

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

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

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

borderTop

object (ParagraphBorder)

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

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

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

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 seguente ha proprietà diverse per i bordi e il rientro.

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

borderLeft

object (ParagraphBorder)

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

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

borderRight

object (ParagraphBorder)

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

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

indentFirstLine

object (Dimension)

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

indentStart

object (Dimension)

La quantità di rientro del paragrafo sul lato corrispondente all'inizio del testo, in base alla direzione del paragrafo corrente. Se non viene configurato, il valore viene ereditato dall'unità organizzativa 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 viene configurato, il valore viene ereditato dall'unità organizzativa principale.

tabStops[]

object (TabStop)

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

Questa proprietà è di sola lettura.

keepLinesTogether

boolean

Indica se tutte le righe del paragrafo devono essere disposte sulla stessa pagina o colonna, se possibile. Se non viene configurato, il valore viene ereditato dall'unità organizzativa principale.

keepWithNext

boolean

Indica se almeno una parte di questo paragrafo deve essere posizionata nella stessa pagina o colonna del paragrafo successivo, se possibile. Se non viene configurato, il valore viene ereditato dall'unità organizzativa principale.

avoidWidowAndOrphan

boolean

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

shading

object (Shading)

L'ombreggiatura del paragrafo. Se non viene configurato, il valore viene ereditato dall'unità organizzativa principale.

pageBreakBefore

boolean

Indica se il paragrafo corrente deve iniziare sempre all'inizio di una pagina. Se non viene configurato, il valore viene ereditato dall'unità organizzativa 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 di un paragrafo.

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

ContentDirection

Le direzioni stradali dei contenuti.

Enum
CONTENT_DIRECTION_UNSPECIFIED La direzione del contenuto non è specificata.
LEFT_TO_RIGHT I contenuti vanno da sinistra a destra.
RIGHT_TO_LEFT I contenuti vanno da destra a sinistra.

SpacingMode

Le diverse modalità per la spaziatura dei paragrafi.

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

ParagraphBorder

Un bordo intorno 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 visualizzare la geometria lineare. Questi valori si basano su "ST_PresetLineDashVal" tipo semplice descritto nella sezione 20.1.10.48 di "Office Open XML FileFormats - 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 "solid" di ECMA-376 ST_PresetLineDashVal. Questo è lo stile predefinito del trattino.
DOT Linea punteggiata. Corrisponde al valore "dot" di ECMA-376 ST_PresetLineDashVal.
DASH Linea tratteggiata. Corrisponde al valore "dash" di ECMA-376 ST_PresetLineDashVal.

TabStop

Una tabulazione all'interno di un paragrafo.

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

object (Dimension)

L'offset tra questa tabulazione e il margine iniziale.

alignment

enum (TabStopAlignment)

L'allineamento di questa tabulazione. Se non viene configurato, il valore predefinito è START.

TabStopAlignment

L'allineamento della tabulazione.

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

Ombreggiatura

L'ombreggiatura di un paragrafo.

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

object (OptionalColor)

Il colore di sfondo dell'ombreggiatura del paragrafo.

SuggestedParagraphStyle

Una modifica suggerita a ParagraphStyle.

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

object (ParagraphStyle)

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

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

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

ParagraphStyleSuggestionState

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

Rappresentazione JSON
{
  "headingIdSuggested": boolean,
  "namedStyleTypeSuggested": boolean,
  "alignmentSuggested": boolean,
  "lineSpacingSuggested": boolean,
  "directionSuggested": boolean,
  "spacingModeSuggested": boolean,
  "spaceAboveSuggested": boolean,
  "spaceBelowSuggested": boolean,
  "borderBetweenSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "indentFirstLineSuggested": boolean,
  "indentStartSuggested": boolean,
  "indentEndSuggested": boolean,
  "keepLinesTogetherSuggested": boolean,
  "keepWithNextSuggested": boolean,
  "avoidWidowAndOrphanSuggested": boolean,
  "shadingSuggestionState": {
    object (ShadingSuggestionState)
  },
  "pageBreakBeforeSuggested": boolean
}
Campi
headingIdSuggested

boolean

Indica se è stata suggerita una modifica a headingId.

namedStyleTypeSuggested

boolean

Indica se è stata suggerita una modifica a namedStyleType.

alignmentSuggested

boolean

Indica se è stata suggerita una modifica a alignment.

lineSpacingSuggested

boolean

Indica se è stata suggerita una modifica a lineSpacing.

directionSuggested

boolean

Indica se è stata suggerita una modifica a direction.

spacingModeSuggested

boolean

Indica se è stata suggerita una modifica a spacingMode.

spaceAboveSuggested

boolean

Indica se è stata suggerita una modifica a spaceAbove.

spaceBelowSuggested

boolean

Indica se è stata suggerita una modifica a spaceBelow.

borderBetweenSuggested

boolean

Indica se è stata suggerita una modifica a borderBetween.

borderTopSuggested

boolean

Indica se è stata suggerita una modifica a borderTop.

borderBottomSuggested

boolean

Indica se è stata suggerita una modifica a borderBottom.

borderLeftSuggested

boolean

Indica se è stata suggerita una modifica a borderLeft.

borderRightSuggested

boolean

Indica se è stata suggerita una modifica a borderRight.

indentFirstLineSuggested

boolean

Indica se è stata suggerita una modifica a indentFirstLine.

indentStartSuggested

boolean

Indica se è stata suggerita una modifica a indentStart.

indentEndSuggested

boolean

Indica se è stata suggerita una modifica a indentEnd.

keepLinesTogetherSuggested

boolean

Indica se è stata suggerita una modifica a keepLinesTogether.

keepWithNextSuggested

boolean

Indica se è stata suggerita una modifica a keepWithNext.

avoidWidowAndOrphanSuggested

boolean

Indica se è stata suggerita una modifica a avoidWidowAndOrphan.

shadingSuggestionState

object (ShadingSuggestionState)

Una maschera che indica quali campi di 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 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. Questa opzione può essere utilizzata insieme a bulletSuggestionState per vedere quali campi sono stati modificati e i relativi nuovi valori.

bulletSuggestionState

object (BulletSuggestionState)

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

BulletSuggestionState

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

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

boolean

Indica se è stata suggerita una modifica a listId.

nestingLevelSuggested

boolean

Indica se è stata suggerita una modifica 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 rappresenta l'inizio di una nuova sezione e lo stile viene applicato alla sezione successiva all'interruzione.

Il corpo del documento inizia sempre con un'interruzione 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 inserimento se si tratta di una modifica suggerita nidificata. Se vuoto, questo non è un inserimento suggerito.

suggestedDeletionIds[]

string

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

sectionStyle

object (SectionStyle)

Lo stile della sezione dopo questa interruzione.

SectionStyle

Lo stile che si applica 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 annulli questa proprietà, verrà visualizzato un errore 400 di richiesta errata.

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 annulli questa proprietà, viene generato un errore di richiesta non valido 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 annulli questa proprietà, viene generato un errore di richiesta non valido 400.

marginBottom

object (Dimension)

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

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

marginRight

object (Dimension)

Il margine della pagina destro della sezione. Se non viene configurato, il valore predefinito è marginRight in DocumentStyle. L'aggiornamento del margine destro determina 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 annulli questa proprietà, viene generato un errore di richiesta non valido 400.

marginLeft

object (Dimension)

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

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli questa proprietà, viene generato un errore di richiesta non valido 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 il margine dell'intestazione viene rispettato per la sezione.

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

sectionType

enum (SectionType)

Solo output. Il tipo di sezione.

defaultHeaderId

string

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

Questa proprietà è di sola lettura.

firstPageHeaderId

string

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

Questa proprietà è di sola lettura.

evenPageHeaderId

string

L'ID dell'intestazione utilizzato solo per le pagine pari. Se il valore di useEvenPageHeaderFooter di DocumentStyle è true, questo valore viene utilizzato per le intestazioni nelle pagine pari della sezione. Se è false, le intestazioni nelle pagine pari utilizzano defaultHeaderId. Se non viene configurato, il valore eredita dal precedente elemento SectionStyle SectionBreak's. Se il valore non viene impostato nella prima Interruzione di sezione, viene ereditato dall'elemento 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 viene impostato nei primi 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 invertire le dimensioni di pageSize di DocumentStyle per questa sezione, il che consente di modificare l'orientamento della pagina da verticale a orizzontale. Se non viene configurato, il valore eredita dall'elemento flipPageOrientation di DocumentStyle.

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

SectionColumnProperties

Proprietà applicabili 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 del separatore di colonna non specificato.
NONE Nessuna riga di separazione delle colonne tra le colonne.
BETWEEN_EACH_COLUMN Visualizza una riga separatore di colonna tra ogni colonna.

SectionType

Rappresenta il posizionamento dell'inizio della sezione corrente rispetto alla sezione precedente.

Enum
SECTION_TYPE_UNSPECIFIED Il tipo di sezione non è specificato.
CONTINUOUS La sezione inizia subito dopo l'ultimo paragrafo della sezione precedente.
NEXT_PAGE La sezione inizia nella pagina successiva.

Tabella

Un StructuralElement che rappresenta una tabella.

Rappresentazione JSON
{
  "rows": integer,
  "columns": integer,
  "tableRows": [
    {
      object (TableRow)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableStyle": {
    object (TableStyle)
  }
}
Campi
rows

integer

Numero di righe nella tabella.

columns

integer

Numero di colonne nella tabella.

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

tableRows[]

object (TableRow)

I contenuti e lo stile di ogni riga.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

tableStyle

object (TableStyle)

Lo stile della tabella.

TableRow

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

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

integer

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

endIndex

integer

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

tableCells[]

object (TableCell)

Contenuti e stile di ogni cella di questa riga.

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

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Gli ID di eliminazione suggeriti. Se viene lasciato vuoto, non sono previste eliminazioni suggerite 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, specificato dall'ID suggerimento.

TableCell

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

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

integer

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

endIndex

integer

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

content[]

object (StructuralElement)

Il contenuto della cella.

tableCellStyle

object (TableCellStyle)

Lo stile della cella.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

suggestedTableCellStyleChanges

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

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

TableCellStyle

Lo stile di un TableCell.

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

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

integer

L'intervallo di righe della cella.

Questa proprietà è di sola lettura.

columnSpan

integer

L'intervallo di colonne della cella.

Questa proprietà è di sola lettura.

backgroundColor

object (OptionalColor)

Il colore di sfondo della cella.

borderLeft

object (TableCellBorder)

Il bordo sinistro della cella.

borderRight

object (TableCellBorder)

Il bordo destro della cella.

borderTop

object (TableCellBorder)

Bordo superiore della cella.

borderBottom

object (TableCellBorder)

Bordo inferiore della cella.

paddingLeft

object (Dimension)

La spaziatura interna sinistra della cella.

paddingRight

object (Dimension)

La spaziatura interna destra della cella.

paddingTop

object (Dimension)

Spaziatura interna superiore della cella.

paddingBottom

object (Dimension)

La spaziatura interna inferiore della cella.

contentAlignment

enum (ContentAlignment)

L'allineamento dei contenuti nella cella della tabella. L'allineamento predefinito corrisponde a quello delle celle delle tabelle 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, imposta la larghezza su 0.

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

object (OptionalColor)

Il colore del bordo.

Questo colore non può essere trasparente.

width

object (Dimension)

La larghezza del bordo.

dashStyle

enum (DashStyle)

Lo stile del trattino del bordo.

ContentAlignment

I tipi di allineamento dei contenuti.

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

Enum
CONTENT_ALIGNMENT_UNSPECIFIED Un allineamento dei contenuti non specificato. L'allineamento dei contenuti viene ereditato dall'elemento principale, se esistente.
CONTENT_ALIGNMENT_UNSUPPORTED Allineamento dei contenuti non supportato.
TOP Allineamento che allinea i contenuti alla parte superiore del contenitore dei contenuti. Corrisponde a ECMA-376 ST_TextAnchoringType "t".
MIDDLE Allineamento che allinea i contenuti al centro del contenitore dei contenuti. Corrisponde a ECMA-376 ST_TextAnchoringType "ctr".
BOTTOM 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 elemento 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 nella base TableCellStyle sono stati modificati in questo suggerimento.

TableCellStyleSuggestionState

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

Rappresentazione JSON
{
  "rowSpanSuggested": boolean,
  "columnSpanSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "paddingLeftSuggested": boolean,
  "paddingRightSuggested": boolean,
  "paddingTopSuggested": boolean,
  "paddingBottomSuggested": boolean,
  "contentAlignmentSuggested": boolean
}
Campi
rowSpanSuggested

boolean

Indica se è stata suggerita una modifica a rowSpan.

columnSpanSuggested

boolean

Indica se è stata suggerita una modifica a columnSpan.

backgroundColorSuggested

boolean

Indica se è stata suggerita una modifica a backgroundColor.

borderLeftSuggested

boolean

Indica se è stata suggerita una modifica a borderLeft.

borderRightSuggested

boolean

Indica se è stata suggerita una modifica a borderRight.

borderTopSuggested

boolean

Indica se è stata suggerita una modifica a borderTop.

borderBottomSuggested

boolean

Indica se è stata suggerita una modifica a borderBottom.

paddingLeftSuggested

boolean

Indica se è stata suggerita una modifica a paddingLeft.

paddingRightSuggested

boolean

Indica se è stata suggerita una modifica a paddingRight.

paddingTopSuggested

boolean

Indica se è stata suggerita una modifica a paddingTop.

paddingBottomSuggested

boolean

Indica se è stata suggerita una modifica a paddingBottom.

contentAlignmentSuggested

boolean

Indica se è stata suggerita una modifica a contentAlignment.

TableRowStyle

Stili che si applicano a una riga della tabella.

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

object (Dimension)

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

tableHeader

boolean

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

preventOverflow

boolean

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

SuggestedTableRowStyle

Una modifica suggerita a TableRowStyle.

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

object (TableRowStyle)

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

tableRowStyleSuggestionState

object (TableRowStyleSuggestionState)

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

TableRowStyleSuggestionState

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

Rappresentazione JSON
{
  "minRowHeightSuggested": boolean
}
Campi
minRowHeightSuggested

boolean

Indica se è stata suggerita una modifica a minRowHeight.

TableStyle

Stili applicabili a una tabella.

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

object (TableColumnProperties)

Le proprietà di ogni colonna.

Tieni presente che in Documenti le tabelle contengono righe e le righe contengono celle, in modo simile all'HTML. Di conseguenza, le proprietà di una riga si trovano nel relativo tableRowStyle.

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 avrà una porzione uguale della larghezza rimanente per la tabella dopo aver considerato 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, questo non è un inserimento suggerito.

suggestedDeletionIds[]

string

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

Piè di pagina

Una nota a piè di pagina di un documento.

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

string

L'ID della nota a piè di pagina.

content[]

object (StructuralElement)

I contenuti della nota a piè di pagina.

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

DocumentStyle

Lo stile del documento.

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

object (Background)

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

defaultHeaderId

string

L'ID dell'intestazione predefinita. Se non viene configurato, non esiste un'intestazione predefinita.

Questa proprietà è di sola lettura.

evenPageHeaderId

string

L'ID dell'intestazione utilizzato solo per le pagine pari. Il valore 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 il criterio non viene configurato, non esiste un'intestazione univoca per la prima pagina. Il valore useFirstPageHeaderFooter determina se utilizzare defaultHeaderId o questo valore per l'intestazione nella 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 il conteggio del numero di pagine.

marginTop

object (Dimension)

Margine superiore della pagina.

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

marginBottom

object (Dimension)

Margine inferiore della pagina.

L'aggiornamento del margine inferiore pagina per lo stile del documento elimina il margine inferiore della pagina in tutti gli stili di sezione.

marginRight

object (Dimension)

Il margine della pagina destro.

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

marginLeft

object (Dimension)

Il margine sinistro della pagina.

L'aggiornamento del margine sinistro della pagina nello stile del documento consente di cancellare il margine sinistro di tutti gli stili di sezione. Inoltre, le colonne potrebbero essere ridimensionate in tutte le sezioni.

pageSize

object (Size)

Le dimensioni di una pagina nel documento.

marginHeader

object (Dimension)

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

flipPageOrientation

boolean

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

Sfondo

Rappresenta lo sfondo di un documento.

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

object (OptionalColor)

Il colore di sfondo.

Dimensioni

Una larghezza e un'altezza.

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

object (Dimension)

L'altezza dell'oggetto.

width

object (Dimension)

La larghezza dell'oggetto.

SuggestedDocumentStyle

Una modifica suggerita per 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. Questa opzione può essere utilizzata insieme a documentStyleSuggestionState per vedere quali campi sono stati modificati e i relativi nuovi valori.

documentStyleSuggestionState

object (DocumentStyleSuggestionState)

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

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

object (BackgroundSuggestionState)

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

defaultHeaderIdSuggested

boolean

Indica se è stata suggerita una modifica a defaultHeaderId.

evenPageHeaderIdSuggested

boolean

Indica se è stata suggerita una modifica a evenPageHeaderId.

firstPageHeaderIdSuggested

boolean

Indica se è stata suggerita una modifica a firstPageHeaderId.

pageNumberStartSuggested

boolean

Indica se è stata suggerita una modifica a pageNumberStart.

marginTopSuggested

boolean

Indica se è stata suggerita una modifica a marginTop.

marginBottomSuggested

boolean

Indica se è stata suggerita una modifica a marginBottom.

marginRightSuggested

boolean

Indica se è stata suggerita una modifica a marginRight.

marginLeftSuggested

boolean

Indica se è stata suggerita una modifica a marginLeft.

pageSizeSuggestionState

object (SizeSuggestionState)

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

marginHeaderSuggested

boolean

Indica se è stata suggerita una modifica a marginHeader.

flipPageOrientationSuggested

boolean

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

BackgroundSuggestionState

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

Rappresentazione JSON
{
  "backgroundColorSuggested": boolean
}
Campi
backgroundColorSuggested

boolean

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

SizeSuggestionState

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

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 nel documento possono ereditare i relativi TextStyle e ParagraphStyle da questo stile con nome quando hanno lo stesso tipo di stile denominato.

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

enum (NamedStyleType)

Il tipo di questo stile con nome.

textStyle

object (TextStyle)

Lo stile del testo di questo stile con nome.

paragraphStyle

object (ParagraphStyle)

Lo stile del paragrafo di questo stile con nome.

SuggestedNamedStyles

Una modifica suggerita per NamedStyles.

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

object (NamedStyles)

Un 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 nella base NamedStyles sono stati modificati in questo suggerimento.

NamedStylesSuggestionState

Lo stato del suggerimento di un messaggio NamedStyles.

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

object (NamedStyleSuggestionState)

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

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

NamedStyleSuggestionState

Uno stato di suggerimento di un messaggio NamedStyle.

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

enum (NamedStyleType)

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

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

textStyleSuggestionState

object (TextStyleSuggestionState)

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

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

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

Elenco

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

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

object (ListProperties)

Le proprietà dell'elenco.

suggestedListPropertiesChanges

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

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

suggestedInsertionId

string

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

suggestedDeletionIds[]

string

Gli ID di eliminazione suggeriti. Se vuoto, non sono previste eliminazioni suggerite di questo elenco.

ListProperties

Le proprietà di un list che descrivono l'aspetto di punti 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 livello di nidificazione 0 corrispondente al livello più alto e livello di nidificazione 8 corrispondente al livello più nidificato. I livelli di nidificazione vengono restituiti in ordine crescente con il valore meno nidificato restituito per primo.

NestingLevel

Contiene proprietà che descrivono l'aspetto di un elenco puntato in 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 glifo contiene uno o più segnaposto, che vengono sostituiti con i valori appropriati a seconda di glyphType o glyphSymbol. I segnaposto seguono lo schema %[nestingLevel]. Inoltre, i segnaposto possono avere prefissi e suffissi. Pertanto, il formato glifo segue il pattern <prefix>%[nestingLevel]<suffix>. Tieni presente che il prefisso e il suffisso sono facoltativi e possono essere stringhe arbitrarie.

Ad esempio, il formato del glifo %0. indica che il glifo 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 glifo può contenere segnaposto per il livello di annidamento corrente e segnaposto per i livelli di annidamento principali. Ad esempio, un elenco può avere un formato glifo %0. a livello di nidificazione 0 e un formato glifo %0.%1. a livello di nidificazione 1. Presumendo che entrambi i livelli di nidificazione abbiano DECIMAL tipi di glifi, verrà visualizzato un elenco con glifi visualizzati

1.

2.

2.1.

2.2.

3.

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

indentFirstLine

object (Dimension)

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

indentStart

object (Dimension)

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

textStyle

object (TextStyle)

Lo stile 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 con lettere e i numeri romani. Per i valori sia di 0 che di 1, gli elenchi con lettere e i numeri romani iniziano rispettivamente con a e i.

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

Campo unione glyph_kind. Il tipo di glifo usato dai punti elenco. Definisce il glifo del punto elenco che sostituisce i segnaposto nell'elemento glyph_format. glyph_kind può essere solo uno dei seguenti:
glyphType

enum (GlyphType)

Il tipo di glifo utilizzato dai punti elenco quando vengono ordinati i paragrafi a questo livello di nidificazione.

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

glyphSymbol

string

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

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

BulletAlignment

I tipi di allineamento di un punto elenco.

Enum
BULLET_ALIGNMENT_UNSPECIFIED L'allineamento dei punti elenco non è specificato.
START Il punto elenco è allineato all'inizio dello spazio assegnato per il rendering del punto elenco. Allineato a sinistra per il testo LTR, altrimenti allineato a destra.
CENTER Il punto elenco è allineato al centro dello spazio assegnato per il rendering del punto elenco.
END Il punto elenco è allineato alla fine dello spazio assegnato per il rendering del punto elenco. Allineato a destra per il testo LTR, allineamento a sinistra negli altri casi.

GlyphType

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

Enum
GLYPH_TYPE_UNSPECIFIED Il tipo di glifo non è specificato o non è supportato.
NONE Una stringa vuota.
DECIMAL Un numero, ad esempio 1, 2 o 3.
ZERO_DECIMAL Un numero in cui i numeri a una sola cifra sono preceduti dal prefisso zero, ad esempio 01, 02 o 03. I numeri con più di una cifra non sono preceduti dal prefisso dello zero.
UPPER_ALPHA Una lettera maiuscola, ad esempio A, B o C.
ALPHA Una lettera minuscola, ad esempio a, b o c.
UPPER_ROMAN Un numero romano maiuscolo, ad esempio I, II o III.
ROMAN Un numero romano minuscolo, ad esempio i, ii o iii.

SuggestedListProperties

Una modifica suggerita per ListProperties.

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

object (ListProperties)

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

listPropertiesSuggestionState

object (ListPropertiesSuggestionState)

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

ListPropertiesSuggestionState

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

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

object (NestingLevelSuggestionState)

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

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

NestingLevelSuggestionState

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

Rappresentazione JSON
{
  "bulletAlignmentSuggested": boolean,
  "glyphTypeSuggested": boolean,
  "glyphFormatSuggested": boolean,
  "glyphSymbolSuggested": boolean,
  "indentFirstLineSuggested": boolean,
  "indentStartSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  },
  "startNumberSuggested": boolean
}
Campi
bulletAlignmentSuggested

boolean

Indica se è stata suggerita una modifica a bulletAlignment.

glyphTypeSuggested

boolean

Indica se è stata suggerita una modifica a glyphType.

glyphFormatSuggested

boolean

Indica se è stata suggerita una modifica a glyphFormat.

glyphSymbolSuggested

boolean

Indica se è stata suggerita una modifica a glyphSymbol.

indentFirstLineSuggested

boolean

Indica se è stata suggerita una modifica a indentFirstLine.

indentStartSuggested

boolean

Indica se è stata suggerita una modifica a indentStart.

textStyleSuggestionState

object (TextStyleSuggestionState)

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

startNumberSuggested

boolean

Indica se è stata suggerita una modifica a startNumber.

NamedRanges

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

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

string

Il nome condiviso da tutti i named ranges.

namedRanges[]

object (NamedRange)

Gli elementi NamedRange che condividono lo stesso nome.

NamedRange

Una raccolta di Range con lo stesso ID intervallo denominato.

Gli intervalli denominati consentono agli sviluppatori di associare parti di un documento a un'etichetta arbitraria definita dall'utente, in modo che i relativi contenuti possano essere letti o modificati in modo programmatico in un secondo momento. Un documento può contenere più intervalli denominati con lo stesso nome, ma ogni intervallo denominato ha un ID univoco.

Un intervallo denominato viene creato con un singolo Range e i contenuti inseriti all'interno di un intervallo denominato generalmente lo espandono. Tuttavia, alcune modifiche al documento possono causare la suddivisione dell'intervallo in più intervalli.

Gli intervalli denominati non sono privati. Tutte le applicazioni e i collaboratori che hanno accesso al documento possono 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 è contenuto l'intervallo. Un ID segmento vuoto indica il corpo del documento.

startIndex

integer

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

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

endIndex

integer

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

In tutti gli utilizzi attuali, è necessario fornire un indice finale. Questo campo è un valore 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 sola scheda:

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

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

In un documento contenente più schede:

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

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

InlineObject

Un oggetto che appare incorporato nel testo. Un oggetto InlineObject contiene un elemento EmbeddedObject come un'immagine.

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

string

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

inlineObjectProperties

object (InlineObjectProperties)

Le proprietà di questo oggetto in linea.

suggestedInlineObjectPropertiesChanges

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

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

suggestedInsertionId

string

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

suggestedDeletionIds[]

string

Gli ID di eliminazione suggeriti. Se 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 sono entrambi 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)

Margine superiore dell'oggetto incorporato.

marginBottom

object (Dimension)

Margine inferiore dell'oggetto incorporato.

marginRight

object (Dimension)

Margine destro dell'oggetto incorporato.

marginLeft

object (Dimension)

Margine sinistro dell'oggetto incorporato.

linkedContentReference

object (LinkedContentReference)

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

Se non viene configurato, l'oggetto incorporato non è collegato.

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

object (EmbeddedDrawingProperties)

Proprietà di un disegno incorporato.

imageProperties

object (ImageProperties)

Le proprietà di un'immagine.

EmbeddedDrawingProperties

Questo tipo non contiene campi.

Proprietà di un disegno incorporato utilizzate per differenziare il tipo di oggetto. Un disegno incorporato è un disegno creato e modificato all'interno di un documento. Tieni presente che i dettagli completi non sono supportati.

ImageProperties

Le proprietà di un'immagine.

Rappresentazione JSON
{
  "contentUri": string,
  "sourceUri": string,
  "brightness": number,
  "contrast": number,
  "transparency": number,
  "cropProperties": {
    object (CropProperties)
  },
  "angle": number
}
Campi
contentUri

string

Un URI dell'immagine con una durata predefinita di 30 minuti. Questo URI è contrassegnato con l'account del richiedente. Chiunque disponga dell'URI accede effettivamente all'immagine come richiedente originale. 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 significa nessun effetto e 1 significa 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 da offset frazionari dei quattro bordi del contenuto originale.

  • Se l'offset è nell'intervallo (0, 1), il bordo corrispondente del rettangolo di ritaglio viene posizionato all'interno del rettangolo di delimitazione originale dell'immagine.
  • Se l'offset è negativo o maggiore di 1, il bordo corrispondente del rettangolo di ritaglio viene posizionato all'esterno del rettangolo di delimitazione originale dell'immagine.
  • Se tutti gli offset e gli angoli di rotazione sono pari a 0, l'immagine non viene ritagliata.
Rappresentazione JSON
{
  "offsetLeft": number,
  "offsetRight": number,
  "offsetTop": number,
  "offsetBottom": number,
  "angle": number
}
Campi
offsetLeft

number

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

offsetRight

number

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

offsetTop

number

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

offsetBottom

number

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

angle

number

L'angolo di rotazione in senso orario del rettangolo di ritaglio intorno al 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à border.

PropertyState

Gli stati possibili di una proprietà.

Enum
RENDERED Se lo stato di una proprietà è RENDERED, l'elemento ha la proprietà corrispondente quando viene visualizzato nel documento. Questo è il valore predefinito.
NOT_RENDERED Se lo stato di una proprietà è NOT_RENDERED, l'elemento non ha la proprietà corrispondente quando viene visualizzato nel documento.

LinkedContentReference

Un riferimento ai contenuti 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 per il tipo di contenuti collegati. reference può essere solo uno dei seguenti:
sheetsChartReference

object (SheetsChartReference)

Un riferimento al grafico collegato.

SheetsChartReference

Un riferimento a un grafico collegato incorporato da Fogli Google.

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

string

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

chartId

integer

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

SuggestedInlineObjectProperties

Una modifica suggerita per InlineObjectProperties.

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

object (InlineObjectProperties)

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

inlineObjectPropertiesSuggestionState

object (InlineObjectPropertiesSuggestionState)

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

InlineObjectPropertiesSuggestionState

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

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

object (EmbeddedObjectSuggestionState)

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

EmbeddedObjectSuggestionState

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

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

object (EmbeddedDrawingPropertiesSuggestionState)

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

imagePropertiesSuggestionState

object (ImagePropertiesSuggestionState)

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

titleSuggested

boolean

Indica se è stata suggerita una modifica a title.

descriptionSuggested

boolean

Indica se è stata suggerita una modifica a description.

embeddedObjectBorderSuggestionState

object (EmbeddedObjectBorderSuggestionState)

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

sizeSuggestionState

object (SizeSuggestionState)

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

marginLeftSuggested

boolean

Indica se è stata suggerita una modifica a marginLeft.

marginRightSuggested

boolean

Indica se è stata suggerita una modifica a marginRight.

marginTopSuggested

boolean

Indica se è stata suggerita una modifica a marginTop.

marginBottomSuggested

boolean

Indica se è stata suggerita una modifica a marginBottom.

linkedContentReferenceSuggestionState

object (LinkedContentReferenceSuggestionState)

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

EmbeddedDrawingPropertiesSuggestionState

Questo tipo non contiene campi.

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

ImagePropertiesSuggestionState

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

Rappresentazione JSON
{
  "contentUriSuggested": boolean,
  "sourceUriSuggested": boolean,
  "brightnessSuggested": boolean,
  "contrastSuggested": boolean,
  "transparencySuggested": boolean,
  "cropPropertiesSuggestionState": {
    object (CropPropertiesSuggestionState)
  },
  "angleSuggested": boolean
}
Campi
contentUriSuggested

boolean

Indica se è stata suggerita una modifica a contentUri.

sourceUriSuggested

boolean

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

brightnessSuggested

boolean

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

contrastSuggested

boolean

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

transparencySuggested

boolean

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

cropPropertiesSuggestionState

object (CropPropertiesSuggestionState)

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

Rappresentazione JSON
{
  "offsetLeftSuggested": boolean,
  "offsetRightSuggested": boolean,
  "offsetTopSuggested": boolean,
  "offsetBottomSuggested": boolean,
  "angleSuggested": boolean
}
Campi
offsetLeftSuggested

boolean

Indica se è stata suggerita una modifica a offsetLeft.

offsetRightSuggested

boolean

Indica se è stata suggerita una modifica a offsetRight.

offsetTopSuggested

boolean

Indica se è stata suggerita una modifica a offsetTop.

offsetBottomSuggested

boolean

Indica se è stata suggerita una modifica a offsetBottom.

angleSuggested

boolean

Indica se è stata suggerita una modifica a angle.

EmbeddedObjectBorderSuggestionState

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

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

boolean

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

widthSuggested

boolean

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

dashStyleSuggested

boolean

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

propertyStateSuggested

boolean

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

LinkedContentReferenceSuggestionState

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

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

object (SheetsChartReferenceSuggestionState)

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

SheetsChartReferenceSuggestionState

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

Rappresentazione JSON
{
  "spreadsheetIdSuggested": boolean,
  "chartIdSuggested": boolean
}
Campi
spreadsheetIdSuggested

boolean

Indica se è stata suggerita una modifica a spreadsheetId.

chartIdSuggested

boolean

Indica se è stata suggerita una modifica a chartId.

PositionedObject

Un oggetto collegato a un Paragraph e posizionato rispetto all'inizio del paragrafo. Un PositionedObject contiene un elemento EmbeddedObject come un'immagine.

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

string

L'ID di questo oggetto posizionato.

positionedObjectProperties

object (PositionedObjectProperties)

Le proprietà di questo oggetto posizionato.

suggestedPositionedObjectPropertiesChanges

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

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

suggestedInsertionId

string

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

suggestedDeletionIds[]

string

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

PositionedObjectProperties

Proprietà di un PositionedObject.

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

object (PositionedObjectPositioning)

Il posizionamento 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 è posizionato rispetto all'inizio del Paragraph a cui è associato.

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

enum (PositionedObjectLayout)

Il layout di questo oggetto posizionato.

leftOffset

object (Dimension)

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

topOffset

object (Dimension)

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

PositionedObjectLayout

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

Enum
POSITIONED_OBJECT_LAYOUT_UNSPECIFIED Il layout non è specificato.
WRAP_TEXT Il testo avvolge intorno all'oggetto posizionato.
BREAK_LEFT Interrompe il testo in modo che l'oggetto posizionato si trovi a sinistra e il testo sia a destra.
BREAK_RIGHT Interrompe il testo in modo che l'oggetto posizionato si trovi a destra e il testo sia a sinistra.
BREAK_LEFT_RIGHT Interrompe il testo in modo che non ci sia testo a sinistra o a destra dell'oggetto posizionato.
IN_FRONT_OF_TEXT L'oggetto posizionato si trova davanti al testo.
BEHIND_TEXT L'oggetto posizionato si trova dietro il testo.

SuggestedPositionedObjectProperties

Una modifica suggerita per PositionedObjectProperties.

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

object (PositionedObjectProperties)

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

positionedObjectPropertiesSuggestionState

object (PositionedObjectPropertiesSuggestionState)

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

PositionedObjectPropertiesSuggestionState

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

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

object (PositionedObjectPositioningSuggestionState)

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

embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

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

PositionedObjectPositioningSuggestionState

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

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

boolean

Indica se è stata suggerita una modifica a layout.

leftOffsetSuggested

boolean

Indica se è stata suggerita una modifica a leftOffset.

topOffsetSuggested

boolean

Indica se è stata suggerita una modifica a topOffset.

SuggestionsViewMode

La modalità di visualizzazione dei suggerimenti applicata al documento e che indica come vengono rappresentate le modifiche suggerite. che offre opzioni per la lettura del documento con tutti i suggerimenti incorporati, accettati o rifiutati.

Enum
DEFAULT_FOR_CURRENT_ACCESS Il valore SuggestionsViewMode applicato al documento restituito dipende dal livello di accesso corrente dell'utente. Se l'utente ha solo accesso in visualizzazione, viene applicato PREVIEW_WITHOUT_SUGGESTIONS. In caso contrario, viene applicato SUGGESTIONS_INLINE. Questa è la modalità di visualizzazione predefinita dei suggerimenti.
SUGGESTIONS_INLINE

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

Le richieste di recupero di un documento utilizzando questa modalità restituiranno un errore 403 se l'utente non dispone dell'autorizzazione per visualizzare le modifiche suggerite.

PREVIEW_SUGGESTIONS_ACCEPTED

Il documento restituito è un'anteprima con tutte le modifiche suggerite accettate.

Le richieste di recupero di un documento utilizzando questa modalità restituiranno un errore 403 se l'utente non dispone dell'autorizzazione per visualizzare le modifiche suggerite.

PREVIEW_WITHOUT_SUGGESTIONS Il documento restituito è un'anteprima in cui tutte le modifiche suggerite vengono rifiutate se ci sono suggerimenti nel documento.

Metodi

batchUpdate

Applica uno o più aggiornamenti al documento.

create

Crea un documento vuoto utilizzando il titolo indicato nella richiesta.

get

Recupera l'ultima versione del documento specificato.