REST Resource: documents

Risorsa: documento

Un documento Google.

Rappresentazione JSON 
{
  "documentId": string,
  "title": string,
  "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)
    },
    ...
  },
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
Campi
documentId

string

Solo output. L'ID del documento.
title

string

Il titolo del documento.
body

object (Body)

Solo output. Il corpo principale del documento.
headers

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

Solo output. Le intestazioni del documento, digitate in base all'ID intestazione.
footers

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

Solo output. I piè di pagina del documento, digitati in base all'ID del piè di pagina.
footnotes

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

Solo output. Le note a piè di pagina nel documento, digitate in base all'ID nota a piè di pagina.
documentStyle

object (DocumentStyle)

Solo output. Lo stile del documento.
suggestedDocumentStyleChanges

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

Solo output. Le modifiche suggerite allo stile del documento, specificate per ID suggerimento.
namedStyles

object (NamedStyles)

Solo output. Gli stili con nome del documento.
suggestedNamedStylesChanges

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

Solo output. Le modifiche suggerite agli stili con nome del documento, inseriti in base all'ID suggerimento.
lists

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

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

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

Solo output. Gli intervalli denominati nel documento, codificati per nome.
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 la revisione. Compilato solo se l'utente ha accesso in modifica al documento.

L'ID revisione non è un numero sequenziale, ma una stringa opaca. Il formato dell'ID revisione potrebbe cambiare nel tempo. È garantito che un ID revisione restituito sia valido solo per 24 ore dopo essere stato restituito e non può essere condiviso tra gli utenti. Se l'ID revisione rimane invariato tra una chiamata e l'altra, significa che il documento non è stato modificato. Viceversa, un ID modificato (per lo stesso documento e lo stesso utente) di solito indica che il documento è stato aggiornato. Tuttavia, un ID modificato può essere dovuto anche a fattori interni, come le modifiche al formato dell'ID.
suggestionsViewMode

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.
inlineObjects

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

Solo output. Gli oggetti in linea nel documento, digitati in base all'ID oggetto.
positionedObjects

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

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

Body

Il corpo del documento.

Il corpo di solito contiene i contenuti completi del documento, ad eccezione di headers, footers e footnotes.

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

object (StructuralElement)

I contenuti del corpo.

Gli indici dei contenuti del corpo del testo iniziano da zero.

ElementoStructuralElement

Uno StructuralElement descrive i contenuti che conferiscono struttura al documento.

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

  // Union field 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 in base zero di questo elemento strutturale, in unità di codice UTF-16.
endIndex

integer

L'indice finale in base zero di questo elemento strutturale, esclusivo, in unità di codice UTF-16.
Campo di unione content. Il contenuto dell'elemento strutturale. content può essere solo uno dei seguenti:
paragraph

object (Paragraph)

Un tipo di paragrafo di elemento strutturale.
sectionBreak

object (SectionBreak)

Un tipo di interruzione di sezione di elemento strutturale.
table

object (Table)

Un tipo di tabella di elemento strutturale.
tableOfContents

object (TableOfContents)

Un tipo di sommario di elemento strutturale.

Paragrafo

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

Rappresentazione JSON 
{
  "elements": [
    {
      object (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)

Il contenuto del paragrafo, suddiviso nelle sue parti.
paragraphStyle

object (ParagraphStyle)

Lo stile di questo paragrafo.
suggestedParagraphStyleChanges

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

Lo stile di paragrafo suggerito cambia in questo paragrafo, inserito in base all'ID suggerimento.
bullet

object (Bullet)

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

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

Le modifiche suggerite al punto elenco di questo paragrafo.
positionedObjectIds[]

string

Gli ID degli oggetti posizionati collegati a questo paragrafo.
suggestedPositionedObjectIds

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

Gli ID degli oggetti posizionati che si suggerisce di associare a questo paragrafo, digitati in base all'ID suggerimento.

ElementoParagrafo

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

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

  // Union field 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, in unità di codice UTF-16.
endIndex

integer

L'indice di fine zero-base di questo elemento paragrafo, esclusivo, in unità di codice UTF-16.
Campo di unione content. Il contenuto dell'elemento paragrafo. content può essere solo uno dei seguenti:
textRun

object (TextRun)

Un elemento paragrafo con esecuzione di testo.
autoText

object (AutoText)

Un elemento paragrafo con testo automatico.
pageBreak

object (PageBreak)

Un elemento paragrafo di interruzione di pagina.
columnBreak

object (ColumnBreak)

Un elemento paragrafo di interruzione di colonna.
footnoteReference

object (FootnoteReference)

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

object (HorizontalRule)

Un elemento paragrafo orizzontale con una riga.
equation

object (Equation)

Un elemento paragrafo di un'equazione.
inlineObjectElement

object (InlineObjectElement)

Elemento paragrafo oggetto in linea.
person

object (Person)

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

Esecuzione testo

Un elemento ParagraphElement che rappresenta una serie di testi tutti con lo stesso stile.

Rappresentazione JSON 
{
  "content": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (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 elemento TextRun può avere più ID inserimento se si tratta di una modifica suggerita nidificata. Se vuoto, non è un inserimento suggerito.
suggestedDeletionIds[]

string

Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti.
textStyle

object (TextStyle)

Lo stile di testo di questa esecuzione.
suggestedTextStyleChanges

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

Lo stile di testo suggerito cambia in questa esecuzione, inserito in base all'ID suggerimento.

Stile testo

Rappresenta lo stile che può essere applicato al testo.

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

  • Il valore TextStyle del testo in un elemento Paragraph eredita il valore named style type corrispondente al paragrafo.
  • L'elemento TextStyle in un named style eredita dallo stile denominato normal text.
  • Lo stile TextStyle dello stile denominato normal text eredita dallo stile di testo predefinito nell'editor di documenti.
  • L'elemento TextStyle in un elemento Paragraph all'interno di una tabella può ereditare il suo stile di testo dallo stile della tabella.

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

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

boolean

Indica se il testo viene visualizzato in grassetto.
italic

boolean

Indica se il testo è in corsivo o meno.
underline

boolean

Indica se il testo è sottolineato.
strikethrough

boolean

Indica se il testo è barrato o meno.
smallCaps

boolean

Indica se il testo è scritto con lettere maiuscole o meno.
backgroundColor

object (OptionalColor)

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

object (OptionalColor)

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

object (Dimension)

Le dimensioni del carattere del testo.
weightedFontFamily

object (WeightedFontFamily)

La famiglia di caratteri e lo spessore visualizzato del testo.

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

Se weightedFontFamily#weight non è impostato, il valore predefinito è 400.

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

enum (BaselineOffset)

Lo scostamento verticale del testo rispetto alla posizione normale.

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

Colore Facoltativo

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.

Colore RGB

Un colore RGB.

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

number

Il componente rosso del colore, da 0,0 a 1,0.
green

number

La componente verde del colore, da 0,0 a 1,0.
blue

number

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

Dimensione

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

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

number

L'entità.
unit

enum (Unit)

Le unità per la grandezza.

Unità

Unità di misura.

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

Famiglia caratteri ponderati

Rappresenta una famiglia di caratteri e lo spessore del testo.

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

string

La famiglia di caratteri del testo.

La famiglia di caratteri può essere qualsiasi carattere presente nel menu Carattere in Documenti o in Google Fonts. Se il nome del carattere non viene riconosciuto, il testo viene visualizzato in 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 specifica CSS 2.1, sezione 15.6, in cui i valori non numerici non sono consentiti.

Il valore predefinito è 400 ("normale").

Lo spessore del carattere è solo un componente dello spessore del carattere visualizzato. Una combinazione del weight e del valore bold risolto dello stile di testo determina la ponderazione visualizzata, tenendo 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, la ponderazione visualizzata è uguale alla ponderazione.
  • Se il testo non è in grassetto, la ponderazione visualizzata è uguale alla ponderazione.

Offset linea di riferimento

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

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

StileTesto suggerito

Una modifica suggerita a TextStyle.

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

object (TextStyle)

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

Stato Suggerimento stileTesto

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

Rappresentazione JSON 
{
  "boldSuggested": boolean,
  "italicSuggested": boolean,
  "underlineSuggested": boolean,
  "strikethroughSuggested": boolean,
  "smallCapsSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "foregroundColorSuggested": boolean,
  "fontSizeSuggested": boolean,
  "weightedFontFamilySuggested": boolean,
  "baselineOffsetSuggested": boolean,
  "linkSuggested": boolean
}
Campi
boldSuggested

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.

Testo automatico

Un ParagraphElement che rappresenta una parte del testo che viene sostituita dinamicamente con contenuti che possono cambiare nel tempo, ad esempio un numero di pagina.

Rappresentazione JSON 
{
  "type": enum (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 elemento AutoText può avere più ID inserimento se si tratta di una modifica suggerita nidificata. Se vuoto, non è un inserimento suggerito.
suggestedDeletionIds[]

string

Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti.
textStyle

object (TextStyle)

Lo stile di testo di questo testo automatico.
suggestedTextStyleChanges

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

Lo stile di testo suggerito viene modificato in questo testo automatico, inserito in base all'ID suggerimento.

Tipo

I tipi di testo automatico.

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

Interruzione di pagina

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

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

string

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

string

Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti.
textStyle

object (TextStyle)

Lo stile di testo di questa interruzione di pagina.

Analogamente ai contenuti di testo, come le esecuzioni di testo e i riferimenti a nota a piè di pagina, lo stile del testo di un'interruzione di pagina può influire sul layout dei contenuti e sullo stile del testo inserito accanto.
suggestedTextStyleChanges

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

Lo stile di testo suggerito passa all'interruzione di pagina, inserito in base all'ID suggerimento.

Interruzione colonna

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

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

string

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

string

Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti.
textStyle

object (TextStyle)

Lo stile di testo di questa ColumnBreak.

Analogamente ai contenuti di testo, come le esecuzioni di testo e i riferimenti a note a piè di pagina, lo stile del testo di un'interruzione di colonna può influire sul layout dei contenuti e sullo stile del testo inserito accanto a quest'ultimo.
suggestedTextStyleChanges

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

Lo stile di testo suggerito viene modificato in ColumnBreak, inserito in base all'ID suggerimento.

Riferimento nota a piè di pagina

Un ParagraphElement che rappresenta un riferimento a una nota a piè di pagina. Un riferimento a una nota a piè di pagina è il contenuto in linea visualizzato con un numero e viene utilizzato per identificare la nota a piè di pagina.

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

string

L'ID dell'elemento footnote che include i contenuti di questo riferimento a nota a piè di pagina.
footnoteNumber

string

Il numero visualizzato di questa nota a piè di pagina.
suggestedInsertionIds[]

string

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

string

Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti.
textStyle

object (TextStyle)

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

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

Lo stile di testo suggerito passa a questo riferimento a piè di pagina, inserito in base all'ID suggerimento.

Regola orizzontale

ParagraphElement che rappresenta una linea orizzontale.

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

string

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

string

Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti.
textStyle

object (TextStyle)

Lo stile di testo di questa HorizontalRules.

Analogamente ai contenuti testuali, come esecuzioni di testo e riferimenti a note a piè di pagina, lo stile del testo di una regola orizzontale può influire sul layout dei contenuti e sullo stile del testo inserito accanto a quest'ultimo.
suggestedTextStyleChanges

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

Lo stile di testo suggerito viene modificato nel valore HorizontalRules, inserito in base all'ID suggerimento.

Equazione

Un ParagraphElement che rappresenta un'equazione.

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

string

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

string

Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti.

InlineObjectElement

Un elemento ParagraphElement che contiene un elemento InlineObject.

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

string

L'ID dell'elemento InlineObject contenuto in questo elemento.
suggestedInsertionIds[]

string

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

string

Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti.
textStyle

object (TextStyle)

Lo stile di testo di questo elemento InlineObjectElement.

Analogamente ai contenuti testuali, come le esecuzioni di testo e i riferimenti a nota a piè di pagina, lo stile del testo di un elemento incorporato in un oggetto può influire sul layout dei contenuti e sullo stile del testo inserito accanto a quest'ultimo.
suggestedTextStyleChanges

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

Lo stile di testo suggerito viene modificato in questo InlineObject, inserito in base all'ID suggerimento.

Persona

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

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

string

Solo output. L'ID univoco di questo collegamento.
suggestedInsertionIds[]

string

ID dei 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 creato da un altro utente). Se vuoto, il link della persona non è un inserimento suggerito.
suggestedDeletionIds[]

string

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

object (TextStyle)

Lo stile di testo di questo Person.
suggestedTextStyleChanges

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

Lo stile di testo suggerito cambia in questo Person, inserito in base all'ID suggerimento.
personProperties

object (PersonProperties)

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

Proprietà Persona

Proprietà specifiche di un elemento Person collegato.

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

string

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

string

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

Proprietà RichLink

Proprietà specifiche di un RichLink.

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

string

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

string

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

string

Solo output. Il tipo MIME di RichLink, se esiste (ad esempio, se si tratta di un file su Drive).

StileParagrafo

Stili che si applicano a un intero paragrafo.

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

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

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

Rappresentazione JSON 
{
  "headingId": string,
  "namedStyleType": enum (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 titolo.

Questa proprietà è di sola lettura.
namedStyleType

enum (NamedStyleType)

Il tipo di stile denominato del paragrafo.

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

enum (Alignment)

L'allineamento del testo per questo paragrafo.
lineSpacing

number

La quantità di spazio tra le righe, come percentuale del normale, dove normale è rappresentato come 100,0. Se non viene configurato, il valore viene ereditato dall'elemento padre.
direction

enum (ContentDirection)

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

enum (SpacingMode)

La modalità spaziatura per il paragrafo.
spaceAbove

object (Dimension)

La quantità di spazio aggiuntivo sopra il paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento padre.
spaceBelow

object (Dimension)

La quantità di spazio aggiuntivo sotto il paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento padre.
borderBetween

object (ParagraphBorder)

Il bordo tra questo paragrafo e i paragrafi successivo e precedente. Se non viene configurato, il valore viene ereditato dall'elemento padre.

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

I bordi del paragrafo non possono essere aggiornati parzialmente. Quando modifichi il bordo di un paragrafo, il nuovo bordo deve essere specificato completamente.
borderTop

object (ParagraphBorder)

Il bordo nella parte superiore di questo paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento padre.

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

I bordi del paragrafo non possono essere aggiornati parzialmente. Quando modifichi il bordo di un paragrafo, il nuovo bordo deve essere specificato completamente.
borderBottom

object (ParagraphBorder)

Il bordo alla fine di questo paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento padre.

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

I bordi del paragrafo non possono essere aggiornati parzialmente. Quando modifichi il bordo di un paragrafo, il nuovo bordo deve essere specificato completamente.
borderLeft

object (ParagraphBorder)

Il bordo a sinistra di questo paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento padre.

I bordi del paragrafo non possono essere aggiornati parzialmente. Quando modifichi il bordo di un paragrafo, il nuovo bordo deve essere specificato completamente.
borderRight

object (ParagraphBorder)

Il bordo a destra di questo paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento padre.

I bordi del paragrafo non possono essere aggiornati parzialmente. Quando modifichi il bordo di un paragrafo, il nuovo bordo deve essere specificato completamente.
indentFirstLine

object (Dimension)

L'entità del rientro per la prima riga del paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento padre.
indentStart

object (Dimension)

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

object (Dimension)

La quantità di rientro per il paragrafo sul lato corrispondente alla fine del testo, in base alla direzione corrente del paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento padre.
tabStops[]

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'elemento padre.
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'elemento padre.
avoidWidowAndOrphan

boolean

Indica se evitare vedove e orfani nel paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento padre.
shading

object (Shading)

L'ombreggiatura del paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento padre.
pageBreakBefore

boolean

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

Il tentativo di aggiornare 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 di richiesta non valido 400.

NamedStyleType

I tipi di stili con nome.

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

Allineamento

I tipi di allineamento del testo di un paragrafo.

Enum
ALIGNMENT_UNSPECIFIED L'allineamento del paragrafo viene ereditato dall'elemento padre.
START Il paragrafo è allineato all'inizio della linea. Allineato a sinistra per il testo LTR, altrimenti allineato a destra.
CENTER Il paragrafo è centrato.
END Il paragrafo è allineato alla fine della linea. Allineato a destra per il testo LTR, altrimenti allineato a sinistra.
JUSTIFIED Il paragrafo è giustificato.

Direzione dei contenuti

I contenuti delle indicazioni stradali possono essere inseriti.

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

Modalità spaziatura

Le diverse modalità per la spaziatura dei paragrafi.

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

Bordo paragrafo

Un bordo intorno a un paragrafo.

Rappresentazione JSON 
{
  "color": {
    object (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.

Stile trattino

I tipi di trattini con cui è possibile eseguire il rendering della geometria lineare. Questi valori si basano sul tipo semplice "ST_PresetLineDashVal" descritto nella sezione 20.1.10.48 del documento "Office Open XML File Models - Fundamentals and Markup Language Reference", parte 1 della quarta edizione di ECMA-376.

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

Interruzione Tab

Una tabulazione all'interno di un paragrafo.

Rappresentazione JSON 
{
  "offset": {
    object (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.

Allineamento TabStop

L'allineamento della tabulazione.

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

Ombreggiatura

L'ombreggiatura di un paragrafo.

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

object (OptionalColor)

Il colore di sfondo dell'ombreggiatura di questo paragrafo.

StileParagraphStyle suggerito

Una modifica suggerita a ParagraphStyle.

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

object (ParagraphStyle)

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

Stato Suggerimento stile paragrafo

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

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

boolean

Indica se è stata suggerita una modifica a headingId.
namedStyleTypeSuggested

boolean

Indica se è stata suggerita una modifica a namedStyleType.
alignmentSuggested

boolean

Indica se è stata suggerita una modifica a alignment.
lineSpacingSuggested

boolean

Indica se è stata suggerita una modifica a lineSpacing.
directionSuggested

boolean

Indica se è stata suggerita una modifica a direction.
spacingModeSuggested

boolean

Indica se è stata suggerita una modifica a spacingMode.
spaceAboveSuggested

boolean

Indica se è stata suggerita una modifica a spaceAbove.
spaceBelowSuggested

boolean

Indica se è stata suggerita una modifica a spaceBelow.
borderBetweenSuggested

boolean

Indica se è stata suggerita una modifica a borderBetween.
borderTopSuggested

boolean

Indica se è stata suggerita una modifica a borderTop.
borderBottomSuggested

boolean

Indica se è stata suggerita una modifica a borderBottom.
borderLeftSuggested

boolean

Indica se è stata suggerita una modifica a borderLeft.
borderRightSuggested

boolean

Indica se è stata suggerita una modifica a borderRight.
indentFirstLineSuggested

boolean

Indica se è stata suggerita una modifica a indentFirstLine.
indentStartSuggested

boolean

Indica se è stata suggerita una modifica a indentStart.
indentEndSuggested

boolean

Indica se è stata suggerita una modifica a indentEnd.
keepLinesTogetherSuggested

boolean

Indica se è stata suggerita una modifica a keepLinesTogether.
keepWithNextSuggested

boolean

Indica se è stata suggerita una modifica a keepWithNext.
avoidWidowAndOrphanSuggested

boolean

Indica se è stata suggerita una modifica a avoidWidowAndOrphan.
shadingSuggestionState

object (ShadingSuggestionState)

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

boolean

Indica se è stata suggerita una modifica a pageBreakBefore.

Stato ShadingSuggestion

Una maschera che indica quali campi sulla base Shading sono stati modificati in questa modifica suggerita. Per ogni campo impostato su true viene suggerito un nuovo valore.

Rappresentazione JSON 
{
  "backgroundColorSuggested": boolean
}
Campi
backgroundColorSuggested

boolean

Indica se è stata suggerita una modifica a Shading.

Bullet

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 annidamento di questo paragrafo nell'elenco.
textStyle

object (TextStyle)

Lo stile di testo specifico del paragrafo applicato al punto elenco.

Punto elenco suggerito

Una modifica suggerita a Bullet.

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

object (Bullet)

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

Stato bulletSuggestion

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

Rappresentazione JSON 
{
  "listIdSuggested": boolean,
  "nestingLevelSuggested": boolean,
  "textStyleSuggestionState": {
    object (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 in text style sono stati modificati in questo suggerimento.

Riferimenti oggetto

Una raccolta di ID oggetto.

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

string

Gli ID oggetto.

Interruzione di sezione

Un StructuralElement che rappresenta un'interruzione di sezione. Una sezione è un intervallo di contenuti che hanno lo stesso SectionStyle. Un'interruzione di sezione rappresenta l'inizio di una nuova sezione e lo stile della sezione viene applicato alla sezione dopo l'interruzione.

Il corpo del documento inizia sempre con un'interruzione di sezione.

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

string

Gli ID di inserimento suggeriti. Un elemento SectionBreak può avere più ID inserimento se si tratta di una modifica suggerita nidificata. Se vuoto, non è un inserimento suggerito.
suggestedDeletionIds[]

string

Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti.
sectionStyle

object (SectionStyle)

Lo stile della sezione dopo questa interruzione di sezione.

Stile Sezione

Lo stile da applicare 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 tre colonne.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli l'impostazione di questa proprietà, verrà visualizzato un errore di richiesta (400) non valido.
columnSeparatorStyle

enum (ColumnSeparatorStyle)

Lo stile dei separatori di colonna.

Questo stile può essere impostato anche se è presente una sola colonna nella sezione.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli l'impostazione di questa proprietà, viene visualizzato l'errore 400 di richiesta errata.
contentDirection

enum (ContentDirection)

La direzione dei contenuti in questa sezione. Se non viene configurato, il valore predefinito è LEFT_TO_RIGHT.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli l'impostazione di questa proprietà, viene visualizzato l'errore 400 di richiesta errata.
marginTop

object (Dimension)

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

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli l'impostazione di questa proprietà, viene visualizzato l'errore 400 di richiesta errata.
marginBottom

object (Dimension)

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

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli l'impostazione di questa proprietà, viene visualizzato l'errore 400 di richiesta errata.
marginRight

object (Dimension)

Il margine di pagina destro della sezione. Se non viene configurato, il valore predefinito di DocumentStyle è marginRight. 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 l'impostazione di questa proprietà, viene visualizzato l'errore 400 di richiesta errata.
marginLeft

object (Dimension)

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

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli l'impostazione di questa proprietà, viene visualizzato l'errore 400 di richiesta errata.
marginHeader

object (Dimension)

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

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli l'impostazione di questa proprietà, viene visualizzato l'errore 400 di richiesta errata.
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 SectionStyle SectionBreak's. Se il valore non viene impostato nella prima interruzione di sezione, eredita 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 SectionStyle SectionBreak's. Se il valore non viene impostato nella prima interruzione di sezione, eredita dall'elemento firstPageHeaderId di DocumentStyle.

Questa proprietà è di sola lettura.
firstPageFooterId

string

L'ID del piè di pagina utilizzato solo per la prima pagina della sezione. Se useFirstPageHeaderFooter è true, questo valore viene utilizzato per il piè di pagina nella prima pagina della sezione. Se è false, il piè di pagina nella prima pagina della sezione utilizza defaultFooterId. Se non viene configurato, il valore eredita dal precedente SectionStyle SectionBreak's. Se il valore non viene impostato nella prima interruzione di sezione, eredita dall'elemento firstPageFooterId di DocumentStyle.

Questa proprietà è di sola lettura.
evenPageHeaderId

string

L'ID dell'intestazione utilizzato solo per le pagine pari. Se il valore di useEvenPageHeaderFooter di DocumentStyle è true, questo valore viene utilizzato per le intestazioni delle pagine pari nella sezione. Se è false, le intestazioni delle pagine pari utilizzano la defaultHeaderId. Se non viene configurato, il valore eredita dal precedente SectionStyle SectionBreak's. Se il valore non viene impostato nella prima interruzione di sezione, eredita dall'elemento evenPageHeaderId di DocumentStyle.

Questa proprietà è di sola lettura.
evenPageFooterId

string

L'ID del piè di pagina utilizzato solo per le pagine pari. Se il valore di useEvenPageHeaderFooter di DocumentStyle è true, questo valore viene utilizzato per i piè di pagina delle pagine pari nella sezione. Se è false, i piè di pagina delle pagine pari utilizzano defaultFooterId. Se non viene configurato, il valore eredita dal precedente SectionStyle SectionBreak's. Se il valore non viene impostato nella prima interruzione di sezione, eredita dall'elemento evenPageFooterId di DocumentStyle.

Questa proprietà è di sola lettura.
useFirstPageHeaderFooter

boolean

Indica se utilizzare gli ID intestazione / piè di pagina della prima pagina per la prima pagina della sezione. Se non viene configurato, eredita il criterio useFirstPageHeaderFooter di DocumentStyle per la prima sezione. Se il valore non è impostato per i settori successivi, deve essere interpretato come falso.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli l'impostazione di questa proprietà, viene visualizzato l'errore 400 di richiesta errata.
pageNumberStart

integer

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

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli l'impostazione di questa proprietà, viene visualizzato l'errore 400 di richiesta errata.
flipPageOrientation

boolean

Campo facoltativo. Indica se invertire le dimensioni dell'elemento pageSize di DocumentStyle per questa sezione, che consente di modificare l'orientamento della pagina da verticale a orizzontale e viceversa. Se non viene configurato, il valore eredita da flipPageOrientation di DocumentStyle.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli l'impostazione di questa proprietà, viene visualizzato l'errore 400 di richiesta errata.

ProprietàSezioneColonna

Proprietà che si applicano alla colonna di una sezione.

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

object (Dimension)

Solo output. La larghezza della colonna.
paddingEnd

object (Dimension)

Spaziatura interna alla fine della colonna.

StileSeparatoreColonna

Lo stile dei separatori di colonna tra le colonne.

Enum
COLUMN_SEPARATOR_STYLE_UNSPECIFIED Uno stile di separatore di colonna non specificato.
NONE Nessuna linea di separazione tra le colonne.
BETWEEN_EACH_COLUMN Visualizza una linea separatore di colonna tra ciascuna colonna.

TipoSezione

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

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

Tabella

Un StructuralElement che rappresenta una tabella.

Rappresentazione JSON 
{
  "rows": integer,
  "columns": integer,
  "tableRows": [
    {
      object (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 può essere non rettangolare, alcune righe potrebbero 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 elemento Table può avere più ID inserimento se si tratta di una modifica suggerita nidificata. Se vuoto, non è un inserimento suggerito.
suggestedDeletionIds[]

string

Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti.
tableStyle

object (TableStyle)

Lo stile della tabella.

RigaTabella

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

Rappresentazione JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "tableCells": [
    {
      object (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, esclusivo, in unità di codice UTF-16.
tableCells[]

object (TableCell)

I contenuti e lo stile di ogni cella di questa riga.

Poiché una tabella può essere non rettangolare, alcune righe possono avere un numero di celle diverso rispetto ad altre righe della stessa tabella.
suggestedInsertionIds[]

string

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

string

Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti.
tableRowStyle

object (TableRowStyle)

Lo stile della riga della tabella.
suggestedTableRowStyleChanges

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

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

Cella tabella

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

Rappresentazione JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "content": [
    {
      object (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, esclusivo, in 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 elemento TableCell può avere più ID inserimento se si tratta di una modifica suggerita nidificata. Se vuoto, non è un inserimento suggerito.
suggestedDeletionIds[]

string

Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti.
suggestedTableCellStyleChanges

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

Le modifiche suggerite allo stile della cella della tabella, specificate per ID suggerimento.

StileCellTabella

Lo stile di un TableCell.

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

Rappresentazione JSON 
{
  "rowSpan": integer,
  "columnSpan": integer,
  "backgroundColor": {
    object (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 riga della cella.

Questa proprietà è di sola lettura.
columnSpan

integer

L'intervallo di colonna della cella.

Questa proprietà è di sola lettura.
backgroundColor

object (OptionalColor)

Il colore di sfondo della cella.
borderLeft

object (TableCellBorder)

Il bordo sinistro della cella.
borderRight

object (TableCellBorder)

Il bordo destro della cella.
borderTop

object (TableCellBorder)

Il bordo superiore della cella.
borderBottom

object (TableCellBorder)

Il bordo inferiore della cella.
paddingLeft

object (Dimension)

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)

Spaziatura interna inferiore della cella.
contentAlignment

enum (ContentAlignment)

L'allineamento dei contenuti nella cella della tabella. L'allineamento predefinito corrisponde all'allineamento delle celle di tabella appena create nell'editor di documenti.

BordoCellTabella

Un bordo intorno a una cella di una tabella.

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

Rappresentazione JSON 
{
  "color": {
    object (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.

Allineamento dei contenuti

I tipi di allineamento dei contenuti.

Ricavato da un sottoinsieme di valori del tipo semplice "ST_TextAnchoringType" nella sezione 20.1.10.59 del documento "Office Open XML File Models - Fundamentals and Markup Language Reference", parte 1 della quarta edizione di ECMA-376.

Enum
CONTENT_ALIGNMENT_UNSPECIFIED Un allineamento dei contenuti non specificato. L'allineamento dei contenuti viene ereditato dall'elemento principale, se esistente.
CONTENT_ALIGNMENT_UNSUPPORTED Allineamento dei contenuti non supportato.
TOP Un allineamento che allinea i contenuti alla parte superiore del titolare dei contenuti. Corrisponde a ECMA-376 ST_TextAnchoringType "t".
MIDDLE Un allineamento che allinea i contenuti al centro del contenitore dei contenuti. Corrisponde a ECMA-376 ST_TextAnchoringType "ctr".
BOTTOM Un allineamento che allinea i contenuti alla parte inferiore del contenitore dei contenuti. Corrisponde a ECMA-376 ST_TextAnchoringType "b".

StileTabellaTabella suggerito

Una modifica suggerita a TableCellStyle.

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

object (TableCellStyle)

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

object (TableCellStyleSuggestionState)

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

Stato Suggerimento tabellaCellStyle

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

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

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.

StileTabellaTabella

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, in modo da mostrare tutti i contenuti delle celle della riga.
tableHeader

boolean

Indica se la riga è un'intestazione di tabella.
preventOverflow

boolean

Indica se l'overflow della riga non può superare i limiti della pagina o della colonna.

StileTableRowStyle suggerito

Una modifica suggerita a TableRowStyle.

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

object (TableRowStyle)

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

Stato Suggerimento TableRowStyle

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

Rappresentazione JSON 
{
  "minRowHeightSuggested": boolean
}
Campi
minRowHeightSuggested

boolean

Indica se è stata suggerita una modifica a minRowHeight.

Stile tabella

Stili che si applicano 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 righe contenenti celle, in modo simile all'HTML. Pertanto, le proprietà di una riga sono disponibili nel relativo valore tableRowStyle.

ProprietàTabellaColonna

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 widthType della colonna è FIXED_WIDTH.

Tipo di larghezza

Il tipo di larghezza della colonna.

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

La larghezza delle colonne è distribuita uniformemente tra le altre colonne distribuite in modo uniforme.

La larghezza della colonna viene determinata automaticamente e avrà una parte uguale della larghezza rimanente per la tabella dopo aver preso in considerazione tutte le colonne con larghezze specificate.
FIXED_WIDTH Una colonna con larghezza fissa. La proprietà [width][google.apps.docs.v1.TableColumnProperties.width contiene la larghezza della colonna.

Sommario

Un StructuralElement che rappresenta un sommario.

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

object (StructuralElement)

Il contenuto del sommario.
suggestedInsertionIds[]

string

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

string

Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti.

Piè di pagina

Una nota a piè di pagina di un documento.

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

string

L'ID della nota a piè di pagina.
content[]

object (StructuralElement)

I contenuti della nota a piè di pagina.

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

StileDocumento

Lo stile del documento.

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

object (Background)

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

string

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

Questa proprietà è di sola lettura.
evenPageHeaderId

string

L'ID dell'intestazione utilizzato solo per le pagine pari. Il valore di useEvenPageHeaderFooter determina se utilizzare defaultHeaderId o questo valore per l'intestazione delle pagine pari. Se non viene impostato, non esiste un'intestazione di pagina pari.

Questa proprietà è di sola lettura.
evenPageFooterId

string

L'ID del piè di pagina utilizzato solo per le pagine pari. Il valore di useEvenPageHeaderFooter determina se utilizzare defaultFooterId o questo valore per il piè di pagina sulle pagine pari. Se non viene impostato, non c'è un piè di pagina delle pagine pari.

Questa proprietà è di sola lettura.
firstPageHeaderId

string

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

Questa proprietà è di sola lettura.
firstPageFooterId

string

L'ID del piè di pagina utilizzato solo per la prima pagina. Se non viene impostato, non esiste un piè di pagina univoco per la prima pagina. Il valore di useFirstPageHeaderFooter determina se utilizzare defaultFooterId o questo valore per il piè di pagina sulla prima pagina. Se non viene configurato, non esiste un piè di pagina per la prima pagina.

Questa proprietà è di sola lettura.
useFirstPageHeaderFooter

boolean

Indica se utilizzare gli ID intestazione / piè di pagina della prima pagina per la prima pagina.
useEvenPageHeaderFooter

boolean

Indica se utilizzare gli ID intestazione / piè di pagina delle pagine pari per le pagine pari.
pageNumberStart

integer

Il numero di pagina da cui iniziare il conteggio del numero di pagine.
marginTop

object (Dimension)

Margine della pagina superiore.

L'aggiornamento del margine superiore della pagina nello stile del documento cancellerà il margine superiore della pagina in tutti gli stili di sezione.
marginBottom

object (Dimension)

Margine inferiore della pagina.

L'aggiornamento del margine inferiore della pagina nello stile del documento cancellerà il margine inferiore della pagina in tutti gli stili di sezione.
marginRight

object (Dimension)

Margine di pagina destro.

L'aggiornamento del margine di pagina destro nello stile del documento cancellerà il margine di pagina destro in tutti gli stili di sezione. Potrebbe anche causare il ridimensionamento delle colonne in tutte le sezioni.
marginLeft

object (Dimension)

Il margine della pagina sinistro.

L'aggiornamento del margine di pagina sinistro nello stile del documento lo cancella in tutti gli stili di sezione. Potrebbe anche causare il ridimensionamento delle colonne in tutte le sezioni.
pageSize

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

Campo facoltativo. Indica se invertire le dimensioni di pageSize per consentire di cambiare l'orientamento della pagina da verticale a orizzontale.

Informazioni preliminari

Rappresenta lo sfondo di un documento.

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

object (OptionalColor)

Il colore dello 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.

StileDocumento suggerito

Una modifica suggerita per DocumentStyle.

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

object (DocumentStyle)

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

object (DocumentStyleSuggestionState)

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

Stato Suggerimento stileDocumento

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

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

object (BackgroundSuggestionState)

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

boolean

Indica se è stata suggerita una modifica a defaultHeaderId.
evenPageHeaderIdSuggested

boolean

Indica se è stata suggerita una modifica a evenPageHeaderId.
evenPageFooterIdSuggested

boolean

Indica se è stata suggerita una modifica a evenPageFooterId.
firstPageHeaderIdSuggested

boolean

Indica se è stata suggerita una modifica a firstPageHeaderId.
firstPageFooterIdSuggested

boolean

Indica se è stata suggerita una modifica a firstPageFooterId.
useFirstPageHeaderFooterSuggested

boolean

Indica se è stata suggerita una modifica a useFirstPageHeaderFooter.
useEvenPageHeaderFooterSuggested

boolean

Indica se è stata suggerita una modifica a useEvenPageHeaderFooter.
pageNumberStartSuggested

boolean

Indica se è stata suggerita una modifica a pageNumberStart.
marginTopSuggested

boolean

Indica se è stata suggerita una modifica a marginTop.
marginBottomSuggested

boolean

Indica se è stata suggerita una modifica a marginBottom.
marginRightSuggested

boolean

Indica se è stata suggerita una modifica a marginRight.
marginLeftSuggested

boolean

Indica se è stata suggerita una modifica a marginLeft.
pageSizeSuggestionState

object (SizeSuggestionState)

Una maschera che indica quali campi in [size] [google.apps.docs.v1.DocumentStyle.size] sono stati modificati in questo suggerimento.
marginHeaderSuggested

boolean

Indica se è stata suggerita una modifica a marginHeader.
flipPageOrientationSuggested

boolean

Campo facoltativo. Indica se è stata suggerita una modifica a flipPageOrientation.

Stato Suggerimento sullo sfondo

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

Rappresentazione JSON 
{
  "backgroundColorSuggested": boolean
}
Campi
backgroundColorSuggested

boolean

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

Stato del suggerimento dimensioni

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

Rappresentazione JSON 
{
  "heightSuggested": boolean,
  "widthSuggested": boolean
}
Campi
heightSuggested

boolean

Indica se è stata suggerita una modifica a height.
widthSuggested

boolean

Indica se è stata suggerita una modifica a width.

Stili NamedStyle

Gli stili con nome. I paragrafi nel documento possono ereditare i valori TextStyle e ParagraphStyle dagli stili con nome.

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

object (NamedStyle)

Gli stili con nome.

È presente una voce per ciascuno dei possibili named style types.

Stile Named

Uno stile con nome. I paragrafi nel documento possono ereditare i valori TextStyle e ParagraphStyle da questo stile con nome se hanno lo stesso tipo di stile denominato.

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

enum (NamedStyleType)

Il tipo di stile con nome.
textStyle

object (TextStyle)

Lo stile di testo di questo stile con nome.
paragraphStyle

object (ParagraphStyle)

Lo stile di paragrafo di questo stile con nome.

StiliNamedSuggeriti

Una modifica suggerita per NamedStyles.

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

object (NamedStyles)

Un NamedStyles che include solo le modifiche apportate in questo suggerimento. 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 sulla 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 del NamedStyle corrispondente in styles sono stati modificati in questo suggerimento.

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

Stato NamedStyleSuggestion

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 lo stato del suggerimento.

Questo campo viene fornito per semplificare la corrispondenza tra NamedStyleSuggestionState e NamedStyle corrispondente.
textStyleSuggestionState

object (TextStyleSuggestionState)

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

object (ParagraphStyleSuggestionState)

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

Elenco

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

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

object (ListProperties)

Le proprietà dell'elenco.
suggestedListPropertiesChanges

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

Le modifiche suggerite alle proprietà dell'elenco, specificate per ID suggerimento.
suggestedInsertionId

string

L'ID inserimento suggerito. Se vuoto, non è un inserimento suggerito.
suggestedDeletionIds[]

string

Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questo elenco.

Proprietà-Elenco

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

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

object (NestingLevel)

Descrive le proprietà dei punti elenco al livello associato.

Un elenco ha al massimo 9 livelli di nidificazione, con il livello di annidamento 0 corrispondente al livello più alto e il livello di nidificazione 8 corrispondente a quello più nidificato. I livelli nidificati vengono restituiti in ordine crescente e vengono restituiti prima quelli meno nidificati.

Livello di nidificazione

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

Rappresentazione JSON 
{
  "bulletAlignment": enum (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 glyph contiene uno o più segnaposto che vengono sostituiti con i valori appropriati a seconda di glyphType o glyphSymbol. I segnaposto seguono il pattern %[nestingLevel]. Inoltre, i segnaposto possono avere prefissi e suffissi. Pertanto, il formato deglifo segue il pattern <prefix>%[nestingLevel]<suffix>. Tieni presente che prefisso e suffisso sono facoltativi e possono essere stringhe arbitrarie.

Ad esempio, il formato %0. indica che il segnaposto visualizzato sostituirà il segnaposto con il glifo corrispondente per il livello 0 nidificato seguito da un punto come suffisso. Pertanto, un elenco con tipo glifo UPPER_ALPHA e formato glifo %0. a livello nidificato 0 darà origine a un elenco con glifi sottoposti a rendering

A.

B.

C.

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

1.

2.

2.1.

2.2.

3.

Per i livelli nidificati che vengono ordinati, la stringa che sostituisce un segnaposto nel formato glifo per un determinato paragrafo dipende dall'ordine del paragrafo nell'elenco.
indentFirstLine

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. Applicata al lato corrispondente all'inizio del testo, in base alla direzione dei contenuti del paragrafo.
textStyle

object (TextStyle)

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

integer

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

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

Questo valore viene ignorato per i livelli nidificati con glifi non ordinati.
Campo di unione glyph_kind. Il tipo di glifo usato dai punti elenco. In questo modo viene definito il glifo del punto elenco che sostituisce i segnaposto in glyph_format. glyph_kind può essere solo uno dei seguenti:
glyphType

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 i paragrafi a questo livello di nidificazione vengono ordinati. Ad esempio, se il livello di annidamento è 0, glyphFormat è %0. e il tipo di glifo è DECIMAL, il glifo visualizzato sostituirà il segnaposto %0 nel formato glifo con un numero corrispondente all'ordine dell'elemento dell'elenco nell'elenco.
glyphSymbol

string

Un simbolo glifo personalizzato utilizzato dai punti elenco quando i paragrafi a questo livello di annidamento non sono ordinati.

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

Allineamento elenco puntato

I tipi di allineamento di un punto elenco.

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

Tipo glifo

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

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

ProprietàElenco suggerite

Una modifica suggerita per ListProperties.

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

object (ListProperties)

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

Stato ElencoProprietàSuggerimento

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

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

object (NestingLevelSuggestionState)

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

Gli stati di suggerimento del livello di annidamento vengono restituiti in ordine crescente del livello di annidamento e vengono restituiti per primi quelli con il livello meno nidificato.

Stato NestingLevelSuggestionState

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

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

boolean

Indica se è stata suggerita una modifica a bulletAlignment.
glyphTypeSuggested

boolean

Indica se è stata suggerita una modifica a glyphType.
glyphFormatSuggested

boolean

Indica se è stata suggerita una modifica a glyphFormat.
glyphSymbolSuggested

boolean

Indica se è stata suggerita una modifica a glyphSymbol.
indentFirstLineSuggested

boolean

Indica se è stata suggerita una modifica a indentFirstLine.
indentStartSuggested

boolean

Indica se è stata suggerita una modifica a indentStart.
textStyleSuggestionState

object (TextStyleSuggestionState)

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

boolean

Indica se è stata suggerita una modifica a startNumber.

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

I valori NamedRange che condividono lo stesso nome.

Intervallo Nome

Una raccolta di Range con lo stesso ID intervallo denominato.

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

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

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

Rappresentazione JSON 
{
  "namedRangeId": string,
  "name": string,
  "ranges": [
    {
      object (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
}
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 in base zero di questo intervallo, in unità di codice UTF-16.

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

integer

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

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

Modalità di visualizzazione dei suggerimenti

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

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

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

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

Il documento restituito è un'anteprima in cui sono state accettate tutte le modifiche suggerite.

Le richieste per recuperare un documento utilizzando questa modalità restituiranno un errore 403 se l'utente non dispone dell'autorizzazione per visualizzare le modifiche suggerite.
PREVIEW_WITHOUT_SUGGESTIONS Il documento restituito è un'anteprima con tutte le modifiche suggerite rifiutate, se il documento contiene suggerimenti.

InlineObject

Oggetto visualizzato in linea con il testo. Un InlineObject contiene un elemento EmbeddedObject, ad esempio un'immagine.

Rappresentazione JSON 
{
  "objectId": string,
  "inlineObjectProperties": {
    object (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à dell'oggetto in linea.
suggestedInlineObjectPropertiesChanges

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

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

string

L'ID inserimento suggerito. Se vuoto, non è un inserimento suggerito.
suggestedDeletionIds[]

string

Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti.

ProprietàInlineObjectProperties

Proprietà di un elemento InlineObject.

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

object (EmbeddedObject)

L'oggetto incorporato di questo oggetto in linea.

Oggetto incorporato

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 vengono combinati per visualizzare il testo alternativo.
description

string

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

object (EmbeddedObjectBorder)

Il bordo dell'oggetto incorporato.
size

object (Size)

Le dimensioni visibili dell'immagine dopo il ritaglio.
marginTop

object (Dimension)

Il margine superiore dell'oggetto incorporato.
marginBottom

object (Dimension)

Il margine inferiore dell'oggetto incorporato.
marginRight

object (Dimension)

Il margine destro dell'oggetto incorporato.
marginLeft

object (Dimension)

Il margine sinistro dell'oggetto incorporato.
linkedContentReference

object (LinkedContentReference)

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

Se il criterio non viene configurato, l'oggetto incorporato non è collegato.
Campo di unione properties. Le proprietà specifiche di ogni tipo di oggetto incorporato. properties può essere solo uno dei seguenti:
embeddedDrawingProperties

object (EmbeddedDrawingProperties)

Le proprietà di un disegno incorporato.
imageProperties

object (ImageProperties)

Le proprietà di un'immagine.

ProprietàDisegnoIncorporato

Questo tipo non ha campi.

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

ImageProperties

Le proprietà di un'immagine.

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

string

Un URI dell'immagine con una durata predefinita di 30 minuti. Questo URI è contrassegnato con l'account del richiedente. Chiunque abbia l'URI accede in modo efficace all'immagine come richiedente originale. Se le impostazioni di condivisione del documento cambiano, potresti perdere l'accesso all'immagine.
sourceUri

string

L'URI di origine è l'URI 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 significa nessun effetto.
contrast

number

L'effetto di contrasto dell'immagine. Il valore deve essere compreso nell'intervallo [-1,0, 1,0], dove 0 significa 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.

Proprietà ritaglio

Le proprietà di ritaglio di un'immagine.

Il rettangolo di ritaglio viene rappresentato utilizzando offset frazionari dai quattro bordi del contenuto originale.

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

number

L'offset specifica quanto si estende verso l'interno il bordo sinistro del rettangolo di ritaglio dal bordo sinistro del contenuto originale come frazione della larghezza di questi ultimi.
offsetRight

number

L'offset specifica quanto si estende verso l'interno il bordo destro del rettangolo di ritaglio dal bordo destro del contenuto originale come frazione della larghezza di questi ultimi.
offsetTop

number

L'offset specifica quanto si estende verso l'interno il bordo superiore del rettangolo di ritaglio dal bordo superiore dei contenuti originali sotto forma di frazione dell'altezza di questi ultimi.
offsetBottom

number

L'offset specifica quanto si estende verso l'interno il bordo inferiore del rettangolo di ritaglio dal bordo inferiore dei contenuti originali sotto forma di frazione dell'altezza di questi ultimi.
angle

number

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

IncorporatoOggettoBorder

Un bordo intorno a un EmbeddedObject.

Rappresentazione JSON 
{
  "color": {
    object (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à di confine.

Stato della proprietà

I possibili stati di una proprietà.

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

RiferimentoContenutolink

Un riferimento ai contenuti della fonte esterna collegata.

Rappresentazione JSON 
{

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

object (SheetsChartReference)

Un riferimento al grafico collegato.

RiferimentoGrafico Fogli

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.

ProprietàOggettoInline Suggerite

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 sulla base InlineObjectProperties sono stati modificati in questo suggerimento.

StatoInlineObjectPropertiesSuggestionState

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

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

object (EmbeddedObjectSuggestionState)

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

StaticObjectSuggestionState

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

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

object (EmbeddedDrawingPropertiesSuggestionState)

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

object (ImagePropertiesSuggestionState)

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

boolean

Indica se è stata suggerita una modifica a title.
descriptionSuggested

boolean

Indica se è stata suggerita una modifica a description.
embeddedObjectBorderSuggestionState

object (EmbeddedObjectBorderSuggestionState)

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

object (SizeSuggestionState)

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

boolean

Indica se è stata suggerita una modifica a marginLeft.
marginRightSuggested

boolean

Indica se è stata suggerita una modifica a marginRight.
marginTopSuggested

boolean

Indica se è stata suggerita una modifica a marginTop.
marginBottomSuggested

boolean

Indica se è stata suggerita una modifica a marginBottom.
linkedContentReferenceSuggestionState

object (LinkedContentReferenceSuggestionState)

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

Stato Suggerimento relativo al disegno incorporato

Questo tipo non ha campi.

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

Stato Suggerimento Proprietà Immagini

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

Rappresentazione JSON 
{
  "contentUriSuggested": boolean,
  "sourceUriSuggested": boolean,
  "brightnessSuggested": boolean,
  "contrastSuggested": boolean,
  "transparencySuggested": boolean,
  "cropPropertiesSuggestionState": {
    object (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 [contrasto] [google.apps.docs.v1.EmbeddedObject.contrast].
transparencySuggested

boolean

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

object (CropPropertiesSuggestionState)

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

boolean

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

Stato CropPropertiesSuggestion

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

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

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.

StaticObjectBorderSuggestionState

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

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

boolean

Indica se è stata suggerita una modifica a [color] [google.apps.docs.v1.EmbedBorderObject.color].
widthSuggested

boolean

Indica se è stata suggerita una modifica a [larghezza] [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].

Stato LinkedContentReferenceSuggestion

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

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

object (SheetsChartReferenceSuggestionState)

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

Stato FogliChartReferenceSuggestion

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

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

boolean

Indica se è stata suggerita una modifica a spreadsheetId.
chartIdSuggested

boolean

Indica se è stata suggerita una modifica a chartId.

Oggetto posizionato

Un oggetto collegato a un Paragraph e posizionato rispetto all'inizio del paragrafo. Un oggetto Posizionato contiene un elemento EmbeddedObject, ad esempio un'immagine.

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

string

L'ID dell'oggetto posizionato.
positionedObjectProperties

object (PositionedObjectProperties)

Le proprietà dell'oggetto posizionato.
suggestedPositionedObjectPropertiesChanges

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

Le modifiche suggerite alle proprietà dell'oggetto posizionato, specificate per ID suggerimento.
suggestedInsertionId

string

L'ID inserimento suggerito. Se vuoto, non è un inserimento suggerito.
suggestedDeletionIds[]

string

Gli ID di eliminazione suggeriti. Se il campo è vuoto, non verranno suggerite eliminazioni di questi contenuti.

Proprietà oggetto posizionato

Proprietà di una proprietà PositionedObject.

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

object (PositionedObjectPositioning)

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

object (EmbeddedObject)

L'oggetto incorporato dell'oggetto posizionato.

Posizionamento oggetto posizionato

Il posizionamento di un elemento PositionedObject. L'oggetto posizionato viene posizionato rispetto all'inizio del Paragraph a cui è vincolato il tethering.

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

enum (PositionedObjectLayout)

Il layout dell'oggetto posizionato.
leftOffset

object (Dimension)

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

object (Dimension)

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

Layout oggetto posizionato

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

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

Proprietà oggetti posizionate suggerite

Una modifica suggerita per PositionedObjectProperties.

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

object (PositionedObjectProperties)

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

object (PositionedObjectPropertiesSuggestionState)

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

PosizionatoOggettoProprietàSuggestionState

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

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

object (PositionedObjectPositioningSuggestionState)

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

object (EmbeddedObjectSuggestionState)

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

Stato posizione dell'oggettoPositioningSuggestion

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

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

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.

Metodi

batchUpdate

 Applica uno o più aggiornamenti al documento.

create

 Crea un documento vuoto utilizzando il titolo specificato nella richiesta.

get

 Restituisce la versione più recente del documento specificato.